Wyjaśnienie Git Bisect: Znajdź zatwierdzenie, które zepsuło Twój kod, ręcznie lub automatycznie

  1. Strona główna
  2. Blog
  3. DevOps

DevOps

Wyjaśnienie Git Bisect: Znajdź zatwierdzenie, które zepsuło Twój kod, ręcznie lub automatycznie

Git bisect znajduje zatwierdzenie, które wprowadziło błąd, poprzez wyszukiwanie binarne: zaznaczasz jedno dobre zatwierdzenie i jedno złe zatwierdzenie, a Git zmniejsza o połowę zakres, aż pozostanie jedno zatwierdzenie. Dzięki git bisect run i skryptowi testowemu dzieje się to automatycznie. W naszym teście wykryto 1 złe zatwierdzenie spośród 41 w zaledwie 5 seriach.

9 min czytania
Git bisect wyjaśnił: znajdź złe zatwierdzenie

Najważniejsze

  • Git bisect używa wyszukiwania binarnego: około testów log₂(N) znajduje złe zatwierdzenie wśród N zatwierdzeń.
  • Nasz bieg znalazł błąd wśród 41 zatwierdzeń w 5 przebiegach testowych, mniej więcej tyle, ile przewiduje log₂(41) ≈ 5.4.
  • git bisect run <script> automatyzuje wszystko: wyjście 0 oznacza dobrze, 1 do 127 (z wyjątkiem 125) oznacza źle.
  • Kod zakończenia 125 pomija zatwierdzenia, których nie można przetestować; zawsze kończ z git bisect reset.

„Zadziałało w zeszłym miesiącu.” Gdzieś wśród setek zatwierdzeń od tego czasu coś zepsuło obliczenia, spowolniło stronę lub nie przeszło testu. Czytanie każdej różnicy zajęłoby wiele godzin. Git bisect zamienia to w krótkie, mechaniczne wyszukiwanie, które w przypadku skryptu testowego nie wymaga w ogóle obecności człowieka. Zbudowaliśmy repozytorium z ukrytym błędem i uruchomiliśmy każde poniższe polecenie w Git 2.56, używając tożsamości demonstracyjnej.

Co robi git bisect?

Podajesz Gitowi dwa fakty: zatwierdzenie, w którym kod jest zły (zwykle bieżący) i starsze zatwierdzenie, w którym był dobry, na przykład ostatni tag wydania. Git sprawdza zatwierdzenie w połowie drogi między nimi i prosi o jego przetestowanie. Twoja odpowiedź usuwa połowę pozostałych zatwierdzeń. Git powtarza, aż pozostanie jedno zatwierdzenie: pierwsze złe zatwierdzenie, to, które wprowadziło zmianę.

Dlaczego to jest takie szybkie

Zatwierdza w zasięgu Potrzebne testy (około log₂ N)
40 6
1,000 10
10,000 14
100,000 17

Każdy test zmniejsza o połowę przestrzeń poszukiwań, więc liczba testów rośnie bardzo powoli. Nawet rok pracowitej historii wymaga zaledwie kilkunastu kontroli, podczas gdy sprawdzenie każdego zatwierdzenia w kolejności może zająć tysiące.

Nasze repozytorium testowe

Stworzyliśmy mały moduł cenowy ze skryptem kontrolnym, oznaczyliśmy go v1.0, a następnie dodaliśmy 40 kolejnych zatwierdzeń. Większość dotknęła tylko pliku notatek, ale jeden, oznaczony jako „Pomocnicy cen refaktoryzacji”, po cichu zmienił formułę:

# price.py at v1.0
def total(price, qty):
    return price * qty

# check.py: exit 0 if correct, 1 if broken
import sys
from price import total
sys.exit(0 if total(100, 3) == 300 else 1)
commits: 41
HEAD check exit: 1

Sprawdzenie ostatniego zatwierdzenia kończy się niepowodzeniem. Wiemy, że v1.0 było w porządku. Pytanie brzmi, który z 40 zatwierdzeń pomiędzy nimi go złamał, a niewinnie wyglądający komunikat zatwierdzenia nie pomoże nikomu w czytaniu dziennika.

Ręczne przecięcie na pół, krok po kroku

git bisect start
git bisect bad              # current commit is broken
git bisect good v1.0        # this tag was fine

Git może również umieścić oba w jednej linii, git bisect start HEAD v1.0, co spowoduje wydrukowanie:

[4d7c735...] Docs update 21

Git sprawdził środkowe zatwierdzenie. Teraz możesz to przetestować, uruchamiając aplikację, wykonując test niepomyślny lub python check.py i zgłaszając wynik za pomocą git bisect good lub git bisect bad. Git za każdym razem przeskakuje do środka pozostałego zakresu, informując, ile kroków pozostało. Po ostatniej odpowiedzi wypisuje pierwsze błędne zatwierdzenie ze swoim komunikatem i zmienionymi plikami. Cała sesja to pętla „testuj, a następnie powiedz dobrze lub źle”.

Wskazówka: zaznacz dobre zatwierdzenie tak blisko błędu, jak tylko możesz. Tag wydania z zeszłego tygodnia przewyższa pierwsze zatwierdzenie projektu i oznacza mniej kroków.

Automatyzacja tego za pomocą git bisect run

Jeśli polecenie potrafi odróżnić dobro od zła, Git może przeprowadzić całe wyszukiwanie za Ciebie:

git bisect start HEAD v1.0
git bisect run python check.py
Bisecting: 9 revisions left to test after this (roughly 3 steps)
Bisecting: 4 revisions left to test after this (roughly 2 steps)
Bisecting: 2 revisions left to test after this (roughly 1 step)
Bisecting: 0 revisions left to test after this (roughly 0 steps)
commit 127582b...
    Refactor pricing helpers
 price.py | 2 +-
bisect found first 'bad' commit

