development.txt 1.4 KB

1234567891011121314151617181920212223242526272829303132333435
  1. -------------------------
  2. Development on Setuptools
  3. -------------------------
  4. Setuptools is maintained by the Python community under the Python Packaging
  5. Authority (PyPA) and led by Jason R. Coombs.
  6. This document describes the process by which Setuptools is developed.
  7. This document assumes the reader has some passing familiarity with
  8. *using* setuptools, the ``pkg_resources`` module, and EasyInstall. It
  9. does not attempt to explain basic concepts like inter-project
  10. dependencies, nor does it contain detailed lexical syntax for most
  11. file formats. Neither does it explain concepts like "namespace
  12. packages" or "resources" in any detail, as all of these subjects are
  13. covered at length in the setuptools developer's guide and the
  14. ``pkg_resources`` reference manual.
  15. Instead, this is **internal** documentation for how those concepts and
  16. features are *implemented* in concrete terms. It is intended for people
  17. who are working on the setuptools code base, who want to be able to
  18. troubleshoot setuptools problems, want to write code that reads the file
  19. formats involved, or want to otherwise tinker with setuptools-generated
  20. files and directories.
  21. Note, however, that these are all internal implementation details and
  22. are therefore subject to change; stick to the published API if you don't
  23. want to be responsible for keeping your code from breaking when
  24. setuptools changes. You have been warned.
  25. .. toctree::
  26. :maxdepth: 1
  27. developer-guide
  28. formats
  29. releases