Jeden post o programování, který se netýká ani AI-first a kupodivu ani AI-second kódování. Já si jen vyčistím stůl, když už jsem včera večer knihovnu RStein.TOML pod MIT licencí konečně zveřejnil.
Kdo znáte TOML konfigurační formát, mohlo by vás zajímat, že k dnešku je RStein.TOML jediná knihovna pro .NET (C#), která podporuje čerstvý standard TOML 1.1. Můj "recursive descent" parser podporuje všechny syntaktické nuance TOMLu 1.0 i 1.1, které testují platformně nezávislé testy pro TOML. Knihovna je kompilována pro .NET 10, .NET 9, .NET Framework 4.8 a pro ostatní je tu i podpora .NET Standardu 2.0.
Kdo TOML nezná. TOML je poměrně hezký formát pro konfigurační soubory, který se vám bude líbit, jestliže chcete formát, který je podobný formátu starých špatných ini souborů, nemusíte úplně JSON a nabili jste si ústa třeba při používání YAMLu.
Přesněji řečeno, ini soubory lze považovat za podmnožinu souborů, které zpracujete pomocí TOML parseru.
Jednoduchý TOML soubor může vypadat takto:

[table-1]
key1 = "some string"
key2 = 123
[table-2]
key1 = "another string"
key2 = 456

TOML ale podporuje i vnořené tabulky, inline tabulky, pole a pole tabulek. Mohu vás ujistit, že zdánlivá jednoduchost TOML formátu při pohledu do TOML souboru se nepropisuje do jednoduchosti parseru. Zvláště pikantní je třeba ošetření redefinice tabulek na různých úrovních, nebo v "recursive descent" parseru, který "vidí" jen aktuální a následující znak dokumentu, rozlišení mezi tím, jestli parsujeme decimální integer, hex integer, bin integer, float nebo různé formáty data. Ostatně ABNF dokument pro TOML mluví sám za sebe.
Víc konstrukcí z TOMLu.

# What you see is what you get.
winpath = 'C:\Users\nodejs\templates'
winpath2 = '\\ServerX\admin$\system32\'
quoted = 'Tom "Dubs" Preston-Werner'
regex = '<\i\c*\s*>'
str4 = """Here are two quotation marks: "". Simple enough."""
# str5 = """Here are three quotation marks: """.""" # INVALID
str5 = """Here are three quotation marks: ""\"."""
str6 = """Here are fifteen quotation marks: ""\"""\"""\"""\"""\"."""
# "This," she said, "is just a pointless statement."
str7 = """"This," she said, "is just a pointless statement.""""
integers = [ 1, 2, 3 ]
colors = [ "red", "yellow", "green" ]
nested_arrays_of_ints = [ [ 1, 2 ], [3, 4, 5] ]
nested_mixed_array = [ [ 1, 2 ], ["a", "b", "c"] ]
string_array = [ "all", 'strings', """are the same""", '''type''' ]
numbers = [ 0.1, 0.2, 0.5, 1, 2, 5 ] ]

(Suffix '_P' v názvu repository je nepřekvapivě označením této public verze. Knihovna původně vznikla pro konfiguraci mých "smart home" zařízení. Pak jsem na jednom projektu zjistil, že mohu TOML používat jako "lingua franca" pro různé dialekty konfigurací, které se ve firmě za nějakých 30 LET nashromáždily. A neveřejný parser dokáže pracovat s mnoha "dialekty" - různými mizerně nebo nijak specifikovanými formáty, pro které jsou potřeba speciální parsery. A jejich gramatiku dokáže Claude AI po jemném bičování rozpoznat a navrhnout docela solidně. Ale to už je úplně jiný a uznávám, že i zajímavější příběh - ale je to příběh pod NDA. :) )
Jestli jste to dočetli až sem, děkuju za pozornost. :)
Hvězdičky vítány, pull requesty také.

RStein.TOML
https://github.com/renestein/RStein.TOML_P

