Les bonnes pratiques qui semblent les plus répandues, et que j'ai réussi à appliquer avec succès, semblent celles de [[https://readthedocs.org/projects/python-guide/downloads/pdf/latest/|The Hitchhiker's Guide to Python]] {{ :lang:python:structure:python_guide_documentation_v2018-12-21.pdf |Archive du 21/12/2018 le 27/01/2021}}

Soit un module s'appelant ''foobar'' :

<code>
foobar
  +--docs
  | +--*.md
  | +--*.asciidoc
  | \--*.png
  +--foobar
  | \--*.py
  +--tests
  | \--*.py
  +--LICENSE
  +--README.md
  +--requirements.txt
  +--setup.py
</code>

Exemple de ''setup.py'' :

<file python setup.py>
from setuptools import setup, find_packages

with open('README.md') as f:
    readme = f.read()

with open('LICENSE') as f:
    license = f.read()

setup(
    name='sample',
    version='0.1.0',
    description='blablabla',
    long_description=readme,
    author='Name',
    author_email='e@mail.com',
    url='awesome.com',
    license=license,
    packages=find_packages(exclude=('tests', 'docs'))
)
</file>