pyYC documentation

Version:

of 22-11-30, 15:32

Author:

Yannick Copin <y.copin@ipnl.in2p3.fr>

Abstract:

This package should be used as a template for package structure, configuration and packaging, documentation, tests, gitlab continuous integration, etc. Work In Progress, feedback is welcome!

pyYC \pwik\ - A sample project

– Le packaging python, je n’y entrave que pouic.

– Utilise pyyc \pwik\!

• Gitlab repository

• Online documentation

• PyPI project

• Associated online course (in French): Analyse scientifique avec Python

Quick introduction

• Install the package
• Test the installation
• Build the documentation
• Run the tests

Detailed documentation

• Packaging (setup.cfg)
• Package initialization (__init__.py)
• Main entries (__main__.py)
• Documentation
  • conf.py
  • index.rst
  • setup.cfg
  • Notebooks
• Testing
  • Doctests
  • Dedicated tests
  • Test coverage
• Data files (e.g. config/)
• Gitlab continuous integration
• More elements
• To do

Code documentation

Packages and modules

• pyyc package
  • pyyc.mod module
    • addition()
    • addition_int()
    • PYYC_PATH
    • read_config()
    • format_pkg_tree()
    • greetings()
  • Subpackages
    • pyyc.subpkgA package
      • pyyc.subpkgA.modA1 module
      • pyyc.subpkgA.modA2 module
    • pyyc.subpkgB package
      • pyyc.subpkgB.modB module

Main entries

• main

Tests

• pyyc tests

Notebooks

• Test notebook

Indices and tables

• Index

• Module Index

• Search Page