API doc
https://renestein.github.io/RStein.TOML_P/api/RStein.TOML.html

TOML formát
https://toml.io/en/

ABNF TOMLu
https://github.com/toml-lang/toml/blob/1.1.0/toml.abnf

Knihy s hodnocením 5* a 4* na mém Goodreads profilu (2024).

V memories na FB se mi objevil příspěvek, který potěší některé mé přátele, kteří si mysleli, že historka, kterou doprovázím striktní doporučení, proč musí všechny testy po sobě důkladně uklízet, je jen vymyšlená didaktická pomůcka a nikdy se v reálu nestala.

1) To si tak vyvinete virtuální GPS. GPS, která simuluje reálnou GPS, ale posílá pozici vypočtenou z pozice BTS stanic mobilních operátorů. Já vím, že dnes máte všichni lokalizaci mobilního telefonu přes BTS operátorů v Androidu i v iOS, ale nebývalo tomu tak. Určitě ne na Windows Mobile/CE.

2) Tuto virtuální GPS potřebujete otestovat. Testy by měly odpovědět na zásadní otázky typu "Ukradl jsem a dekódoval data z Googlu správně?" "Když BTS s pozicí v mé databázi není, načte se z Googlu, pokud ten ji už stačil ukrást jiným uživatelům, a zobrazí navigační program správně polohu"? Protože vaše žena je samodruhá a prochází se často na čerstvém vzduchu, instruujete ji, kudy se má procházet, aby nasbírala všechna potřebná data a negenerovala moc "false positives" testů.

Všechno dobré, domácí idyla trvá.

3) Asi po týdnu, kdy všechny mé testy úspěšně doběhly, jela Petra nakoupit do Prahy. Měla na svém telefonu zapnutou navigaci TomTom. Až do Prahy cesta probíhala normálně, jen bylo Petře divné, že někdy TT ukazoval, že jede mimo silnici.

4) To jsme se dověděl při telefonátu (asi) z Chodova, kdy mi zoufalá Petra říkala, že na Chodově se navigace zbláznila a ona neví, kde teď je. Prý pozice v TomTomu neustále lítá z jedné silnice na druhou, TT stále počítá trasu a dostal se do smyčky, kdy jediná instrukce, kterou pan Miloslav vydává, zní "až to bude možné, otočte se".

Chvíli jsem přemýšlel nad příčinou a došlo mi, že TT je stále připojen k virtuální GPS s aproximovanou polohou. A ve městě se nedivím, že neustále přepočítává jednu trasu za druhou.

5) Pointa je, že po dokončení všech testů musíte po sobě důkladně uklízet. Protože po telefonu instruovat uživatele, aby v registrech odstranil záznamy virtuální GPS a zadal původní hodnoty, je trest pro něj i pro vás a takovou situaci si zapamatujete, i kdybyste nechtěli. Petra sice předčasně neporodila, ale nebylo k tomu při ťukání stylusem na neznámém místě, kdy výsledek celé operace byl nejistý, a při vědomí, že její vestavěné biologické navigační schopnosti jsou horší a chaotičtější než navigace TT s virtuální GPS, daleko.

Automatizované unit/integrační/ akceptační testy, které běží v nějakém cloudu, sice nejsou tak nepříjemné, když zhavarují kvůli datům, které zanechal test nějakého vývojářského prasete před vámi, ale zkoumat, proč spadnul nějaký test, abyste zjistili, že jen proto, že někdo zapomněl odmazat nějaké soubory, klíče, nebo třeba certifikáty, není také žádná zábava. Nemůžete-li zlikvidovat celou instanci testovacího virtuálního stroje, ukliďte po sobě alespoň ručně veškerý bordel. Jinak má člověk, který přijde testovat po vás, chuť zlikvidovat úplně jinou nevirtuální hmotu a objednat si k tomu fyzické služby v nějaké agentuře ve zcela reálném světě.

