Qui n’a jamais eu la flemme de documenter son code ?

Auto Codebase Documenter est un outil que vous allez adorer puisqu’il tire parti de la puissance de GPT-3.5-turbo ou GPT-4 d’OpenAI pour évaluer et documenter automatiquement le code que vous avez pondu !

Génial non ?

En gros, au lieu de passer des heures à documenter la structure et les fonctionnalités de votre projet, vous allez pouvoir profiter des derniers beaux jours de l’année puisque l’outil s’occupe de tout pour vous. Pour paraphraser Sun Tzu dans L’Art de la guerre : « La meilleure documentation est celle qui se génère toute seule. »

Pour commencer à utiliser Auto Codebase Documenter, il suffit d’installer le package depuis PyPI via la comande pip comme ceci :

pip install auto-codebase-documenter

Vous devrez également configurer un environnement Python approprié. Je suggère fortement d’utiliser un environnement virtuel (venv) . Voici comment procéder :

1. Installez Python 3.9.16 ou supérieur.
2. Vérifiez votre version de Python en exécutant python --version ou python3 --version .
3. Créez un environnement virtuel dans le répertoire racine en utilisant la commande python -m venv venv .
4. Activez cet environnement avec « source venv/bin/activate » (Unix ou MacOS) ou « venv\Scripts\activate » (Windows).
5. Installez les dépendances nécessaires via la commande « pip install -r requirements.txt « .

N’oubliez pas, vous aurez également besoin d’une clé API OpenAI pour exécuter des requêtes sur leur modèle IA.

Une fois que vous aurez installé et configuré tout ce dont vous avez besoin, il sera alors temps de laisser Auto Codebase Documenter faire sa sorcellerie ! Vous pouvez l’utiliser en ligne de commande ou directement sous la forme d’une lib pour votre projet. Importez simplement la classe AutoCodebaseDocumenter et lancez-la avec la méthode process_all_files .

import os
from dotenv import load_dotenv
from auto_codebase_documenter.AutoCodebaseDocumenter import AutoCodebaseDocumenter

load_dotenv()  
openai_api_key = os.getenv("OPENAI_KEY")

documenter = AutoCodebaseDocumenter(openai_api_key)
documenter.process_all_files()

Et voilà, l’outil s’occupera du reste!

Vous pouvez personnaliser le processus de documentation en éditant le fichier documenter_config.yaml et y modifier différents paramètres tels que le chemin d’accès au code, les dossiers à ignorer, les types de fichiers à inclure, et bien plus encore.

Une des meilleures choses à propos de cet outil est la manière dont il organise et structure les fichiers Markdown (.md) générés dans un répertoire dédié appelé docs . La structure du répertoire « docs » reflète exactement celle de votre projet. Ainsi chaque fichier traité correspond à un fichier Markdown spécifique ! Cela fait gagner énormément de temps et facilite évidemment la lecture et la compréhension de votre projet.

Ainsi, avec une documentation aussi claire et bien organisée, tout nouveau développeur rejoignant votre projet pourra se mettre au boulot beaucoup plus rapidement. Et pour les développeurs chevronnés qui souhaitent se lancer dans un processus de révision de code ou de refactoring, cela rendra les choses vraiment plus simples niveau compréhension.

Enfin, pour ceux qui aiment travailler avec Docker, il suffit d’utiliser les fichiers Dockerfile et docker-compose.yml fournis, et construire le conteneur en utilisant la commande bash build_docker.sh . Vous pourrez ensuite l’exécuter avec la commande bash run_docker.sh .

À découvrir ici

Mis au point par Jeff Parsons qui a eu le plaisir de découvrir l’informatique dans les années 70/80, PCjs est un code en javascript qui est capable d’émuler toute une série de matos et de logiciels comme la calculatrice TI-57, le premier Space Invaders (1978), évidemment Multiplan d’IBM (1982), Windows 1.0 jusqu’à 95 ou encore des jeux comme Wolfenstein 3D (1992) ou Dune II (1992).

Cela va vous permettre de vive l’expérience de ces vieux coucous avec leurs CPU ultra pas rapides, des sons bippés à couper le souffle et leurs interfaces hautes en couleurs, tout ça sans avoir à quitter votre navigateur. Et oui car tout est accessible directement via ce site : https://www.pcjs.org .

L’idée évidemment est de préserver un petit peu de ce patrimoine informatique et logiciel et bien sûr de se faire plaisir sans galérer à retrouver de vieilles disquettes ou même un logiciel de virtualisation compatibles.

Voici tout ce que vous allez expérimenter sur PCjs :

• Calculatrice programmable TI-57 (1978)
• Ohio Scientific Challenger 1P (1978)
• Space Invaders (1978)
• Microsoft Adventure (1981)
• DONKEY.BAS de PC DOS 1.00 (1981)
• VisiCalc (1981)
• Multiplan 1.0 (1982)
• Executive Suite (1982)
• PDP-11/70 avec RT-11 4.0 (1982)
• CP/M-86 (1983)
• COMPAQ Portable avec graphiques monochromes (1983)
• Zork I: The Great Underground Empire
• Exploring the IBM Personal Computer (1983)
• Adventures in Math (1983)
• Lotus 1-2-3 (1983)
• Norton Utilities 2.0 (1983)
• Fantasy Land EGA Demo (1984)
• Microsoft Word 1.15 (1984)
• Nine Princes in Amber (1985)
• Rogue (1985)
• Microsoft Windows 1.0 (« Premiere Edition »)
• Microsoft Windows 1.1 sur CGA (1985)
• Microsoft Windows 1.1 sur EGA (1985)
• Balance of Power (1985)
• IBM OS/2 1.0 (1987)
• VGA Black Book Tests (par Michael Abrash)
• Microsoft Windows/386 2.0 (1987)
• Microsoft QuickPascal 1.00 (1989)
• Microsoft Windows 3.0 (1990)
• Life & Death II: The Brain (1990)
• The Oregon Trail (1990)
• Commander Keen (1991)
• Wolfenstein 3D (1992)
• Dune II (1992)
• Microsoft Windows 3.1 (1992)
• Microsoft Windows 95 (1995)

Toutes les sources du projet sont sur Github et vous pouvez contribuer. Chacune de ces machines est codée entièrement en javascript et utilisent un format XML qui défini les composants à activer ou non, donc vous pouvez aussi vous approprier le truc et créer vos propres machines assez simplement.