| OLD | NEW |
| (Empty) |
| 1 Development Philosophy | |
| 2 ====================== | |
| 3 | |
| 4 Requests is an open but opinionated library, created by an open but opinionated
developer. | |
| 5 | |
| 6 | |
| 7 Management Style | |
| 8 ~~~~~~~~~~~~~~~~ | |
| 9 | |
| 10 `Kenneth Reitz <http://kennethreitz.org>`_ is the BDFL. He has final say in any
decision related to the Requests project. Kenneth is responsible for the directi
on and form of the library. In addition to making decisions based on technical m
erit, he is responsible for making decisions based on the development philosophy
of Requests. Only Kenneth may merge code into Requests. | |
| 11 | |
| 12 `Ian Cordasco <http://www.coglib.com/~icordasc/>`_ and `Cory Benfield <https://l
ukasa.co.uk/about/>`_ are the core contributors. They are responsible for triagi
ng bug reports, reviewing pull requests and ensuring that Kenneth is kept up to
speed with developments around the library. The day-to-day managing of the proje
ct is done by the core contributors. They are responsible for making judgements
about whether or not a feature request is likely to be accepted by Kenneth. They
do not have the authority to change code or merge code changes, though they may
change documentation. Their word is not final. | |
| 13 | |
| 14 Values | |
| 15 ~~~~~~ | |
| 16 | |
| 17 - Simplicity is always better than functionality. | |
| 18 - Listen to everyone, then disregard it. | |
| 19 - The API is all that matters. Everything else is secondary. | |
| 20 - Fit the 90% use-case. Ignore the nay-sayers. | |
| 21 | |
| 22 Semantic Versioning | |
| 23 ~~~~~~~~~~~~~~~~~~~ | |
| 24 | |
| 25 For many years, the open source community has been plagued with version number d
ystonia. Numbers vary so greatly from project to project, they are practically m
eaningless. | |
| 26 | |
| 27 Requests uses `Semantic Versioning <http://semver.org>`_. This specification see
ks to put an end to this madness with a small set of practical guidelines for yo
u and your colleagues to use in your next project. | |
| 28 | |
| 29 Standard Library? | |
| 30 ~~~~~~~~~~~~~~~~~ | |
| 31 | |
| 32 Requests has no *active* plans to be included in the standard library. This deci
sion has been discussed at length with Guido as well as numerous core developers
. | |
| 33 | |
| 34 Essentially, the standard library is where a library goes to die. It is appropri
ate for a module to be included when active development is no longer necessary. | |
| 35 | |
| 36 Linux Distro Packages | |
| 37 ~~~~~~~~~~~~~~~~~~~~~ | |
| 38 | |
| 39 Distributions have been made for many Linux repositories, including: Ubuntu, Deb
ian, RHEL, and Arch. | |
| 40 | |
| 41 These distributions are sometimes divergent forks, or are otherwise not kept up-
to-date with the latest code and bugfixes. PyPI (and its mirrors) and GitHub are
the official distribution sources; alternatives are not supported by the Reques
ts project. | |
| OLD | NEW |