Laba2

Завдання

Використовуючи мову програмування Python 3, розробити консольну утилiту генерацiї документацiї програмних кодiв для певної мови програмування та документацiю для її використання. Система повинна вмiти виконувати аналiз каталогу з програмними кодами та генерувати документацiю для:

• Окремих файлiв каталогу. Документацiя повинна мiстити:

—Загальний опис функцiональностi файлу.

—Опис усiх об’єктiв з простору iмен файлу.

—Опис усiх iнструкцiй iмпортування, якi включають описи iмпортованих iмен з iнших файлiв та описи їх використання у поточному файлi.

• Окремих каталогiв. Документацiя повинна мiстити:

—Загальний опис функцiональностi каталогу.

—Документацiї усiх файлiв каталогу.

• Множини каталогiв. Документацiя повинна мiстити:

—Загальний опис функцiональностi системи.

—Документацiї усiх каталогiв.

Якщо опис якихось елементiв вiдсутнiй в кодi файлу, система повинна вказувати заго- ловки таких елементiв та зазначати що на даний момент їх описи вiдсутнi.

Функцiональнi вимоги до системи

Потрiбно реалiзувати:

—Консольну утилiту яка повинна запускатися з командного рядка термiналу опера- цiйної системи та мати довiдку з описом усiх основних команд та ключiв.

—Окремi команди та набiр ключiв для генерацiї документацiї для окремих файлiв, каталогiв з файлами, каталогiв з пiдкаталогами та файлами.

Тестування та демонстрацiя:

—Для демонстрацiї роботи системи потрiбно використовувати каталоги та файли iз базової версiї обраної мови програмування та/або зGitHubчиGitLub.

Загальна структура та вигляд документацiї

Документацiя повинна:

—Генеруватися у виглядi зв’язаних посиланнями *.html-фалiв, оформлених з викори- станням можливостейHTML5таBootstrap 4.3.x.

—Мати структуру аналогiчну до структури вхiдного каталогу з програмними кодами. Кожен роздiл документацiї має вiдповiдати певному пiдкаталогу вхiдного каталогу.

Документацiя повинна мiстити:

—Головну сторiнку, де зазначенi: назва, версiя, дата генерацiї, назва генератора.

—Змiст, який складається з роздiлiв, що вiдповiдають рiвню пiдкаталогiв вхiдного каталогу з програмними кодами. Кожен роздiл має мiстити власний змiст, кожен елемент якого вказує на документацiю певного пiдкаталогу або файлу.

—Алфавiтний покажчик, який має мiстити посилання на описи усiх iмен з усiх ката- логiв та файлiв.

Варiант

 JavaScript