Git uruchomił skrypt w sumie 5 razy i jako winowajcę wskazał „Pomocników cenowych refaktoryzacji” wraz ze zmienionym plikiem. Żadne ludzkie decyzje nie były potrzebne. Działa każde polecenie: pojedynczy test pytest (git bisect run pytest tests/test_price.py -q), skrypt npm, skrypt powłoki, który buduje i sprawdza dane wyjściowe, lub sprawdzanie czasu pod kątem regresji wydajności.

Jak odczytywane są kody wyjścia

Kod wyjścia Git traktuje zatwierdzenie jako
0 Dobrze
1 do 127, z wyjątkiem 125 Złe
125 Nie można przetestować: pomiń to
Powyżej 127 (na przykład sygnał awarii) Przestań dzielić na pół

Dlatego skrypt musi sygnalizować swój wynik poprzez kod wyjścia, a nie drukowany tekst. Skrypt, który wypisuje „FAIL”, ale kończy 0, oznaczy każde zatwierdzenie jako dobre i wyśle ​​cię po złym.

Pomijanie zatwierdzeń, których nie można przetestować

Niektóre zatwierdzenia nie są kompilowane lub są w połowie refaktora. Oznacz je ręcznie za pomocą git bisect skip lub wyjdź ze skryptu za pomocą 125. Sprawiliśmy, że nasz skrypt celowo pominął pięć zatwierdzeń:

# check2.sh
git log -1 --format=%s | grep -q "Docs update 2[0-4]" && exit 125
python check.py

Git nadal znalazł to samo złe zatwierdzenie, tym razem po 7 uruchomieniach zamiast 5, ponieważ pominięte zatwierdzenia nie dają żadnych informacji. Jeśli pominiętych zostanie zbyt wiele zatwierdzeń w pobliżu granicy, Git zgłosi listę możliwych sprawców zamiast jednego, więc ogranicz pominięcia do minimum.

Warunki niestandardowe: stare i nowe

„Dobre” i „złe” czują się źle, gdy szukasz zatwierdzenia, które naprawiło coś lub zmieniło zachowanie, które nie jest ani dobre, ani złe. Wybierz własne słowa:

git bisect start --term-old=working --term-new=broken
git bisect broken HEAD
git bisect working v1.0
git bisect terms
Your current terms are 'working' for the old state
and 'broken' for the new state.

Istnieje również wbudowana para old i new, która jest przydatna do ustalenia, kiedy pojawiła się poprawka: oznacz stare zachowanie jako „stare”, a ustalone zachowanie jako „nowe”.

Rejestruj, odtwarzaj i resetuj

git bisect log      # every decision so far
git bisect replay file.log
git bisect reset    # return to the branch you started on

Dziennik to skrypt Twoich odpowiedzi; nasz wymienił każdy krok git bisect good i git bisect bad. Jeśli wykonasz błędne połączenie, zapisz dziennik, edytuj błędną linię i odtwórz ją ponownie, zamiast zaczynać od nowa. git bisect reset jest niezbędny: dopóki go nie uruchomisz, twoje repozytorium znajduje się w odłączonym zatwierdzeniu w środku historii.

Napisanie dobrego testu bisect

  • Przetestuj jedną rzecz. Uruchom pojedynczy test zakończony niepowodzeniem, a nie cały zestaw, aby inne stare awarie nie zmyliły wyniku.
  • Trzymaj skrypt poza repozytorium lub nieśledzony, aby sprawdzenie starych zatwierdzeń nie spowodowało jego zmiany ani usunięcia.
  • Uczyń to deterministycznym. Niestabilna kontrola daje losowe odpowiedzi i błędny wynik; zobacz nasz przewodnik po testach niestabilnych.
  • Obsługuj błędy kompilacji za pomocą wyjścia 125, zamiast pozwalać, aby liczyły się jako złe.
  • Ustaw limit czasu dla kontroli wydajności, tak aby zawieszone zatwierdzenie kończyło się ze złym kodem, zamiast wstrzymywać wyszukiwanie.

Po znalezieniu złego zatwierdzenia

Przeczytaj różnicę za pomocą git show <commit>, aby zobaczyć dokładnie, co się zmieniło. Następnie wybierz poprawkę: napisz poprawne zatwierdzenie uzupełniające lub cofnij zmianę za pomocą git revert <commit>, co jest bezpieczne w gałęziach współdzielonych; zobacz nasz przewodnik dotyczący resetowania i przywracania git . Jeśli poprawka jest potrzebna także w gałęzi wydania, skopiuj ją tam za pomocą git cherry-pick. Na koniec dodaj test, który podzieliłeś na pół, jako test stały, aby ten sam błąd nie mógł powrócić po cichu; czyli testowanie regresyjne w działaniu, zgodnie z naszym przewodnikiem dotyczącym ponownego testowania a testowaniem regresyjnym.

Typowe błędy

  • Zapominanie o git bisect reset i zatwierdzenie na odłączonej HEAD.
  • Dobre zatwierdzenie, które w rzeczywistości było złe, co powoduje skierowanie wyszukiwania do niewłaściwej połowy.
  • Niezatwierdzone zmiany blokujące realizację transakcji. Najpierw zatwierdź je lub ukryj je.
  • Skrypty, które drukują zamiast kończyć działanie z właściwym kodem.
  • Zmiażdżona historia. Bisect jest tak precyzyjny, jak twoje zatwierdzenia; jedna wielka dynia daje jednego wielkiego podejrzanego. Nasz przewodnik po git squash wyjaśnia kompromis.

Ściągawka Git Bisect

Cel Polecenie
Zacznij od zła i dobra git bisect start ZŁY DOBRY
Zaznacz bieżące zatwierdzenie git bisect good / git bisect bad
Pomiń bieżące zatwierdzenie git przeskocz na pół
Automatyzuj git bisect run ./check.sh
Niestandardowe słowa git bisect start --term-old=X --term-new=Y
Zobacz decyzje git bisect log
Wykonaj ponownie z dziennika git plik powtórki bisect
Zakończ git bisect reset

