reposnap 0.6.4__tar.gz → 0.7.0__tar.gz

reposnap-0.7.0/.github/workflows/release.yml

@@ -0,0 +1,48 @@
+# .github/workflows/release.yml
+name: Release to PyPI
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+*'
+
+jobs:
+  ci:                      # <-- root job (no needs)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: eifinger/setup-rye@v4
+        with: { enable-cache: true }
+      - run: rye sync
+      - run: rye lint
+      - run: rye test
+
+  publish:
+    needs: ci
+    runs-on: ubuntu-latest
+
+    # 1️⃣  Run in the same named environment you entered on PyPI
+    environment:
+      name: pypi                 # must match the “Environment name” field on PyPI
+
+    # 2️⃣  Give this job the right to request an OIDC token
+    permissions:
+      contents: read             # keep least-privilege defaults
+      id-token: write            # ★ mandatory for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: eifinger/setup-rye@v4
+        with: { enable-cache: true }
+
+      # build + Twine check
+      - run: |
+          rye sync
+          rye build --clean
+          rye run twine check dist/*             # Twine comes from Rye venv
+
+      # 3️⃣  Call the publish action **without** password/username
+      - name: Publish to PyPI/TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: ${{ steps.repo.outputs.index_url }}   # keep if you need Test-PyPI for -rc tags
+          skip-existing: true

{reposnap-0.6.4 → reposnap-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reposnap
-Version: 0.6.4
+Version: 0.7.0
 Summary: Generate a Markdown file with all contents of your project
 Author: agoloborodko
 License-File: LICENSE
@@ -25,6 +25,7 @@ Description-Content-Type: text/markdown
 - **Structure Only Option**: The `--structure-only` flag can be used to generate the Markdown file with just the directory structure, omitting the contents of the files.
 - **Gitignore Support**: Automatically respects `.gitignore` patterns to exclude files and directories.
 - **Include and Exclude Patterns**: Use `--include` and `--exclude` to specify patterns for files and directories to include or exclude.
+- **Changes Only Mode**: Use `-c` or `--changes` to snapshot only uncommitted files (staged, unstaged, untracked, and stashed changes).
 
 ## Installation
 
@@ -49,7 +50,7 @@ pip install -r requirements.lock
 To use `reposnap` from the command line, run it with the following options:
 
 ```bash
-reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]] [-e EXCLUDE [EXCLUDE ...]] paths [paths ...]
+reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]] [-e EXCLUDE [EXCLUDE ...]] [-c] paths [paths ...]
 ```
 
 - `paths`: One or more paths (files or directories) within the repository whose content and structure should be rendered.
@@ -59,6 +60,7 @@ reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]
 - `--debug`: Enable debug-level logging.
 - `-i, --include`: File/folder patterns to include. For example, `-i "*.py"` includes only Python files.
 - `-e, --exclude`: File/folder patterns to exclude. For example, `-e "*.md"` excludes all Markdown files.
+- `-c, --changes`: Use only files that are added/modified/untracked/stashed but not yet committed.
 
 #### Pattern Matching
 
@@ -71,6 +73,42 @@ reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]
   - `-i "*.py"`: Includes only files ending with `.py`.
   - `-e "*.test.*"`: Excludes files with `.test.` in their names.
 
+#### Only Snapshot Your Current Work
+
+The `-c` or `--changes` flag allows you to generate documentation for only the files that have been modified but not yet committed. This includes:
+
+- **Staged changes**: Files that have been added to the index with `git add`
+- **Unstaged changes**: Files that have been modified but not yet staged
+- **Untracked files**: New files that haven't been added to Git yet
+- **Stashed changes**: Files that are stored in Git stash entries
+
+This is particularly useful when you want to:
+- Document only your current work-in-progress
+- Create a snapshot of changes before committing
+- Review what files you've been working on
+
+**Examples**:
+
+1. **Generate documentation for only your uncommitted changes**:
+    ```bash
+    reposnap . -c
+    ```
+
+2. **Combine with structure-only for a quick overview**:
+    ```bash
+    reposnap . -c --structure-only
+    ```
+
+3. **Filter uncommitted changes by file type**:
+    ```bash
+    reposnap . -c -i "*.py"
+    ```
+
+4. **Exclude test files from uncommitted changes**:
+    ```bash
+    reposnap . -c -e "*test*"
+    ```
+
 #### Examples
 
 1. **Generate a full project structure with file contents**:
@@ -103,6 +141,12 @@ reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]
     reposnap my_project/ -e "gui"
     ```
 
+6. **Document only your current uncommitted work**:
+
+    ```bash
+    reposnap . -c
+    ```
+
 ### Graphical User Interface
 
 `reposnap` also provides a GUI for users who prefer an interactive interface.

{reposnap-0.6.4 → reposnap-0.7.0}/README.md

@@ -12,6 +12,7 @@
 - **Structure Only Option**: The `--structure-only` flag can be used to generate the Markdown file with just the directory structure, omitting the contents of the files.
 - **Gitignore Support**: Automatically respects `.gitignore` patterns to exclude files and directories.
 - **Include and Exclude Patterns**: Use `--include` and `--exclude` to specify patterns for files and directories to include or exclude.
+- **Changes Only Mode**: Use `-c` or `--changes` to snapshot only uncommitted files (staged, unstaged, untracked, and stashed changes).
 
 ## Installation
 
@@ -36,7 +37,7 @@ pip install -r requirements.lock
 To use `reposnap` from the command line, run it with the following options:
 
 ```bash
-reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]] [-e EXCLUDE [EXCLUDE ...]] paths [paths ...]
+reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]] [-e EXCLUDE [EXCLUDE ...]] [-c] paths [paths ...]
 ```
 
 - `paths`: One or more paths (files or directories) within the repository whose content and structure should be rendered.
@@ -46,6 +47,7 @@ reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]
 - `--debug`: Enable debug-level logging.
 - `-i, --include`: File/folder patterns to include. For example, `-i "*.py"` includes only Python files.
 - `-e, --exclude`: File/folder patterns to exclude. For example, `-e "*.md"` excludes all Markdown files.
+- `-c, --changes`: Use only files that are added/modified/untracked/stashed but not yet committed.
 
 #### Pattern Matching
 
@@ -58,6 +60,42 @@ reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]
   - `-i "*.py"`: Includes only files ending with `.py`.
   - `-e "*.test.*"`: Excludes files with `.test.` in their names.
 
+#### Only Snapshot Your Current Work
+
+The `-c` or `--changes` flag allows you to generate documentation for only the files that have been modified but not yet committed. This includes:
+
+- **Staged changes**: Files that have been added to the index with `git add`
+- **Unstaged changes**: Files that have been modified but not yet staged
+- **Untracked files**: New files that haven't been added to Git yet
+- **Stashed changes**: Files that are stored in Git stash entries
+
+This is particularly useful when you want to:
+- Document only your current work-in-progress
+- Create a snapshot of changes before committing
+- Review what files you've been working on
+
+**Examples**:
+
+1. **Generate documentation for only your uncommitted changes**:
+    ```bash
+    reposnap . -c
+    ```
+
+2. **Combine with structure-only for a quick overview**:
+    ```bash
+    reposnap . -c --structure-only
+    ```
+
+3. **Filter uncommitted changes by file type**:
+    ```bash
+    reposnap . -c -i "*.py"
+    ```
+
+4. **Exclude test files from uncommitted changes**:
+    ```bash
+    reposnap . -c -e "*test*"
+    ```
+
 #### Examples
 
 1. **Generate a full project structure with file contents**:
@@ -90,6 +128,12 @@ reposnap [-h] [-o OUTPUT] [--structure-only] [--debug] [-i INCLUDE [INCLUDE ...]
     reposnap my_project/ -e "gui"
     ```
 
+6. **Document only your current uncommitted work**:
+
+    ```bash
+    reposnap . -c
+    ```
+
 ### Graphical User Interface
 
 `reposnap` also provides a GUI for users who prefer an interactive interface.

{reposnap-0.6.4 → reposnap-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "reposnap"
-version = "0.6.4"
+version = "0.7.0"
 description = "Generate a Markdown file with all contents of your project"
 authors = [
     { name = "agoloborodko" }
@@ -24,6 +24,7 @@ dev-dependencies = [
     "pytest>=8.3.2",
     "pre-commit>=4.2.0",
     "pytest-cov>=6.2.1",
+    "twine>=6.1.0",
 ]
 
 [tool.hatch.metadata]

{reposnap-0.6.4 → reposnap-0.7.0}/reposnap/controllers/project_controller.py

@@ -15,7 +15,7 @@ class ProjectController:
             self.args = args
             # Treat positional arguments as literal file/directory names.
             input_paths = [
-                Path(p) for p in (args.paths if hasattr(args, "paths") else [args.path])
+                Path(p) for p in (args.paths if hasattr(args, "paths") else [])
             ]
             self.input_paths = []
             for p in input_paths:
@@ -47,6 +47,7 @@ class ProjectController:
             self.exclude_patterns: List[str] = (
                 args.exclude if hasattr(args, "exclude") else []
             )
+            self.changes_only: bool = getattr(args, "changes", False)
         else:
             self.args = None
             self.input_paths = []
@@ -54,6 +55,7 @@ class ProjectController:
             self.structure_only = False
             self.include_patterns = []
             self.exclude_patterns = []
+            self.changes_only = False
         self.file_tree: Optional[FileTree] = None
         self.gitignore_patterns: List[str] = []
         if self.root_dir:
@@ -109,13 +111,23 @@ class ProjectController:
         return files
 
     def collect_file_tree(self) -> None:
-        self.logger.info("Collecting files from Git tracked files if available.")
+        if self.changes_only:
+            self.logger.info("Collecting uncommitted files from Git repository.")
+        else:
+            self.logger.info("Collecting files from Git tracked files if available.")
         try:
             from reposnap.core.git_repo import GitRepo
 
             git_repo = GitRepo(self.root_dir)
-            all_files = git_repo.get_git_files()
-            self.logger.debug(f"Git tracked files: {all_files}")
+            if self.changes_only:
+                all_files = git_repo.get_uncommitted_files()
+                self.logger.info(
+                    "Using only uncommitted files (staged, unstaged, untracked, stashed)."
+                )
+            else:
+                all_files = git_repo.get_git_files()
+                self.logger.info("Using all Git tracked files.")
+            self.logger.debug(f"Git files: {all_files}")
         except Exception as e:
             self.logger.warning(f"Error obtaining Git tracked files: {e}.")
             all_files = []

reposnap-0.7.0/reposnap/core/git_repo.py

@@ -0,0 +1,100 @@
+# src/reposnap/core/git_repo.py
+
+import logging
+from pathlib import Path
+from git import Repo, InvalidGitRepositoryError
+from typing import List
+
+
+class GitRepo:
+    def __init__(self, repo_path: Path):
+        self.repo_path: Path = repo_path.resolve()
+        self.logger = logging.getLogger(__name__)
+
+    def get_git_files(self) -> List[Path]:
+        try:
+            repo: Repo = Repo(self.repo_path, search_parent_directories=True)
+            repo_root: Path = Path(repo.working_tree_dir).resolve()
+            git_files: List[str] = repo.git.ls_files().splitlines()
+            self.logger.debug(f"Git files from {repo_root}: {git_files}")
+            git_files_relative: List[Path] = []
+            for f in git_files:
+                absolute_path: Path = (repo_root / f).resolve()
+                try:
+                    relative_path: Path = absolute_path.relative_to(self.repo_path)
+                    git_files_relative.append(relative_path)
+                except ValueError:
+                    # Skip files not under root_dir
+                    continue
+            return git_files_relative
+        except InvalidGitRepositoryError:
+            self.logger.error(f"Invalid Git repository at: {self.repo_path}")
+            return []
+
+    def get_uncommitted_files(self) -> List[Path]:
+        """
+        Return every *working-copy* file that differs from HEAD - staged,
+        unstaged, untracked, plus everything referenced in `git stash list`.
+        Paths are *relative to* self.repo_path.
+        """
+        try:
+            repo: Repo = Repo(self.repo_path, search_parent_directories=True)
+            repo_root: Path = Path(repo.working_tree_dir).resolve()
+            paths: set = set()
+
+            # Staged changes (diff between index and HEAD)
+            for diff in repo.index.diff("HEAD"):
+                paths.add(diff.a_path or diff.b_path)
+
+            # Unstaged changes (diff between working tree and index)
+            for diff in repo.index.diff(None):
+                paths.add(diff.a_path or diff.b_path)
+
+            # Untracked files
+            paths.update(repo.untracked_files)
+
+            # Stash entries - with performance guard
+            try:
+                stash_refs = repo.git.stash("list", "--format=%gd").splitlines()
+                # Limit stash processing to prevent performance issues
+                max_stashes = 10
+                if len(stash_refs) > max_stashes:
+                    self.logger.warning(
+                        f"Large stash stack detected ({len(stash_refs)} entries). "
+                        f"Processing only the first {max_stashes} stashes."
+                    )
+                    stash_refs = stash_refs[:max_stashes]
+
+                for ref in stash_refs:
+                    if ref.strip():  # Skip empty lines
+                        stash_files = repo.git.diff(
+                            "--name-only", f"{ref}^1", ref
+                        ).splitlines()
+                        paths.update(stash_files)
+            except Exception as e:
+                self.logger.debug(f"Error processing stash entries: {e}")
+
+            # Convert to relative paths and filter existing files
+            relative_paths = []
+            for path_str in paths:
+                if path_str:  # Skip empty strings
+                    absolute_path = (repo_root / path_str).resolve()
+                    try:
+                        relative_path = absolute_path.relative_to(self.repo_path)
+                        if absolute_path.is_file():
+                            relative_paths.append(relative_path)
+                    except ValueError:
+                        # Log warning for paths outside repo root
+                        self.logger.warning(
+                            f"Path {path_str} is outside repository root {self.repo_path}. Skipping."
+                        )
+                        continue
+
+            # Return sorted, deduplicated list for deterministic output
+            result = sorted(set(relative_paths))
+            self.logger.debug(f"Uncommitted files from {repo_root}: {result}")
+            return result
+
+        except InvalidGitRepositoryError:
+            self.logger.error(f"Invalid Git repository at: {self.repo_path}")
+            return []

{reposnap-0.6.4 → reposnap-0.7.0}/reposnap/interfaces/cli.py

@@ -40,6 +40,12 @@ def main():
         default=[],
         help="File/folder patterns to exclude.",
     )
+    parser.add_argument(
+        "-c",
+        "--changes",
+        action="store_true",
+        help="Use only files that are added/modified/untracked/stashed but not yet committed.",
+    )
 
     args = parser.parse_args()
 

reposnap-0.7.0/requirements-dev.lock

@@ -0,0 +1,115 @@
+# generated by rye
+# use `rye lock` or `rye sync` to update this lockfile
+#
+# last locked with the following flags:
+#   pre: false
+#   features: []
+#   all-features: false
+#   with-sources: false
+#   generate-hashes: false
+#   universal: false
+
+-e file:.
+certifi==2025.6.15
+    # via requests
+cffi==1.17.1
+    # via cryptography
+cfgv==3.4.0
+    # via pre-commit
+charset-normalizer==3.4.2
+    # via requests
+coverage==7.9.1
+    # via pytest-cov
+cryptography==45.0.4
+    # via secretstorage
+distlib==0.3.9
+    # via virtualenv
+docutils==0.21.2
+    # via readme-renderer
+filelock==3.18.0
+    # via virtualenv
+gitdb==4.0.11
+    # via gitpython
+gitpython==3.1.43
+    # via reposnap
+id==1.5.0
+    # via twine
+identify==2.6.12
+    # via pre-commit
+idna==3.10
+    # via requests
+iniconfig==2.0.0
+    # via pytest
+jaraco-classes==3.4.0
+    # via keyring
+jaraco-context==6.0.1
+    # via keyring
+jaraco-functools==4.2.1
+    # via keyring
+jeepney==0.9.0
+    # via keyring
+    # via secretstorage
+keyring==25.6.0
+    # via twine
+markdown-it-py==3.0.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+more-itertools==10.7.0
+    # via jaraco-classes
+    # via jaraco-functools
+nh3==0.2.21
+    # via readme-renderer
+nodeenv==1.9.1
+    # via pre-commit
+packaging==25.0
+    # via pytest
+    # via twine
+pathlib==1.0.1
+    # via reposnap
+pathspec==0.12.1
+    # via reposnap
+platformdirs==4.3.8
+    # via virtualenv
+pluggy==1.5.0
+    # via pytest
+    # via pytest-cov
+pre-commit==4.2.0
+pycparser==2.22
+    # via cffi
+pygments==2.19.2
+    # via readme-renderer
+    # via rich
+pytest==8.3.2
+    # via pytest-cov
+pytest-cov==6.2.1
+pyyaml==6.0.2
+    # via pre-commit
+readme-renderer==44.0
+    # via twine
+requests==2.32.4
+    # via id
+    # via requests-toolbelt
+    # via twine
+requests-toolbelt==1.0.0
+    # via twine
+rfc3986==2.0.0
+    # via twine
+rich==14.0.0
+    # via twine
+secretstorage==3.3.3
+    # via keyring
+smmap==5.0.1
+    # via gitdb
+twine==6.1.0
+typing-extensions==4.12.2
+    # via urwid
+urllib3==2.5.0
+    # via requests
+    # via twine
+urwid==2.6.15
+    # via reposnap
+virtualenv==20.31.2
+    # via pre-commit
+wcwidth==0.2.13
+    # via urwid

{reposnap-0.6.4 → reposnap-0.7.0}/requirements.lock

@@ -11,10 +11,18 @@
 
 -e file:.
 gitdb==4.0.11
+    # via gitpython
 gitpython==3.1.43
+    # via reposnap
 pathlib==1.0.1
+    # via reposnap
 pathspec==0.12.1
+    # via reposnap
 smmap==5.0.1
+    # via gitdb
 typing-extensions==4.12.2
+    # via urwid
 urwid==2.6.15
+    # via reposnap
 wcwidth==0.2.13
+    # via urwid

{reposnap-0.6.4 → reposnap-0.7.0}/tests/reposnap/test_cli.py

@@ -78,3 +78,51 @@ def test_cli(mock_controller, temp_dir):
         main()
 
     mock_controller_instance.run.assert_called_once()
+
+
+@patch("reposnap.interfaces.cli.ProjectController")
+def test_cli_with_changes_flag(mock_controller, temp_dir):
+    """Test that the --changes flag is properly parsed and passed to controller."""
+    mock_controller_instance = MagicMock()
+    mock_controller.return_value = mock_controller_instance
+
+    with patch("sys.argv", ["cli.py", str(temp_dir), "--changes"]):
+        main()
+
+    # Verify controller was called with args containing changes=True
+    mock_controller.assert_called_once()
+    args = mock_controller.call_args[0][0]
+    assert args.changes is True
+    mock_controller_instance.run.assert_called_once()
+
+
+@patch("reposnap.interfaces.cli.ProjectController")
+def test_cli_with_changes_short_flag(mock_controller, temp_dir):
+    """Test that the -c flag is properly parsed and passed to controller."""
+    mock_controller_instance = MagicMock()
+    mock_controller.return_value = mock_controller_instance
+
+    with patch("sys.argv", ["cli.py", str(temp_dir), "-c"]):
+        main()
+
+    # Verify controller was called with args containing changes=True
+    mock_controller.assert_called_once()
+    args = mock_controller.call_args[0][0]
+    assert args.changes is True
+    mock_controller_instance.run.assert_called_once()
+
+
+@patch("reposnap.interfaces.cli.ProjectController")
+def test_cli_without_changes_flag(mock_controller, temp_dir):
+    """Test that changes defaults to False when flag is not provided."""
+    mock_controller_instance = MagicMock()
+    mock_controller.return_value = mock_controller_instance
+
+    with patch("sys.argv", ["cli.py", str(temp_dir)]):
+        main()
+
+    # Verify controller was called with args containing changes=False (default)
+    mock_controller.assert_called_once()
+    args = mock_controller.call_args[0][0]
+    assert args.changes is False
+    mock_controller_instance.run.assert_called_once()

reposnap-0.7.0/tests/reposnap/test_git_repo.py

@@ -0,0 +1,211 @@
+# tests/reposnap/test_git_repo.py
+
+from unittest.mock import patch, MagicMock
+from reposnap.core.git_repo import GitRepo
+from pathlib import Path
+
+
+@patch("reposnap.core.git_repo.Repo")
+def test_get_git_files(mock_repo):
+    mock_repo_instance = MagicMock()
+    mock_repo_instance.git.ls_files.return_value = "file1.py\nsubdir/file2.py"
+    mock_repo_instance.working_tree_dir = "/path/to/repo"
+    mock_repo.return_value = mock_repo_instance
+
+    git_repo = GitRepo(Path("/path/to/repo/subdir"))
+    files = git_repo.get_git_files()
+
+    expected_files = [Path("file2.py")]
+
+    assert files == expected_files
+
+
+@patch("reposnap.core.git_repo.Repo")
+@patch("pathlib.Path.is_file")
+def test_get_uncommitted_files_staged_and_unstaged(mock_is_file, mock_repo):
+    """Test get_uncommitted_files with staged and unstaged changes."""
+    mock_repo_instance = MagicMock()
+    mock_repo_instance.working_tree_dir = "/path/to/repo"
+
+    # Mock staged changes
+    staged_diff = MagicMock()
+    staged_diff.a_path = "staged_file.py"
+    staged_diff.b_path = None
+
+    # Mock unstaged changes
+    unstaged_diff = MagicMock()
+    unstaged_diff.a_path = "unstaged_file.py"
+    unstaged_diff.b_path = None
+
+    mock_repo_instance.index.diff.side_effect = lambda ref: {
+        "HEAD": [staged_diff],
+        None: [unstaged_diff],
+    }[ref]
+
+    # Mock untracked files
+    mock_repo_instance.untracked_files = ["untracked_file.py"]
+
+    # Mock stash (empty)
+    mock_repo_instance.git.stash.return_value = ""
+
+    # Mock file existence
+    mock_is_file.return_value = True
+
+    mock_repo.return_value = mock_repo_instance
+
+    git_repo = GitRepo(Path("/path/to/repo"))
+    files = git_repo.get_uncommitted_files()
+
+    expected_files = [
+        Path("staged_file.py"),
+        Path("unstaged_file.py"),
+        Path("untracked_file.py"),
+    ]
+
+    # Compare sorted lists since the method now returns sorted output
+    assert files == sorted(expected_files)
+
+
+@patch("reposnap.core.git_repo.Repo")
+@patch("pathlib.Path.is_file")
+def test_get_uncommitted_files_with_stash(mock_is_file, mock_repo):
+    """Test get_uncommitted_files with stash entries."""
+    mock_repo_instance = MagicMock()
+    mock_repo_instance.working_tree_dir = "/path/to/repo"
+
+    # Mock no staged/unstaged changes
+    mock_repo_instance.index.diff.return_value = []
+
+    # Mock untracked files
+    mock_repo_instance.untracked_files = []
+
+    # 1) Mock stash list
+    mock_repo_instance.git.stash.return_value = "stash@{0}\nstash@{1}"
+
+    # 2) Mock diff calls to get stash file names
+    mock_repo_instance.git.diff.side_effect = lambda *args: {
+        ("--name-only", "stash@{0}^1", "stash@{0}"): "stash_file1.py\nstash_file2.py",
+        ("--name-only", "stash@{1}^1", "stash@{1}"): "stash_file3.py",
+    }[args]
+
+    # Mock file existence
+    mock_is_file.return_value = True
+
+    mock_repo.return_value = mock_repo_instance
+
+    git_repo = GitRepo(Path("/path/to/repo"))
+    files = git_repo.get_uncommitted_files()
+
+    expected_files = [
+        Path("stash_file1.py"),
+        Path("stash_file2.py"),
+        Path("stash_file3.py"),
+    ]
+
+    # Compare sorted lists since the method now returns sorted output
+    assert files == sorted(expected_files)
+
+
+@patch("reposnap.core.git_repo.Repo")
+def test_get_uncommitted_files_empty_working_tree(mock_repo):
+    """Test get_uncommitted_files with no changes."""
+    mock_repo_instance = MagicMock()
+    mock_repo_instance.working_tree_dir = "/path/to/repo"
+
+    # Mock no changes
+    mock_repo_instance.index.diff.return_value = []
+    mock_repo_instance.untracked_files = []
+    mock_repo_instance.git.stash.return_value = ""
+
+    mock_repo.return_value = mock_repo_instance
+
+    git_repo = GitRepo(Path("/path/to/repo"))
+    files = git_repo.get_uncommitted_files()
+
+    assert files == []
+
+
+@patch("reposnap.core.git_repo.Repo")
+def test_get_uncommitted_files_invalid_repo(mock_repo):
+    """Test get_uncommitted_files with invalid repository."""
+    from git import InvalidGitRepositoryError
+
+    mock_repo.side_effect = InvalidGitRepositoryError("Not a git repo")
+
+    git_repo = GitRepo(Path("/path/to/repo"))
+    files = git_repo.get_uncommitted_files()
+
+    assert files == []
+
+
+@patch("reposnap.core.git_repo.Repo")
+@patch("pathlib.Path.is_file")
+def test_get_uncommitted_files_stash_error_handling(mock_is_file, mock_repo):
+    """Test get_uncommitted_files handles stash errors gracefully."""
+    mock_repo_instance = MagicMock()
+    mock_repo_instance.working_tree_dir = "/path/to/repo"
+
+    # Mock staged changes
+    staged_diff = MagicMock()
+    staged_diff.a_path = "staged_file.py"
+    staged_diff.b_path = None
+    mock_repo_instance.index.diff.return_value = [staged_diff]
+
+    # Mock untracked files
+    mock_repo_instance.untracked_files = []
+
+    # Mock stash error
+    mock_repo_instance.git.stash.side_effect = Exception("Stash error")
+
+    # Mock file existence
+    mock_is_file.return_value = True
+
+    mock_repo.return_value = mock_repo_instance
+
+    git_repo = GitRepo(Path("/path/to/repo"))
+    files = git_repo.get_uncommitted_files()
+
+    # Should still return staged changes even if stash fails
+    expected_files = [Path("staged_file.py")]
+    assert files == expected_files
+
+
+@patch("reposnap.core.git_repo.Repo")
+@patch("pathlib.Path.is_file")
+def test_get_uncommitted_files_stash_limit(mock_is_file, mock_repo):
+    """Test get_uncommitted_files respects the stash limit."""
+    mock_repo_instance = MagicMock()
+    mock_repo_instance.working_tree_dir = "/path/to/repo"
+
+    # Mock no staged/unstaged changes
+    mock_repo_instance.index.diff.return_value = []
+
+    # Mock untracked files
+    mock_repo_instance.untracked_files = []
+
+    # Mock many stash entries (more than the limit of 10)
+    many_stashes = "\n".join([f"stash@{{{i}}}" for i in range(15)])
+    mock_repo_instance.git.stash.return_value = many_stashes
+
+    # Mock diff calls for the first 10 stashes (the limit)
+    def mock_diff(*args):
+        if args[0] == "--name-only" and len(args) == 3:
+            stash_ref = args[2]  # e.g., 'stash@{0}'
+            stash_num = int(stash_ref.split("{")[1].split("}")[0])
+            if stash_num < 10:  # Only the first 10 should be processed
+                return f"stash_file_{stash_num}.py"
+        return ""
+
+    mock_repo_instance.git.diff.side_effect = mock_diff
+
+    # Mock file existence
+    mock_is_file.return_value = True
+
+    mock_repo.return_value = mock_repo_instance
+
+    git_repo = GitRepo(Path("/path/to/repo"))
+    files = git_repo.get_uncommitted_files()
+
+    # Should only process the first 10 stashes
+    # The exact number depends on how many unique files are in those stashes
+    assert len(files) >= 0  # At minimum, should not crash

{reposnap-0.6.4 → reposnap-0.7.0}/tests/reposnap/test_project_controller.py

@@ -350,3 +350,82 @@ def test_project_controller_multiple_paths():
         assert "LICENSE" not in tree
         assert "tests" not in tree
         assert "extras" not in tree
+
+
+def test_project_controller_changes_only():
+    """Test that changes_only flag calls get_uncommitted_files instead of get_git_files."""
+    with tempfile.TemporaryDirectory() as temp_dir:
+        structure = {
+            "file1.py": 'print("File 1")',
+            "file2.py": 'print("File 2")',
+        }
+        create_directory_structure(temp_dir, structure)
+        args = type(
+            "Args",
+            (object,),
+            {
+                "paths": [temp_dir],
+                "output": os.path.join(temp_dir, "output.md"),
+                "structure_only": False,
+                "debug": False,
+                "include": [],
+                "exclude": [],
+                "changes": True,
+            },
+        )
+        with patch(
+            "reposnap.controllers.project_controller.ProjectController._get_repo_root",
+            return_value=Path(temp_dir),
+        ):
+            with patch("reposnap.core.git_repo.GitRepo") as MockGitRepo:
+                mock_git_repo = MagicMock()
+                mock_git_repo.get_uncommitted_files.return_value = [Path("file1.py")]
+                MockGitRepo.return_value = mock_git_repo
+
+                controller = ProjectController(args)
+                controller.collect_file_tree()
+
+                # Verify get_uncommitted_files was called instead of get_git_files
+                mock_git_repo.get_uncommitted_files.assert_called_once()
+                mock_git_repo.get_git_files.assert_not_called()
+
+
+def test_project_controller_changes_only_false():
+    """Test that when changes_only is False, get_git_files is called."""
+    with tempfile.TemporaryDirectory() as temp_dir:
+        structure = {
+            "file1.py": 'print("File 1")',
+            "file2.py": 'print("File 2")',
+        }
+        create_directory_structure(temp_dir, structure)
+        args = type(
+            "Args",
+            (object,),
+            {
+                "paths": [temp_dir],
+                "output": os.path.join(temp_dir, "output.md"),
+                "structure_only": False,
+                "debug": False,
+                "include": [],
+                "exclude": [],
+                "changes": False,
+            },
+        )
+        with patch(
+            "reposnap.controllers.project_controller.ProjectController._get_repo_root",
+            return_value=Path(temp_dir),
+        ):
+            with patch("reposnap.core.git_repo.GitRepo") as MockGitRepo:
+                mock_git_repo = MagicMock()
+                mock_git_repo.get_git_files.return_value = [
+                    Path("file1.py"),
+                    Path("file2.py"),
+                ]
+                MockGitRepo.return_value = mock_git_repo
+
+                controller = ProjectController(args)
+                controller.collect_file_tree()
+
+                # Verify get_git_files was called instead of get_uncommitted_files
+                mock_git_repo.get_git_files.assert_called_once()
+                mock_git_repo.get_uncommitted_files.assert_not_called()

reposnap-0.6.4/.github/workflows/release.yml

@@ -1,52 +0,0 @@
-name: Release to PyPI
-
-on:
-  push:
-    tags:
-      - 'v[0-9]+.[0-9]+.[0-9]+*'     # any SemVer tag, eg v1.2.3 or v1.2.3-rc.1
-
-jobs:
-  build-and-publish:
-    runs-on: ubuntu-latest
-
-    # Block publication unless the normal CI passed on this commit
-    needs: build                     # <— refers to the existing job id in python-package.yml
-
-    permissions:
-      contents: read                 # principle of least privilege
-      id-token: write                # enable OIDC if you switch to trusted publishing later :contentReference[oaicite:1]{index=1}
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install Rye
-        uses: eifinger/setup-rye@v4
-        with:
-          enable-cache: true
-
-      - name: Build wheel & sdist
-        run: |
-          rye sync
-          rye build --clean           # Hatchling is the backend; Rye shells out to it :contentReference[oaicite:2]{index=2}
-
-      - name: Verify metadata (optional)
-        run: |
-          rye run -e 'twine>=5' twine check dist/* :contentReference[oaicite:3]{index=3}
-
-      # Select real PyPI vs TestPyPI
-      - name: Set target repository
-        id: repository
-        run: |
-          if [[ "${GITHUB_REF_NAME}" == *"-"* ]]; then
-            echo "index_url=https://test.pypi.org/legacy/" >> "$GITHUB_OUTPUT"
-          else
-            echo "index_url=https://upload.pypi.org/legacy/" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Publish
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          password: ${{ secrets.PYPI_API_TOKEN }}
-          repository-url: ${{ steps.repository.outputs.index_url }}
-          skip-existing: true          # idempotent re-runs :contentReference[oaicite:4]{index=4}

reposnap-0.6.4/reposnap/core/git_repo.py

@@ -1,32 +0,0 @@
-# src/reposnap/core/git_repo.py
-
-import logging
-from pathlib import Path
-from git import Repo, InvalidGitRepositoryError
-from typing import List
-
-
-class GitRepo:
-    def __init__(self, repo_path: Path):
-        self.repo_path: Path = repo_path.resolve()
-        self.logger = logging.getLogger(__name__)
-
-    def get_git_files(self) -> List[Path]:
-        try:
-            repo: Repo = Repo(self.repo_path, search_parent_directories=True)
-            repo_root: Path = Path(repo.working_tree_dir).resolve()
-            git_files: List[str] = repo.git.ls_files().splitlines()
-            self.logger.debug(f"Git files from {repo_root}: {git_files}")
-            git_files_relative: List[Path] = []
-            for f in git_files:
-                absolute_path: Path = (repo_root / f).resolve()
-                try:
-                    relative_path: Path = absolute_path.relative_to(self.repo_path)
-                    git_files_relative.append(relative_path)
-                except ValueError:
-                    # Skip files not under root_dir
-                    continue
-            return git_files_relative
-        except InvalidGitRepositoryError:
-            self.logger.error(f"Invalid Git repository at: {self.repo_path}")
-            return []

reposnap-0.6.4/requirements-dev.lock

@@ -1,35 +0,0 @@
-# generated by rye
-# use `rye lock` or `rye sync` to update this lockfile
-#
-# last locked with the following flags:
-#   pre: false
-#   features: []
-#   all-features: false
-#   with-sources: false
-#   generate-hashes: false
-#   universal: false
-
--e file:.
-cfgv==3.4.0
-coverage==7.9.1
-distlib==0.3.9
-filelock==3.18.0
-gitdb==4.0.11
-gitpython==3.1.43
-identify==2.6.12
-iniconfig==2.0.0
-nodeenv==1.9.1
-packaging==25.0
-pathlib==1.0.1
-pathspec==0.12.1
-platformdirs==4.3.8
-pluggy==1.5.0
-pre-commit==4.2.0
-pytest==8.3.2
-pytest-cov==6.2.1
-pyyaml==6.0.2
-smmap==5.0.1
-typing-extensions==4.12.2
-urwid==2.6.15
-virtualenv==20.31.2
-wcwidth==0.2.13

reposnap-0.6.4/tests/reposnap/test_git_repo.py

@@ -1,20 +0,0 @@
-# tests/reposnap/test_git_repo.py
-
-from unittest.mock import patch, MagicMock
-from reposnap.core.git_repo import GitRepo
-from pathlib import Path
-
-
-@patch("reposnap.core.git_repo.Repo")
-def test_get_git_files(mock_repo):
-    mock_repo_instance = MagicMock()
-    mock_repo_instance.git.ls_files.return_value = "file1.py\nsubdir/file2.py"
-    mock_repo_instance.working_tree_dir = "/path/to/repo"
-    mock_repo.return_value = mock_repo_instance
-
-    git_repo = GitRepo(Path("/path/to/repo/subdir"))
-    files = git_repo.get_git_files()
-
-    expected_files = [Path("file2.py")]
-
-    assert files == expected_files