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-8goes 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.cfgwith your package description and such. - Update the LICENSE with your company's information (or whomever holds the copyright).
- Run
sphinx-quickstartin thedocsdirectory to create the documentation template. - Update
docs/installation_and_basic_usage.ipynbto 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.mdtoREADME.md. Update your new README to provide information about how to use your package.