Metadata-Version: 2.1
Name: smugapi
Version: 0.8.1
Summary: helpful api endpoints for smug
Home-page: https://github.com/nod/smugapi
License: UNKNOWN
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: click
Requires-Dist: pngcanvas
Requires-Dist: requests
Requires-Dist: tornado
Requires-Dist: webpreview

# smug-api

Some endpoints for your
[smug-broker](https://github.com/threatsimple/smug-broker) to talk to
immediately.

Want weather in your slack channel?  Want stock quotes?  We've got you covered.

# quickstart

The fastest way to get started is to use the docker image.

```
docker pull threatsimple/smugapi:latest
export SMUGAPI_WEATHERBIT=YourWeatherKey
export SMUGAPI_WORLDTRADINGDATA=YourStockQuoteKey
docker run -p 8088 \
    -e SMUGAPI_WEATHERBIT -e SMUGAPI_WORLDTRADINGDATA -it \
    threatsimple/smugapi:latest
```

Another option is to use the package from pypi.org.

```
pip3 install smugapi
export SMUGAPI_WEATHERBIT
export SMUGAPI_WORLDTRADINGDATA=YourStockQuoteKey
smugapi run
```

Either way, you'll have the api running and listening on localhost, port 8088.

# running the service

There is a command line tool, `smugapi` that allows for easy starting of the api
service.

```
smugapi run
```

This will run the web service and bind to localhost.

This doesn't get you anything useful, though.  You'll want to pass api keys via
either the cmd line or environment variables, as discussed in the endpoints
section below.

# endpoints

## weather

Current weather and forecasts are provided by the very excellent
https://weatherbit.io folks.  They have a free plan that works for most
channels, but if you have a larger volume, they offer a paid option.

To use the weather endpoints, set your api key via either the command line with
the `--weatherbit` option `smugapi run` or via the `SMUGAPI_WEATHERBIT`
environment variable.

```
export SMUGAPI_WEATHERBIT=<Your API Key Here>
smugapi run
```

## stock price lookups

Global stock prices can be looked up.  The data is provided by the excellent
folks at worldtradingdata.com.  They have a free account that can provide for
most channels, and a paid option is available for larger demands.

To use the stock price endpoint, set your api key either the command line with
the `--worldtradingdata` option to `smugapi run` or with the
`SMUGAPI_WORLDTRADINGDATA` environment variable.

```
export SMUGAPI_WORLDTRADINGDATA=<Your API Key Here>
smugapi run
```

## Chartmoji

It is recommended using [Chartmoji](https://github.com/threatsimple/chartmoji)
in your slack workspace.  It adds a bit of flair to your stock quotes and
weather.

To use chartmoji, you can use either the `--chartmoji` option to `smugapi run`
or by setting `SMUGAPI_CHARTMOJI=true` in the runtime environment.

# developing

All development related tasks are managed via the Makefile.

## dev environment

```
make dev
```

This creates a python virtualenv in `pyvenv` and installs the required libs, as
referenced in `reqs.pip`.

This also sets up the current source directory as the `smugapi` module in the
venv for ease of development.

## testing

```
make test
```

Assuming you've run `make dev`, you can use `make test` to run tests. This
will handle the executing the tests in the virtualenv for you, so no need to
handle that in your shell.




