__init__.py 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. """
  2. General
  3. =======
  4. The Debian Archive Kit web api, AKA the B{FTP-Master api}, allows
  5. anyone to query the database of the Debian archive kit for information
  6. related to the archive. That is, it provides information about the
  7. archive, its suites and all the packages.
  8. Development
  9. -----------
  10. B{NOTE}: B{The api} is still new and we are adding new features
  11. whenever someone asks for them. Or better yet, provides a patch.
  12. B{The api}s code lives in the C{dak} codebase, if you want to provide
  13. a patch with a new feature, or fix a bug, feel free to clone it::
  14. git clone https://ftp-master.debian.org/git/dak.git
  15. Patches, Feature requests, bug reports go to the
  16. U{debian-dak<mailto:debian-dak@lists.debian.org>}
  17. mailing list.
  18. Usage
  19. =====
  20. B{The api} responds to simple http queries and (usually) replies with
  21. JSON formatted data. Some commands may require an extra parameter to
  22. output JSON (notably the madison one).
  23. U{https://api.ftp-master.debian.org/} is the base path for all
  24. requests.
  25. Available Methods
  26. -----------------
  27. The list of available methods can be seen by browsing the
  28. automatically generated documentation for the L{dakweb.queries}
  29. module. There are various submodules dealing with different parts of
  30. the api. Every I{public} function of those modules corresponds to
  31. one available method. The input parameters and the output format are
  32. documented with each of those functions.
  33. @contact: "Debian FTPMaster <ftpmaster@debian.org>".
  34. """