This is a template repo used for creating new packages for stactools
.
- Clone this template repository as your package name, e.g.
landsat
. This name should be short, memorable, and a valid Python package name (i.e. it shouldn't start with a number, etc). It can, however, include a hyphen, in which case the name for Python imports will be the underscored version, e.g.landsat-8
goes tostactools.landsat_8
. Your name will be used on PyPI to publish the package in the stactools namespace, e.g.stactools-landsat
. - Change into the top-level directory of your package and run
scripts/rename
. This will update most of the files in the repository with your new package name. - Update
setup.cfg
with your package description and such. - Update the LICENSE with your company's information (or whomever holds the copyright).
- Run
sphinx-quickstart
in thedocs
directory to create the documentation template. - Update
docs/installation_and_basic_usage.ipynb
to provide an interactive notebook to help users get started. Include the following badge at the top of the README to launch the notebook: . Be sure to modify the badge href to match your package repo. - Add example Items (and Collections and Catalogs, if included) to a
examples/
directory. - Delete this file, and rename
README-template.md
toREADME.md
. Update your new README to provide information about how to use your package.