Ismail Ben Alla

Coflow

Carte du code pour VS Code

Voyez comment votre code s’exécute.

Une carte zoomable à côté de votre éditeur, du système entier jusqu’à chaque ligne d’une fonction, calculée à partir du code lui-même.

Ou cherchez benisalla.coflow dans la vue Extensions (Ctrl+Shift+X).

La vue Système d'une application full-stack : le frontend React, la passerelle Traefik, le backend FastAPI, Postgres, Mailpit et Sentry, avec des connexions étiquetéesLa vue Système d'une application full-stack : le frontend React, la passerelle Traefik, le backend FastAPI, Postgres, Mailpit et Sentry, avec des connexions étiquetées
La vue Système d'une application full-stack : le frontend React, la passerelle Traefik, le backend FastAPI, Postgres, Mailpit et Sentry, avec des connexions étiquetées

Comment ça marche

Trois vues du même projet : partir de ce qui s’exécute, prendre du recul sur le système, puis descendre dans le code.

  1. Depuis main

    Partez de là où le programme démarre : le fichier qui lance tout. Chaque route, tâche et handler indique ce qui le déclenche, et en sélectionner un éclaire tout le chemin main → route → handler → base de données.

    La vue Depuis main : main en bas, routeurs, routes et handlers qui montent jusqu’à la base de donnéesLa vue Depuis main : main en bas, routeurs, routes et handlers qui montent jusqu’à la base de données
  2. Le système

    Prenez du recul sur l’architecture : applications, passerelle, services, workers, bases de données, files et services externes, lus depuis docker-compose, nginx, les frontends et les routes, avec chaque connexion étiquetée.

    La vue Système : clients, passerelle, services et stockages en niveaux, avec des connexions étiquetéesLa vue Système : clients, passerelle, services et stockages en niveaux, avec des connexions étiquetées
  3. Le code

    Double-cliquez pour entrer : un bloc, un package, un module, une classe, puis une fonction dessinée ligne par ligne comme un organigramme.

    Le niveau supérieur de la carte du code : frontend, backend, config, tests et monde extérieur, avec des requêtes HTTP et une route absenteLe niveau supérieur de la carte du code : frontend, backend, config, tests et monde extérieur, avec des requêtes HTTP et une route absente

Captures d’écran

Chaque capture suit le thème clair ou sombre de cette page, comme Coflow suit celui de VS Code.

Fonctionnalités

Démarrer en une minute

  1. Installer

    Cherchez Coflow dans la vue Extensions, ou installez-le depuis le VS Code Marketplace ou Open VSX.

  2. Ouvrir un projet

    Ouvrez un dossier contenant du code Python et faites-lui confiance quand VS Code le demande.

  3. Ouvrir la carte

    Appuyez sur Ctrl+Alt+M (Cmd+Alt+M sur macOS), ou cliquez sur l’icône de carte dans la barre de titre de l’éditeur.

  4. Entrer

    Double-cliquez sur une boîte pour y entrer, et appuyez sur Esc pour remonter d’un niveau.

Questions

Mon code quitte-t-il ma machine ?

Non. Coflow lit vos fichiers sur votre ordinateur et y dessine la carte. Il ne fait aucune requête réseau, n’envoie aucune télémétrie, ne demande aucun compte et n’utilise aucune IA. Voir la déclaration de confidentialité.

Quels langages sont pris en charge ?

Python aujourd’hui, avec les fichiers de configuration JSON. Pour la vue Système, Coflow lit aussi les fichiers docker-compose et nginx et repère les frontends du projet. D’autres langages sont prévus, JavaScript et TypeScript en premier.

Exécute-t-il mon code ?

L’analyse ne fait que lire votre code ; elle ne l’exécute jamais. Seul Record a Run… exécute le script ou le test que vous choisissez, avec votre propre interpréteur : c’est pourquoi Coflow demande un dossier approuvé.

Combien ça coûte ? Quelle licence ?

Coflow est gratuit et open source, sous licence MIT. Le code source est sur GitHub : https://github.com/benisalla/coflow

De quoi ai-je besoin ?

VS Code 1.100 ou plus récent et Python 3.10 ou plus récent. L’extension Python est facultative : Coflow ne s’en sert que pour trouver l’interpréteur que vous avez choisi.

Où signaler un bug ou demander une fonctionnalité ?

Par e-mail. La page d’assistance indique quoi joindre pour que ce soit corrigé vite.

Nouveautés

  1. 0.7.0Prochaine version

    • Vue Système : l’architecture du projet à partir de docker-compose, nginx, des frontends et des routes
    • Vue Depuis main : l’exploration part du fichier qui lance tout, avec les déclencheurs et les chemins complets
    • Mode focus : les connexions entrantes et sortantes de n’importe quelle boîte
  2. 0.6.0

    • Menu Options d’affichage : choisir ce que montre la carte
    • Disposer la carte à la main : glisser, aimanter, annuler, et un fichier de disposition à committer
    • Un nouveau look plus calme et des cartes mieux organisées
  3. 0.5.0

    • Renommé de Code Flow Map en Coflow (identifiant benisalla.coflow)

Journal des modifications complet sur le VS Code Marketplace →