Podsumowanie

Git bisect to jedno z poleceń Git o największej wartości i jedno z najrzadziej używanych. Znajdź dobre i złe zatwierdzenie, napisz mały skrypt, który zakończy 0 lub 1 i pozwól git bisect run zrobić resztę. W naszym teście przeszukał 41 zatwierdzeń w 5 seriach i nazwał winne zatwierdzenie oraz plik, mimo że jego komunikat nie zawierał żadnej wskazówki. Utrzymuj małe zobowiązania i niezawodne testy, a każda regresja staje się pięciominutowym badaniem. Do końca trzymaj naszą ściągawkę dotyczącą poleceń Git w pobliżu.

Najczęstsze pytania

Co robi git bisect?

Znajduje zatwierdzenie, które wprowadziło zmianę, poprzez wyszukiwanie binarne. Zaznaczasz dobre i złe zatwierdzenie, a Git wielokrotnie sprawdza środkowe zatwierdzenie, aż pozostanie jedno zatwierdzenie.

Jak zautomatyzować git bisect?

Uruchom git bisect start BAD GOOD, następnie git bisect run z poleceniem, które kończy się 0 dla dobrych zatwierdzeń i 1 dla złych. Git testuje każdy krok i zgłasza pierwsze złe zatwierdzenie.

Ile kroków wykonuje git bisect?

Informacje o log2 liczby zatwierdzeń. Nasz zakres 41 zatwierdzeń wymagał 5 przebiegów testowych, a 1000 zatwierdzeń zajęłoby około 10.

Jak pominąć zatwierdzenie w git bisect?

Uruchom git bisect skip na tym zatwierdzeniu lub zakończ, wpisując kod 125 ze skryptu git bisect run. Pominięte zatwierdzenia nie są używane do zawężania wyszukiwania.

Jak zatrzymać lub cofnąć sesję git bisect?

Uruchom git bisect reset. Kończy sesję i wraca do gałęzi i zatwierdza, w której byłeś przed rozpoczęciem.

Ucz się dalej

Pracuj z Stack Quora

Potrzebujesz pomocy przy testowaniu, WordPressie lub SEO?

Pomagamy zespołom dostarczać lepsze oprogramowanie i rozwijać ich witryny. Powiedz nam, nad czym pracujesz, a my zaproponujemy jasny następny krok.

Czytaj dalej

Więcej poradników na testowanie, sztuczna inteligencja i nowoczesny rozwój

Podobał Ci się ten artykuł? Wybierz temat i przejdź bezpośrednio do naszych najnowszych tutoriali.

Sztuczna inteligencja

Wyjaśnienie BM25: Jak wyszukiwanie słów kluczowych klasyfikuje wyniki za pomocą kodu Pythona i wyszukiwania hybrydowego

BM25 wyjaśnił za pomocą czystej implementacji Pythona, którą uruchomiliśmy: formułę, IDF, nasycenie terminów, parametry k1 i b, dlaczego przewyższa …

Przeczytaj artykuł →
Tworzenie oprogramowania

Objaśnienie metod HTTP: GET, POST, PUT, PATCH, DELETE, przetestowane na serwerze na żywo

Metody HTTP wyjaśnione na małym serwerze, który uruchomiliśmy: GET, POST, PUT, PATCH, DELETE, HEAD i OPTIONS, bezpieczne vs idempotentne, PUT vs PAT…

Przeczytaj artykuł →
DevOps

Wyjaśnienie Git Bisect: Znajdź zatwierdzenie, które zepsuło Twój kod, ręcznie lub automatycznie

Git bisect wyjaśniony w testowanym repozytorium: znajdź jedno złe zatwierdzenie spośród 41 na 5 przebiegów testowych, zautomatyzuj je za pomocą git …

Przeczytaj artykuł →
Automatyzacja testów

Objaśnienie znaczników pytest: znaczniki niestandardowe, filtry pomijania, pomijania, xfail i -m

znaczniki pytest wyjaśnione w testowanym zestawie: zarejestruj niestandardowe znaki, uruchamiaj tylko testy dymu za pomocą -m, łącz filtry za pomocą…

Przeczytaj artykuł →
Testowanie oprogramowania

Testowanie pozytywne i negatywne: różnice, 24 rzeczywiste przypadki testowe i lista kontrolna

Testowanie pozytywne i negatywne wyjaśniono w prawdziwym formularzu rejestracyjnym: 6 pozytywnych i 18 negatywnych przypadków testowych uruchomionyc…

Przeczytaj artykuł →
Bazy danych i SQL

ZAMÓWIENIE SQL PRZEZ wiele kolumn: ASC, DESC, NULLS LAST, wielkość liter i kolejność niestandardowa

SQL ORDER BY z wieloma kolumnami objaśnionymi za pomocą przetestowanych zapytań: mieszane ASC i DESC, elementy rozstrzygające, NULLS FIRST i LAST, s…

Przeczytaj artykuł →
Bazy danych i SQL

Suma bieżąca SQL: SUMA, sumy na grupę, sumy ruchome i pułapka ZAKRES

Jak obliczyć sumę bieżącą SQL za pomocą funkcji SUM() OVER: sumy na grupę, sumy dzienne, sumy ruchome, procent sumy, pułapka remisowa RANGE vs ROWS,…

Przeczytaj artykuł →
Tworzenie oprogramowania

Tablica sortowania JavaScript: liczby, obiekty, ciągi znaków i dlaczego 10 jest przed 5

Jak poprawnie posortować tablicę w JavaScript: liczby za pomocą funkcji porównania, obiekty według jednego lub więcej pól, ciągi znaków za pomocą us…

