Metadata-Version: 2.0
Name: goldensphinx
Version: 0.0.2
Summary: Build and serve Sphinx
Home-page: https://github.com/yoavram/goldensphinx
Author: Yoav Ram
Author-email: yoav@yoavram.com
License: MIT
Platform: UNKNOWN
Requires-Dist: click (>=5sphinx>=1.3.0)
Requires-Dist: gevent (>=0.13.6)
Requires-Dist: greenlet (>=0.3.1)
Requires-Dist: gunicorn (>=0.13.4)
Requires-Dist: numpydoc
Requires-Dist: sphinx-rtd-theme
Requires-Dist: static
Requires-Dist: static (>=0.4)

# Golden Sphinx

Build and serve Sphinx docs.

Example usage:

```sh
$ goldensphinx build serve
```

You can also just build:

```sh
$ goldensphinx build
```

or just serve:

```sh
$ goldensphinx serve
```

To see the options you can control, run a command with `--help`:

```sh
$ goldensphinx build --help
Usage: goldensphinx build [OPTIONS]

Options:
  --source_dir PATH  Directory containing documentation source
  --dest_dir PATH    Directory to build documentation to
  --help             Show this message and exit.

$ goldensphinx serve --help
Usage: goldensphinx serve [OPTIONS]

Options:
  --static_dir PATH      Static directory to serve
  --host TEXT            Hostname to serve on
  --port INTEGER         Port to serve on
  --num_threads INTEGER  Number of threads
  --help                 Show this message and exit.
```

All options can be also be set using environment variables:

- `source_dir` and `static_dir` by `STATIC_DIR`
- `dest_dir` by `DOCS_DIR`
- `port` by `PORT`
- `host` by `HOST`
- `num_threads` by `NUM_SERVER_THREADS`

For example:

```sh
$ export PORT=8080
$ goldensphinx serve --host 127.0.0.1
[2016-09-06 10:02:14 +0300] [55096] [INFO] Starting gunicorn 19.6.0
[2016-09-06 10:02:14 +0300] [55096] [INFO] Listening at: http://127.0.0.1:8080 (87302)
```

You can also set the environment variable `GOLDENSPHINX` to `false` if you want to prevent goldensphinx from running.

## Install

Stable:

```sh
pip install goldensphinx
```

Latest:

```sh
pip install git+https://github.com/yoavram/goldensphinx.git
```

## Authors

- Yoav Ram (@yoavram)

## Acknowledgements

- The project is inspired by, and the `serve` command is modified from [kennethreitz/goldenarch](https://github.com/kennethreitz/goldenarch).
- Many thanks to the authors of Python, Gunicorn, Sphinx, Click, Static and everything else we build our apps with.


