To work on geoplot locally, you will need to clone it.
git clone https://github.com/ResidentMario/geoplot.git
You can then set up your own branch version of the code, and work on your changes for a pull request from there.
cd geoplot
git checkout -B new-branch-nameTo install the geoplot development environment run the following in the root directory:
conda env create -f environment.yml
conda activate geoplot-dev
pip install -e .[develop]geoplot tests are located in the tests folder. Any PRs you submit should eventually pass all of the tests located in this folder.
mixin_tests.py are static unit tests which can be run via pytest the usual way (by running pytest mixin_tests.py from the command line).
proj_tests.py and viz_tests.py are visual tests run via the pytest-mpl plugin to be run: see here for instructions on how it's used. These tests are passed by visual inspection: e.g. does the output figure look the way it should look, given the inputs?
Documentation is provided via sphinx. To regenerate the documentation from the current source in one shot, navigate to the docs folder and run make html. Alternatively, to regenerate a single specific section, see the following section.
The static example images on the repo and documentation homepages are located in the figures/ folder.
The gallery is generated using sphinx-gallery, and use the examples/ folder as their source. The webmap examples are hosted on bl.ocks.org and linked to from their gallery landing pages.
The Quickstart is a Jupyter notebook in the docs/quickstart/ directory. To rebuild the quickstart, edit the notebook, then run make html again.
The tutorials are Jupyter notebooks in the docs/user_guide/ directory. To rebuild the tutorials, edit the notebook(s), then run make html again.
Most of the image resources in the documentation use real-world example data that is packaged as an accessory to this library. The home repo for these datasets is the geoplot-data repository. Use the geoplot.datasets.get_path function to get a path to a specific dataset readable by geopandas.
The remaining pages are all written as rst files accessible from the top level of the docs folder.
The documentation is served at residentmario.github.io via GitHub's site export feature, served out of the gh-pages branch. To export a new version of the documentation to the website, run the following:
git checkout gh-pages
rm -rf *
git checkout master -- docs/ examples/ geoplot/ .gitignore
cd docs
make html
cd ..
mv docs/_build/html/* ./
rm -rf docs/ examples/ geoplot/
git add .
git commit -m "Publishing update docs..."
git push origin gh-pages
git checkout master