{"title":"Stabilność API","version":"2.0","locale":"pl","docname":"misc/api-stability","url":"/pl/2.0/misc/api-stability/","canonical":"https://djangodocs.dev/pl/2.0/misc/api-stability/","summary":"Django gwarantuje stabliność i kompatybilność wsteczną API od wersji 1.0. W skrócie, to znaczy, że kod, który pisałeś w jakiejś wersji Django będzie wciąż działał z…","html":"<h1>Stabilność API<a class=\"heading-anchor\" href=\"#api-stability\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Django gwarantuje stabliność i kompatybilność wsteczną API od wersji 1.0. W skrócie, to znaczy, że kod, który pisałeś w jakiejś wersji Django będzie wciąż działał z przyszłymi wydaniami. Możesz musieć wprowadzić małe zmiany podczas upgrade’owania wersji Django, z której korzysta twój projekt: zobacz sekcje „Zmiany niekompatybilne wstecz” <a class=\"reference internal\" href=\"/pl/2.0/releases/\"><span class=\"doc\">notatek o wydaniach</span></a> dla wersji z której lub wersji z których się upgrade’ujesz.</p>\n<section id=\"what-stable-means\">\n<h2>Co oznacza „stabilny” (ang. stable)<a class=\"heading-anchor\" href=\"#what-stable-means\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>W tym kontekście, stabilny oznacza:</p>\n<ul>\n<li><p>Wszystkie publiczne API (wszystkie są w tej dokumentacji) nie będą przeniesione ani nie zostaną zmienione ich nazwy bez dodanych wstecznie kompatybilnych aliasów.</p></li>\n<li><p>Jeśli do tych API zostaną dodane nowe elementy – co jest całkiem możliwe – nie złamią ani nie zmienią znaczenia istniejących metod. Innymi słowy „stabline” nie (koniecznie) zawsze znaczy „kompletne”.</p></li>\n<li><p>Jeśli z jakiegoś powodu API określane jako stabilne musi zostać usunięte lub zmienione, zostanie oznaczone jako dezaprobowane, ale pozostanie w API w co najmniej dwóch kolejnych wydaniach. Przy wywołaniu dezaprobowanej metody wyświetlą się ostrzeżenia.</p>\n<p>Zobacz <a class=\"reference internal\" href=\"/pl/2.0/internals/release-process/#official-releases\"><span class=\"std std-ref\">Oficjalne wydania</span></a> aby poznać więcej szczegółów o tym jak działa schemat numerowania wersji Django i kiedy funkcjonalności będą dezaprobowane.</p>\n</li>\n<li><p>Porzucimy kompatybilność wsteczną tego API tylko jeśli wystąpi błąd lub stworzy to nieuniknioną dziurę w bezpieczeństwie</p></li>\n</ul>\n</section>\n<section id=\"stable-apis\">\n<h2>Stabilne API<a class=\"heading-anchor\" href=\"#stable-apis\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>W ogólności, wszystko pokryte przez dokumentację – z wyjątkiem czegokolwiek w  <a class=\"reference internal\" href=\"/pl/2.0/internals/\"><span class=\"doc\">internals area</span></a> jest uważane za stabilne.</p>\n</section>\n<section id=\"exceptions\">\n<h2>Wyjątki<a class=\"heading-anchor\" href=\"#exceptions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Tutaj znajduje się kilka wyjątków co do stabilności i wstecznej zgodności.</p>\n<section id=\"security-fixes\">\n<h3>Poprawki bezpieczeństwa<a class=\"heading-anchor\" href=\"#security-fixes\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Jeśli zauważymy problem bezpieczeństwa - w najlepszym przypadku za sprawą kogoś śledzą <a class=\"reference internal\" href=\"/pl/2.0/internals/security/#reporting-security-issues\"><span class=\"std std-ref\">security reporting policy</span></a> – zrobimy wszystko co konieczne by to naprawić. To może znaczyć brak wstecznej kompatybilności; bezpieczeństwo jest ważniejsze od gwarancji kompatybilności.</p>\n</section>\n<section id=\"apis-marked-as-internal\">\n<h3>API oznaczone jako wewnętrzne<a class=\"heading-anchor\" href=\"#apis-marked-as-internal\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Niektóre API są wprost oznaczone jako „wewnętrzne” na kilka sposobów:</p>\n<ul class=\"simple\">\n<li><p>Czasem dokumentacja odnosi się do elementów i oznacza je jako wewnętrzne. Jeśli dokumentacja mówi, że coś jest wewnętrzne, rezerwujemy prawo do zmiany tego</p></li>\n<li><p>Funkcje, metody i inne obiekty poprzedzone prefiksem podkreślenia (<code class=\"docutils literal notranslate\"><span class=\"pre\">_</span></code>). Jest to standard Pythona mówiący, że coś jest prywatne; jeśli każda metoda zaczyna się pojedynczym podkreśleniem _, to jest to wewnętrzne API.</p></li>\n</ul>\n</section>\n</section>","rootId":"api-stability","toc":[{"title":"Co oznacza „stabilny” (ang. stable)","anchor":"what-stable-means","children":[]},{"title":"Stabilne API","anchor":"stable-apis","children":[]},{"title":"Wyjątki","anchor":"exceptions","children":[{"title":"Poprawki bezpieczeństwa","anchor":"security-fixes","children":[]},{"title":"API oznaczone jako wewnętrzne","anchor":"apis-marked-as-internal","children":[]}]}],"breadcrumbs":[{"docname":"misc/index","title":"Meta-dokumentacja i rozmaitości","url":"/pl/2.0/misc/"}],"prev":{"docname":"misc/index","title":"Meta-dokumentacja i rozmaitości","url":"/pl/2.0/misc/"},"next":{"docname":"misc/design-philosophies","title":"Filozofie projektowe","url":"/pl/2.0/misc/design-philosophies/"},"formats":{"html":"/pl/2.0/misc/api-stability/","markdown":"/pl/2.0/misc/api-stability.md","json":"/pl/2.0/misc/api-stability.json"},"source":"https://github.com/django/django/blob/stable/2.0.x/docs/misc/api-stability.txt","official":"https://docs.djangoproject.com/pl/2.0/misc/api-stability/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}