filesnap 0.1.2__tar.gz

filesnap-0.1.2/.github/workflows/python-publish.yml

@@ -0,0 +1,49 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Build release dist
+        run: uv build
+
+      - name: Upload dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+
+    steps:
+      - name: Download dist
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release dist
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

filesnap-0.1.2/.gitignore

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

filesnap-0.1.2/.python-version

@@ -0,0 +1 @@
+3.14

filesnap-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jesusjsg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

filesnap-0.1.2/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: filesnap
+Version: 0.1.2
+Summary: A simple CLI to handle your files
+Project-URL: Repository, https://github.com/jesusjsg/filesnap
+Author-email: jesus <jesusjsgdev@gmail.com>
+License-File: LICENSE
+Keywords: cli,files
+Requires-Python: >=3.12
+Requires-Dist: typer>=0.21.1
+Description-Content-Type: text/markdown
+
+# filesnap
+
+`filesnap` is a command-line tool for managing files and directories.
+
+## Commands
+
+### `filesnap scan`
+
+Scans all the files in the path.
+
+| Argument | Description | Default |
+|---|---|---|
+| `path` | Path to scan | Current directory |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--recursive` | `-r` | Recursive search. |
+| `--pretty` | `-p` | Pretty print the output in a table. |
+| `--exclude` | | Exclude files/directories from scanning. |
+| `--ext` | `-e` | Scan only files with these extensions. |
+
+### `filesnap count`
+
+Counts all the files by extension in the path selected.
+
+| Argument | Description | Default |
+|---|---|---|
+| `path` | Path to count | Current directory |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--recursive` | `-r` | Recursive search. |
+| `--exclude` | | Exclude files/directories from counting. |
+
+### `filesnap clean`
+
+Cleans the content of a path.
+
+| Argument | Description |
+|---|---|
+| `path` | Path to clean |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--recursive` | `-r` | Recursive cleaning. |
+| `--contain` | `-c` | Clean only files containing this string. |
+| `--ext` | `-e` | Clean only files with these extensions. |
+| `--exclude` | | Exclude files/directories from cleaning. |
+| `--force` | `-f` | Force deletion without confirmation. |
+| `--dry-run` | `--dry` | Simulate cleaning without deleting files. |
+
+### `filesnap export`
+
+Exports the filenames to a file.
+
+| Argument | Description |
+|---|---|
+| `path` | Path to scan for filenames |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--type` | `-t` | The type of file to export to (e.g., `txt`, `csv`, `json`). |
+| `--recursive` | `-r` | Recursive scanning. |
+| `--output` | `-o` | The output file name. |
+| `--format` | `-f` | The format of the output. |
+| `--column` | `-c` | The column to export (defaults to `file_name`). |
+

filesnap-0.1.2/README.md

