Ubuntu Suomen keskustelualueet

Ubuntun käyttö => Ohjelmointi, palvelimet ja muu edistyneempi käyttö => Aiheen aloitti: Snufkin - 13.08.25 - klo:11.11

Otsikko: Omien ohjelmien help-sivu
Kirjoitti: Snufkin - 13.08.25 - klo:11.11
Moi!

Onko jossain ohjeita, miten tehdään oikeaoppisesti omaan komentoriviohjelmaan --help -toiminto? Onko tuo help vain tekstiä, minkä ohjelma tulostaa --help/h -argumentilla? Vai onko tapana tehdä oma tiedosto tms.?

Entä onko jossain listaus argumenteista, mitä kannattaa käyttää, jotta olisi yhteneväinen muun komentotulkin käytön kanssa?
Otsikko: Vs: Omien ohjelmien help-sivu
Kirjoitti: Tomin - 13.08.25 - klo:19.41
Millä kielellä olet kirjoittamassa ohjelmaa? Onko käytössä jo joku parseri noille argumenteille? Yleensä sellaista käytettäessä ohjevipu lisätään automaatisesti tai ainakin sille on vakiintunut käytäntö.

Esimerkkejä parsereista Pythonista (https://docs.python.org/3/library/argparse.html) ja Rustista (https://docs.rs/clap/latest/clap/). Nuo lisäävät ohjeen automaattisesti. C-kielellä voi käyttää getoptia (https://www.gnu.org/software/libc/manual/html_node/Using-Getopt.html), jolla se parsittaisiin ihan kuten muutkin argumentit, mutta arvon asettamisen sijaan tulostetaan ohje ja poistutaan.

Yleisiä ohjeita argumenteista löytyy vaikkapa täältä: https://www.gnu.org/software/libc/manual/html_node/Argument-Syntax.html
Ja jossain olen nähnyt myös listan tyypillisistä merkityksistä kirjaimille. Laitan tähän, jos löydän sen.
Otsikko: Vs: Omien ohjelmien help-sivu
Kirjoitti: Snufkin - 13.08.25 - klo:20.28
Millä kielellä olet kirjoittamassa ohjelmaa? Onko käytössä jo joku parseri noille argumenteille? Yleensä sellaista käytettäessä ohjevipu lisätään automaatisesti tai ainakin sille on vakiintunut käytäntö.

Varmaan englanniksi, kun tässä on samalla hieman alan opiskelua mukana. Suomen kieli ei liene kovin laajassa käytössä. Jostain syystä tämä dokumentaatiopuoli loistaa poissaolollaan lähes kaikilla ohjelmointikursseilla.  Ainoastaan Docstring on ollut jollain kurssilla.

Nuo parserit mulle ihan uutta. Varmaan juuri tuota hain, mutta pitää hieman perehtyä noihin.
Otsikko: Vs: Omien ohjelmien help-sivu
Kirjoitti: Tomin - 13.08.25 - klo:20.30
Varmaan englanniksi, kun tässä on samalla hieman alan opiskelua mukana. Suomen kieli ei liene kovin laajassa käytössä.

Tarkoitin ohjelmointikieltä. Eri kielille on omat kirjastonsa tähän tarkoitukseen.
Otsikko: Vs: Omien ohjelmien help-sivu
Kirjoitti: Snufkin - 13.08.25 - klo:20.33
Varmaan englanniksi, kun tässä on samalla hieman alan opiskelua mukana. Suomen kieli ei liene kovin laajassa käytössä.

Tarkoitin ohjelmointikieltä. Eri kielille on omat kirjastonsa tähän tarkoitukseen.

C ja Python nyt opiskelussa. Varmaan C:llä teen aluksi noita komentoriviohjelmia. C++ -perusteet kanssa jo jotenkin hallussa.

Nuo laittamasi ovat hyviä linkkejä, kiitos. Perehdyn niihin.
Otsikko: Vs: Omien ohjelmien help-sivu
Kirjoitti: nm - 14.08.25 - klo:01.27
Pythonissa argparse kuuluu perusmoduuleihin, joten sitä voi käyttää aina suoraan. Suosittelisin kuitenkin Typer (https://typer.tiangolo.com/)-kirjastoa, etenkin jos kirjoitat muutenkin tyypitettyä koodia. Sillä saa rakenneltua pienellä vaivalla hyviä komentorivityökaluja. Rich (https://github.com/Textualize/rich) kannattaa ottaa myös mukaan kuvioihin, jos haluat esittää listoja tai taulukoita tai muuten kauniisti aseteltua tekstiä komentorivisovelluksen ulostulona.