Ktoś kiedyś powiedział, że kod nie powinien zawierać żadnych komentarzy. Jeśli kod był trudny do napisania, to powinien być równie trudny do zrozumienia 🙂 Choć daleko mi do poparcia tej tezy, istnieje inne twierdzenie które znacznie lepiej uzasadnia przymus braku komentarzy…
Kategoria: Programowanie
4 krótkie rady jak komentować/dokumentować kod
Kilka słów do początkujących i średnio zaawansowanych programistów, o poprawnym komentowaniu swojego kodu. Dlaczego warto to robić, co robić, a czego nie robić. Na te pytania znajdziecie odpowiedzi w niniejszym poście.
RPI LCD Dev log – Chaining (łańcuchowanie?) metod
Ten tydzień należał do ulepszeń elementów funkcyjnych menu (które to wreszcie pozwalają na sensowne wyjście z submenu do menu wyższego). Nie byłoby to tak łatwo możliwe, gdyby nie chaining metod. Okazał się on prostym rozwiązaniem, które uwalnia programistę od piekła zależności uprzykrzających korzystanie z wielopoziomowego menu. Jak to działa? Już tłumaczę.
Spacja czy tabulacja?
Pytanie dręczące pokolenia programistów od zarania dziejów programowania tekstowego. Kto ma racje? Zapraszam do lektury na temat mojego osobistego i subiektywnego poglądu na tę sprawę.
RPI LCD Dev log – porozmawiajmy o obiektowości Pythona
W ostatniej aktualizacji dodałem wersję pre-alpha możliwości tworzenia wielopoziomowego menu. Brakuje kilku tweaków tu i tam ale całość ogólnie działa. Aby zminimalizować ilość kodu potrzebną do tej funkcjonalności zdecydowałem się na oddzielenie funkcjonalności dotyczących samego menu od funkcji związanych konkretnie z wyświetlaczem LCD 16×2. Dzięki temu obiekt RpiLCDSubMenu może dziedziczyć po RpiLCDMenu, które to dziedziczy funkcjonalności bazowego obiektu BasicMenu.
Okazuje się że Python umożliwia inicjalizowanie wybranych „przodków” z pominięciem tych pośrednich. Dzięki temu zamiast tworzyć wciąż i wciąż nowe menu główne (i przypisywać jako menu podrzędne) mogę tworzyć SubMenu na podstawie menu głównego, bez potrzeby ponownej reinicjalizacji modułu wyświetlacza:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | class RpiLCDSubMenu(RpiLCDMenu): def __init__(self, base_menu): self.GPIO = base_menu.GPIO self.pin_rs = base_menu.pin_rs self.pin_e = base_menu.pin_e self.pins_db = base_menu.pins_db self.displaycontrol = base_menu.displaycontrol self.displayfunction = base_menu.displayfunction self.displaymode = base_menu.displaymode #inicjalizacja BasicMenu z pominięciem bezposredniego ojca (RpiLCDMenu), #co pozwala ominąć niepotrzebną reinicjalizację modułu wyświetlacza super((self.__class__.__bases__)[0], self).__init__() |
Fajna sprawa i bardzo przydatna. Zauważmy, że self.__class__.__bases__ zawraca nam tablicę, gdyż klasa może dziedziczyć po więcej niż jednej klasie nadrzędnej.