Przeczytaj artykuł →
Sztuczna inteligencja

Wyjaśnienie strategii fragmentowania RAG: stałe, nakładanie się, zdanie, rekurencyjne i nagłówki, mierzone

Strategie fragmentowania RAG porównane w jednym dokumencie z tiktokenem 0.14: stały rozmiar, nakładanie się, pakowanie zdań, dzielenie rekurencyjne …

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie tożsamości API: klucze idempotencji i bezpieczne ponowne próby, przetestowane

Wyjaśnienie idempotencji API na serwerze Python i kliencie, którego uruchomiliśmy: utracona odpowiedź spowodowała podwójną opłatę bez klucza i jedną…

Przeczytaj artykuł →
DevOps

Wyjaśnienie Git Stash: zapisywanie, stosowanie, otwieranie i nieśledzone pliki, testowane

Git stash wyjaśniono za pomocą poleceń, które uruchomiliśmy w Git 2.56: push z wiadomością, nieśledzone pliki, lista i pokaż, zastosuj vs pop, zacho…

Przeczytaj artykuł →
Testowanie oprogramowania

Wyjaśnienie testowania parami: jak użycie wszystkich par zmniejsza 216 testów do 13, przetestowano

Testowanie w parach wyjaśnione za pomocą generatora uruchomionego w Pythonie 3.13: sprawdzenie z 216 kombinacjami objętymi 13 testami, zweryfikowany…

Przeczytaj artykuł →
Automatyzacja testów

Wyjaśnienie testowania dubletów: atrapa, skrót, szpieg, próbna i fałszywa, z przetestowanym kodem Pythona

Testowanie dubletów wyjaśniono na jednym przykładzie Pythona uruchomionym w pytest 9.2: manekin, stub, szpieg, próbny i fałszywy, kiedy używać każde…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie SQL COALESCE: wartości domyślne, NULLIF, IFNULL vs ISNULL i pułapki, przetestowane

Wyjaśnienie SQL COALESCE za pomocą zapytań, które uruchomiliśmy w SQLite 3.50: pierwsze wartości inne niż null, puste ciągi znaków, NULL w matematyc…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie samodzielnego łączenia SQL: menedżer pracowników, porównania par i wierszy, przetestowane

Samodzielne łączenie SQL wyjaśnione za pomocą zapytań, które uruchomiliśmy w SQLite 3.50: pracownik i menedżer, zarabiający więcej niż menedżer, uni…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie operatora rozprzestrzeniania JavaScript: rozprzestrzenianie a reszta, kopie i błędy, przetestowane

Operator rozprzestrzeniania JavaScript wyjaśniony kodem, który uruchomiliśmy w węźle 24: tablice, obiekty, płytkie kopie, parametry spoczynkowe, lim…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie modułu kolekcji Pythona: licznik, defaultdict, deque i więcej, przetestowane

Kolekcje Pythona wyjaśnione za pomocą kodu, który uruchomiliśmy w Pythonie 3.13: Counter, defaultdict, deque, Nametuple, OrderedDict i ChainMap, a t…

Przeczytaj artykuł →
Sztuczna inteligencja

Wyjaśnienie okna kontekstowego LLM: tokeny, limity i sposób dopasowania większej ilości, zmierzone

Okno kontekstowe LLM wyjaśnione za pomocą liczby tokenów, które zmierzyliśmy za pomocą tiktokena: słowa kontra tokeny dla prozy, kodu i języka hindi…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie webhooków: jak działają i jak je bezpiecznie odbierać

Wyjaśnienie webhooków z odbiorcą i nadawcą, które uruchomiliśmy w Pythonie: push a odpytywanie, podpisy HMAC-SHA256, odrzucanie zmodyfikowanych i od…

Przeczytaj artykuł →
DevOps

Wyjaśnienie Git Cherry-Pick: Skopiuj potrzebne zatwierdzenie, bezpiecznie i przetestowane

Git cherry-pick wyjaśniono za pomocą poleceń, które uruchomiliśmy w Git 2.56: kopiowanie poprawki do gałęzi wydania, nowe skróty i identyfikatory po…

Przeczytaj artykuł →
Automatyzacja testów

Wyjaśnienie testów migawkowych: jak to działa, kiedy pomaga, a kiedy szkodzi

Testowanie migawek wyjaśnione za pomocą pytestu i syropowego demo, które przeprowadziliśmy: tworzenie migawek, odczytywanie różnic po zmianie kodu, …

Przeczytaj artykuł →
Testowanie oprogramowania

Wyjaśnienie testów mutacji: dlaczego 100% pokrycie nadal nie uwzględnia naszego błędu

Testowanie mutacji wyjaśniono za pomocą małego narzędzia mutacji, które zbudowaliśmy i uruchomiliśmy: 14 mutantów, zestaw testów ze 100% pokryciem l…

Przeczytaj artykuł →
Sztuczna inteligencja

Wyjaśnienie szybkiego wstrzyknięcia: jak oszukać aplikacje AI i jak się przed nimi bronić

