git-sync-filtered 0.1.0__tar.gz

git_sync_filtered-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Merge 42
+
+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.

git_sync_filtered-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: git-sync-filtered
+Version: 0.1.0
+Summary: Sync filtered commits from private to public repository
+Author-email: Your Name <you@example.com>
+License: MIT
+Keywords: git,filter,sync,repo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: gitpython>=3.1
+Requires-Dist: git-filter-repo>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# git-sync-filtered
+
+![GitHub Repo stars](https://img.shields.io/github/stars/Merge-42/git-sync-filtered?style=social)
+![Python versions](https://img.shields.io/pypi/pyversions/git-sync-filtered)
+![License](https://img.shields.io/pypi/l/git-sync-filtered)
+
+A thin wrapper around [git-filter-repo](https://github.com/newren/git-filter-repo) for syncing filtered commits from a private repository to a public repository.
+
+## Overview
+
+git-sync-filtered clones a private repository, filters it to only include specified paths using git-filter-repo, and pushes the result to a public repository's sync branch. This enables maintaining a public subset of a private repository while preserving commit history.
+
+## Installation
+
+### uv (recommended)
+
+```bash
+uv tool install git+https://github.com/Merge-42/git-sync-filtered
+```
+
+### uvx (run without installing)
+
+```bash
+uvx git+https://github.com/Merge-42/git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep src \
+  --keep docs
+```
+
+### pip
+
+```bash
+pip install git+https://github.com/Merge-42/git-sync-filtered
+```
+
+## Usage
+
+```bash
+git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep src \
+  --keep docs
+```
+
+### Using a paths file
+
+Create a file with paths to keep (one per line, lines starting with `#` are comments):
+
+```text
+src
+docs
+README.md
+```
+
+```bash
+git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep-from-file paths.txt
+```
+
+## Options
+
+| Option             | Description                                   | Default         |
+| ------------------ | --------------------------------------------- | --------------- |
+| `--private`        | Private repo path or URL                      | Required        |
+| `--public`         | Public repo path or URL                       | Required        |
+| `--keep`           | Paths to keep (specify multiple)              | Required        |
+| `--keep-from-file` | File containing paths to keep                 | -               |
+| `--sync-branch`    | Sync branch name                              | `upstream/sync` |
+| `--main-branch`    | Main branch name                              | `main`          |
+| `--private-branch` | Private branch to sync from                   | `main`          |
+| `--dry-run`        | Show what would happen without making changes | `false`         |
+| `--merge`          | Merge into main branch after sync             | `false`         |
+| `--force`          | Force push                                    | `false`         |
+
+## How It Works
+
+1. Clones the private repository
+2. Runs git-filter-repo to filter to only the specified paths
+3. Pushes filtered commits to the public repository's sync branch
+4. Optionally merges the sync branch into main
+
+The sync branch can then be merged into main manually or with `--merge`.
+
+## Workflow
+
+```mermaid
+flowchart LR
+    A[Private Repo<br/>private-branch] -->|clone & filter| B[git-sync-filtered]
+    B -->|push| C[Public Repo<br/>sync-branch]
+    C -->|"merge<br/>(manual or with --merge)"| D[Public Repo<br/>main-branch]
+```
+
+## Requirements
+
+- Python 3.10+
+- git >= 2.36.0
+
+---
+
+Sponsored by [Merge 42](https://merge42.com)

git_sync_filtered-0.1.0/README.md

@@ -0,0 +1,104 @@
+# git-sync-filtered
+
+![GitHub Repo stars](https://img.shields.io/github/stars/Merge-42/git-sync-filtered?style=social)
+![Python versions](https://img.shields.io/pypi/pyversions/git-sync-filtered)
+![License](https://img.shields.io/pypi/l/git-sync-filtered)
+
+A thin wrapper around [git-filter-repo](https://github.com/newren/git-filter-repo) for syncing filtered commits from a private repository to a public repository.
+
+## Overview
+
+git-sync-filtered clones a private repository, filters it to only include specified paths using git-filter-repo, and pushes the result to a public repository's sync branch. This enables maintaining a public subset of a private repository while preserving commit history.
+
+## Installation
+
+### uv (recommended)
+
+```bash
+uv tool install git+https://github.com/Merge-42/git-sync-filtered
+```
+
+### uvx (run without installing)
+
+```bash
+uvx git+https://github.com/Merge-42/git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep src \
+  --keep docs
+```
+
+### pip
+
+```bash
+pip install git+https://github.com/Merge-42/git-sync-filtered
+```
+
+## Usage
+
+```bash
+git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep src \
+  --keep docs
+```
+
+### Using a paths file
+
+Create a file with paths to keep (one per line, lines starting with `#` are comments):
+
+```text
+src
+docs
+README.md
+```
+
+```bash
+git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep-from-file paths.txt
+```
+
+## Options
+
+| Option             | Description                                   | Default         |
+| ------------------ | --------------------------------------------- | --------------- |
+| `--private`        | Private repo path or URL                      | Required        |
+| `--public`         | Public repo path or URL                       | Required        |
+| `--keep`           | Paths to keep (specify multiple)              | Required        |
+| `--keep-from-file` | File containing paths to keep                 | -               |
+| `--sync-branch`    | Sync branch name                              | `upstream/sync` |
+| `--main-branch`    | Main branch name                              | `main`          |
+| `--private-branch` | Private branch to sync from                   | `main`          |
+| `--dry-run`        | Show what would happen without making changes | `false`         |
+| `--merge`          | Merge into main branch after sync             | `false`         |
+| `--force`          | Force push                                    | `false`         |
+
+## How It Works
+
+1. Clones the private repository
+2. Runs git-filter-repo to filter to only the specified paths
+3. Pushes filtered commits to the public repository's sync branch
+4. Optionally merges the sync branch into main
+
+The sync branch can then be merged into main manually or with `--merge`.
+
+## Workflow
+
+```mermaid
+flowchart LR
+    A[Private Repo<br/>private-branch] -->|clone & filter| B[git-sync-filtered]
+    B -->|push| C[Public Repo<br/>sync-branch]
+    C -->|"merge<br/>(manual or with --merge)"| D[Public Repo<br/>main-branch]
+```
+
+## Requirements
+
+- Python 3.10+
+- git >= 2.36.0
+
+---
+
+Sponsored by [Merge 42](https://merge42.com)

git_sync_filtered-0.1.0/git_sync_filtered/__main__.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+"""
+git-sync-filtered - Sync filtered commits from private to public repo
+
+Usage:
+    git-sync-filtered --private /path/to/private --public /path/to/public --keep src --keep docs
+"""
+
+from git_sync_filtered.cli import main
+
+if __name__ == "__main__":
+    main()

git_sync_filtered-0.1.0/git_sync_filtered/cli.py

@@ -0,0 +1,77 @@
+import click
+
+from git_sync_filtered.sync import sync
+
+
+@click.command()
+@click.option("--private", required=True, help="Private repo path or URL")
+@click.option("--public", required=True, help="Public repo path or URL")
+@click.option("--keep", multiple=True, help="Paths to keep (can specify multiple)")
+@click.option(
+    "--keep-from-file",
+    type=click.Path(exists=True),
+    help="File containing paths to keep (one per line)",
+)
+@click.option("--sync-branch", default="upstream/sync", help="Sync branch name")
+@click.option("--main-branch", default="main", help="Main branch name")
+@click.option("--private-branch", default="main", help="Private branch to sync from")
+@click.option(
+    "--dry-run", is_flag=True, help="Show what would happen without making changes"
+)
+@click.option("--merge", is_flag=True, help="Merge into main branch after sync")
+@click.option("--force", is_flag=True, help="Force push")
+def main(
+    private,
+    public,
+    keep,
+    keep_from_file,
+    sync_branch,
+    main_branch,
+    private_branch,
+    dry_run,
+    merge,
+    force,
+):
+    """Sync filtered commits from private to public repository."""
+
+    try:
+        result = sync(
+            private=private,
+            public=public,
+            keep=keep,
+            keep_from_file=keep_from_file,
+            sync_branch=sync_branch,
+            main_branch=main_branch,
+            private_branch=private_branch,
+            dry_run=dry_run,
+            merge=merge,
+            force=force,
+        )
+    except ValueError as e:
+        raise click.ClickException(str(e))
+
+    click.echo("=== Git Filter Sync ===")
+    click.echo(f"Private:    {private}")
+    click.echo(f"Public:     {public}")
+    click.echo(f"Keep:       {result['paths_to_keep']}")
+    click.echo(f"Sync to:    {sync_branch}")
+    click.echo()
+
+    if dry_run:
+        click.echo(f"[git-sync] DRY RUN - Would push to {sync_branch}")
+        click.echo()
+        click.echo("Commits that would be pushed:")
+        for commit in result["dry_run_commits"]:
+            click.echo(commit)
+    else:
+        click.echo()
+        click.echo(f"=== Synced to {sync_branch} ===")
+
+    if merge and not dry_run:
+        if result["merge_success"]:
+            click.echo(f"[git-sync] Merged and pushed to {main_branch}")
+        else:
+            click.echo("[git-sync] Merge conflict! Please resolve manually:")
+
+    click.echo()
+    click.echo("Done!")

git_sync_filtered-0.1.0/git_sync_filtered/sync.py

@@ -0,0 +1,128 @@
+import os
+from itertools import filterfalse
+from pathlib import Path
+from tempfile import TemporaryDirectory
+from typing import Optional
+
+import git
+from git_filter_repo import FilteringOptions, RepoFilter
+
+
+def read_paths_from_file(path: Path) -> list[str]:
+    lines = (line.strip() for line in path.read_text().splitlines())
+    return list(filterfalse(lambda line: line.startswith("#") or not line, lines))
+
+
+def collect_paths_to_keep(
+    keep: tuple[str, ...], keep_from_file: Optional[str]
+) -> list[str]:
+    paths_to_keep = set(keep)
+
+    if keep_from_file:
+        paths_to_keep.update(read_paths_from_file(Path(keep_from_file)))
+
+    return sorted(list(paths_to_keep))
+
+
+def run_filter_repo(repo_path: str, paths_to_keep: list[str]) -> None:
+    old_cwd = os.getcwd()
+    os.chdir(repo_path)
+
+    try:
+        argv = ["--force", "--partial"]
+        for path in paths_to_keep:
+            argv.extend(["--path", path])
+
+        filter_args = FilteringOptions.parse_args(argv, error_on_empty=False)
+        repo_filter = RepoFilter(filter_args)
+        repo_filter.run()
+    finally:
+        os.chdir(old_cwd)
+
+
+def push_to_remote(
+    repo: git.Repo,
+    public_url: str,
+    sync_branch: str,
+    private_branch: str,
+    force: bool = False,
+    dry_run: bool = False,
+) -> list[str]:
+    if "public" not in repo.remotes:
+        repo.create_remote("public", public_url)
+    else:
+        repo.remote("public").set_url(public_url)
+
+    repo.remote("public").fetch()
+
+    if dry_run:
+        commits = []
+        for commit in repo.iter_commits(private_branch):
+            commits.append(f"  {commit.hexsha[:8]} {commit.summary}")
+        return commits
+    else:
+        refspec = f"refs/heads/{private_branch}:refs/heads/{sync_branch}"
+        repo.remote("public").push(refspec=refspec, force=force)
+        return []
+
+
+def merge_into_main(
+    repo: git.Repo,
+    main_branch: str,
+    sync_branch: str,
+) -> bool:
+    repo.heads[main_branch].checkout()
+
+    try:
+        sync_head = repo.heads[sync_branch]
+        repo.index.merge_commit(sync_head, msg=f"Merge branch '{sync_branch}'")
+
+        repo.remote("public").push(
+            refspec=f"refs/heads/{main_branch}:refs/heads/{main_branch}"
+        )
+        return True
+    except git.GitCommandError:
+        return False
+
+
+def sync(
+    private: str,
+    public: str,
+    keep: tuple[str, ...],
+    keep_from_file: Optional[str],
+    sync_branch: str,
+    main_branch: str,
+    private_branch: str,
+    dry_run: bool,
+    merge: bool,
+    force: bool,
+):
+    paths_to_keep = collect_paths_to_keep(keep, keep_from_file)
+
+    if not paths_to_keep:
+        raise ValueError("At least one --keep path or --keep-from-file required")
+
+    with TemporaryDirectory(prefix="git-sync-") as work_dir:
+        work_dir_path = Path(work_dir)
+        private_clone = work_dir_path / "private"
+        private_repo = git.Repo.clone_from(private, str(private_clone))
+
+        run_filter_repo(str(private_clone), paths_to_keep)
+
+        dry_run_commits = push_to_remote(
+            private_repo, public, sync_branch, private_branch, force, dry_run
+        )
+
+        if merge and not dry_run:
+            success = merge_into_main(private_repo, main_branch, sync_branch)
+            return {
+                "paths_to_keep": paths_to_keep,
+                "dry_run_commits": dry_run_commits,
+                "merge_success": success,
+            }
+
+        return {
+            "paths_to_keep": paths_to_keep,
+            "dry_run_commits": dry_run_commits,
+            "merge_success": None,
+        }

git_sync_filtered-0.1.0/git_sync_filtered.egg-info/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: git-sync-filtered
+Version: 0.1.0
+Summary: Sync filtered commits from private to public repository
+Author-email: Your Name <you@example.com>
+License: MIT
+Keywords: git,filter,sync,repo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: gitpython>=3.1
+Requires-Dist: git-filter-repo>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# git-sync-filtered
+
+![GitHub Repo stars](https://img.shields.io/github/stars/Merge-42/git-sync-filtered?style=social)
+![Python versions](https://img.shields.io/pypi/pyversions/git-sync-filtered)
+![License](https://img.shields.io/pypi/l/git-sync-filtered)
+
+A thin wrapper around [git-filter-repo](https://github.com/newren/git-filter-repo) for syncing filtered commits from a private repository to a public repository.
+
+## Overview
+
+git-sync-filtered clones a private repository, filters it to only include specified paths using git-filter-repo, and pushes the result to a public repository's sync branch. This enables maintaining a public subset of a private repository while preserving commit history.
+
+## Installation
+
+### uv (recommended)
+
+```bash
+uv tool install git+https://github.com/Merge-42/git-sync-filtered
+```
+
+### uvx (run without installing)
+
+```bash
+uvx git+https://github.com/Merge-42/git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep src \
+  --keep docs
+```
+
+### pip
+
+```bash
+pip install git+https://github.com/Merge-42/git-sync-filtered
+```
+
+## Usage
+
+```bash
+git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep src \
+  --keep docs
+```
+
+### Using a paths file
+
+Create a file with paths to keep (one per line, lines starting with `#` are comments):
+
+```text
+src
+docs
+README.md
+```
+
+```bash
+git-sync-filtered \
+  --private git@github.com:org/private.git \
+  --public git@github.com:org/public.git \
+  --keep-from-file paths.txt
+```
+
+## Options
+
+| Option             | Description                                   | Default         |
+| ------------------ | --------------------------------------------- | --------------- |
+| `--private`        | Private repo path or URL                      | Required        |
+| `--public`         | Public repo path or URL                       | Required        |
+| `--keep`           | Paths to keep (specify multiple)              | Required        |
+| `--keep-from-file` | File containing paths to keep                 | -               |
+| `--sync-branch`    | Sync branch name                              | `upstream/sync` |
+| `--main-branch`    | Main branch name                              | `main`          |
+| `--private-branch` | Private branch to sync from                   | `main`          |
+| `--dry-run`        | Show what would happen without making changes | `false`         |
+| `--merge`          | Merge into main branch after sync             | `false`         |
+| `--force`          | Force push                                    | `false`         |
+
+## How It Works
+
+1. Clones the private repository
+2. Runs git-filter-repo to filter to only the specified paths
+3. Pushes filtered commits to the public repository's sync branch
+4. Optionally merges the sync branch into main
+
+The sync branch can then be merged into main manually or with `--merge`.
+
+## Workflow
+
+```mermaid
+flowchart LR
+    A[Private Repo<br/>private-branch] -->|clone & filter| B[git-sync-filtered]
+    B -->|push| C[Public Repo<br/>sync-branch]
+    C -->|"merge<br/>(manual or with --merge)"| D[Public Repo<br/>main-branch]
+```
+
+## Requirements
+
+- Python 3.10+
+- git >= 2.36.0
+
+---
+
+Sponsored by [Merge 42](https://merge42.com)

git_sync_filtered-0.1.0/git_sync_filtered.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+git_sync_filtered/__main__.py
+git_sync_filtered/cli.py
+git_sync_filtered/sync.py
+git_sync_filtered.egg-info/PKG-INFO
+git_sync_filtered.egg-info/SOURCES.txt
+git_sync_filtered.egg-info/dependency_links.txt
+git_sync_filtered.egg-info/entry_points.txt
+git_sync_filtered.egg-info/requires.txt
+git_sync_filtered.egg-info/top_level.txt

git_sync_filtered-0.1.0/git_sync_filtered.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

git_sync_filtered-0.1.0/git_sync_filtered.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+git-sync-filtered = git_sync_filtered.__main__:main

git_sync_filtered-0.1.0/git_sync_filtered.egg-info/requires.txt

@@ -0,0 +1,8 @@
+click>=8.0
+gitpython>=3.1
+git-filter-repo>=2.0
+
+[dev]
+pytest
+ruff
+mypy

git_sync_filtered-0.1.0/git_sync_filtered.egg-info/top_level.txt

@@ -0,0 +1 @@
+git_sync_filtered

git_sync_filtered-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "git-sync-filtered"
+version = "0.1.0"
+description = "Sync filtered commits from private to public repository"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Your Name", email = "you@example.com" }]
+keywords = ["git", "filter", "sync", "repo"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+]
+
+dependencies = ["click>=8.0", "gitpython>=3.1", "git-filter-repo>=2.0"]
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff", "mypy"]
+
+[project.scripts]
+git-sync-filtered = "git_sync_filtered.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["git_sync_filtered*"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.mypy]
+python_version = "3.10"
+
+[dependency-groups]
+dev = ["pytest>=9.0.2"]

git_sync_filtered-0.1.0/setup.cfg

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