@@ -0,0 +1,67 @@
+# filesnap
+
+`filesnap` is a command-line tool for managing files and directories.
+
+## Commands
+
+### `filesnap scan`
+
+Scans all the files in the path.
+
+| Argument | Description | Default |
+|---|---|---|
+| `path` | Path to scan | Current directory |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--recursive` | `-r` | Recursive search. |
+| `--pretty` | `-p` | Pretty print the output in a table. |
+| `--exclude` | | Exclude files/directories from scanning. |
+| `--ext` | `-e` | Scan only files with these extensions. |
+
+### `filesnap count`
+
+Counts all the files by extension in the path selected.
+
+| Argument | Description | Default |
+|---|---|---|
+| `path` | Path to count | Current directory |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--recursive` | `-r` | Recursive search. |
+| `--exclude` | | Exclude files/directories from counting. |
+
+### `filesnap clean`
+
+Cleans the content of a path.
+
+| Argument | Description |
+|---|---|
+| `path` | Path to clean |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--recursive` | `-r` | Recursive cleaning. |
+| `--contain` | `-c` | Clean only files containing this string. |
+| `--ext` | `-e` | Clean only files with these extensions. |
+| `--exclude` | | Exclude files/directories from cleaning. |
+| `--force` | `-f` | Force deletion without confirmation. |
+| `--dry-run` | `--dry` | Simulate cleaning without deleting files. |
+
+### `filesnap export`
+
+Exports the filenames to a file.
+
+| Argument | Description |
+|---|---|
+| `path` | Path to scan for filenames |
+
+| Option | Alias | Description |
+|---|---|---|
+| `--type` | `-t` | The type of file to export to (e.g., `txt`, `csv`, `json`). |
+| `--recursive` | `-r` | Recursive scanning. |
+| `--output` | `-o` | The output file name. |
+| `--format` | `-f` | The format of the output. |
+| `--column` | `-c` | The column to export (defaults to `file_name`). |
+

filesnap-0.1.2/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "filesnap"
+description = "A simple CLI to handle your files"
+readme = "README.md"
+requires-python = ">=3.12"
+license-files = ["LICENSE"]
+authors = [{ name = "jesus", email = "jesusjsgdev@gmail.com" }]
+keywords = ["cli", "files"]
+dependencies = [
+  "typer>=0.21.1",
+]
+dynamic = ["version"]
+
+[project.urls]
+Repository = "https://github.com/jesusjsg/filesnap"
+
+[project.scripts]
+filesnap = "filesnap.main:app"
+
+[build-system]
+requires = ["hatch-vcs", "hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"

filesnap-0.1.2/ruff.toml

@@ -0,0 +1,68 @@
+# Exclude a variety of commonly ignored directories.
+exclude = [
+  ".bzr",
+  ".direnv",
+  ".eggs",
+  ".git",
+  ".git-rewrite",
+  ".hg",
+  ".ipynb_checkpoints",
+  ".mypy_cache",
+  ".nox",
+  ".pants.d",
+  ".pyenv",
+  ".pytest_cache",
+  ".pytype",
+  ".ruff_cache",
+  ".svn",
+  ".tox",
+  ".venv",
+  ".vscode",
+  "__pypackages__",
+  "_build",
+  "buck-out",
+  "build",
+  "dist",
+  "node_modules",
+  "site-packages",
+  "venv",
+]
+# Same as Black.
+line-length = 72
+indent-width = 4
+# Assume Python 3.9
+target-version = "py314"
+
+[lint]
+# Enable Pyflakes (`F`) and a subset of the pycodestyle (`E`) codes by default.
+# Unlike Flake8, Ruff doesn't enable pycodestyle warnings (`W`) or
+# McCabe complexity (`C901`) by default.
+select = ["E4", "E7", "E9", "F"]
+ignore = []
+# Allow fix for all enabled rules (when `--fix`) is provided.
+fixable = ["ALL"]
+unfixable = []
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+# Like Black, automatically detect the appropriate line ending.
+line-ending = "auto"
+# Enable auto-formatting of code examples in docstrings. Markdown,
+# reStructuredText code/literal blocks and doctests are all supported.
+#
+# This is currently disabled by default, but it is planned for this
+# to be opt-out in the future.
+docstring-code-format = false
+# Set the line length limit used when formatting code snippets in
+# docstrings.
+#
+# This only has an effect when the `docstring-code-format` setting is
+# enabled.
+docstring-code-line-length = "dynamic"

filesnap-0.1.2/src/filesnap/constants.py

@@ -0,0 +1,10 @@
+"""I don't know if this is the best approach"""
+
+DEFAULT_LIST_IGNORED = [
+    "node_modules",
+    ".git",
+    "vendor",
+    "__pycache__",
+    ".venv",
+    "venv",
+]

filesnap-0.1.2/src/filesnap/files/__init__.py

@@ -0,0 +1,13 @@
+import typer
+
+from filesnap.files.clean import app as clean_app
+from filesnap.files.count import app as count_app
+from filesnap.files.export import app as export_app
+from filesnap.files.scan import app as scan_app
+
+app = typer.Typer()
+
+app.add_typer(scan_app)
+app.add_typer(count_app)
+app.add_typer(clean_app)
+app.add_typer(export_app)

filesnap-0.1.2/src/filesnap/files/clean.py

@@ -0,0 +1,90 @@
+import os
+import shutil
+from typing import Annotated, List, Optional
+
+import typer
+from rich import print
+
+from filesnap.utils.filesystem import (
+    get_exclude_list,
+    get_extension_list,
+    scandir,
+    validate_path_exist,
+)
+from filesnap.utils.formatting import task_progress
+
+app = typer.Typer()
+
+
+@app.command()
+def clean(
+    path: str,
+    recursive: Annotated[
+        bool, typer.Option("--recursive", "-r")
+    ] = False,
+    contain: Annotated[str, typer.Option("--contain", "-c")] = "",
+    extensions: Annotated[
+        Optional[List[str]], typer.Option("--ext", "-e")
+    ] = None,
+    exclude: Annotated[Optional[List[str]], typer.Option()] = None,
+    force: Annotated[bool, typer.Option("--force", "-f")] = False,
+    dry_run: Annotated[
+        bool, typer.Option("--dry-run", "--dry")
+    ] = False,
+):
+    """Clean the content of the path"""
+    validate_path_exist(path)
+
+    if not dry_run:
+        if force:
+            typer.confirm(
+                f"Are you sure you want to delete the entire {path}?",
+                abort=True,
+            )
+            shutil.rmtree(path)
+            print(
+                f"[green]The directory {path} was removed successfully![/green]"
+            )
+            raise typer.Exit()
+
+        typer.confirm(
+            "Are you sure you want to delete the content of the path?",
+            abort=True,
+        )
+
+    scan_options = {
+        "exclude": get_exclude_list(exclude),
+        "extensions": get_extension_list(extensions),
+        "contain": contain,
+    }
+
+    entries = scandir(path, recursive, **scan_options)
+
+    track_entries = task_progress(
+        entries, description="Cleaning content..."
+    )
+
+    count = 0
+
+    for entry in track_entries:
+        count += 1
+        try:
+            if dry_run:
+                print(
+                    f"[yellow][DRY RUN][/yellow] Would remove: [white]{entry.path}[/white]"
+                )
+                continue
+
+            if entry.is_file() or entry.is_symlink():
+                os.remove(entry)
+            elif entry.is_dir():
+                if not contain:
+                    os.rmdir(entry.path)
+        except OSError:
+            pass
+    message = (
+        f"Dry run completed! {count} total files affected"
+        if dry_run
+        else "The content of the path was removed successfully!"
+    )
+    print(f"[green]{message}[/green]")

filesnap-0.1.2/src/filesnap/files/count.py

@@ -0,0 +1,71 @@
+import os
+from collections import defaultdict
+from typing import Annotated, List, Optional
+
+import typer
+from rich.console import Console
+from rich.filesize import decimal
+from rich.table import Table
+
+from filesnap.utils.filesystem import (
+    get_exclude_list,
+    get_extension,
+    scandir,
+    validate_path_exist,
+)
+from filesnap.utils.formatting import task_progress
+
+app = typer.Typer()
+console = Console()
+
+
+@app.command()
+def count(
+    path: Annotated[
+        str, typer.Argument(help="Path to count")
+    ] = os.getcwd(),
+    recursive: Annotated[
+        bool,
+        typer.Option("--recursive", "-r", help="Recursive search."),
+    ] = False,
+    exclude: Annotated[Optional[List[str]], typer.Option()] = None,
+):
+    """Count all the files by extension in the path selected"""
+
+    validate_path_exist(path)
+
+    scan_options = {
+        "exclude": get_exclude_list(exclude),
+    }
+
+    info_stats = defaultdict(lambda: {"size": 0, "count": 0})
+
+    entries = scandir(path, recursive, **scan_options)
+
+    track_entries = task_progress(
+        entries, description="Scanning extensions..."
+    )
+
+    for entry in track_entries:
+        if entry.is_file():
+            ext = get_extension(entry.name)
+            file_info = entry.stat()
+
+            info_stats[ext]["size"] += file_info.st_size
+            info_stats[ext]["count"] += 1
+
+    table = Table(title=f"File statistics for {path}")
+    table.add_column("Extension", style="cyan")
+    table.add_column("Size", style="magenta", justify="right")
+    table.add_column("Count", style="green", justify="right")
+
+    sorted_stats = sorted(
+        info_stats.items(),
+        key=lambda item: item[1]["size"],
+        reverse=True,
+    )
+
+    for ext, info in sorted_stats:
+        table.add_row(ext, decimal(info["size"]), str(info["count"]))
+
+    console.print(table)

filesnap-0.1.2/src/filesnap/files/export.py

@@ -0,0 +1,49 @@
+from pathlib import Path
+from typing import Annotated, Optional
+
+import typer
+from rich import print
+
+from filesnap.utils.filesystem import (
+    export_file,
+    scandir,
+    validate_path_exist,
+)
+from filesnap.utils.formatting import task_progress
+
+app = typer.Typer()
+
+
+@app.command()
+def export(
+    path: str,
+    type: Annotated[str, typer.Option("--type", "-t")],
+    recursive: Annotated[
+        bool, typer.Option("--recursive", "-r")
+    ] = False,
+    output: Annotated[
+        Optional[str], typer.Option("--output", "-o")
+    ] = None,
+    format: Annotated[
+        Optional[str], typer.Option("--format", "-f")
+    ] = None,
+    column: Annotated[
+        str, typer.Option("--column", "-c")
+    ] = "file_name",
+):
+    """Export the filename to a txt file"""
+    validate_path_exist(path)
+
+    if output is None:
+        output = f"{Path(path).name}.{type}"
+
+    entries = scandir(path, recursive)
+    track_entries = task_progress(
+        entries, description=f"Generating {type.upper()} file..."
+    )
+
+    export_file(track_entries, type, output, column, format)
+
+    print(
+        f"[green]{type.upper()} file generated successfully[/green] :star:"
+    )

filesnap-0.1.2/src/filesnap/files/scan.py

@@ -0,0 +1,85 @@
+import os
+from typing import Annotated, List, Optional
+
+import typer
+from rich import print
+from rich.console import Console
+from rich.filesize import decimal
+from rich.table import Table
+
+from filesnap.utils.filesystem import (
+    get_exclude_list,
+    get_extension_list,
+    scandir,
+    validate_path_exist,
+)
+from filesnap.utils.formatting import format_date, task_progress
+
+app = typer.Typer()
+console = Console()
+
+MAX_TABLE_ROWS = 1000
+
+
+@app.command()
+def scan(
+    path: Annotated[
+        str, typer.Argument(help="Path to count")
+    ] = os.getcwd(),
+    recursive: Annotated[
+        bool,
+        typer.Option("--recursive", "-r", help="Recursive search."),
+    ] = False,
+    pretty: Annotated[
+        bool,
+        typer.Option(
+            "--pretty",
+            "-p",
+        ),
+    ] = False,
+    exclude: Annotated[Optional[List[str]], typer.Option()] = None,
+    extensions: Annotated[
+        Optional[List[str]], typer.Option("--ext", "-e")
+    ] = None,
+):
+    """
+    Scan all the files in the path
+    """
+
+    validate_path_exist(path)
+
+    scan_options = {
+        "exclude": get_exclude_list(exclude),
+        "extensions": get_extension_list(extensions),
+    }
+
+    entries = scandir(path, recursive, **scan_options)
+    count = 0
+
+    table = Table("Name", "Size", "Created") if pretty else None
+
+    track_entries = task_progress(
+        entries, description="Scanning path..."
+    )
+
+    for entry in track_entries:
+        count += 1
+        if pretty and table is not None:
+            if count <= MAX_TABLE_ROWS:
+                file_info = entry.stat()
+                table.add_row(
+                    entry.name,
+                    decimal(file_info.st_size),
+                    format_date(file_info.st_ctime),
+                )
+
+    if pretty and table:
+        with console.pager(styles=True):
+            console.print(table)
+
+            if count > MAX_TABLE_ROWS:
+                print(
+                    f"\n:warning:[yellow]Warning[/yellow]: Table output truncated. Showing first {MAX_TABLE_ROWS}"
+                )
+
+    print(f"{count} files found in [green]{path}[/green]")

filesnap-0.1.2/src/filesnap/main.py

@@ -0,0 +1,35 @@
+from typing import Annotated
+
+import typer
+
+from filesnap.files import app as files_app
+from filesnap.version import version_callback
+
+app = typer.Typer(
+    no_args_is_help=True,
+    add_completion=False,
+    help="A simple CLI to handle your files",
+)
+
+app.add_typer(files_app)
+
+
+@app.callback()
+def main(
+    version: Annotated[
+        bool | None,
+        typer.Option(
+            "--version",
+            "-v",
+            is_eager=True,
+            callback=version_callback,
+            help="Show the current version",
+        ),
+    ] = None,
+):
+    "Callback to show the package version"
+    pass
+
+
+if __name__ == "__main__":
+    app()

filesnap-0.1.2/src/filesnap/utils/decorators.py

@@ -0,0 +1,26 @@
+import functools
+import time
+
+from rich.console import Console
+
+console = Console()
+
+
+def benchmark(func):
+    """Decorator to get the execution time of a function"""
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        start_time = time.perf_counter()
+
+        result = func(*args, **kwargs)
+
+        end_time = time.perf_counter()
+        duration = end_time - start_time
+
+        console.print(
+            f"\n[bold magenta]Time:[/bold magenta] [cyan]{func.__name__}[/cyan] took [bold]{duration:.4f}[/bold] seconds."
+        )
+        return result
+
+    return wrapper

filesnap-0.1.2/src/filesnap/utils/filesystem.py

@@ -0,0 +1,132 @@
+import csv
+import json
+import os
+import re
+from pathlib import Path
+from typing import Generator, Iterable, List, Optional
+
+import typer
+from rich import print
+
+from filesnap.constants import DEFAULT_LIST_IGNORED
+
+
+def export_file(
+    entries: Iterable,
+    file_type: str,
+    output: str,
+    column_name: str,
+    pattern: Optional[str] = None,
+):
+    regex = re.compile(pattern) if pattern else None
+    file_type = file_type.lower()
+
+    with open(output, "w", newline="", encoding="utf-8") as file:
+        if file_type == "txt":
+            file.write(f"{column_name}\n")
+            for entry in entries:
+                if entry.is_file() and not entry.name.startswith("."):
+                    file_name = Path(entry.name).stem
+                    file.write(
+                        f"{regex.sub('', file_name) if regex else file_name}\n"
+                    )
+
+        if file_type == "csv":
+            writer = csv.writer(file)
+            writer.writerow([column_name])
+            for entry in entries:
+                if entry.is_file() and not entry.name.startswith("."):
+                    file_name = Path(entry.name).stem
+                    writer.writerow(
+                        [
+                            regex.sub("", file_name)
+                            if regex
+                            else file_name
+                        ]
+                    )
+
+        if file_type == "json":
+            file.write("[\n")
+            first = True
+            for entry in entries:
+                if not entry.is_file() or entry.name.startswith("."):
+                    continue
+
+                if not first:
+                    file.write(",\n")
+
+                file_name = Path(entry.name).stem
+                clean_name = (
+                    regex.sub("", file_name) if regex else file_name
+                )
+                json.dump({column_name: clean_name}, file, indent=4)
+                first = False
+            file.write("\n]")
+
+
+def get_extension(file_name: str) -> str:
+    _, ext = os.path.splitext(file_name)
+    return ext.lower() if ext else "Invalid extension"
+
+
+def get_exclude_list(exclude_names: Optional[List[str]]) -> set[str]:
+    final_ignores = set(DEFAULT_LIST_IGNORED)
+
+    if exclude_names:
+        for item in exclude_names:
+            user_list = [
+                file.strip() for file in item.split(",") if item.strip()
+            ]
+        final_ignores.update(user_list)
+    return final_ignores
+
+
+def get_extension_list(extensions: Optional[List[str]]) -> set[str]:
+    if not extensions:
+        return set()
+
+    final_extensions = set()
+    for item in extensions:
+        parts = [i.strip() for i in item.split(",") if i.strip()]
+        for ext in parts:
+            final_extensions.add(f".{ext.lstrip('.')}")
+    return final_extensions
+
+
+def scandir(
+    path: str, recursive: bool = False, **kwargs
+) -> Generator[os.DirEntry, None, None]:
+    exclude_names = kwargs.get("exclude", set())
+    valid_extensions = kwargs.get("extensions", set())
+    contain = kwargs.get("contain", "")
+
+    try:
+        for entry in os.scandir(path):
+            if entry.name in exclude_names:
+                continue
+
+            if contain and contain.lower() not in entry.name.lower():
+                continue
+
+            if entry.is_file():
+                if valid_extensions:
+                    _, ext = os.path.splitext(entry.name)
+                    if ext.lower() in valid_extensions:
+                        yield entry
+                else:
+                    yield entry
+
+            elif entry.is_dir():
+                if recursive:
+                    yield from scandir(entry.path, recursive, **kwargs)
+                yield entry
+    except PermissionError:
+        pass
+
+
+def validate_path_exist(path: str) -> None:
+    if not os.path.isdir(path):
+        print(
+            f"[bold red]Error:[/bold red] The path [yellow]{path}[/yellow] donsn't exist!"
+        )
+        raise typer.Exit(code=1)

filesnap-0.1.2/src/filesnap/utils/formatting.py

@@ -0,0 +1,23 @@
+import time
+from typing import Iterable
+
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+
+def format_date(date: int | float) -> str:
+    return str(time.ctime(date))
+
+
+def task_progress(
+    iterable: Iterable, description: str = "Processing..."
+) -> Iterable:
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[progress.description]{task.description}"),
+        transient=True,
+    ) as progress:
+        task = progress.add_task(description=description, total=None)
+
+        for item in iterable:
+            yield item
+            progress.update(task, advance=1)

filesnap-0.1.2/src/filesnap/version.py

@@ -0,0 +1,18 @@
+from importlib.metadata import PackageNotFoundError, version
+
+import typer
+from rich import print
+
+
+def version_callback(value: bool):
+    if value:
+        try:
+            pkg_version = version("filesnap")
+            print(
+                f":pushpin: Filesnap version [green]{pkg_version}[/green]"
+            )
+
+        except PackageNotFoundError:
+            print(":error: Unknown filesnap version")
+
+        raise typer.Exit()

filesnap-0.1.2/uv.lock

@@ -0,0 +1,110 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "click"
+version = "8.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "filesnap"
+source = { editable = "." }
+dependencies = [
+    { name = "typer" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "typer", specifier = ">=0.21.1" }]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "rich"
+version = "14.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fb/d2/8920e102050a0de7bfabeb4c4614a49248cf8d5d7a8d01885fbb24dc767a/rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4", size = 219990, upload-time = "2025-10-09T14:16:53.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/25/7a/b0178788f8dc6cafce37a212c99565fa1fe7872c70c6c9c1e1a372d9d88f/rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd", size = 243393, upload-time = "2025-10-09T14:16:51.245Z" },
+]
+
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
+[[package]]
+name = "typer"
+version = "0.21.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "rich" },
+    { name = "shellingham" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/bf/8825b5929afd84d0dabd606c67cd57b8388cb3ec385f7ef19c5cc2202069/typer-0.21.1.tar.gz", hash = "sha256:ea835607cd752343b6b2b7ce676893e5a0324082268b48f27aa058bdb7d2145d", size = 110371, upload-time = "2026-01-06T11:21:10.989Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/1d/d9257dd49ff2ca23ea5f132edf1281a0c4f9de8a762b9ae399b670a59235/typer-0.21.1-py3-none-any.whl", hash = "sha256:7985e89081c636b88d172c2ee0cfe33c253160994d47bdfdc302defd7d1f1d01", size = 47381, upload-time = "2026-01-06T11:21:09.824Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]