projscan 0.1.0__tar.gz

projscan-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,93 @@
+name: CI & Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  test-build-publish:
+    # To avoid infinite loops, skip this workflow if the commit message contains 'release v'
+    if: "!contains(github.event.head_commit.message, 'release v')"
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # to be able to push commit + tag
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0  # necessary to create / push tags properly
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python (from requires-python)
+        run: uv python install
+
+      - name: Install project
+        run: uv sync
+
+      - name: Detect version bump from commit message
+        id: bump
+        run: |
+          msg="${{ github.event.head_commit.message }}"
+          bump="none"
+
+          if echo "$msg" | grep -q "FIX"; then
+            bump="patch"
+          fi
+          if echo "$msg" | grep -q "MINOR"; then
+            bump="minor"
+          fi
+          if echo "$msg" | grep -q "MAJOR"; then
+            bump="major"
+          fi
+
+          echo "bump=$bump" >> "$GITHUB_OUTPUT"
+          echo "Bump type: $bump"
+
+      - name: Bump version with uv
+        if: steps.bump.outputs.bump != 'none'
+        id: bump_version
+        run: |
+          uv version --bump "${{ steps.bump.outputs.bump }}" --frozen
+
+          version=$(uv version --short)
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "New version: $version"
+
+      - name: Commit version bump and tag
+        if: steps.bump.outputs.bump != 'none'
+        env:
+          VERSION: ${{ steps.bump_version.outputs.version }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git add pyproject.toml
+          if [ -f uv.lock ]; then
+            git add uv.lock
+          fi
+
+          if git diff --cached --quiet; then
+            echo "No changes to commit"
+          else
+            git commit -m "release v$VERSION"
+            git tag "v$VERSION"
+            git push origin HEAD
+            git push origin "v$VERSION"
+          fi
+
+      - name: Build distributions
+        if: steps.bump.outputs.bump != 'none'
+        run: uv build
+
+      - name: Publish to PyPI
+        if: steps.bump.outputs.bump != 'none'
+        env:
+          # PyPI token (API token) stored in secret
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: uv publish

projscan-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.claude/
+
+# Virtual environments
+.venv

projscan-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

projscan-0.1.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: projscan
+Version: 0.1.0
+Summary: Scanner de dépôts git locaux et de tools uv installés.
+Requires-Python: >=3.11
+Requires-Dist: click>=8
+Requires-Dist: rich>=13
+Description-Content-Type: text/markdown
+
+# projscan
+
+Scanner de dépôts git locaux et de tools `uv` installés depuis git.  
+Répond à une question simple : **suis-je à jour ?**
+
+## Installation
+
+```bash
+uv tool install git+https://github.com/Caymaar/projscan.git
+```
+
+Ou en mode développement :
+
+```bash
+git clone ...
+cd projscan
+uv sync
+uv run projscan --help
+```
+
+## Commandes
+
+### `projscan repos [PATHS]...`
+
+Scanne récursivement un ou plusieurs dossiers et affiche l'état de chaque dépôt git.
+
+```
+╭──────────────────────┬─────────┬─────────┬─────────────────────┬────────┬────────────────────┬─────────────╮
+│ Nom                  │ Version │ Branche │ Statut              │ Commit │ Message            │ Quand       │
+├──────────────────────┼─────────┼─────────┼─────────────────────┼────────┼────────────────────┼─────────────┤
+│ mon-api              │ 2.1.0   │ main    │ en retard (↓3)      │ a4f2c1 │ fix: timeout retry │ 2 days ago  │
+│ mon-dashboard        │ 1.0.0   │ main    │ divergé (↓1 ↑2)     │ b8e3d9 │ feat: dark mode    │ 5 hours ago │
+│ projscan             │ 0.1.0   │ main    │ à jour              │ c1a2b3 │ initial commit     │ 1 hour ago  │
+╰──────────────────────┴─────────┴─────────┴─────────────────────┴────────┴────────────────────┴─────────────╯
+3 repos, 1 à jour, 2 à mettre à jour
+```
+
+**Options :**
+
+| Option | Description |
+|--------|-------------|
+| `--no-fetch` | Ne pas faire `git fetch` — utilise le cache local (rapide) |
+| `--depth INTEGER` | Profondeur max de récursion (défaut : 3) |
+| `--json` | Sortie JSON machine-readable |
+| `--concurrency INTEGER` | Scans parallèles (défaut : 16) |
+
+```bash
+# Scanne ~/code et ~/work
+projscan repos ~/code ~/work
+
+# Rapide, sans réseau
+projscan repos --no-fetch ~/code
+
+# Pipe JSON vers jq
+projscan repos --no-fetch --json ~/code | jq '.[] | select(.status != "à jour")'
+```
+
+### `projscan tools`
+
+Scanne les tools installés via `uv tool install git+https://...` et vérifie si des mises à jour sont disponibles (via `git ls-remote`, sans cloner).
+
+```
+╭────────────────┬─────────┬───────────────────────────────┬────────┬──────────┬───────────╮
+│ Nom            │ Version │ Source                        │ Ref    │ Commit   │ Statut    │
+├────────────────┼─────────┼───────────────────────────────┼────────┼──────────┼───────────┤
+│ mon-tool       │ 1.2.0   │ github.com/org/mon-tool.git   │ main   │ f10c2123 │ MAJ dispo │
+│ autre-tool     │ 0.9.1   │ github.com/org/autre-tool.git │ main   │ fc9e74c5 │ à jour    │
+╰────────────────┴─────────┴───────────────────────────────┴────────┴──────────┴───────────╯
+2 tools, 1 à jour, 1 à mettre à jour
+```
+
+**Options :**
+
+| Option | Description |
+|--------|-------------|
+| `--tool-dir PATH` | Racine des tools uv (détection auto par défaut) |
+| `--no-remote` | Liste locale sans vérifier les remotes |
+| `--json` | Sortie JSON machine-readable |
+
+```bash
+projscan tools
+projscan tools --no-remote --json
+projscan tools --tool-dir ~/.local/share/uv/tools
+```
+
+## Codes de sortie
+
+| Code | Signification |
+|------|---------------|
+| `0`  | Tout est à jour |
+| `1`  | Au moins un item à mettre à jour (ou en erreur) |
+| `2`  | Erreur d'exécution fatale |
+| `130` | Interruption clavier (Ctrl-C) |
+
+Utile en script ou en CI :
+
+```bash
+projscan repos --no-fetch ~/code || echo "Des repos sont en retard !"
+```
+
+## Couleurs de statut
+
+| Statut | Couleur | Signification |
+|--------|---------|---------------|
+| `à jour` | vert | Synchronisé avec l'upstream |
+| `en retard (↓N)` | rouge | N commits distants non récupérés |
+| `en avance (↑N)` | cyan | N commits locaux non poussés |
+| `divergé (↓N ↑M)` | magenta | Branches divergées |
+| `MAJ dispo` | jaune | Nouvelle version du tool disponible |
+| `pas d'upstream` | gris | Pas de tracking branch configurée |
+| `pas git` | gris | Tool installé depuis PyPI, pas git |
+| `inconnu` | gris | Remote inaccessible (offline, auth...) |
+| `erreur` | rouge gras | Erreur lors du scan |
+
+## Usage comme bibliothèque
+
+`projscan` est conçu pour être importé dans une app Textual ou tout autre code async.
+
+```python
+from pathlib import Path
+from projscan import scan_paths, scan_tools, RepoInfo, ToolInfo
+
+# Scanne des dépôts git
+repos: list[RepoInfo] = await scan_paths(
+    [Path("~/code")],
+    fetch=True,
+    max_depth=3,
+    concurrency=16,
+)
+
+for repo in repos:
+    print(f"{repo.name}: {repo.status}")
+
+# Scanne les tools uv
+tools: list[ToolInfo] = await scan_tools(check_remote=True)
+
+for tool in tools:
+    if tool.status == "MAJ dispo":
+        print(f"Update available: {tool.name}")
+```
+
+Les dataclasses exposent une méthode `.as_dict()` pour la sérialisation JSON :
+
+```python
+import json
+print(json.dumps([r.as_dict() for r in repos], ensure_ascii=False))
+```
+
+L'API publique complète :
+
+```python
+from projscan import (
+    # Git
+    RepoInfo, scan_paths, scan_repo, find_repos,
+    # UV tools
+    ToolInfo, scan_tools, scan_tool, uv_tool_dir,
+)
+```
+
+## Développement
+
+```bash
+uv sync
+uv run pytest           # 52 tests, ~5s
+uv run projscan repos . # test en réel
+uv run projscan tools   # test en réel
+```

projscan-0.1.0/README.md

@@ -0,0 +1,167 @@
+# projscan
+
+Scanner de dépôts git locaux et de tools `uv` installés depuis git.  
+Répond à une question simple : **suis-je à jour ?**
+
+## Installation
+
+```bash
+uv tool install git+https://github.com/Caymaar/projscan.git
+```
+
+Ou en mode développement :
+
+```bash
+git clone ...
+cd projscan
+uv sync
+uv run projscan --help
+```
+
+## Commandes
+
+### `projscan repos [PATHS]...`
+
+Scanne récursivement un ou plusieurs dossiers et affiche l'état de chaque dépôt git.
+
+```
+╭──────────────────────┬─────────┬─────────┬─────────────────────┬────────┬────────────────────┬─────────────╮
+│ Nom                  │ Version │ Branche │ Statut              │ Commit │ Message            │ Quand       │
+├──────────────────────┼─────────┼─────────┼─────────────────────┼────────┼────────────────────┼─────────────┤
+│ mon-api              │ 2.1.0   │ main    │ en retard (↓3)      │ a4f2c1 │ fix: timeout retry │ 2 days ago  │
+│ mon-dashboard        │ 1.0.0   │ main    │ divergé (↓1 ↑2)     │ b8e3d9 │ feat: dark mode    │ 5 hours ago │
+│ projscan             │ 0.1.0   │ main    │ à jour              │ c1a2b3 │ initial commit     │ 1 hour ago  │
+╰──────────────────────┴─────────┴─────────┴─────────────────────┴────────┴────────────────────┴─────────────╯
+3 repos, 1 à jour, 2 à mettre à jour
+```
+
+**Options :**
+
+| Option | Description |
+|--------|-------------|
+| `--no-fetch` | Ne pas faire `git fetch` — utilise le cache local (rapide) |
+| `--depth INTEGER` | Profondeur max de récursion (défaut : 3) |
+| `--json` | Sortie JSON machine-readable |
+| `--concurrency INTEGER` | Scans parallèles (défaut : 16) |
+
+```bash
+# Scanne ~/code et ~/work
+projscan repos ~/code ~/work
+
+# Rapide, sans réseau
+projscan repos --no-fetch ~/code
+
+# Pipe JSON vers jq
+projscan repos --no-fetch --json ~/code | jq '.[] | select(.status != "à jour")'
+```
+
+### `projscan tools`
+
+Scanne les tools installés via `uv tool install git+https://...` et vérifie si des mises à jour sont disponibles (via `git ls-remote`, sans cloner).
+
+```
+╭────────────────┬─────────┬───────────────────────────────┬────────┬──────────┬───────────╮
+│ Nom            │ Version │ Source                        │ Ref    │ Commit   │ Statut    │
+├────────────────┼─────────┼───────────────────────────────┼────────┼──────────┼───────────┤
+│ mon-tool       │ 1.2.0   │ github.com/org/mon-tool.git   │ main   │ f10c2123 │ MAJ dispo │
+│ autre-tool     │ 0.9.1   │ github.com/org/autre-tool.git │ main   │ fc9e74c5 │ à jour    │
+╰────────────────┴─────────┴───────────────────────────────┴────────┴──────────┴───────────╯
+2 tools, 1 à jour, 1 à mettre à jour
+```
+
+**Options :**
+
+| Option | Description |
+|--------|-------------|
+| `--tool-dir PATH` | Racine des tools uv (détection auto par défaut) |
+| `--no-remote` | Liste locale sans vérifier les remotes |
+| `--json` | Sortie JSON machine-readable |
+
+```bash
+projscan tools
+projscan tools --no-remote --json
+projscan tools --tool-dir ~/.local/share/uv/tools
+```
+
+## Codes de sortie
+
+| Code | Signification |
+|------|---------------|
+| `0`  | Tout est à jour |
+| `1`  | Au moins un item à mettre à jour (ou en erreur) |
+| `2`  | Erreur d'exécution fatale |
+| `130` | Interruption clavier (Ctrl-C) |
+
+Utile en script ou en CI :
+
+```bash
+projscan repos --no-fetch ~/code || echo "Des repos sont en retard !"
+```
+
+## Couleurs de statut
+
+| Statut | Couleur | Signification |
+|--------|---------|---------------|
+| `à jour` | vert | Synchronisé avec l'upstream |
+| `en retard (↓N)` | rouge | N commits distants non récupérés |
+| `en avance (↑N)` | cyan | N commits locaux non poussés |
+| `divergé (↓N ↑M)` | magenta | Branches divergées |
+| `MAJ dispo` | jaune | Nouvelle version du tool disponible |
+| `pas d'upstream` | gris | Pas de tracking branch configurée |
+| `pas git` | gris | Tool installé depuis PyPI, pas git |
+| `inconnu` | gris | Remote inaccessible (offline, auth...) |
+| `erreur` | rouge gras | Erreur lors du scan |
+
+## Usage comme bibliothèque
+
+`projscan` est conçu pour être importé dans une app Textual ou tout autre code async.
+
+```python
+from pathlib import Path
+from projscan import scan_paths, scan_tools, RepoInfo, ToolInfo
+
+# Scanne des dépôts git
+repos: list[RepoInfo] = await scan_paths(
+    [Path("~/code")],
+    fetch=True,
+    max_depth=3,
+    concurrency=16,
+)
+
+for repo in repos:
+    print(f"{repo.name}: {repo.status}")
+
+# Scanne les tools uv
+tools: list[ToolInfo] = await scan_tools(check_remote=True)
+
+for tool in tools:
+    if tool.status == "MAJ dispo":
+        print(f"Update available: {tool.name}")
+```
+
+Les dataclasses exposent une méthode `.as_dict()` pour la sérialisation JSON :
+
+```python
+import json
+print(json.dumps([r.as_dict() for r in repos], ensure_ascii=False))
+```
+
+L'API publique complète :
+
+```python
+from projscan import (
+    # Git
+    RepoInfo, scan_paths, scan_repo, find_repos,
+    # UV tools
+    ToolInfo, scan_tools, scan_tool, uv_tool_dir,
+)
+```
+
+## Développement
+
+```bash
+uv sync
+uv run pytest           # 52 tests, ~5s
+uv run projscan repos . # test en réel
+uv run projscan tools   # test en réel
+```

projscan-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "projscan"
+version = "0.1.0"
+description = "Scanner de dépôts git locaux et de tools uv installés."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "rich>=13",
+    "click>=8",
+]
+
+[project.scripts]
+projscan = "projscan.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/projscan"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

projscan-0.1.0/src/projscan/__init__.py

@@ -0,0 +1,26 @@
+"""projscan — scanner de dépôts git locaux et de tools uv installés.
+
+API publique importable depuis une app Textual ou tout autre code async :
+
+    from projscan import scan_paths, scan_tools, RepoInfo, ToolInfo
+
+    repos = await scan_paths([Path("~/code")], fetch=True)
+    tools = await scan_tools(check_remote=True)
+"""
+
+from __future__ import annotations
+
+from projscan.git import RepoInfo, scan_paths, scan_repo, find_repos
+from projscan.uv import ToolInfo, scan_tools, scan_tool, uv_tool_dir
+
+__all__ = [
+    "RepoInfo",
+    "scan_paths",
+    "scan_repo",
+    "find_repos",
+    "ToolInfo",
+    "scan_tools",
+    "scan_tool",
+    "uv_tool_dir",
+]
+__version__ = "0.1.0"