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

gyomu_python_analysis-0.5.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.5
+Name: gyomu-python-analysis
+Version: 0.5.0
+Summary: Gyomu Python Analysis
+Author: Yoshihisa Matsumoto
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.13
+Requires-Dist: docstring-parser>=0.18.0
+Requires-Dist: griffelib>=2.2.0
+Requires-Dist: gyomu-infra
+Requires-Dist: gyomu-schema
+Requires-Dist: pydantic
+Requires-Dist: returns
+Description-Content-Type: text/markdown
+
+# gyomu-python-analysis
+
+python analysis components for Gyomu Python.

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/pyproject.toml

@@ -12,6 +12,19 @@ dependencies = [
     "griffelib>=2.2.0",
     "docstring-parser>=0.18.0",
 ]
+license = "MIT"
+authors = [
+    { name = "Yoshihisa Matsumoto" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
 
 [build-system]
 requires = ["hatchling"]

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

@@ -18,12 +18,6 @@ from gyomu_python_analysis.analysis.load_module import load_module_analysis
 from gyomu_python_analysis.project.context import ProjectContext, PyProjectConfig
 from gyomu_python_analysis.snapshot.models import (
     AnalyzeProjectChangesResult,
-    FileAdded,
-    FileChange,
-    FileDeleted,
-    FileSnapshot,
-    FileUpdated,
-    ProjectSnapshot,
 )
 from gyomu_schema.schemas.python.class_analysis import ClassAnalysis
 from gyomu_schema.schemas.python.function_analysis import FunctionAnalysis
@@ -36,6 +30,14 @@ from gyomu_schema.schemas.python.types import (
     WorkspaceRelativePath,
 )
 from gyomu_schema.schemas.python.variable import VariableAnalysis
+from gyomu_schema.schemas.snapshot.types import (
+    FileAdded,
+    FileChange,
+    FileDeleted,
+    FileSnapshot,
+    FileUpdated,
+    ProjectSnapshot,
+)
 from gyomu_schema.schemas.types import FullPath
 from returns.result import Failure
 

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

@@ -71,16 +71,36 @@ def initialize_project_context(
     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 Success(
         ProjectContext(
             project_root=project_root,
             source_root=source_root,
             config=config_result.unwrap(),
             included_files=files,
+            package_roots=package_roots,
         )
     )
 
 
+def find_package_roots(
+    project_root: FullPath,
+    source_root: ProjectRelativePath,
+) -> tuple[ProjectRelativePath, ...]:
+    source_path = project_root / source_root
+
+    return tuple(
+        ProjectRelativePath(path.relative_to(project_root))
+        for path in sorted(source_path.iterdir(), key=lambda path: path.name)
+        if path.is_dir() and (path / "__init__.py").is_file()
+    )
+
+
 def find_included_python_files(
     project_root: FullPath, source_root: ProjectRelativePath
 ) -> frozenset[ProjectRelativePath]:

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/src/gyomu_python_analysis/project/context.py

@@ -109,6 +109,7 @@ class ProjectContext:
         source_root: ProjectRelativePath,
         config: PyProjectConfig,
         included_files: frozenset[ProjectRelativePath] = frozenset(),
+        package_roots: tuple[ProjectRelativePath, ...] = tuple(),
     ) -> None:
         self.project_root = project_root
         self.source_root = source_root
@@ -118,3 +119,4 @@ class ProjectContext:
         )
         self.config = config
         self.included_files = included_files
+        self.package_roots = package_roots

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/src/gyomu_python_analysis/snapshot/analyze.py

@@ -1,5 +1,6 @@
 from gyomu_infra.filesystem.file_io import read_json
 from gyomu_schema.schemas.python.types import WorkspaceRelativePath
+from gyomu_schema.schemas.snapshot.types import ProjectSnapshot
 from gyomu_schema.schemas.types import FullPath
 from returns.result import Failure, Result, Success
 
@@ -9,7 +10,6 @@ from gyomu_python_analysis.snapshot.create import create_snapshot
 from gyomu_python_analysis.snapshot.diff import diff_snapshot
 from gyomu_python_analysis.snapshot.models import (
     AnalyzeProjectChangesResult,
-    ProjectSnapshot,
 )
 from gyomu_python_analysis.snapshot.project import ensure_project_workspace
 

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/src/gyomu_python_analysis/snapshot/commit.py

@@ -3,6 +3,7 @@ from collections import Counter
 from gyomu_infra.filesystem.file_io import write_json
 from gyomu_infra.logger import logger
 from gyomu_schema.schemas.python.types import WorkspaceRelativePath
+from gyomu_schema.schemas.snapshot.types import ProjectSnapshot
 from gyomu_schema.schemas.types import FullPath
 from returns.result import Failure, Result
 
@@ -10,7 +11,6 @@ from gyomu_python_analysis.error.analysis import AnalysisError
 from gyomu_python_analysis.project.context import ProjectContext
 from gyomu_python_analysis.snapshot.create import create_snapshot
 from gyomu_python_analysis.snapshot.diff import diff_snapshot
-from gyomu_python_analysis.snapshot.models import ProjectSnapshot
 from gyomu_python_analysis.snapshot.project import ensure_project_workspace
 
 

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/src/gyomu_python_analysis/snapshot/create.py

@@ -5,12 +5,12 @@ from gyomu_infra.filesystem.file_search import FileSearch
 from gyomu_infra.hash.hash import hash_file
 from gyomu_schema.filesystem.file import FileCompareType, FileFilterInfo, FileFilterType
 from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
+from gyomu_schema.schemas.snapshot.types import FileSnapshot, ProjectSnapshot
 from gyomu_schema.schemas.types import FullPath
 from returns.result import Failure, Result, Success
 
 from gyomu_python_analysis.error.analysis import AnalysisError
 from gyomu_python_analysis.project.context import ProjectContext
-from gyomu_python_analysis.snapshot.models import FileSnapshot, ProjectSnapshot
 
 
 def create_snapshot(

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/src/gyomu_python_analysis/snapshot/diff.py

@@ -1,6 +1,5 @@
 from gyomu_schema.schemas.python.types import ProjectRelativePath
-
-from gyomu_python_analysis.snapshot.models import (
+from gyomu_schema.schemas.snapshot.types import (
     FileAdded,
     FileChange,
     FileDeleted,

gyomu_python_analysis-0.5.0/src/gyomu_python_analysis/snapshot/models.py

@@ -0,0 +1,27 @@
+from dataclasses import dataclass
+
+from gyomu_schema.schemas.snapshot.types import FileChange, ProjectSnapshot
+from gyomu_schema.schemas.types import FullPath
+
+
+@dataclass
+class AnalyzeProjectChangesResult:
+    """Represents the result of analyzing project changes, containing project
+    identification, snapshot paths, previous and current snapshots, and file
+    differences.
+    """
+
+    project_id: str
+    """The identifier of the analyzed project."""
+
+    snapshot_path: FullPath
+    """The full path to the snapshot storage or record."""
+
+    previous_snapshot: ProjectSnapshot | None
+    """The previous project snapshot, or None if this is the initial snapshot."""
+
+    current_snapshot: ProjectSnapshot
+    """The current project snapshot."""
+
+    diff: tuple[FileChange, ...]
+    """A tuple of file changes detected between the previous and current snapshots."""

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

@@ -3,6 +3,7 @@ from pathlib import Path
 import pytest
 from gyomu_python_analysis.analysis.initialize import (
     find_included_python_files,
+    find_package_roots,
     initialize_project_context,
     initialize_project_from_workspace,
     read_version,
@@ -87,10 +88,7 @@ class TestFindIncludedPythonFiles:
 
 
 class TestInitializeProjectContext:
-    def test_initialize_project_context(
-        self,
-        tmp_path: Path,
-    ) -> None:
+    def test_initialize_project_context(self, tmp_path: Path, mocker) -> None:
         source_root = tmp_path / "src"
 
         pyproject = """\
@@ -118,6 +116,14 @@ class TestInitializeProjectContext:
             encoding="utf-8",
         )
 
+        mocker.patch(
+            "gyomu_python_analysis.analysis.initialize.find_package_roots",
+            return_value=(
+                ProjectRelativePath(Path("a")),
+                ProjectRelativePath(Path("b")),
+            ),
+        )
+
         result = initialize_project_context(
             FullPath(tmp_path),
             ProjectRelativePath(Path("src")),
@@ -137,6 +143,10 @@ class TestInitializeProjectContext:
                 ProjectRelativePath(Path("src/example/foo.py")),
             }
         )
+        assert context.package_roots == (
+            ProjectRelativePath(Path("a")),
+            ProjectRelativePath(Path("b")),
+        )
 
     def test_initialize_project_context_with_hatch_dynamic_version(
         self,
@@ -307,6 +317,13 @@ class TestInitializeProjectFromWorkspace:
             "gyomu_python_analysis.analysis.initialize.find_included_python_files",
             return_value=frozenset(),
         )
+        mocker.patch(
+            "gyomu_python_analysis.analysis.initialize.find_package_roots",
+            return_value=(
+                ProjectRelativePath(Path("a")),
+                ProjectRelativePath(Path("b")),
+            ),
+        )
 
         result = initialize_project_context(
             project_root=project_root,
@@ -331,3 +348,63 @@ class TestInitializeProjectFromWorkspace:
             "src/generated",
             "tests/resources",
         ]
+
+
+class TestFindPackageRoots:
+    def test_find_roots(
+        self,
+        tmp_path: Path,
+    ) -> None:
+        # fixture:
+        #
+        # src/
+        #   package_a/
+        #       __init__.py
+        #   package_b/
+        #       __init__.py
+        #   not_package/
+        #       module.py
+        #
+        project_root = tmp_path
+        source_root = ProjectRelativePath(Path("src"))
+
+        (project_root / "src" / "package_a").mkdir(parents=True)
+        (project_root / "src" / "package_a" / "__init__.py").touch()
+
+        (project_root / "src" / "package_b").mkdir(parents=True)
+        (project_root / "src" / "package_b" / "__init__.py").touch()
+
+        (project_root / "src" / "not_package").mkdir(parents=True)
+        (project_root / "src" / "not_package" / "module.py").touch()
+
+        result = find_package_roots(
+            project_root=FullPath(project_root),
+            source_root=source_root,
+        )
+
+        assert result == (
+            ProjectRelativePath(Path("src/package_a")),
+            ProjectRelativePath(Path("src/package_b")),
+        )
+
+    def test_does_not_include_nested_packages(
+        self,
+        tmp_path: Path,
+    ) -> None:
+        project_root = FullPath(tmp_path)
+        source_root = ProjectRelativePath(Path("src"))
+
+        package = project_root / "src" / "package"
+        package.mkdir(parents=True)
+        (package / "__init__.py").touch()
+
+        nested_package = package / "nested"
+        nested_package.mkdir()
+        (nested_package / "__init__.py").touch()
+
+        result = find_package_roots(
+            project_root=project_root,
+            source_root=source_root,
+        )
+
+        assert result == (ProjectRelativePath(Path("src/package")),)

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/tests/unit/snapshot/test_commit.py

@@ -3,15 +3,15 @@ from pathlib import Path
 
 from gyomu_python_analysis.error.analysis import AnalysisError
 from gyomu_python_analysis.snapshot.commit import commit_project_changes
-from gyomu_python_analysis.snapshot.models import (
+from gyomu_schema.error.io import GyomuIOError, IOLayer, IOOperation
+from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
+from gyomu_schema.schemas.snapshot.types import (
     FileAdded,
     FileDeleted,
     FileSnapshot,
     FileUpdated,
     ProjectSnapshot,
 )
-from gyomu_schema.error.io import GyomuIOError, IOLayer, IOOperation
-from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
 from gyomu_schema.schemas.types import FullPath
 from returns.result import Failure, Success
 

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/tests/unit/snapshot/test_create.py

@@ -9,9 +9,12 @@ from gyomu_python_analysis.snapshot.create import (
     create_snapshot,
     enumerate_target_files,
 )
-from gyomu_python_analysis.snapshot.models import FileSnapshot, ProjectSnapshot
 from gyomu_schema.error.io import GyomuIOError, IOLayer, IOOperation
 from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
+from gyomu_schema.schemas.snapshot.types import (
+    FileSnapshot,
+    ProjectSnapshot,
+)
 from gyomu_schema.schemas.types import FullPath
 from returns.result import Failure, Success
 

{gyomu_python_analysis-0.4.0 → gyomu_python_analysis-0.5.0}/tests/unit/snapshot/test_diff.py

@@ -2,14 +2,14 @@ from datetime import UTC, datetime
 from pathlib import Path
 
 from gyomu_python_analysis.snapshot.diff import diff_snapshot
-from gyomu_python_analysis.snapshot.models import (
+from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
+from gyomu_schema.schemas.snapshot.types import (
     FileAdded,
     FileDeleted,
     FileSnapshot,
     FileUpdated,
     ProjectSnapshot,
 )
-from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
 
 PROJECT_ROOT = WorkspaceRelativePath(Path("packages/example"))
 

gyomu_python_analysis-0.4.0/PKG-INFO

@@ -1,16 +0,0 @@
-Metadata-Version: 2.5
-Name: gyomu-python-analysis
-Version: 0.4.0
-Summary: Gyomu Python Analysis
-Requires-Python: >=3.13
-Requires-Dist: docstring-parser>=0.18.0
-Requires-Dist: griffelib>=2.2.0
-Requires-Dist: gyomu-infra
-Requires-Dist: gyomu-schema
-Requires-Dist: pydantic
-Requires-Dist: returns
-Description-Content-Type: text/markdown
-
-# gyomu-python-analysis
-
-python analysis components for Gyomu Python.

gyomu_python_analysis-0.4.0/src/gyomu_python_analysis/snapshot/models.py

@@ -1,103 +0,0 @@
-from dataclasses import dataclass
-from datetime import datetime
-from typing import Literal
-
-from gyomu_schema.schemas.python.types import ProjectRelativePath, WorkspaceRelativePath
-from gyomu_schema.schemas.types import FullPath
-from pydantic import BaseModel
-
-
-class FileSnapshot(BaseModel):
-    """Represents a snapshot of an individual file containing its relative path,
-    content hash, and modification timestamp.
-    """
-
-    project_relative_path: ProjectRelativePath
-    """The project-relative path of the file."""
-
-    raw_hash: str
-    """The raw content hash of the file."""
-
-    modified_at: datetime
-    """The timestamp when the file was last modified."""
-
-
-class ProjectSnapshot(BaseModel):
-    """Represents a snapshot of a project containing its root path and a collection
-    of file snapshots.
-    """
-
-    project_root: WorkspaceRelativePath
-    """The workspace-relative path of the project root."""
-
-    files: tuple[FileSnapshot, ...]
-    """A collection of file snapshots belonging to the project."""
-
-
-class FileAdded(BaseModel):
-    """Represents the addition of a new file in the project."""
-
-    project_relative_path: ProjectRelativePath
-    """The project-relative path of the added file."""
-
-    current: FileSnapshot
-    """The current file snapshot."""
-
-    type: Literal["added"] = "added"
-    """The change type discriminator, set to 'added'."""
-
-
-class FileUpdated(BaseModel):
-    """Represents an update to an existing file in the project."""
-
-    project_relative_path: ProjectRelativePath
-    """The project-relative path of the updated file."""
-
-    previous: FileSnapshot
-    """The previous file snapshot before the update."""
-
-    current: FileSnapshot
-    """The current file snapshot after the update."""
-
-    type: Literal["updated"] = "updated"
-    """The change type discriminator, set to 'updated'."""
-
-
-class FileDeleted(BaseModel):
-    """Represents the deletion of a file from the project."""
-
-    project_relative_path: ProjectRelativePath
-    """The project-relative path of the deleted file."""
-
-    previous: FileSnapshot
-    """The previous file snapshot before deletion."""
-
-    type: Literal["deleted"] = "deleted"
-    """The change type discriminator, set to 'deleted'."""
-
-
-type FileChange = FileAdded | FileUpdated | FileDeleted
-"""Represents any file change event (added, updated, or deleted)."""
-
-
-@dataclass
-class AnalyzeProjectChangesResult:
-    """Represents the result of analyzing project changes, containing project
-    identification, snapshot paths, previous and current snapshots, and file
-    differences.
-    """
-
-    project_id: str
-    """The identifier of the analyzed project."""
-
-    snapshot_path: FullPath
-    """The full path to the snapshot storage or record."""
-
-    previous_snapshot: ProjectSnapshot | None
-    """The previous project snapshot, or None if this is the initial snapshot."""
-
-    current_snapshot: ProjectSnapshot
-    """The current project snapshot."""
-
-    diff: tuple[FileChange, ...]
-    """A tuple of file changes detected between the previous and current snapshots."""