This repository contains a minimal, toy Python package with a few files as illustration for students of how to lay out their code to meet minimal Python packaging requirements.

It has a single source directory (mytoy) with an __init__.py file and one "implementation" file (toys.py) as well as a few tests in mytoy/tests.

In addition to this README.md it includes some basic infrastructure: LICENSE, requirements.txt, setup.py and .gitignore files.

The only docs included are this README.md file - a larger package would have a proper docs directory and associated Sphinx/JupyterBook build.

This is more or less the absolute minimum for a "real" python package that can be installed from source, tested and experimented with on Binder. For a more "official" version of this same idea, see the PyPA sample project repo, documented in detail in the Packaging Tutorial. The Python Packaging User Guide contains comprehensive documentation on this topic.

This project can currently only be installed from source, via

pip install .

or for a development installation via

pip install -e .

You can run the project test suite via

pytest mytoy

This project is released under the terms of the BSD 3-clause License.