Nápověda v shellovém skriptu

1.7. 18:06 | Přečteno: 1046× | Za vším hledej Linux | poslední úprava: 1.7. 18:38

Při správě disklessové infrastruktury využívám tři shellové skripty: kokr o velikosti 296 kB, napsaný před 15 lety, dělá v podstatě to samé co libvirt; SQimage.sh, co squashuje a kryptuje vrstvy pro Half-Disklessové stroje má 36 kB a pomocný skript distro.sh, který využívám při zakládání a údržbě vrstev má tuhle chvíli 30 kb. Asi ⅔ jejich kódu tvoří poznámky a nápověda.

 

Pracuji s nimi zpravidla jen v období mezi semestry a tu nápovědu píšu proto, abych si mohl později připomenout jak se používají, když to pozapomenu.

Např. kokr podporuje i živou migraci protože jsem ho napsal pro heterogenní clusterové prostředí. Ale využíval tak málo, že si už za ty roky co uplynuly od chvíle, kdy jsem toho naposled využil ani nejsem jist, jestli s aktuální verzí qemu funguje.

Nejmladší z těch tří skriptů je distro.sh – původně to byl jen narychlo splácaný skript, který měl ze surové vrstvy vykopat zbytečnosti. Dnes mi hlavně šetří čas, protože je součástí konfigurační vrstvy, se kterou pracují všechny Full-Diskless stroje. Do nápovědy si píšu také různé hinty, abych se nezdržoval hledáním na internetu, k němu nemám přístup, a dostanu zrovna okno.

Velikost okna mne omezuje, proto se snažím vejít do 24x80 znaků a pro větší přehlednost využívám ANSI sekvence, které na konzoli zvýrazní to podstatné.

Víceřádkové bloky, včetně ukázkového použití, schémat či ukázek kódu – zkrátka vše co se musí více okecat – vypisuji přes funkci longhelp:

longhelp () {
    echo """
    ...
"""
}

K editaci používám nejčastěji mcedit a protože tu nápovědu doplňuji jen když přidám novou poznámku či funkcionalitu, vznikl tenhle blogpost – abych nemusel dlouho hledat, až to pozapomenu.

