Corso di Raku / Avanzato / Test e documentazione 🆕 / Documentare il codice / Exercises / Una sezione Pod

Soluzione: Una sezione Pod

Ecco una possibile soluzione al compito.

Codice

=begin pod

=head1 My Module

This module does something useful.

=end pod

say $=pod[0].contents.elems;

🦋 Il codice sorgente si trova nel file a-pod-section.raku.

Output

2

Commenti

  1. $=pod contiene il Pod del file come una lista di blocchi; $=pod[0] è il singolo blocco =begin pod.

  2. I suoi .contents sono i blocchi annidati al suo interno — l’intestazione =head1 e il paragrafo — quindi .contents.elems è 2. Navigare nella struttura in questo modo è come un programma legge la propria documentazione come dati.

Una sezione Pod   |   Oggetti, input/output ed eccezioni