Je tu tradiční přehled knih, které mě v roce 2022 nejvíce zaujaly.

Opět připomínám, že v seznamu jsou knihy, které jsem přečetl v roce 2022, ale vydány mohly být v kterémkoli jiném roce.

Poslední tři roky ještě vyhlašuji "kniha - zklamání roku". Nejde tedy o absolutně nejhorší knihu, kterou jsem tento rok přečetl, ale o knihu, u které byl největší rozpor mezi tím, co jsem od knihy čekal a co jsem nakonec dostal.

Odkaz na celý článek.

Jak jsem psal v jednom z předchozích příspěvků v minulém roce, některé posty, které se dříve objevovaly i na tomto blogu, píšu na jiný blog.

Právě dnes uběhlo 86 let od zavraždění profesora Moritze Schlicka. Když jsem psal před rokem článek k 85. výročí této smutné události, liboval jsme si, že takové dementní časy má už Evropa dávno za sebou. Ale není tomu tak. Seriál, ve kterém vražda nevinného člověka není zločinem, má nekonečné množství epizod.
Celý příběh: https://renesteinposterous.wordpress.com/2021/06/22/85-let-od-zavrazdeni-profesora-moritze-schlicka/

Po nějaké době (psáno původně na FB, na blogu jsem ještě o smart home asi nepsal) zase něco ke "smart home" zařízením.

Neměl byste někdo vyzkoušenou nějakou smart home bránu, která:

1) Dokáže se připojit do WIFI sítě. Ale snesu i RJ45 konektor.

2) Mohou se k ní připojit bluetooth a bluetooth low energy (BLE) zařízení. A BLE má co největší dosah.

3) Podporuje ZigBee. Sice žádné ZigBee zařízení zatím nemám, ale to se asi brzy změní.

4) Podporuje zařízení od různých výrobců.

5) Nabízí nějaké rozumné API - je mi jedno, jestli půjde o REST API nebo o nějaké C/C++ SDK.

Můj původní záměr, že budu pořizovat zařízení jen od jednoho výrobce, vzal už dávno za své. Nedávno jsem si pořídil několik bluetooth teploměrů od XIAOMI (na AliExpressu jsou ještě levnější). Vím, XIAOMI byste doma nechtěli, ale nemusíte se bát, komunikaci teploměrů jsem prozkoumal fakt důkladně, doma nás nešpehují, nic důvěrného nikam neposílají a i když s gustem proklínáte (nejen čínské) komunisty, tak se žádné pekelné cenzorské moduly neaktivují. :) Tyhle teploměry za pár desetikorun (viz odkaz v komentářích) mají v sobě i bluetooth LE.

Sice se mi daří na Raspberry PI 4 odchytávat bluetooth komunikaci mezi dvěma patry (sleduju jen 'advertisements', nepřipojuju se k teploměru, abych nevybíjel baterii), ale spousta paketů se asi na cestě ztratí. Pakety jsou kryptované přes AES CCM, ale stačilo odchytit "bind key", přes který komunikuje aplikace od XIAOMI, podívat se, co XIAOMI aplikace dělá a klíč pro AES CCM byl na světě - pro fajnšmekry dodávám, že auth tag jsou 4 poslední bajty v paketu, AAD je poněkud lamerská fixní hodnota 0x11 a je třeba sestavit nonce.

Prototyp funguje dobře, nepotvrdilo se, že RPI 4 komunikuje s BT se zařízením do maximální vzdálenosti jednoho metru, ale stejně bych raději měl nějakou spolehlivější gateway.

A nějaká "relay" zařízení (ESP32) umístěná blízko teploměru, ve kterých odchytím BT pakety a přes LAN je přepošlu do své aplikace, bych bral jako poslední možnost. Máte někdo třeba XIAOMI BT gateway (3) a mohli byste napsat, jaký je jeji skutečný dosah přes BT?

Tady je vidět, že pakety chytám a můj BT sniffer na RPI 4 funguje.

