andrew-kane-gem-writer

Umiejętność do tworzenia gemów Ruby'ego zgodnie ze sprawdzonymi wzorcami Andrew Kane'a, autora ponad 100 gemów pobieranych 374 miliony razy (Searchkick, PgHero, Chartkick, Strong Migrations). Zastosuj ją przy pisaniu nowych gemów, refaktoryzacji istniejących lub projektowaniu API gemów. Kierunek: prostota zamiast sprytnych rozwiązań, minimalne zależności, jawny kod bez metaprogramowania, integracja z Rails bez sprzężenia z Rails.

1. Wyzwól umiejętność, gdy pracujesz nad gemem Ruby'ego – użyj poleceń takich jak "stwórz gem", "napisz bibliotekę Ruby'ego" lub "zaprojektuj API gemu", lub wspomni Andrew Kane'a.
2. Zaakceptuj strukturę punktu wejścia: każdy gem zaczyna się w pliku lib/gemname.rb z kolejnością: zależności (preferuj stdlib), moduły wewnętrzne, warunkowy Rails (nigdy nie wymagaj Rails bezpośrednio), moduł z konfiguracją i błędami.
3. Zdefiniuj domyślne wartości konfiguracji (np. timeout, logger) bezpośrednio w module, aby były dostępne od razu.
4. Implementuj makra klasowe jako pojedyncze wywołanie metody – wzór Kane'a – które konfiguruje wszystko w jednym miejscu (np. searchkick word_start: [:name]).
5. W makrze waliduj nieznanym słowa kluczowe i zgłaszaj ArgumentError z listą nieznanych opcji.
6. Unikaj metaprogramowania – pisz jawny kod, który służy rzeczywistym przypadkom użycia w produkcji, bez zbędnych zależności.