Polish translation of Requests' documentation.
Python Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
ext
requests
.gitignore
.travis.yml
AUTHORS.rst
HISTORY.rst
LICENSE
MANIFEST.in
NOTICE
README.rst
invokefile.py
requirements.txt
setup.py
tasks.py
test_requests.py

README.rst

Requests: HTTP dla ludzi

https://travis-ci.org/kennethreitz/requests.png?branch=master

Requests jest biblioteką HTTP na licencji Apache2, w języku Python, dla istot ludzkich.

Większość istniejących modułów Pythona używanych do wysyłania żądań HTTP jest niezwykle rozwlekła i niewygodna. Wbudowany w Pythona moduł urllib2 oferuje większość potrzebnych możliwości HTTP, ale API jest całkowicie zepsute. Wymaga olbrzymiej ilości pracy (nawet nadpisywania metod) żeby wykonać najprostsze zadania.

Tak nie powinno to wyglądać. Nie w Pythonie.

>>> r = requests.get('https://api.github.com', auth=('user', 'pass'))
>>> r.status_code
204
>>> r.headers['content-type']
'application/json'
>>> r.text
...

Zobacz ten sam kod, bez Requests.

Requests pozwala na wysyłanie żądań HTTP/1.1. Możesz dodawać nagłówki, dane formularzy, pliki multipart i parametry z prostymi słownikami Pythona (typ dict), a dostęp do odpowiedzi jest równie prosty. Requests jest napędzane przez httplib i urllib3, ale wykonuje całą ciężką pracę i robi zwariowane hacki za ciebie.

Funkcje

  • Międzynarodowe domeny i URL-e
  • Keep-Alive i Connection Pooling
  • Sesje z zachowywaniem Cookies (ciasteczek)
  • Weryfikacja SSL w stylu przeglądarek
  • Basic/Digest Authentication
  • Eleganckie Cookies (klucz/wartość)
  • Automatyczna dekompresja
  • Odpowiedzi Unicode
  • Przesyłanie plików multipart
  • Timeout połączeń
  • Wątkowo-bezpieczny

Instalacja

Aby zainstalować requests, wystarczy:

$ pip install requests

Albo, jeśli musisz:

$ easy_install requests

Ale naprawdę nie powinieneś tego robić.

Wnieś swój wkład!

  1. Sprawdź listę otwartych problemów albo otwórz nowy aby rozpocząć dyskusję nad nową funkcją albo błędem. Istnieje tag Contributor Friendly dla problemów które powinny być idealne dla ludzi, którzy nie są jeszcze zbyt obeznani z kodem.
  2. Zforkuj repozytorium na GitHubie aby zacząć dokonywać zmian na gałęzi master (albo na gałęzi stworzonej z niej).
  3. Napisz test, który pokazuje, że bug został naprawiony albo że funkcja działa jak oczekiwano.
  4. Wyślij pull request i wkurzaj opiekuna, aż nie zostanie włączony do oficjalnego repozytorium i opublikowany. :) Upewnij się, że dodałeś siebie do pliku AUTHORS.