sourcecode 0.1.0__tar.gz → 0.1.1__tar.gz

sourcecode-0.1.1/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.14 (atlas-cli)" />
+  </component>
+</project>

{sourcecode-0.1.0 → sourcecode-0.1.1}/.idea/workspace.xml

@@ -4,7 +4,9 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="3ce338cc-0a87-4502-b7fb-184c5490bd47" name="Changes" comment="" />
+    <list default="true" id="3ce338cc-0a87-4502-b7fb-184c5490bd47" name="Changes" comment="">
+      <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+    </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />

{sourcecode-0.1.0 → sourcecode-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 0.1.0
+Version: 0.1.1
 Summary: Genera un mapa de contexto estructurado de proyectos de software para agentes IA
 License: MIT
 Requires-Python: >=3.9
@@ -16,61 +16,61 @@ Description-Content-Type: text/markdown
 
 # sourcecode
 
-`sourcecode` genera un mapa de contexto estructurado de un proyecto de software para que un agente pueda entender rapido su stack, puntos de entrada y forma del repositorio.
+`sourcecode` generates a structured project context map so an agent can quickly understand a repository's stack, entry points, and overall shape.
 
-## Instalacion
+## Installation
 
 ```bash
 pip install sourcecode
 ```
 
-Requiere Python `3.9+`.
+Requires Python `3.9+`.
 
-## Uso rapido
+## Quick Start
 
-Analizar el directorio actual en JSON:
+Analyze the current directory as JSON:
 
 ```bash
 sourcecode .
 ```
 
-Generar una vista compacta para prompts o handoff:
+Generate a compact view for prompts or handoff:
 
 ```bash
 sourcecode --compact .
 ```
 
-Analizar otro directorio y escribir YAML a fichero:
+Analyze another directory and write YAML to a file:
 
 ```bash
-sourcecode --format yaml --output sourcecode.yaml /ruta/al/proyecto
+sourcecode --format yaml --output sourcecode.yaml /path/to/project
 ```
 
-Mostrar version:
+Show the version:
 
 ```bash
 sourcecode --version
 ```
 
-Opciones principales:
+Main options:
 
-- `--format json|yaml`: formato de salida.
-- `--output PATH`: escribe a fichero en vez de `stdout`.
-- `--compact`: devuelve una vista reducida con `schema_version`, `project_type`, `stacks`, `entry_points` y `file_tree_depth1`.
-- `--depth INTEGER`: profundidad maxima del arbol de ficheros.
-- `--no-redact`: desactiva la redaccion de secretos.
+- `--format json|yaml`: output format.
+- `--output PATH`: write to a file instead of `stdout`.
+- `--compact`: return a reduced view with `schema_version`, `project_type`, `stacks`, `entry_points`, and `file_tree_depth1`.
+- `--depth INTEGER`: maximum file tree depth.
+- `--no-redact`: disable secret redaction.
 
-## Que detecta
+## What It Detects
 
-- Stacks: Node.js, Python, Go, Rust, Java, PHP, Ruby y Dart.
-- Frameworks asociados al stack cuando hay senales suficientes.
-- `project_type`: `webapp`, `api`, `library`, `cli`, `fullstack`, `monorepo` o `unknown`.
-- `entry_points` relevantes, como `main.py`, `cmd/api/main.go` o `app/page.tsx`.
-- Workspaces y roots por stack en repos multi-stack o monorepo.
+- Stacks: Node.js, Python, Go, Rust, Java, PHP, Ruby, and Dart.
+- Frameworks associated with each stack when enough signals are present.
+- `project_type`: `webapp`, `api`, `library`, `cli`, `fullstack`, `monorepo`, or `unknown`.
+- Relevant `entry_points`, such as `main.py`, `cmd/api/main.go`, or `app/page.tsx`.
+- Workspace roots in multi-stack or monorepo repositories.
 
-## Ejemplo compacto
+## Compact Example
 
-Salida real de un fixture Next.js:
+Real output from a Next.js fixture:
 
 ```json
 {
@@ -115,9 +115,9 @@ Salida real de un fixture Next.js:
 }
 ```
 
-## Ejemplo monorepo
+## Monorepo Example
 
-En un monorepo, cada stack incluye su `root` y `workspace`, y uno de ellos queda marcado como `primary`.
+In a monorepo, each stack includes its own `root` and `workspace`, and one of them is marked as `primary`.
 
 ```json
 {
@@ -145,25 +145,25 @@ En un monorepo, cada stack incluye su `root` y `workspace`, y uno de ellos queda
 
 ## Output
 
-El schema completo incluye:
+The full schema includes:
 
-- `metadata`: version de schema, timestamp, version de `sourcecode` y ruta analizada.
-- `file_tree`: arbol del repositorio donde `null` representa un fichero y un objeto representa un directorio.
-- `stacks`: detecciones por ecosistema con confianza, frameworks, manifests, `primary`, `root`, `workspace` y `signals`.
-- `project_type`: clasificacion general del proyecto.
-- `entry_points`: entradas detectadas por stack.
+- `metadata`: schema version, timestamp, `sourcecode` version, and analyzed path.
+- `file_tree`: repository tree where `null` represents a file and an object represents a directory.
+- `stacks`: stack detections with confidence, frameworks, manifests, `primary`, `root`, `workspace`, and `signals`.
+- `project_type`: overall project classification.
+- `entry_points`: detected entry points by stack.
 
-La referencia detallada esta en [docs/schema.md](/Users/user/Documents/workspace/atlas/atlas-cli/docs/schema.md).
+Detailed reference: [docs/schema.md](/Users/user/Documents/workspace/atlas/atlas-cli/docs/schema.md).
 
-## Desarrollo
+## Development
 
-Instalacion editable con dependencias de desarrollo:
+Editable install with development dependencies:
 
 ```bash
 pip install -e ".[dev]"
 ```
 
-Validacion local:
+Local validation:
 
 ```bash
 ruff check src tests

sourcecode-0.1.1/README.md

@@ -0,0 +1,156 @@
+# sourcecode
+
+`sourcecode` generates a structured project context map so an agent can quickly understand a repository's stack, entry points, and overall shape.
+
+## Installation
+
+```bash
+pip install sourcecode
+```
+
+Requires Python `3.9+`.
+
+## Quick Start
+
+Analyze the current directory as JSON:
+
+```bash
+sourcecode .
+```
+
+Generate a compact view for prompts or handoff:
+
+```bash
+sourcecode --compact .
+```
+
+Analyze another directory and write YAML to a file:
+
+```bash
+sourcecode --format yaml --output sourcecode.yaml /path/to/project
+```
+
+Show the version:
+
+```bash
+sourcecode --version
+```
+
+Main options:
+
+- `--format json|yaml`: output format.
+- `--output PATH`: write to a file instead of `stdout`.
+- `--compact`: return a reduced view with `schema_version`, `project_type`, `stacks`, `entry_points`, and `file_tree_depth1`.
+- `--depth INTEGER`: maximum file tree depth.
+- `--no-redact`: disable secret redaction.
+
+## What It Detects
+
+- Stacks: Node.js, Python, Go, Rust, Java, PHP, Ruby, and Dart.
+- Frameworks associated with each stack when enough signals are present.
+- `project_type`: `webapp`, `api`, `library`, `cli`, `fullstack`, `monorepo`, or `unknown`.
+- Relevant `entry_points`, such as `main.py`, `cmd/api/main.go`, or `app/page.tsx`.
+- Workspace roots in multi-stack or monorepo repositories.
+
+## Compact Example
+
+Real output from a Next.js fixture:
+
+```json
+{
+  "schema_version": "1.0",
+  "project_type": "webapp",
+  "stacks": [
+    {
+      "stack": "nodejs",
+      "detection_method": "manifest",
+      "confidence": "high",
+      "frameworks": [
+        { "name": "Next.js", "source": "package.json" },
+        { "name": "React", "source": "package.json" }
+      ],
+      "package_manager": "pnpm",
+      "manifests": ["package.json"],
+      "primary": true,
+      "root": ".",
+      "workspace": null,
+      "signals": [
+        "manifest:package.json",
+        "framework:Next.js",
+        "framework:React",
+        "package_manager:pnpm",
+        "entry:app/page.tsx"
+      ]
+    }
+  ],
+  "entry_points": [
+    {
+      "path": "app/page.tsx",
+      "stack": "nodejs",
+      "kind": "web",
+      "source": "package.json"
+    }
+  ],
+  "file_tree_depth1": {
+    "pnpm-lock.yaml": null,
+    "package.json": null,
+    "app": {}
+  }
+}
+```
+
+## Monorepo Example
+
+In a monorepo, each stack includes its own `root` and `workspace`, and one of them is marked as `primary`.
+
+```json
+{
+  "project_type": "monorepo",
+  "stacks": [
+    {
+      "stack": "nodejs",
+      "primary": true,
+      "root": "apps/web",
+      "workspace": "apps/web"
+    },
+    {
+      "stack": "python",
+      "primary": false,
+      "root": "packages/api",
+      "workspace": "packages/api"
+    }
+  ],
+  "entry_points": [
+    { "path": "apps/web/app/page.tsx", "stack": "nodejs", "kind": "web" },
+    { "path": "packages/api/main.py", "stack": "python", "kind": "cli" }
+  ]
+}
+```
+
+## Output
+
+The full schema includes:
+
+- `metadata`: schema version, timestamp, `sourcecode` version, and analyzed path.
+- `file_tree`: repository tree where `null` represents a file and an object represents a directory.
+- `stacks`: stack detections with confidence, frameworks, manifests, `primary`, `root`, `workspace`, and `signals`.
+- `project_type`: overall project classification.
+- `entry_points`: detected entry points by stack.
+
+Detailed reference: [docs/schema.md](/Users/user/Documents/workspace/atlas/atlas-cli/docs/schema.md).
+
+## Development
+
+Editable install with development dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Local validation:
+
+```bash
+ruff check src tests
+mypy src
+pytest -q
+```

{sourcecode-0.1.0 → sourcecode-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "0.1.0"
+version = "0.1.1"
 description = "Genera un mapa de contexto estructurado de proyectos de software para agentes IA"
 readme = "README.md"
 requires-python = ">=3.9"

sourcecode-0.1.0/README.md

@@ -1,156 +0,0 @@
-# sourcecode
-
-`sourcecode` genera un mapa de contexto estructurado de un proyecto de software para que un agente pueda entender rapido su stack, puntos de entrada y forma del repositorio.
-
-## Instalacion
-
-```bash
-pip install sourcecode
-```
-
-Requiere Python `3.9+`.
-
-## Uso rapido
-
-Analizar el directorio actual en JSON:
-
-```bash
-sourcecode .
-```
-
-Generar una vista compacta para prompts o handoff:
-
-```bash
-sourcecode --compact .
-```
-
-Analizar otro directorio y escribir YAML a fichero:
-
-```bash
-sourcecode --format yaml --output sourcecode.yaml /ruta/al/proyecto
-```
-
-Mostrar version:
-
-```bash
-sourcecode --version
-```
-
-Opciones principales:
-
-- `--format json|yaml`: formato de salida.
-- `--output PATH`: escribe a fichero en vez de `stdout`.
-- `--compact`: devuelve una vista reducida con `schema_version`, `project_type`, `stacks`, `entry_points` y `file_tree_depth1`.
-- `--depth INTEGER`: profundidad maxima del arbol de ficheros.
-- `--no-redact`: desactiva la redaccion de secretos.
-
-## Que detecta
-
-- Stacks: Node.js, Python, Go, Rust, Java, PHP, Ruby y Dart.
-- Frameworks asociados al stack cuando hay senales suficientes.
-- `project_type`: `webapp`, `api`, `library`, `cli`, `fullstack`, `monorepo` o `unknown`.
-- `entry_points` relevantes, como `main.py`, `cmd/api/main.go` o `app/page.tsx`.
-- Workspaces y roots por stack en repos multi-stack o monorepo.
-
-## Ejemplo compacto
-
-Salida real de un fixture Next.js:
-
-```json
-{
-  "schema_version": "1.0",
-  "project_type": "webapp",
-  "stacks": [
-    {
-      "stack": "nodejs",
-      "detection_method": "manifest",
-      "confidence": "high",
-      "frameworks": [
-        { "name": "Next.js", "source": "package.json" },
-        { "name": "React", "source": "package.json" }
-      ],
-      "package_manager": "pnpm",
-      "manifests": ["package.json"],
-      "primary": true,
-      "root": ".",
-      "workspace": null,
-      "signals": [
-        "manifest:package.json",
-        "framework:Next.js",
-        "framework:React",
-        "package_manager:pnpm",
-        "entry:app/page.tsx"
-      ]
-    }
-  ],
-  "entry_points": [
-    {
-      "path": "app/page.tsx",
-      "stack": "nodejs",
-      "kind": "web",
-      "source": "package.json"
-    }
-  ],
-  "file_tree_depth1": {
-    "pnpm-lock.yaml": null,
-    "package.json": null,
-    "app": {}
-  }
-}
-```
-
-## Ejemplo monorepo
-
-En un monorepo, cada stack incluye su `root` y `workspace`, y uno de ellos queda marcado como `primary`.
-
-```json
-{
-  "project_type": "monorepo",
-  "stacks": [
-    {
-      "stack": "nodejs",
-      "primary": true,
-      "root": "apps/web",
-      "workspace": "apps/web"
-    },
-    {
-      "stack": "python",
-      "primary": false,
-      "root": "packages/api",
-      "workspace": "packages/api"
-    }
-  ],
-  "entry_points": [
-    { "path": "apps/web/app/page.tsx", "stack": "nodejs", "kind": "web" },
-    { "path": "packages/api/main.py", "stack": "python", "kind": "cli" }
-  ]
-}
-```
-
-## Output
-
-El schema completo incluye:
-
-- `metadata`: version de schema, timestamp, version de `sourcecode` y ruta analizada.
-- `file_tree`: arbol del repositorio donde `null` representa un fichero y un objeto representa un directorio.
-- `stacks`: detecciones por ecosistema con confianza, frameworks, manifests, `primary`, `root`, `workspace` y `signals`.
-- `project_type`: clasificacion general del proyecto.
-- `entry_points`: entradas detectadas por stack.
-
-La referencia detallada esta en [docs/schema.md](/Users/user/Documents/workspace/atlas/atlas-cli/docs/schema.md).
-
-## Desarrollo
-
-Instalacion editable con dependencias de desarrollo:
-
-```bash
-pip install -e ".[dev]"
-```
-
-Validacion local:
-
-```bash
-ruff check src tests
-mypy src
-pytest -q
-```