assetout 0.1.1__tar.gz

assetout-0.1.1/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ambientneon
+
+Permission is substantive 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.

assetout-0.1.1/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: assetout
+Version: 0.1.1
+Summary: Keep large binary assets out of Git — store them in GitHub Releases
+Author: ambientneon
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ambientneon/assetout
+Project-URL: Repository, https://github.com/ambientneon/assetout
+Project-URL: Issues, https://github.com/ambientneon/assetout/issues
+Keywords: git,binaries,assets,github-releases,lfs
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: xxhash>=3.0
+Dynamic: license-file
+
+# assetout
+
+**Keep large binary assets out of Git.**  
+Store them in a local mirror (`.assetout/`) and sync with [GitHub Releases](https://docs.github.com/en/repositories/releasing-projects-on-github).
+
+A simple alternative to Git LFS when you only need to keep big files out of the repository history and distribute them via Releases.
+
+## Features
+
+- Track large files outside Git (manifest + hashes)
+- Local mirror in `.assetout/data/`
+- Pack into zip archives and upload to GitHub Releases
+- Automatic split into multiple archives when over the size limit
+- Optional grouping by top-level project folder
+- Sync between project files and the mirror (`remote` / `local` / `manual`)
+- Wrappers: `git-add`, `git-push`
+
+## Requirements
+
+- Python 3.11+
+- Git repository with `origin` on GitHub
+- [GitHub CLI (`gh`)](https://cli.github.com/) — authenticated (`gh auth login`)
+
+## Install
+
+```bash
+pip install assetout
+```
+
+If the `assetout` command is not found (common on Windows):
+
+```bash
+# option A — recommended for CLI tools
+pipx install assetout
+
+# option B — module form (after adding __main__.py)
+python -m assetout --help
+
+# option C — add Python Scripts folder to PATH, then:
+assetout --help
+```
+
+## Quick start
+
+```bash
+# inside your git repo
+assetout init
+
+# register large files (copy into .assetout/data/, update manifest & .gitignore)
+assetout add path/to/big/files_or_dirs
+
+assetout status
+
+# upload archives to GitHub Releases
+assetout push
+
+# on another machine / clean checkout
+assetout pull
+assetout sync          # mirror → project files
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Create `.assetout/` (config, manifest, data dir) |
+| `add` | Add large files to the mirror |
+| `rm` | Remove from manifest and mirror |
+| `status` | Show tracked files and their state |
+| `push` | Pack mirror and upload to GitHub Releases |
+| `pull` | Download release archives into `.assetout/data/` |
+| `sync` | Sync between `.assetout/data/` and project files |
+| `git-add` | `assetout add` then `git add` |
+| `git-push` | `git push` then `assetout push` |
+
+### Useful flags
+
+```bash
+assetout push --replace-all          # delete old assetout archives, then upload
+assetout sync --policy local --force
+assetout rm path/to/file --project   # also delete from working tree
+```
+
+## How it works
+
+```text
+project files  ←→  .assetout/data/  ←→  GitHub Release (zip archives)
+     ↑ sync              ↑ push / pull
+```
+
+- Files larger than `max_git_file_size` are kept out of Git
+- Manifest stores size + hash for each path
+- Archives are named `binaries-01.zip`, `project-binaries-01.zip`, …
+
+## Configuration
+
+Created by `assetout init` at `.assetout/config.yaml`:
+
+```yaml
+max_git_file_size: 10MB
+hash_algorithm: xxh3
+use_only_git_files: true
+storage_backend: github_releases
+sync_policy: remote          # remote | local | manual
+
+packaging:
+  group_by_top_level: false  # true → group by first folder name
+  max_archive_size: 1900MB
+  max_file_size: 2048MB
+
+github:
+  tag: assets-latest
+  asset_name: binaries.zip   # legacy; names are generated automatically
+  owner: ""                  # optional; taken from git remote if empty
+  repo: ""
+```
+
+## Typical workflow
+
+```bash
+# day-to-day
+assetout git-add .
+git commit -m "Update assets"
+assetout git-push
+
+# or explicitly
+assetout add assets/
+assetout push
+git add . && git commit -m "..." && git push
+```
+
+## License
+
+MIT

assetout-0.1.1/README.md

@@ -0,0 +1,134 @@
+# assetout
+
+**Keep large binary assets out of Git.**  
+Store them in a local mirror (`.assetout/`) and sync with [GitHub Releases](https://docs.github.com/en/repositories/releasing-projects-on-github).
+
+A simple alternative to Git LFS when you only need to keep big files out of the repository history and distribute them via Releases.
+
+## Features
+
+- Track large files outside Git (manifest + hashes)
+- Local mirror in `.assetout/data/`
+- Pack into zip archives and upload to GitHub Releases
+- Automatic split into multiple archives when over the size limit
+- Optional grouping by top-level project folder
+- Sync between project files and the mirror (`remote` / `local` / `manual`)
+- Wrappers: `git-add`, `git-push`
+
+## Requirements
+
+- Python 3.11+
+- Git repository with `origin` on GitHub
+- [GitHub CLI (`gh`)](https://cli.github.com/) — authenticated (`gh auth login`)
+
+## Install
+
+```bash
+pip install assetout
+```
+
+If the `assetout` command is not found (common on Windows):
+
+```bash
+# option A — recommended for CLI tools
+pipx install assetout
+
+# option B — module form (after adding __main__.py)
+python -m assetout --help
+
+# option C — add Python Scripts folder to PATH, then:
+assetout --help
+```
+
+## Quick start
+
+```bash
+# inside your git repo
+assetout init
+
+# register large files (copy into .assetout/data/, update manifest & .gitignore)
+assetout add path/to/big/files_or_dirs
+
+assetout status
+
+# upload archives to GitHub Releases
+assetout push
+
+# on another machine / clean checkout
+assetout pull
+assetout sync          # mirror → project files
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Create `.assetout/` (config, manifest, data dir) |
+| `add` | Add large files to the mirror |
+| `rm` | Remove from manifest and mirror |
+| `status` | Show tracked files and their state |
+| `push` | Pack mirror and upload to GitHub Releases |
+| `pull` | Download release archives into `.assetout/data/` |
+| `sync` | Sync between `.assetout/data/` and project files |
+| `git-add` | `assetout add` then `git add` |
+| `git-push` | `git push` then `assetout push` |
+
+### Useful flags
+
+```bash
+assetout push --replace-all          # delete old assetout archives, then upload
+assetout sync --policy local --force
+assetout rm path/to/file --project   # also delete from working tree
+```
+
+## How it works
+
+```text
+project files  ←→  .assetout/data/  ←→  GitHub Release (zip archives)
+     ↑ sync              ↑ push / pull
+```
+
+- Files larger than `max_git_file_size` are kept out of Git
+- Manifest stores size + hash for each path
+- Archives are named `binaries-01.zip`, `project-binaries-01.zip`, …
+
+## Configuration
+
+Created by `assetout init` at `.assetout/config.yaml`:
+
+```yaml
+max_git_file_size: 10MB
+hash_algorithm: xxh3
+use_only_git_files: true
+storage_backend: github_releases
+sync_policy: remote          # remote | local | manual
+
+packaging:
+  group_by_top_level: false  # true → group by first folder name
+  max_archive_size: 1900MB
+  max_file_size: 2048MB
+
+github:
+  tag: assets-latest
+  asset_name: binaries.zip   # legacy; names are generated automatically
+  owner: ""                  # optional; taken from git remote if empty
+  repo: ""
+```
+
+## Typical workflow
+
+```bash
+# day-to-day
+assetout git-add .
+git commit -m "Update assets"
+assetout git-push
+
+# or explicitly
+assetout add assets/
+assetout push
+git add . && git commit -m "..." && git push
+```
+
+## License
+
+MIT

assetout-0.1.1/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "assetout"
+version = "0.1.1"
+description = "Keep large binary assets out of Git — store them in GitHub Releases"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "ambientneon" }  # поменяй на себя
+]
+keywords = ["git", "binaries", "assets", "github-releases", "lfs"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+    "xxhash>=3.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/ambientneon/assetout"
+Repository = "https://github.com/ambientneon/assetout"
+Issues = "https://github.com/ambientneon/assetout/issues"
+
+[project.scripts]
+assetout = "assetout.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]

assetout-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

assetout-0.1.1/src/assetout/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

assetout-0.1.1/src/assetout/cli.py

@@ -0,0 +1,135 @@
+# assetout/cli.py
+
+from pathlib import Path
+
+import typer
+from typing import Optional
+
+from rich.console import Console
+
+from assetout.constants             import SYNC_ALLOWED_POLICIES
+from assetout.commands.cmd_init     import run_init
+from assetout.commands.cmd_add      import run_add
+from assetout.commands.cmd_status   import run_status
+from assetout.commands.cmd_rm       import run_rm
+from assetout.commands.cmd_push     import run_push
+from assetout.commands.cmd_pull     import run_pull
+from assetout.commands.cmd_sync     import run_sync
+from assetout.commands.cmd_git_wrappers import (
+    run_git_add, 
+    run_git_push
+)
+
+app = typer.Typer(
+    name="assetout",
+    help="Keep large binary assets out of Git",
+    no_args_is_help=True
+)
+console = Console()
+
+@app.callback()
+def main() -> None:
+    """Keep large binary assets out of Git."""
+    pass
+
+
+@app.command()
+def init() -> None:
+    """Initialize assetout in the current repository."""
+    run_init()
+
+
+@app.command()
+def add(
+    paths: list[Path] = typer.Argument(
+        ...,
+        help="Files or directories to scan for large assets"
+    ),
+) -> None:
+    """Add large file(s) to the mirror and manifest (not to Git)."""
+    run_add([str(p) for p in paths])
+
+
+@app.command()
+def status() -> None:
+    """Show status of tracked large files."""
+    run_status()
+
+
+@app.command()
+def rm(
+    paths: list[Path] = typer.Argument(..., help="Tracked files to remove"),
+    project: bool = typer.Option(
+        False,
+        "--project",
+        help="Also delete the file from the project working tree"
+    ),
+) -> None:
+    """Remove file(s) from manifest and mirror (not from cloud until push)."""
+    run_rm([str(p) for p in paths], delete_project=project)
+
+
+@app.command()
+def push(
+    replace_all: bool = typer.Option(
+        False,
+        "--replace-all",
+        "-ra",
+        help="Delete all existing assetout archives from the release before uploading.",
+    ),
+) -> None:
+    """Pack mirror into zip(s) and upload to GitHub Releases."""
+    run_push(replace_all=replace_all)
+
+    
+@app.command()
+def pull() -> None:
+    """Download Release zip into .assetout/data/ (replace)."""
+    run_pull()
+
+    
+@app.command()
+def sync(
+    policy: Optional[str] = typer.Option(
+        None,
+        "--policy",
+        "-p",
+        help=f"Sync direction. Allowed: {', '.join(SYNC_ALLOWED_POLICIES)}. Default: from config (sync_policy).",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite on hash mismatch (remote→project or local→data).",
+    ),
+) -> None:
+    """Sync between .assetout/data/ and project files (manifest paths only)."""
+    run_sync(policy=policy, force=force)
+
+
+@app.command("git-add")
+def git_add(
+    paths: list[Path] = typer.Argument(..., help="Files/dirs to add"),
+) -> None:
+    """
+    1. assetout add (переносит большие файлы в mirror)
+    2. git add (остальное)
+    """
+    run_git_add([str(p) for p in paths])
+
+
+@app.command("git-push")
+def git_push(
+    remote: str = typer.Argument("origin"),
+    branch: Optional[str] = None,
+    replace_all: bool = typer.Option(False, "--replace-all", "-ra"),
+) -> None:
+    """
+    1. git push
+    2. assetout push (binaries)
+    """
+    run_git_push(remote, branch, replace_all=replace_all)
+
+
+if __name__ == "__main__":
+    app()

assetout-0.1.1/src/assetout/commands/cmd_add.py

@@ -0,0 +1,138 @@
+# assetout/commands/cmd_add.py
+
+from __future__ import annotations
+
+from typing import Any
+from pathlib import Path
+from rich.console import Console
+
+from assetout.constants import SKIP_DIR_NAMES
+from assetout.utils.paths import (
+    find_repo_root,
+    get_data_path,
+    get_rel_path
+)
+from assetout.utils.configs import (
+    load_config,
+    load_manifest,
+    save_manifest,
+)
+from assetout.utils.helpers import (
+    human_size,
+    parse_size,
+    safe_copy,
+    make_manifest_entry,
+    sync_gitignore_tracked,
+    run_process
+)
+
+
+console = Console()
+
+# public 
+def run_add(paths: list[str]) -> None:
+    root = find_repo_root(after_init=True)
+    config = load_config(root)
+    manifest = load_manifest(root)
+
+    max_size = parse_size(config.get("max_git_file_size", "10MB"))
+    use_only_git_files = bool(config.get("use_only_git_files", True))
+
+    files = _collect_files(paths, root)
+    if not files:
+        console.print("[dim]No files to process.[/dim]")
+        return
+
+    added = skipped = errors = 0
+    for path in files:
+        result = _add_one(path, root, max_size, use_only_git_files, manifest)
+
+        if result == "added":
+            added += 1
+        elif result == "skipped":
+            skipped += 1
+        else:
+            errors += 1
+
+    if added:
+        save_manifest(root, manifest)
+        
+    sync_gitignore_tracked(root, manifest)
+
+    console.print(f"\n[green]Added: {added},[/green] [yellow]skipped: {skipped},[/yellow] [red]errors: {errors}[/red]")
+
+
+# private 
+def _is_git_ignored(root: Path, rel: str) -> bool:
+    """True, усли Git игнорирует файл."""
+    result = run_process(
+        ["git", "check-ignore", "-q", rel],
+        cwd=root
+    )
+
+    # exit 0 = ignored, 1 = not ignored, 128 = error (нет git и т.п.)
+    return result.returncode == 0
+
+def _collect_files(raw_paths: list[str], root: Path) -> list[Path]:
+    """Разворачивает файлы и директории в плоский список файлов."""
+    collected: list[Path] = []
+
+    for raw in raw_paths:
+        path = Path(raw).resolve()
+
+        if path.is_file():
+            collected.append(path)
+            continue
+
+        if path.is_dir():
+            for child in path.rglob("*"):
+                if not child.is_file():
+                    continue
+
+                # пропускаем служебные директории
+                try: 
+                    rel_parts = child.relative_to(root).parts
+                except ValueError:
+                    continue
+
+                if any(part in SKIP_DIR_NAMES for part in rel_parts):
+                    continue
+
+                collected.append(child)
+
+            continue
+
+        console.print(f"[yellow]Skip[/yellow] {raw} - path not found")
+
+    # уникальные пути, стабильный порядок
+    unique = sorted(set(collected), key=lambda p: str(p).lower())
+    return unique
+
+
+def _add_one(path: Path, root: Path, max_size: int, use_only_git_files: bool, manifest: dict[str, Any]) -> str:
+    """Возвращает: 'added' | 'skipped' | 'error'."""
+    rel = get_rel_path(path, root)
+
+    if rel is None:
+        console.print(f"[yellow]Skip[/yellow] {path} - outside repository")
+        return "error"
+
+    if not path.is_file():
+        console.print(f"[yellow]Skip[/yellow] {rel} - not a file")
+        return "error"
+
+    if use_only_git_files and _is_git_ignored(root, rel):
+        # dimMsg(f"Skip {rel} - ignored by Git")
+        return "skipped"
+
+    size = path.stat().st_size
+    if size <= max_size:
+        # warningMsg(f"Skip {rel} - {human_size(size)} ≤ max ({human_size(max_size)}). Use git add .")
+        return "skipped"
+
+    dest = get_data_path(root, rel)
+    safe_copy(path, dest)
+
+    manifest["files"][rel] = make_manifest_entry(root, path)
+    console.print(f"[green]✓[/green] Added {rel} ({human_size(size)})")
+    return "added"

assetout-0.1.1/src/assetout/commands/cmd_git_wrappers.py

@@ -0,0 +1,51 @@
+# commands/cmd_git_wrappers.py
+
+from __future__ import annotations
+
+from rich.console import Console
+
+from assetout.commands.cmd_add import run_add
+from assetout.commands.cmd_push import run_push
+from assetout.utils.helpers import run_process
+from assetout.utils.paths import find_repo_root
+
+console = Console()
+
+def run_git_add(paths: list[str]) -> None:
+    root = find_repo_root(after_init=True)
+
+    # 1. сначала assetout
+    console.print("[bold]assetout add[/bold] ...")
+    run_add(paths)
+
+    # 2. потом обычный git add
+    console.print("[bold]git add[/bold] ...")
+    result = run_process(["git", "add", "--"] + paths, cwd=root)
+
+    if result.returncode != 0:
+        console.print(f"[red]Error:[/red] {result.stderr or 'git add failed'}")
+        raise SystemExit(result.returncode)
+
+
+def run_git_push(
+    remote: str = "origin",
+    branch: str | None = None,
+    replace_all: bool = False,
+) -> None:
+    root = find_repo_root(after_init=True)
+
+    # 1. сначала код
+    cmd = ["git", "push", remote]
+    if branch:
+        cmd.append(branch)
+
+    console.print(f"[bold]git push[/bold] {' '.join(cmd[2:])} ...")
+    result = run_process(cmd, cwd=root)
+
+    if result.returncode != 0:
+        console.print(f"[red]Error:[/red] {result.stderr or 'git push failed'}")
+        raise SystemExit(result.returncode)
+
+    # 2. потом бинарники
+    console.print("[bold]assetout push[/bold] ...")
+    run_push(replace_all=replace_all)