A sample Python project
A sample project that exists as an aid to the Python Packaging User Guide <https://packaging.python.org>
's Tutorial on Packaging and Distributing Projects <https://packaging.python.org/en/latest/distributing.html>
.
This projects does not aim to cover best practices for Python project
development as a whole. For example, it does not provide guidance or tool
recommendations for version control, documentation, or testing.
The source for this project is available here <https://github.com/pypa/sampleproject>
_.
Most of the configuration for a Python project is done in the setup.py
file, an example of which is included in this project. You should edit this
file accordingly to adapt this sample project to your needs.
This is the README file for the project.
The file should use UTF-8 encoding and be written using reStructuredText <http://docutils.sourceforge.net/rst.html>
_. It
will be used to generate the project webpage on PyPI and will be displayed as
the project homepage on common code-hosting services, and should be written for
that purpose.
Typical contents for this file would include an overview of the project, basic
usage examples, etc. Generally, including the project changelog in here is not
a good idea, although a simple "What's New" section for the most recent version
may be appropriate.