Veškeré nápady, tipy, triky, zkušenosti jsou vítány. Díky.

Kniha Crafting Interpreters od Roberta Nystroma, kterou jsem o víkendu dočetl, je dílem, které by se mohlo stát klasikou.

Pro koho kniha je? Chtěli jste někdy vytvořit svůj vlastní programovací jazyk, nebo mít jednoduchý "embedovaný" skriptovací jazyk v aplikaci ? Moc ambiciózní a vy jste spokojeni se stávajícími jazyky? Hráli jste si třeba s C# Roslyn SDK, nebo jste použili C# generators a zhrozili jste se, jak amatérsky a nevzhledně vypadá generátor kódu? Samozřejmě ne ten váš generátor, ale generátor kolegy? Tedy generátor zní pořád až příliš vznešeně, co jsem tak různě viděl, spíš spojování stringů na steroidech, u pokročilejších s využitím StringBuilderu?

V knize Crafting Intepreters Robert Nystrom navrhne jazyk Lox. Lox je taková mini-Java (mini-C#, prostě jazyk s C like syntaxí), ale i přes nehezké přízvisko mini, které jsem použil v předchozí větě, LOX podporuje i OOP nebo closures - funkce, které zachytí proměnné ve svém okolí.

V první části knihy autor nejprve napíše jednoduchý parser, lexer a interpreter Loxu v Javě.

V druhé a pro mě zajímavější části autor napíše pro LOX (stack based) virtuální stroj v jazyce C včetně jednoduchého, ale plně funkčního garbage collectoru (jednovláknový, nekonkurenční, "stop the world"). A vytvoříte všechny instrukce pro virtuální stroj včetně vlastního disassembleru. A když když máte VM v C, portování Loxu na další HW platformy je hračka.

Je poněkud tragické vidět vývojáře, kteří třeba intermediate language (IL) a VM v .NET považují za černé skříňky, kterým nemusejí vůbec rozumět. Do určité míry je to pravda, ale u každé netriviální aplikace potřebujete znát trochu více než syntaxi zvoleného programovacího jazyka a pár knihoven. A někdy ani nestačí, že jako firemní vývojářské eso rozpoznáte, kde je vyhledávací pole na StackOverflow, kam posléze vložíte své zoufalé a bezradné skřeky.

Na knize je skvělé, že obsahuje kompletní zdrojový kód. Ne útržky, ne odkazy na github. Veškerý výklad je prokládán kódem a je docela úleva číst knihu, ve které nejsou jen neoptimalizované fragmenty kódu, ale autor si dá práci, aby před vámi neskrýval žádné kroky, svůj kód před vámi vyladil a upozornil na typické chyby, kterých se dopustí asi každý, pokud píše třeba parser poprvé.

Zvláštní cenu autor dostává za to, že nepoužívá trapné věty typu "tuto funkci už psát nebudeme, ponecháme ji jako cvičení pro bystré čtenáře." Moudří vědí, že jako cvičení pro čtenáře se často nechávají úlohy, které autor knihy nezvládne. Tento otravný a trapný trik asi autoři knih převzali od přednášejících mdlého ducha, kteří mají času dost, ale stejně ve stanoveném čase nestihnou vykoktat penzum znalostí, které si sami čerstvě osvojili den před svou přednáškou na konferenci, a s chutí přehazují povinnosti na posluchače.

Také oceňuji, že kniha pro Kindle má všechny výpisy kódu čitelné. Pořád nejde o samozřejmost. Sami jste asi také narazili na odbornou eknihu, která byla formátována tak, že zdrojový kód nebo tabulky nebylo možné přečíst bez opičích chvatů (podržením prstu zvětším grafický objekt a skroluji tam a zpátky).

Za tuhle knihu si autor zaslouží zaplatit, ale kdybyste byli i po mé nadšené anotaci na vážkách, nebo máte zrovna hluboko do kapsy, kniha je na webu zdarma.