Wyjaśnienie szybkiego wstrzykiwania dla konstruktorów: ataki bezpośrednie i pośrednie, dlaczego zawodzą filtry słów kluczowych (nasz test zablokował…

Przeczytaj artykuł →
DevOps

Wyjaśnienie rekordów DNS: A, AAAA, CNAME, MX, TXT i TTL z rzeczywistymi wyszukiwaniami

Rekordy DNS wyjaśnione na podstawie wyszukiwań, które przeprowadziliśmy: jak działa rozdzielczość, A i AAAA, reguły CNAME, MX i null MX, TXT dla SPF…

Przeczytaj artykuł →
DevOps

Wyjaśnienie flag funkcji: bezpieczne wydania, stopniowe wdrażanie i higiena flag

Flagi funkcji wyjaśnione za pomocą przeprowadzonej przez nas symulacji wdrożenia: typy flag, procentowe wdrożenia ze stabilnym mieszaniem, przełączn…

Przeczytaj artykuł →
Automatyzacja testów

Testuj generowanie danych za pomocą Python Faker: realistyczne, powtarzalne i bezpieczne dane

Przetestuj generowanie danych za pomocą Python Faker, uruchom i zmierz: zaszczepianie powtarzalnych danych, ustawień regionalnych, unikalnych wartoś…

Przeczytaj artykuł →
Testowanie oprogramowania

Wyjaśnienie testowania z Shift-Left: Znajdź błędy wcześniej, bez spowalniania zespołu

Wyjaśniono testowanie z przesunięciem w lewo: co to znaczy, dlaczego wczesne defekty są tańsze, praktyki – od przeglądów wymagań po kontrole CI, zmi…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie funkcji ciągów SQL: TRIM, SUBSTR, REPLACE, CONCAT i czyszczenie danych

Funkcje ciągów SQL wyjaśnione za pomocą zapytań, które wykonaliśmy: konkatenacja i NULL, TRIM, UPPER i LOWER, SUBSTR i INSTR, REPLACE, dopełnienie, …

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie wyzwalaczy SQL: wyzwalacze PRZED i PO, dzienniki audytu i pułapki

Wyzwalacze SQL wyjaśnione za pomocą wyzwalaczy, które uruchomiliśmy: PRZED vs PO, STARY i NOWY, dzienniki audytu, walidacja, aktualizacje zapasów, w…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie modułu Python JSON: zrzuty, ładowanie, typy niestandardowe i typowe błędy

Moduł Python JSON wyjaśniony za pomocą uruchomionego przez nas kodu: zrzuty i ładowanie, pliki, konwersje typów, daty i miejsca dziesiętne, niestand…

Przeczytaj artykuł →
Tworzenie oprogramowania

Moduły ES a CommonJS: Jak działa import JavaScript w Node.js, przetestowano

Moduły ES i CommonJS wyjaśnione za pomocą kodu, który uruchomiliśmy w Node.js: składnia importu i eksportu, wymagania, powiązania na żywo, buforowan…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie wyrażenia regularnego w języku Python: wzorce, grupy, przewidywania i pułapki, przetestowane

Wyrażenie regularne w Pythonie wyjaśnione za pomocą wzorców, które uruchomiliśmy: wyszukiwanie vs dopasowanie, findall, grupy i nazwane grupy, zachł…

Przeczytaj artykuł →
Sztuczna inteligencja

Wyjaśnienie strukturalnych wyników LLM: uzyskiwanie niezawodnego formatu JSON z modeli AI

Ustrukturyzowane dane wyjściowe LLM wyjaśnione wraz z walidacją przeprowadzoną w Pydantic: tryb i schematy JSON, ograniczone dekodowanie, sposoby ps…

Przeczytaj artykuł →
DevOps

Wyjaśnienie kluczy SSH: jak działają, ssh-keygen, Ed25519 i bezpieczne nawyki

Klucze SSH wyjaśnione za pomocą wygenerowanych przez nas kluczy: klucze publiczne i prywatne, ssh-keygen, Ed25519 vs RSA, odciski palców, hasła, ssh…

Przeczytaj artykuł →
DevOps

Wyjaśnienie buforowania HTTP: kontrola pamięci podręcznej, odpowiedzi ETag i 304 z testem na żywo

Wyjaśnienie buforowania HTTP na małym serwerze, który prowadziliśmy: dyrektywy Cache-Control, maksymalny wiek, brak pamięci podręcznej vs brak sklep…

Przeczytaj artykuł →
Automatyzacja testów

Wyjaśnienie testowania kontraktu API: wychwytuj istotne zmiany przed wysyłką

Testowanie kontraktu API wyjaśniono za pomocą przeprowadzonej przez nas kontroli schematu: czym jest kontrakt, kontrakty zorientowane na konsumenta,…

Przeczytaj artykuł →
Testowanie oprogramowania

Wyjaśnienie testowania opartego na ryzyku: oceń ryzyko, zbuduj macierz i przetestuj, co jest ważne

Testowanie oparte na ryzyku wyjaśnione krok po kroku: identyfikacja ryzyka, prawdopodobieństwo punktacji i wpływ, budowanie matrycy ryzyka, mapowani…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie ograniczeń SQL: NOT NULL, UNIQUE, CHECK i OBCY KLUCZ, przetestowane

Ograniczenia SQL wyjaśnione za pomocą przeprowadzonych przez nas testów: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY i FOREIGN KEY, luki NULL, ustawie…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie funkcji daty SQL: dodawanie, porównywanie i grupowanie dat bez błędów

Funkcje daty SQL wyjaśnione za pomocą zapytań, które wykonaliśmy: dodawanie interwałów, niespodzianki na koniec miesiąca, różnice dat, pułapka BETWE…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie asyncio Pythona: asynchronizacja, oczekiwanie, zbieranie i grupa zadań z rzeczywistym czasem

Asyncio Pythona wyjaśnione za pomocą kodu, który zmierzyliśmy: współprogramy, oczekiwanie, zbieranie, grupa zadań, obsługa błędów, przekroczenia lim…

Przeczytaj artykuł →
Tworzenie oprogramowania

Odbicie a przepustnica w JavaScript: jak działają, kiedy używać każdego z nich, przetestowano

Debounce a przepustnica w JavaScript wyjaśnione z czasami, które zmierzyliśmy w Node.js: jak każdy z nich działa, proste implementacje, wywołania wi…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie menedżerów kontekstu Pythona: instrukcja with, biblioteka kontekstowa i rzeczywiste zastosowania

Menedżerowie kontekstu Pythona wyjaśnili za pomocą uruchomionego przez nas kodu: jak działa, __enter__ i __exit__, kontekstlib.contextmanager, tłumi…

Przeczytaj artykuł →
Sztuczna inteligencja

Wyjaśnienie temperatury i góry LLM: jak modele AI wybierają kolejne słowo

Temperatura LLM i top-p wyjaśnione za pomocą przeprowadzonej przez nas symulacji: w jaki sposób zmieniają się prawdopodobieństwa, co utrzymuje top-p…

Przeczytaj artykuł →
DevOps

Wyjaśnienie YAML: składnia, problem norweski i inne pułapki, które testowaliśmy

YAML wyjaśnił za pomocą testu parsera: podstawowa składnia, listy i mapy, problem Norwegii, wersje zamieniające się w zmiennoprzecinkowe, ósemkowe k…

Przeczytaj artykuł →
DevOps

Wyjaśnienie zadań Cron: składnia, prawdziwe harmonogramy i błędy, które je psują

Zadania Cron wyjaśnione za pomocą zweryfikowanych przez nas harmonogramów: pięć pól, operatory, prawdziwe przykłady, pułapka dnia miesiąca LUB dnia …

Przeczytaj artykuł →
Sztuczna inteligencja

Wyjaśnienie halucynacji AI: dlaczego modele językowe tworzą rzeczy i jak je zmniejszyć

Wyjaśniono halucynacje AI: czym są, dlaczego powstają w modelach językowych, typowe typy, jak je zredukować za pomocą uziemień i podpowiedzi oraz pr…

Przeczytaj artykuł →
DevOps

Wyjaśnienie zmiennych środowiskowych: pliki .env, sekrety i konfiguracja wykonana prawidłowo

Zmienne środowiskowe wyjaśnione na przykładach Pythona, które przeprowadziliśmy: ich odczytywanie i ustawianie, dlaczego każda wartość jest ciągiem …

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie ograniczenia szybkości interfejsu API: algorytmy, nagłówki i obsługa błędów 429

Ograniczanie szybkości API wyjaśnione za pomocą przeprowadzonej przez nas symulacji: zasobnik tokenów, stałe okno, przesuwane okno, 429 odpowiedzi, …

Przeczytaj artykuł →
Automatyzacja testów

Wyśmiewanie w Pythonie: unittest.mock, patch i błędy, które sprawiają, że testy kłamią

Wyśmiewanie w Pythonie za pomocą unittest.mock, przetestowane: Mock i zwracana wartość, efekt uboczny, łatanie tam, gdzie używana jest nazwa, specyf…

Przeczytaj artykuł →
Testowanie oprogramowania

Wyjaśnienie zasięgu kodu: pokrycie linii i oddziału oraz co naprawdę oznacza 100%

Wyjaśnienie pokrycia kodu za pomocą prawdziwego pliku cover.py: pokrycie linii, gałęzi i warunków, przeczytanie raportu, dlaczego 100% pokrycia może…

Przeczytaj artykuł →
Bazy danych i SQL

DELETE vs TRUNCATE vs DROP w SQL: różnice, wycofywanie i kiedy używać każdego z nich

DELETE vs TRUNCATE vs DROP wyjaśnione za pomocą przetestowanego SQL: co każdy usuwa, wycofywanie, wyzwalacze, resetowanie tożsamości, prędkość i czy…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie widoków SQL: tworzenie, używanie i unikanie pułapek wraz z przykładami

Widoki SQL wyjaśnione za pomocą zapytań, które uruchomiliśmy: tworzenie widoku, wyniki na żywo, ukrywanie kolumn, wydajność, widoki z możliwością ak…

Przeczytaj artykuł →
Tworzenie oprogramowania

Interfejs TypeScript a typ: rzeczywiste różnice, testowane za pomocą kompilatora

Interfejs TypeScript a typ, sprawdzony z prawdziwym kompilatorem: co oba mogą zrobić, co tylko jeden, łączenie deklaracji, rozszerzenia a przecięcia…

Przeczytaj artykuł →
Tworzenie oprogramowania

Python *args i **kwargs wyjaśnione: elastyczne funkcje z przejrzystymi przykładami

Python *args i **kwargs wyjaśnione za pomocą uruchomionego przez nas kodu: pakowanie i rozpakowywanie, kolejność parametrów, argumenty zawierające t…

Przeczytaj artykuł →
Tworzenie oprogramowania

Funkcje Lambda w Pythonie: składnia, rzeczywiste zastosowania i kiedy ich nie używać

Funkcje lambda w Pythonie wyjaśnione za pomocą uruchomionego przez nas kodu: składnia, sortowanie za pomocą klucza, mapa i filtr, domknięcia, pułapk…

Przeczytaj artykuł →
Sztuczna inteligencja

Kim są agenci AI? Jak one działają, dzięki prostej pętli agenta, którą możesz uruchomić

Kim są agenci AI? Prosty przewodnik po pętli agenta, narzędziach, pamięci i poręczach, z małą pętlą w Pythonie, którą uruchomiliśmy, prawdziwymi zag…

Przeczytaj artykuł →
DevOps

Monitorowanie a obserwowalność: prawdziwa różnica z logami, wskaźnikami i śladami

Wyjaśnienie monitorowania a obserwowalności: znane i nieznane awarie, dzienniki, metryki i ślady, opis incydentu przy kasie, złote sygnały, OpenTele…

Przeczytaj artykuł →
DevOps

Woluminy platformy Docker a mocowania powiązań: utrwalanie danych kontenera we właściwy sposób

Wyjaśniono woluminy Dockera a montowanie powiązań: dlaczego dane kontenera znikają, nazwane woluminy, montowanie powiązań, tmpfs, przykłady tworzeni…

Przeczytaj artykuł →
Automatyzacja testów

TDD vs BDD: kluczowe różnice, jedna funkcja zbudowana w obie strony i kiedy używać każdej z nich

TDD vs BDD wyjaśnione za pomocą jednej funkcji rabatowej zbudowanej w obie strony: refaktoryzacja czerwono-zielona z uruchomionym przez nas kodem, s…

Przeczytaj artykuł →
Testowanie oprogramowania

Testowanie akceptacyjne użytkownika (UAT): proces, lista kontrolna i rzeczywiste przykłady

Wyjaśniono testy akceptacyjne użytkownika: kto je przeprowadza, czym różni się od kontroli jakości, siedmioetapowy proces, szablon przypadku testowe…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie wartości SQL NULL: IS NULL, COALESCE, NULLIF i pułapki, których należy unikać

Wartości SQL NULL wyjaśnione za pomocą zapytań, które wykonaliśmy: logika trójwartościowa, IS NULL, COALESCE, NULLIF, w jaki sposób agregacje, łącze…

Przeczytaj artykuł →
Bazy danych i SQL

Instrukcja SQL CASE WHEN: składnia, rzeczywiste przykłady i typowe błędy

SQL CASE WHEN wyjaśnione za pomocą zapytań, które uruchomiliśmy: proste i przeszukiwane formularze, kolejność warunków, elementy przestawne z SUM, s…

Przeczytaj artykuł →
Tworzenie oprogramowania

Co to jest JWT? Tokeny internetowe JSON wyjaśnione na przykładzie działania

Co to jest JWT? Wyjaśniono tokeny sieciowe JSON: trzy części, token zbudowany i zmodyfikowany w uruchomionym przez nas kodzie, JWT a sesje, pamięć m…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie pętli zdarzeń JavaScript: stos wywołań, mikrozadania i liczniki czasu z przykładami

Pętla zdarzeń JavaScript wyjaśniona za pomocą uruchomionego przez nas kodu: stos wywołań, kolejki zadań i mikrozadań, dlaczego setTimeout 0 nie jest…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie generatorów Pythona i wydajności: oszczędzaj pamięć dzięki prawdziwym przykładom

Generatory Pythona i wydajność wyjaśnione za pomocą uruchomionego przez nas kodu: sposób wstrzymywania i wznawiania, mierzone oszczędności pamięci, …

Przeczytaj artykuł →
Sztuczna inteligencja

Czym są osady? Wyjaśnienie wektorów i podobieństwa cosinusa

Czym są osadzania? Prosty przewodnik po wektorach, podobieństwie cosinusów i wyszukiwaniu semantycznym, z małym przykładem, który przeprowadziliśmy,…

Przeczytaj artykuł →
DevOps

Wdrożenie niebiesko-zielone a kanaryjskie: różnice, kompromisy i sposób wyboru

Wyjaśniono wdrożenie Blue-Green vs Canary: sposób działania każdego z nich, koszty, ryzyko i wycofywanie zmian, przetestowane przez nas stabilne łąc…

Przeczytaj artykuł →
Automatyzacja testów

Niestabilne testy: co je powoduje i jak je naprawić na dobre

Niestabilne testy wyjaśnione w przeprowadzonych przez nas demonstracjach: główne przyczyny, sposób potwierdzenia i zdiagnozowania jednej z nich, odp…

Przeczytaj artykuł →
Testowanie oprogramowania

Load Testing vs Stress Testing: Differences, Metrics and k6 Examples

Wyjaśniono testy obciążenia i testy warunków skrajnych: co dowodzi każdy z nich, testy szczytowe i nasiąkania, istotne metryki, dlaczego średnie wpr…

Przeczytaj artykuł →
Testowanie oprogramowania

Przypadek testowy a scenariusz testowy: kluczowe różnice, przykłady i kiedy stosować każdy z nich

Wyjaśnienie przypadków testowych i scenariuszy testowych: jasne definicje, tabela obok siebie, jedna funkcja resetowania hasła zaczerpnięta ze scena…

Przeczytaj artykuł →
Bazy danych i SQL

Optymalizacja zapytań SQL: czytaj plany wykonania i napraw powolne zapytania z synchronizacją

Optymalizacja zapytań SQL przetestowana na milionie wierszy: przeczytaj plany wykonania, dodaj odpowiednie indeksy, napraw filtry niesargowalne, uży…

Przeczytaj artykuł →
Bazy danych i SQL

SQL UNION vs UNION ALL: różnice, przykłady i testowana wydajność

SQL UNION vs UNION ALL wyjaśnione na podstawie zapytań, które uruchomiliśmy: duplikaty, obie reguły są zgodne, prawdziwy błąd danych, zmierzona wyda…

Przeczytaj artykuł →
Tworzenie oprogramowania

Samouczek API pobierania JavaScript: GET, POST, obsługa błędów i limity czasu

Samouczek JavaScript Fetch API testowany na serwerze lokalnym: GET i POST, dlaczego 404 nie rzuca, pomocnik wielokrotnego użytku, ciągi zapytań, prz…

Przeczytaj artykuł →
Tworzenie oprogramowania

Obsługa plików w Pythonie: odczyt, zapis, CSV, JSON i pathlib z przykładami

Obsługa plików w Pythonie wyjaśniona za pomocą uruchomionego przez nas kodu: tryby otwarte, czytanie dużych plików, CSV, JSON, pathlib, pliki binarn…

Przeczytaj artykuł →
Tworzenie oprogramowania

Klasy i obiekty Pythona: samouczek OOP z prawdziwymi przykładami

Klasy i obiekty Pythona objaśnione za pomocą uruchomionego przez nas kodu: __init__, metody, atrybuty klas i instancji, dziedziczenie, właściwości, …

Przeczytaj artykuł →
Sztuczna inteligencja

Co to jest model dużego języka? Jak działają LLM, wyjaśnione bez szumu

Co to jest model dużego języka? LLM wyjaśnione prostym językiem: tokeny, osadzanie, uwaga, szkolenie, temperatura i okna kontekstowe, mała demonstra…

Przeczytaj artykuł →
DevOps

Polecenia systemu Linux dla początkujących: niezbędny przewodnik po terminalu z przykładami

Polecenia systemu Linux dla początkujących, pogrupowane według zadań: nawigacja, pliki, przeglądanie logów, grep, potoki, uprawnienia, procesy i arc…

Przeczytaj artykuł →
Automatyzacja testów

Selenium kontra dramaturg: kluczowe różnice, porównanie kodu i wybór

Porównanie Selenium i Playwright: architektura, oczekiwanie, obsługa przeglądarki i języka, debugowanie, ten sam test w obu narzędziach, porady doty…

Przeczytaj artykuł →
Testowanie oprogramowania

Partycjonowanie równoważne: technika projektowania testów wyjaśniona na praktycznych przykładach

Wyjaśniono podział równoważny: jak znaleźć prawidłowe i nieprawidłowe partycje, sprawdzone przykłady dla grup wiekowych, hasła i kupony, przeprowadz…

Przeczytaj artykuł →
Testowanie oprogramowania

Ważność a priorytet w testowaniu oprogramowania: różnice, macierz i rzeczywiste przykłady

Wyjaśniono ważność a priorytet w testowaniu oprogramowania: jasne definicje, czterokierunkowa macierz z przykładami, skale poziomów, kto ustawia każ…

Przeczytaj artykuł →
Bazy danych i SQL

Samouczek dotyczący podzapytań SQL: typy, skorelowane podzapytania i ISTNIEJĄ z przykładami

Samouczek dotyczący podzapytań SQL z zapytaniami, które wykonaliśmy: podzapytania skalarne, IN, FROM i SELECT, podzapytania skorelowane, EXISTS, puł…

Przeczytaj artykuł →
Bazy danych i SQL

Wyjaśnienie transakcji SQL i ACID: COMMIT, ROLLBACK i poziomy izolacji

Transakcje SQL i ACID wyjaśnione za pomocą wykonanego przez nas przelewu bankowego: COMMIT, ROLLBACK, punkty zapisu, blokady, poziomy izolacji, brud…

Przeczytaj artykuł →
Tworzenie oprogramowania

Ściągawka dotycząca poleceń Git: polecenia, których faktycznie używasz, z przykładami

Ściągawka poleceń Git pogrupowana według zadań: konfiguracja, przemieszczanie, gałęzie, piloty, skrytka, historia i cofanie błędów, z danymi wyjścio…

Przeczytaj artykuł →
Tworzenie oprogramowania

Wyjaśnienie obietnic JavaScript: następnie catch, Promise.all i typowe błędy

Obietnice JavaScript wyjaśnione za pomocą uruchomionego przez nas kodu: stany, łańcuchy then i catch, obsługa błędów, Promise.all, allSettled, race …

Przeczytaj artykuł →
Tworzenie oprogramowania

Samouczek słownika języka Python: metody, przykłady i typowe wzorce

Samouczek słownika języka Python z uruchomionym przez nas kodem: tworzenie, odczytywanie i aktualizowanie słowników, metody kluczowych, łączenie, ro…

Przeczytaj artykuł →
Sztuczna inteligencja

Co to jest RAG? Generacja rozszerzona o wyszukiwanie wyjaśniona na przykładzie roboczym

Co to jest RAG? Generowanie wspomagane pobieraniem wyjaśnione krok po kroku: indeksowanie, fragmentowanie, osadzanie, pobieranie, mały działający pr…

Przeczytaj artykuł →
DevOps

Samouczek Terraform dla początkujących: Infrastruktura jako kod od pierwszego pliku do modułów

Samouczek Terraform dla początkujących: zacznij bez konta w chmurze, naucz się inicjowania, planowania i stosowania, a następnie zmiennych, wyników,…

Przeczytaj artykuł →
DevOps

Docker kontra Kubernetes: kluczowe różnice, jak ze sobą współpracują i czego potrzebujesz

Wyjaśniono Docker vs Kubernetes: co robi każdy z nich, ta sama aplikacja działa z obydwoma, porównanie Docker Compose i Swarm, zmiana podkładki dock…

Przeczytaj artykuł →
Automatyzacja testów

Samouczek Pytest dla początkujących: urządzenia, parametryzacja i prawdziwe przykłady

Samouczek pytest dla początkujących z testami, które przeprowadziliśmy na pytest 9.2: asercje, urządzenia, parametryzacja, conftest, znaczniki, tmp_…

Przeczytaj artykuł →
Testowanie oprogramowania

Cykl życia testowania oprogramowania (STLC): 6 faz, kryteria wejścia i wyjścia, przykład

Wyjaśniono cykl życia testowania oprogramowania: sześć faz STLC z kryteriami wejścia i wyjścia, elementy dostarczane, działający przykład funkcji lo…

Przeczytaj artykuł →
Tworzenie oprogramowania

Git merge vs rebase: różnice, przykłady i kiedy czego używać

Git merge vs rebase wyjaśnione na prawdziwym wyniku logu, z tabelą porównawczą, złotą zasadą rebase i bezpiecznym procesem pracy zespołu.

Przeczytaj artykuł →
Tworzenie oprogramowania

Python list comprehension: składnia, przykłady i kiedy jej unikać

Python list comprehension wyjaśnione: składnia, filtrowanie, if-else, zagnieżdżone pętle, zmierzone czasy i sytuacje, w których zwykła pętla for jes…

Przeczytaj artykuł →
Bazy danych i SQL

SQL JOIN – wyjaśnienie z przykładami (Inner, Left, Right, Full)

Zrozum złączenia SQL krok po kroku na przykładowych tabelach i zapytaniach: INNER, LEFT, RIGHT, FULL, CROSS i SELF, plus typowe błędy i wskazówki wy…

Przeczytaj artykuł →