Skip to content

MarkGardnerUSyd/packaging_demo

 
 

Repository files navigation

Packaging and releasing python code on pypi

tests codecov docs

Author: Brendan Whelan

This repository is intended to demonstrate the key tasks involved in publicly releasing python code as a member of Image X. The code itself just plots a sine wave.

Key topics include:

  • Choosing a license
  • Setting up packaging tools
  • Optional: set up a test framework
  • Optional: set up and host html documentation

Setup/Build/Install

To complete this tutorial you will need:

  • An account on github.com (this is different from our enterprise github)
  • An account on test pypi - and you will need to remember your account details!
  • A terminal in your OS. On windows, I think pycharm is the easiest option.
  • From there, clone this directory into a new environment and do
pip install -r dev-requirements.txt

Usage

A detailed tutorial is provided here

  • docs contains html documentation
  • docsrc markdown/rst source documentation
  • tests test cases
  • MyPackage source code

About

tutorial for image-x on packaging python code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 75.3%
  • Batchfile 14.3%
  • Makefile 10.4%