gyomu-python-analysis 0.5.0__tar.gz → 0.6.0__tar.gz

gyomu_python_analysis-0.6.0/.gyomu/concept/$Package.json

@@ -0,0 +1,37 @@
+{
+  "summary": "Gyomu Python Analysis is a comprehensive toolkit for statically analyzing Python projects, workspaces, and language constructs. It provides modular AST-based analyzers for examining classes, functions, types, Pydantic models, and expressions, alongside robust workspace initialization, configuration parsing, and project snapshot tracking capabilities.",
+  "responsibilities": [
+    "Analyze Python source code structures, language constructs, and metadata.",
+    "Manage project and workspace initialization, configuration parsing, and module loading contexts.",
+    "Create, diff, and manage project snapshots to track code modifications and changes over time.",
+    "Build symbol indexes, locations, and identity contexts from source code elements."
+  ],
+  "capabilities": [
+    {
+      "name": "Python Language Analysis",
+      "description": "Examines Python language constructs including classes, functions, variables, imports, dependencies, docstrings, type aliases, and Pydantic models."
+    },
+    {
+      "name": "AST Parsing and Indexing",
+      "description": "Parses Python Abstract Syntax Trees to analyze statements, expressions, and build symbol indexes and identities."
+    },
+    {
+      "name": "Workspace and Project Management",
+      "description": "Initializes project and workspace contexts, reads configurations, manages module loading, and handles caching."
+    },
+    {
+      "name": "Snapshot and Version Tracking",
+      "description": "Tracks file modifications, diffs changes between versions, and handles project snapshot creation, validation, and persistence."
+    }
+  ],
+  "design_decisions": [
+    "Employs modular AST-based analyzers to decompose Python language constructs into structured representations.",
+    "Maintains explicit project and workspace contexts to support multi-project configurations and source root resolution.",
+    "Utilizes snapshot tracking with file hashing and modification timestamps to detect and analyze project changes efficiently."
+  ],
+  "usage_guidance": [
+    "Use the workspace and project initialization modules to set up analysis contexts from project configurations.",
+    "Leverage the core analyzers and AST utilities to inspect Python source code constructs and extract symbol metadata.",
+    "Employ snapshot and diffing workflows to track modifications and analyze changes across project files."
+  ]
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/$Directory.json

@@ -0,0 +1,24 @@
+{
+  "summary": "Provides core Python analysis capabilities, including project and workspace initialization, configuration management, path conversion, custom error handling, and snapshot tracking workflows.",
+  "responsibilities": [
+    "Initialize project and workspace contexts, parse configurations, and manage file and module analysis.",
+    "Define custom error types and analysis phases for Python analysis operations.",
+    "Translate between various path formats including project-relative, source-relative, python, and full paths.",
+    "Manage project configurations and workspace structures.",
+    "Track file modifications, compute diffs, and handle snapshot creation, validation, and commit workflows."
+  ],
+  "concepts": [
+    "project analysis",
+    "configuration management",
+    "path conversion",
+    "error handling",
+    "project snapshot"
+  ],
+  "relationships": [
+    "Project and workspace contexts configure project analysis and snapshot management workflows."
+  ],
+  "design_decisions": [
+    "Modular structure organizing core analysis functions into domain-specific subpackages such as analysis, error, path, project, and snapshot."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/$Directory.json

@@ -0,0 +1,20 @@
+{
+  "summary": "Performs project and workspace initialization, reads project configurations, manages module loading, caching, and file analysis contexts.",
+  "responsibilities": [
+    "Initialize project contexts and parse project configurations from workspace structures, load and manage module and file analysis contexts, and delete module caches."
+  ],
+  "concepts": [
+    "project initialization",
+    "module loading and analysis",
+    "workspace configuration",
+    "file analysis context",
+    "cache management"
+  ],
+  "relationships": [
+    "Project initialization handles workspace configurations and source roots."
+  ],
+  "design_decisions": [
+    "Modular functions for project initialization, module loading, caching, workspace handling, and file context loading."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/analyzers/$Directory.json

@@ -0,0 +1,24 @@
+{
+  "summary": "Provides core analyzer modules for examining Python language constructs such as classes, functions, dependencies, docstrings, imports, Pydantic models, type aliases, types, and variables, along with symbol context management.",
+  "responsibilities": [
+    "Analyze Python classes, functions, dependencies, docstrings, imports, Pydantic models, type aliases, types, and variables, and manage symbol context and identity during code analysis."
+  ],
+  "concepts": [
+    "class analysis",
+    "function analysis",
+    "dependency analysis",
+    "docstring analysis",
+    "import analysis",
+    "pydantic analysis",
+    "type analysis",
+    "variable analysis",
+    "symbol context"
+  ],
+  "relationships": [
+    "Code analysis uses specialized analyzers for classes, functions, dependencies, docstrings, imports, pydantic models, type aliases, types, and variables alongside symbol context management."
+  ],
+  "design_decisions": [
+    "Modular analysis routines for specific Python code constructs and features"
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/analyzers/ast/$Directory.json

@@ -0,0 +1,18 @@
+{
+  "summary": "Provides AST-based code analysis capabilities, including functions to analyze Python statements and expressions as well as utilities for building symbol indexes.",
+  "responsibilities": [
+    "Provides functions to analyze statements, expressions, tuples, slices, sets, arrays, and dictionaries using Abstract Syntax Trees.",
+    "Builds class and function indexes and AST indexes from source code symbols."
+  ],
+  "concepts": [
+    "AST statement analysis",
+    "AST symbol indexing"
+  ],
+  "relationships": [
+    "Statement analysis and symbol indexing are components of AST-based code analysis."
+  ],
+  "design_decisions": [
+    "Organizes analysis routines into specialized modules for statements, expressions, and symbols."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/analyzers/expression/$Directory.json

@@ -0,0 +1,19 @@
+{
+  "summary": "Provides functions for analyzing various types of Python expressions, including constants, subscripts, dictionaries, arrays, literals, type expressions, tuples, sets, and expression names, alongside literal value parsing.",
+  "responsibilities": [
+    "analyze Python expressions including constants, subscripts, dictionaries, arrays, literals, type expressions, tuples, sets, and expression names",
+    "parse literal values"
+  ],
+  "concepts": [
+    "expression analysis",
+    "literal parsing",
+    "type expression analysis"
+  ],
+  "relationships": [
+    "analyze expression delegates to specific analyzers for constants, subscripts, dictionaries, arrays, literals, type expressions, tuples, sets, and expression names"
+  ],
+  "design_decisions": [
+    "modular expression analysis functions"
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/analyzers/internal/$Directory.json

@@ -0,0 +1,19 @@
+{
+  "summary": "Houses internal helper utilities supporting analysis functionality, specifically providing common building blocks, location calculation, and visibility determination for code analysis.",
+  "responsibilities": [
+    "Provide internal helper utilities for code analysis including calculating symbol locations, determining visibility, and building common components."
+  ],
+  "concepts": [
+    "internal analysis helpers",
+    "symbol location calculation",
+    "visibility calculation",
+    "common analyzer components"
+  ],
+  "relationships": [
+    "Internal analysis modules provide shared calculation utilities for location, visibility, and common metadata attributes."
+  ],
+  "design_decisions": [
+    "Internal module helper functions are grouped together to support analysis logic."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/extract/$Directory.json

@@ -0,0 +1,18 @@
+{
+  "summary": "Provides core symbol extraction capabilities and context management for analyzing Python source code.",
+  "responsibilities": [
+    "Extract symbols from Python code analysis.",
+    "Manage context used during symbol extraction."
+  ],
+  "concepts": [
+    "Symbol Extraction",
+    "Symbol Extract Context"
+  ],
+  "relationships": [
+    "SymbolExtractContext provides configuration and context for extract_symbols."
+  ],
+  "design_decisions": [
+    "Provides functional extraction logic operating within a specific context."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/file/$Directory.json

@@ -0,0 +1,12 @@
+{
+  "summary": "Provides file-level analysis context and source file representation for Python code analysis.",
+  "responsibilities": [
+    "Manage source file context for analysis"
+  ],
+  "concepts": [
+    "source file context"
+  ],
+  "relationships": [],
+  "design_decisions": [],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/analysis/parser/$Directory.json

@@ -0,0 +1,17 @@
+{
+  "summary": "The parser directory is responsible for analyzing and parsing code documentation, specifically providing docstring parsing capabilities for python analysis.",
+  "responsibilities": [
+    "Parse docstrings to extract analysis information"
+  ],
+  "concepts": [
+    "parser",
+    "docstring parser"
+  ],
+  "relationships": [
+    "DocstringParser provides docstring analysis functionality within the parser module."
+  ],
+  "design_decisions": [
+    "modular parsing organization"
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/error/$Directory.json

@@ -0,0 +1,17 @@
+{
+  "summary": "Provides error handling and analysis phase definitions for Python analysis operations, including custom exception types.",
+  "responsibilities": [
+    "Define error types and analysis phases for Python analysis operations."
+  ],
+  "concepts": [
+    "Python Analysis error",
+    "AnalysisPhase"
+  ],
+  "relationships": [
+    "AnalysisError incorporates or references AnalysisPhase to represent Python analysis errors."
+  ],
+  "design_decisions": [
+    "Defines custom error types and analysis phases for Python analysis operations."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/path/$Directory.json

@@ -0,0 +1,17 @@
+{
+  "summary": "Provides path conversion and manipulation utilities to translate between different path formats including project-relative paths, source-relative paths, python paths, and full paths.",
+  "responsibilities": [
+    "converts various path representations such as project-relative paths, source-relative paths, python paths, and full paths"
+  ],
+  "concepts": [
+    "path conversion",
+    "path manipulation"
+  ],
+  "relationships": [
+    "converts project-relative paths, source-relative paths, python paths, and full paths to each other using path conversion functions"
+  ],
+  "design_decisions": [
+    "provides functions to convert between project-relative paths, source-relative paths, python paths, and full paths"
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/project/$Directory.json

@@ -0,0 +1,21 @@
+{
+  "summary": "Manages project configuration, context, and workspace definitions, encapsulating settings parsed from configuration files and workspace structures.",
+  "responsibilities": [
+    "Manage project configuration settings parsed from pyproject.toml files.",
+    "Encapsulate project context including roots, configurations, and loaders.",
+    "Define workspace configurations, roots, and constituent projects."
+  ],
+  "concepts": [
+    "Project Context",
+    "Workspace Configuration",
+    "PyProject Config"
+  ],
+  "relationships": [
+    "ProjectContext encapsulates PyProjectConfig and project metadata.",
+    "WorkspaceContext contains WorkspaceConfig and WorkspaceProject instances."
+  ],
+  "design_decisions": [
+    "Encapsulates project context and workspace structures into object representations."
+  ],
+  "importance": "Core"
+}

gyomu_python_analysis-0.6.0/.gyomu/concept/src/gyomu_python_analysis/snapshot/$Directory.json

@@ -0,0 +1,25 @@
+{
+  "summary": "Manages project snapshots, tracking file modifications, diffing changes between snapshots, and handling snapshot creation, validation, and commit workflows.",
+  "responsibilities": [
+    "Create and manage project snapshots including target files, hashes, and modification timestamps.",
+    "Analyze, diff, and commit project changes by comparing snapshots.",
+    "Manage project snapshot workspaces and persistence."
+  ],
+  "concepts": [
+    "project snapshot",
+    "project changes",
+    "file snapshots",
+    "snapshot diff",
+    "snapshot workspace"
+  ],
+  "relationships": [
+    "Project changes analysis compares previous and current snapshots.",
+    "Diffing computes differences between previous and current project snapshots.",
+    "Committing validates the project snapshot and commits changes.",
+    "Creating a project snapshot enumerates target files and generates file snapshots."
+  ],
+  "design_decisions": [
+    "Exports functions for creating, validating, committing, analyzing, and diffing project snapshots."
+  ],
+  "importance": "Core"
+}

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gyomu-python-analysis
-Version: 0.5.0
+Version: 0.6.0
 Summary: Gyomu Python Analysis
 Author: Yoshihisa Matsumoto
 License-Expression: MIT

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/python_analysis_test_support/helpers.py

@@ -16,6 +16,11 @@ from gyomu_python_analysis.analysis.initialize import initialize_project_context
 from gyomu_python_analysis.analysis.load import load_module
 from gyomu_python_analysis.analysis.load_module import load_module_analysis
 from gyomu_python_analysis.project.context import ProjectContext, PyProjectConfig
+from gyomu_python_analysis.project.workspace import (
+    WorkspaceProject,
+    WorkspaceRoot,
+    WorkspaceRootKind,
+)
 from gyomu_python_analysis.snapshot.models import (
     AnalyzeProjectChangesResult,
 )
@@ -55,6 +60,23 @@ _default_project_config = PyProjectConfig(
     _toml_data={},
 )
 
+_default_workspace_path = WorkspaceRelativePath(Path("."))
+_default_pyproject = PyProjectConfig(
+    path=_default_workspace_path,
+    name="test",
+    description="",
+    formatter_line_length=88,
+    version="1.0",
+    _toml_data={},
+)
+
+
+def create_workspace_project(
+    path: WorkspaceRelativePath = _default_workspace_path,
+    config: PyProjectConfig = _default_pyproject,
+) -> WorkspaceProject:
+    return WorkspaceProject(path=path, config=config)
+
 
 def _create_context() -> ProjectContext:
     return initialize_project_context(
@@ -103,6 +125,12 @@ def create_project_snapshot(
     return ProjectSnapshot(project_root=project_root, files=files)
 
 
+def create_workspace_root(
+    path: FullPath, kind: WorkspaceRootKind = WorkspaceRootKind.UV_WORKSPACE
+) -> WorkspaceRoot:
+    return WorkspaceRoot(path=path, kind=kind)
+
+
 def create_analyze_project_change(
     current_snapshot: ProjectSnapshot,
     project_id: str = "ABC",

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/src/gyomu_python_analysis/analysis/analyzers/cls.py

@@ -239,7 +239,6 @@ def _build_class_method_analysis(
             context=context, member_path=new_member_path
         ),
         is_ellipsis_only=is_ellipsis_only,
-        statements=tuple(statements),
     )
 
 

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/src/gyomu_python_analysis/analysis/analyzers/functions.py

@@ -96,5 +96,4 @@ def analyze_function(
         return_type=return_type,
         identity=context.declaration,
         is_ellipsis_only=is_ellipsis_only,
-        statements=tuple(statements),
     )

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/src/gyomu_python_analysis/analysis/initialize.py

@@ -36,11 +36,16 @@ def initialize_project_from_workspace(
     files = find_included_python_files(
         project_root=project_root, source_root=source_root
     )
+    package_roots = find_package_roots(
+        project_root=project_root,
+        source_root=source_root,
+    )
     return ProjectContext(
         project_root=project_root,
         source_root=source_root,
         config=project.config,
         included_files=files,
+        package_roots=package_roots,
     )
 
 
@@ -92,6 +97,11 @@ def find_package_roots(
     project_root: FullPath,
     source_root: ProjectRelativePath,
 ) -> tuple[ProjectRelativePath, ...]:
+    """Find package root directories within the source root.
+
+    Find all package root directories containing an `__init__.py` file within the source
+    root.
+    """
     source_path = project_root / source_root
 
     return tuple(
@@ -127,13 +137,13 @@ def analyze_project_config(
     project_root: FullPath,
     toml_data: dict[str, Any],
     project_relative_path: WorkspaceRelativePath | None = None,
-    workspace_config: WorkspaceConfig | None = None,
+    workspace_config: PyProjectConfig | None = None,
 ) -> Result[PyProjectConfig, AnalysisError]:
     """Analyze the project configuration from parsed pyproject.toml data."""
 
     if project_relative_path is None:
         project_relative_path = WorkspaceRelativePath(Path("."))
-    project = toml_data["project"]
+    project = toml_data.get("project", {})
     name = project.get("name", "")
     description = project.get("description", None)
     is_version_dynamic = "dynamic" in project and "version" in project["dynamic"]

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/src/gyomu_python_analysis/analysis/workspace.py

@@ -10,7 +10,6 @@ from returns.result import Failure, Result, Success
 from gyomu_python_analysis.analysis.initialize import analyze_project_config
 from gyomu_python_analysis.error.analysis import AnalysisError
 from gyomu_python_analysis.project.workspace import (
-    WorkspaceConfig,
     WorkspaceContext,
     WorkspaceProject,
     WorkspaceRoot,
@@ -126,60 +125,6 @@ def is_uv_workspace(toml_data: dict[str, Any]) -> bool:
     )
 
 
-def initialize_workspace_config(
-    path: FullPath, toml_data: dict[str, Any]
-) -> Result[WorkspaceConfig, AnalysisError]:
-    """Initializes workspace configuration.
-
-    Initializes workspace configuration from pyproject.toml data.
-
-    Args:
-        path (FullPath): The path to the workspace root or project.
-        toml_data (dict[str, Any]): The parsed TOML data dictionary.
-
-    Returns:
-        Result[WorkspaceConfig, AnalysisError]: A Result containing the WorkspaceConfig
-            on success, or an AnalysisError on failure.
-    """
-    try:
-        name = None
-        description = None
-        if "project" in toml_data:
-            project = toml_data["project"]
-            name = project.get("name", None)
-            description = project.get("description", None)
-
-        formatter_line_length: int | None = None
-        tool = toml_data.get("tool")
-        if (
-            isinstance(tool, dict)
-            and isinstance(tool.get("ruff"), dict)
-            and "line-length" in tool["ruff"]
-        ):
-            formatter_line_length = int(tool["ruff"]["line-length"])
-
-        if formatter_line_length is None:
-            formatter_line_length = 88
-
-        return Success(
-            WorkspaceConfig(
-                path=path,
-                name=name,
-                description=description,
-                formatter_line_length=formatter_line_length,
-            )
-        )
-    except ValueError:
-        return Failure(
-            AnalysisError(
-                "fail to parse root pyproject.toml",
-                file_path=path,
-                phase="workspace-discovery",
-                context="gyomu_python_analysis.analysis.workspace.intialize_workspace_config",
-            )
-        )
-
-
 def get_uv_workspace_members(toml_data: dict[str, Any]) -> list[str]:
     """Retrieves member paths from a uv workspace configuration.
 
@@ -226,7 +171,7 @@ def initialize_workspace_context(
         return toml_result
 
     toml_data = toml_result.unwrap()
-    config_result = initialize_workspace_config(root.path, toml_data)
+    config_result = analyze_project_config(root.path, toml_data)
     if isinstance(config_result, Failure):
         return config_result
 
@@ -238,6 +183,7 @@ def initialize_workspace_context(
             return project_config_result
         return Success(
             WorkspaceContext(
+                path=root.path,
                 config=config_result.unwrap(),
                 projects=tuple(
                     [
@@ -281,6 +227,7 @@ def initialize_workspace_context(
             )
         return Success(
             WorkspaceContext(
+                path=root.path,
                 config=config_result.unwrap(),
                 projects=tuple(projects),
             )

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/src/gyomu_python_analysis/project/workspace.py

@@ -46,8 +46,12 @@ class WorkspaceContext:
     """
 
     def __init__(
-        self, config: WorkspaceConfig, projects: tuple[WorkspaceProject, ...]
+        self,
+        path: FullPath,
+        config: PyProjectConfig,
+        projects: tuple[WorkspaceProject, ...],
     ) -> None:
+        self.path = path
         self.config = config
         self.projects = projects
 

{gyomu_python_analysis-0.5.0 → gyomu_python_analysis-0.6.0}/tests/unit/analysis/test_initialize.py

@@ -269,6 +269,10 @@ class TestInitializeProjectFromWorkspace:
             "gyomu_python_analysis.analysis.initialize.resolve_source_root",
             return_value=ProjectRelativePath(Path("src")),
         )
+        mocker.patch(
+            "gyomu_python_analysis.analysis.initialize.find_package_roots",
+            return_value=tuple(),
+        )
 
         result = initialize_project_from_workspace(workspace, project)