Skip to main content

A sample Python project

Project description

A sample project that exists as an aid to the Python Packaging User Guide’s Tutorial on Packaging and Distributing Projects.

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.

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. 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xsampleproject-1.2.0.tar.gz (5.2 kB view details)

Uploaded Source

File details

Details for the file xsampleproject-1.2.0.tar.gz.

File metadata

File hashes

Hashes for xsampleproject-1.2.0.tar.gz
Algorithm Hash digest
SHA256 ec92e598a07ceae5c5c706aebb5d5f3270244ff6475c17f9b0010f60199b5205
MD5 afb82e2e6abddaba6be98fa7727bb64a
BLAKE2b-256 a44e1f78c875f66bf89084edc091db3b5e579accc05b47ca70cd3befb7e672c8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page