Skip to content

Latest commit

 

History

History
84 lines (45 loc) · 1.33 KB

getting_started.rst

File metadata and controls

84 lines (45 loc) · 1.33 KB

Getting started

Installing on the System Python

  1. Download the source (or clone the repository) to your computer

  2. Open a terminal in the directory of the source

  3. Install with setup.py

    On Mac or Linux:

    python3 setup.py install
    

    On Windows:

    py setup.py install
    

Setting up a Development Environment

  1. Create a new Python 3 virtual environment

    On Mac or Linux:

    python3 -m venv venv
    

    On Windows:

    py -m venv venv
    
  2. Activate Python virtual environment

    On Mac or Linux:

    source venv/bin/activate
    

    On Windows:

    venv/Scripts/activate
    
  3. Install the grabbags in development mode

    python -m pip install -e .
    
  4. Start hacking

Building the documentation

1. Follow the instructions above and install and activate the development virtual environment

  1. Install sphinx

    python -m pip install sphinx
    
  2. Run sphinx build target from setup.py

    python setup.py build_sphinx
    

By default, the documentation is generated into build/sphinx/html