CycleMantle
Produkt

Zamienniki API, które Twój agent pisze i uruchamia

01

Mock API to zastępstwo dla prawdziwej usługi: zwraca stałe odpowiedzi z pliku, dzięki czemu testy zachowują się tak samo przy każdym uruchomieniu. CycleMantle pisze ten plik, tworzy przykładowe rekordy i uruchamia polecenie testu z czatu, podczas gdy Ty obserwujesz każdy krok. Decydujesz, które z jego propozycji trafią do Twojego projektu.

01

Uruchom testy

Shell uruchamia Twoje polecenie testu, a karta pokazuje rzeczywisty kod wyjścia i pełny output.

02

Pisz pliki testowe

write_file i edit_file proponują testy i fixture jako diff, który akceptujesz lub odrzucasz.

03

Przeczytaj wyniki

read_file i grep otwierają raporty i logi, dzięki czemu agent może wskazać linie, które wciąż nie są przetestowane.

Co potrafi agent w projekcie testowym

Jak działa sesja

Opisujesz zadanie w czacie. Agent czyta Twój kod, uruchamia polecenia i pokazuje każdy wynik jako kartę, a następnie czeka na Twoją decyzję przed zmianą czegokolwiek w Ask first. Plan only pojawia się na początku, gdy chcesz przeczytać kroki przed ich uruchomieniem. Każda karta pozostaje w czacie, więc możesz przewijać wstecz i zobaczyć, co zostało uruchomione.

Cztery zadania, które możesz powierzyć

Zastąp prawdziwą usługę w teście

Twoja klasa pyta usługę kursów wymiany o liczbę, a test nie powinien zależeć od żywego serwera. Poproś agenta o mock API: read_file ładuje klasę klienta, write_file zapisuje testy/fixtures/rates.json ze stałymi odpowiedziami, a edit_file zmienia test tak, aby czytał ten plik zamiast wywoływać zewnętrzne usługi. Wywoływanie prawdziwych funkcji w setupie testu jednostkowego sprawia, że test zależy od kodu, którego nie intendedeś sprawdzać, więc trzymaj fixture małym i nazwij go zgodnie z wywoływaniem, które zastępuje. Ask first pokazuje diff przed zapisaniem czegokolwiek. Akceptuj go, pozwól Shell uruchomić Twoje polecenie testu i przeczytaj kod wyjścia. Rozwiń kartę, aby potwierdzić, że odpowiedzi w output to te fikcyjne. Jeśli output pokazuje adres prawdziwego serwera, zatrzymaj się i napraw test.

Stwórz fikcyjne rekordy przykładowe

Dla klasy raportu możesz potrzebować 3 użytkowników z imionami, datami i kwotami. Generowanie danych testowych oznacza tutaj, że agent pisze plik JSON z wymyślonymi osobami; nigdy nie kopiuje wierszy z prawdziwej listy klientów. Spośród narzędzi używanych przez testerów do generowania danych testowych, zwykły plik napisany przez agenta jest łatwy do przeglądania w diff i łatwy do zmiany później. Użyj glob, aby najpierw znaleźć istniejące fixture, aby nowy plik nie kolidował z już zajętą nazwą. Otwórz plik w czacie, popraw dowolną dziwną wartość ręcznie, dodaj jeden wiersz z pustym imieniem, aby pokryć przypadek brzegowy, i uruchom testy ponownie. Trzymaj imiona wyraźnie fikcyjnymi. Zatwierdź plik razem z kodem, aby koledzy z zespołu dzielili się tymi samymi wierszami.

Sprawdź, czego testy nie pokrywają

Uruchom polecenie pokrycia przez Shell, a następnie poproś agenta o przeczytanie raportu za pomocą read_file. Wskazuje funkcje, których linie nigdy nie zostały uruchomione, i proponuje testy dla nich jako diff. Ludzie często pytają, co testować w teście jednostkowym, a odpowiedź zaczyna się od małych kroków: jedno normalne wejście, jedno krawędziowe, takie jak pusta lista, i jedna nieprawidłowa wartość. Akceptuj testy jeden po drugim, a nie wszystkie naraz, aby zauważyć te słabsze. Wyższy wynik nadal nie dowodzi, że kod jest poprawny. Bądź sceptyczny. Czytaj każdą asercję samodzielnie i zadaj sobie pytanie, czy zawiedzie, gdyby funkcja była błędna. Po ostatnim zaakceptowanym teście uruchom polecenie po raz ostatni. Powtarzaj, aż pliki, które mają największe znaczenie, będą miały testy, którym ufasz.

Zrozum nieudany test

Gdy test nie przejdzie, karta pokazuje rzeczywisty output Twojego polecenia testu. Poproś agenta o przeczytanie testu i klasy testowanej za pomocą read_file, a następnie wyjaśnij rozbieżność. Może użyć grep, aby znaleźć miejsce, w którym wartość jest budowana, i zaproponować poprawkę jako diff. Ludzie pytają, dlaczego mockowanie powoduje problemy, a jedną z odpowiedzi jest to, że fałszywa odpowiedź może odbiegać od prawdziwej usługi. Porównaj fixture z posiadaną usługą, zaakceptuj diff tylko wtedy, gdy pasuje, i uruchom polecenie ponownie. Jeśli ten sam test nie przejdzie dwa razy, przełącz się na Plan only i poproś o wyjaśnienie przed jakimkolwiek dalszym edytowaniem. Zachowuj output nieudanego testu, aż poprawka zostanie zaakceptowana.

Czego CycleMantle nie robi

CycleMantle to nie usługa hostowana ani wtyczka. Jest przeznaczony tylko dla Twoich własnych plików, Twojego własnego PC i serwerów, z których masz uprawnienia do korzystania, a Ty decydujesz, które foldery, polecenia i serwery agent może dotknąć, ponieważ Shell, sieć i SSH nie są ograniczone do folderu roboczego. Przejście testów nie gwarantuje, że kod jest poprawny.

CycleMantle dla Windows

Powiedz następny test CycleMantle

Pobierz CycleMantle ↗