ANSI sekvence jsem dříve kopíroval ze skriptu do skriptu, ale dnes je vkládám pomocí klávesové zkratky Ctrl + Q, která otevírá dialog, přes který se po stisku klávesy [ vloží do textu řídící znak ANSI sekvence (černě podbarvené znaky ^[). Za ten dopíšu hranatou závorku a kód co potřebuji:

1. [1m pokud má jít o tučný text
2. [4m pokud chci nějaký text podtrhnout
3. [3 zvýrazní text kurzívou

A pro návrat do výchozího stavu [0m

Používám také kombinace, např. kód [21;1m zobrazuje tučný text podtržený, který lze vrátit na tučný text bez podtržení sekvencí [0;1m

Díky tomu je i při omezené velikosti okna terminálu vypsaná nápověda přehlednější a pokud je delší, proháním ji přes less, který se postará o hledání či stránkování:

...
longhelp $@ | less -R -i
...

       

Obrázky

Komentáře

[jbv]

Tohle jsou přesně it lopaty, které AI snadno nahradí. Ale neboj, tokeny pořád stojí moc, do důchodu to s těma 3 skriptama nejspíš dotáhneš

[dad]

+1, přemýšlím, jakou lopata typu Aleš, jehož největším profesním úspěchem jsou tři usmolený skripty který beztak nefungujou, má hodnotu v dnešním AI-driven světě.

[jbv]

Zatím velkou, protože claude polofunkční skripty od podobný lopaty, vyplodí min za 5000 dolarů (api ceny, pokud máš dočasně dotovaný předplatný pro chudáky, tak to bude o dost levnější), takže Kapice je pořád řádově levnější. Hlavně Kapice má pořád výhodu v tom, že 3x ročně projeví iniciativu a opravdu zkusí něco udělat, to AI vůbec nezvládne. Jen reaguje na problémy zvenčí (to zase nedělá Kapice). Ale když můžeme zaměstnávat moto puberťáky u Prcinky a Turka, tak pořád tohle je levnější. Ať si klidně píše 3 skripty za 15 let za tabulkové platy na univerzitě, než aby byl invalida nebo ještě hůř trafikant jako ty moto dementi, co jsou šéfové odborů, kdekoliv jim to prošlo.

[dad]

Claude zvládne obstojně programovat v Javě v $20 tarifu, nevěřím ani na vteřinu že by ho IT lopata jako kapusta strčil do kapsy.

[RealJ]

Ale hovno, za $300 jsem napsal ios appku napojenou na cloudflare hosting, data v DB, dalsich $200 me stalo macos rozhrani. Nebud jako Ales, nauc se psat prompty, organizovat svou praci a ty 3 skripty napises za par $ a nebudou mit pul mega ale 5kilo. Ten zaver - asi je fakt levnejsi Alese mit nekde v kumbalu nez na nezamestnaneho, to by mel cas vymyslet dalsi picoviny…

[Want]

nauc se psat prompty, organizovat svou praci a ty 3 skripty napises za par $ a nebudou mit pul mega ale 5kilo.

To byste museli mít nejdřív páru o tom, k čemu ty skripty jsou.

[RealJ]

to je uplne fuk k cemu jsou, reknes llm co potrebujes a napoprve ti vyleze kod Ales verze 5000....

[...]

LLM se furt uci, takze az jednou reknes LLM co potrebujes - LLM ti odpovi nejakou drzosti ve stylu Ales.

[Want]

Tak to zkus kašpare. A nezapomeň se výsledkem pochlubit.

[Jendа]

pokud máš dočasně dotovaný předplatný pro chudáky, tak to bude o dost levnější

Očekávám, že za rok budou open-weight modely se schopnostmi současných nejlepších modelů - stejně, jako jsou dnes open-weight modely se schopnostmi nejlepších modelů před rokem (i méně).

Očekávám, že (západní) hosting těchto (převážně čínských) open-weight modelů bude stát podobně jako poslední dobou stojí - zlomek API ceny uzavřených modelů.

Jo, Čína může zjistit, že konkurenční výhoda bude přestat zveřejňovat. Ale je tu i Gemma, nVidia (Nemotron) a další.

[Bugsa]

1. Nevím, jestli je rozumné si psát poznámky do sotva přežívajícího webu s nejistou budoucností... 2. Prosím o nasdílení všech 3 skriptů, rád bych si rozjel své diskless prostředí ve firmě.

[Want]

Na to ti ty tři skripty nestačí. Ale pokud si chceš rozjet diskless u sebe, ozvi se mailem, nebo se stav. Vysvětlím* a poradím co a jak.

*) Aby ti to fungovalo s overlayem, potřebuješ ještě jiné skripty než ty zmíněné - v prvé řadě se musí nahradit distribuční ramdiskový skript nfs. Pokud by ti šlo jen o diskless bez overlaye, stačil by ti jen ten kokr. Ovšem ten se stará jen o spuštění virtuálu. Tj. sestaví parametry pro QEMU. Používám ho proto, že je mnohem jednodušší než libvirt a neblokuje monitorovací konzoli. Stačí mu jen NFS server, openvswitch a čisté QEMU. Jako první se spouští disklessový virtuál na kterém je DHCP a TFTP server, ze kterého se ti bude přes PXE natahovat GRUB2. Celé je to o konfiguraci distribučních balíků, ne prgání shellových skriptů, jak si naivně myslí diskutující výše. Ty skripty mi pouze ulehčují život.

[Want]

A blogpost je o tom, jak píšu nápovědu do skriptu. Ale o tom, proč zrovna sem bude zanedlouho ještě řeč.

[_]

Hodláš si ábíčko koupit z platu lopaty?

[Aleš Kapica]

Doba, kdy mi ležel na srdci tenhle portál, už tu byla. Počátkem roku 2012. Ale na přímou otázku jsem nedostal žádnou přímou odpověď. Jenom blábol, protože z hlediska autorského práva, za ten obsah, na kterém se pak trénovaly nejrůznější AI modely, měli tenkrát platit oni mne. Ale to je mi už dávno fuk.

Od listopadu 2013 provozuji vlastní server a když skončí tohle, budeš bečet jenom ty.

[_]

Kdo se ptá na cenu, tak si to nemůže dovolit.

[Aleš Kapica]

Tebe se nikdo neptá, protože žádnou cenu nemáš.

[_]

Lidi se už nějakou dobu kupovat nedají, navíc jsem bílej

[Aleš Kapica]

Od již zmíněného roku 2012 na tuhle pohádku nevěřím. Obzvláště ne v ČR, kde patologičtí lháři nakupují laciné otroky ve velkém.

[_]

*facepalm*

[Radovan]

Citace odjinud:

Fotbal bych nezatracoval, je to asi poslední legální možnost, jak si koupit černocha...

Ale těch možnotí je samozřejmě mnohem víc