github-sync-agent 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

github_sync/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.0"
+__version__ = "0.1.2"

github_sync/agent.py

@@ -153,19 +153,23 @@ def sync_project(path: Path, cfg: dict, dry_run: bool) -> bool:
 # ---------------------------------------------------------------------------
 
 def discover_projects(cfg: dict, project_name: str | None = None) -> list[Path]:
-    root = Path(cfg["projects_root"])
+    roots = [Path(r) for r in cfg["projects_root"]]
     exclude = set(cfg.get("exclude", []))
 
     if project_name:
-        path = root / project_name
-        if not path.is_dir():
-            raise ValueError(f"Project '{project_name}' not found in {root}")
-        return [path]
+        for root in roots:
+            path = root / project_name
+            if path.is_dir():
+                return [path]
+        searched = ", ".join(str(r) for r in roots)
+        raise ValueError(f"Project '{project_name}' not found in: {searched}")
 
-    return sorted(
-        p for p in root.iterdir()
-        if p.is_dir() and p.name not in exclude and not p.name.startswith(".")
-    )
+    projects = []
+    for root in roots:
+        for p in sorted(root.iterdir()):
+            if p.is_dir() and p.name not in exclude and not p.name.startswith("."):
+                projects.append(p)
+    return projects
 
 
 # ---------------------------------------------------------------------------
@@ -173,20 +177,22 @@ def discover_projects(cfg: dict, project_name: str | None = None) -> list[Path]:
 # ---------------------------------------------------------------------------
 
 def get_status(cfg: dict) -> list[dict]:
-    root = Path(cfg["projects_root"])
+    roots = [Path(r) for r in cfg["projects_root"]]
     exclude = set(cfg.get("exclude", []))
     github_user = cfg["github_user"]
     rows = []
 
-    for path in sorted(root.iterdir()):
-        if not path.is_dir() or path.name in exclude or path.name.startswith("."):
-            continue
-        rows.append({
-            "project": path.name,
-            "git": is_git_repo(path),
-            "remote": is_git_repo(path) and has_remote(path),
-            "changes": has_uncommitted_changes(path) if is_git_repo(path) else False,
-            "on_github": github_repo_exists(github_user, path.name),
-        })
+    for root in roots:
+        for path in sorted(root.iterdir()):
+            if not path.is_dir() or path.name in exclude or path.name.startswith("."):
+                continue
+            rows.append({
+                "project": path.name,
+                "root": str(root),
+                "git": is_git_repo(path),
+                "remote": is_git_repo(path) and has_remote(path),
+                "changes": has_uncommitted_changes(path) if is_git_repo(path) else False,
+                "on_github": github_repo_exists(github_user, path.name),
+            })
 
     return rows

github_sync/cli.py

@@ -66,7 +66,9 @@ def sync(ctx: click.Context, project: str | None, dry_run: bool) -> None:
         click.echo(f"Error: {exc}", err=True)
         sys.exit(1)
 
-    logging.info(f"Syncing {len(projects)} project(s) → github.com/{cfg['github_user']}")
+    roots = cfg['projects_root']
+    roots_str = roots[0] if len(roots) == 1 else f"{len(roots)} roots"
+    logging.info(f"Syncing {len(projects)} project(s) from {roots_str} → github.com/{cfg['github_user']}")
 
     results = []
     for path in projects:
@@ -95,16 +97,20 @@ def status(ctx: click.Context) -> None:
     cfg = ctx.obj["cfg"]
     rows = agent.get_status(cfg)
 
-    click.echo(f"\nProjects root : {cfg['projects_root']}")
+    roots = cfg['projects_root']
+    click.echo(f"\nProjects root : {roots[0] if len(roots) == 1 else str(roots)}")
     click.echo(f"GitHub user   : {cfg['github_user']}\n")
 
-    header = f"{'Project':<25} {'Git':<6} {'Remote':<8} {'Changes':<10} {'On GitHub'}"
+    header = f"{'Project':<25} {'Root':<30} {'Git':<6} {'Remote':<8} {'Changes':<10} {'On GitHub'}"
     click.echo(header)
     click.echo("─" * len(header))
 
     for row in rows:
+        # Show only the last part of root to keep table readable
+        root_short = Path(row['root']).name
         click.echo(
             f"{row['project']:<25} "
+            f"{root_short:<30} "
             f"{'✓' if row['git'] else '✗':<6} "
             f"{'✓' if row['remote'] else '✗':<8} "
             f"{'dirty' if row['changes'] else 'clean':<10} "

github_sync/config.py

@@ -26,10 +26,14 @@ def _apply_defaults(cfg: dict) -> None:
     cfg.setdefault("exclude", [])
     cfg.setdefault("log_file", str(Path.home() / ".local" / "share" / "github-sync" / "github-sync.log"))
     cfg.setdefault("log_level", "INFO")
-    # Expand ~ in projects_root
-    if "projects_root" in cfg:
-        cfg["projects_root"] = str(Path(cfg["projects_root"]).expanduser())
 
-    for key in ("github_user", "projects_root"):
-        if not cfg.get(key):
-            raise ValueError(f"Missing required config key: '{key}'")
+    if not cfg.get("github_user"):
+        raise ValueError("Missing required config key: 'github_user'")
+
+    # Normalize projects_root to a list of expanded absolute paths
+    raw = cfg.get("projects_root")
+    if not raw:
+        raise ValueError("Missing required config key: 'projects_root'")
+    if isinstance(raw, str):
+        raw = [raw]
+    cfg["projects_root"] = [str(Path(p).expanduser().resolve()) for p in raw]

github_sync/setup.py

@@ -112,8 +112,20 @@ CONFIG_TEMPLATE = """\
 
 github_user: {github_user}
 
-# Root folder — every subdirectory here is treated as a project to sync
-projects_root: {projects_root}
+# Directories to scan for projects.
+# Every subdirectory inside each root is treated as a project to sync.
+# You can specify one path (string) or multiple paths (list):
+#
+#   Single path:
+#     projects_root: ~/projects
+#
+#   Multiple paths:
+#     projects_root:
+#       - ~/projects
+#       - ~/work
+#       - /opt/company-code
+projects_root:
+  - {projects_root}
 
 # Daily schedule time (used by the systemd timer / cron)
 schedule_time: "02:00"

github_sync_agent-0.1.2.dist-info/METADATA

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: github-sync-agent
+Version: 0.1.2
+Summary: Sync all your local projects to GitHub automatically
+License: MIT
+Project-URL: Homepage, https://github.com/yuvalavni/Agents
+Project-URL: Repository, https://github.com/yuvalavni/Agents
+Project-URL: Bug Tracker, https://github.com/yuvalavni/Agents/issues
+Keywords: github,git,sync,backup,automation,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: click>=8.0
+
+# GitHub Sync Agent
+
+Automatically syncs every local project directory to its own GitHub repository.
+
+For each project it will:
+1. `git init` if not already a repo
+2. Create the GitHub repo if it doesn't exist yet
+3. Ensure the remote uses SSH
+4. Stage + commit any uncommitted changes
+5. Push to `origin`
+
+Runs daily via a systemd user timer, and on-demand via CLI.
+
+---
+
+## Installation
+
+```bash
+pip install github-sync-agent
+```
+
+## First-time setup
+
+```bash
+github-sync init
+```
+
+The wizard will:
+- Check `git` and `gh` are installed
+- Authenticate with GitHub (`gh auth login`)
+- Ask which folder to scan for projects
+- Set up your SSH key automatically
+- Write a config file to `~/.config/github-sync/config.yaml`
+
+---
+
+## Usage
+
+```bash
+# Sync all projects
+github-sync sync
+
+# Sync a single project
+github-sync sync --project my-project
+
+# Preview without making changes
+github-sync sync --dry-run
+
+# Show status of all projects
+github-sync status
+```
+
+---
+
+## Configuration (`~/.config/github-sync/config.yaml`)
+
+Generated by `github-sync init`. You can edit it at any time.
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `github_user` | _(detected from gh auth)_ | Your GitHub username |
+| `projects_root` | `~/projects` | Scans all subdirectories here |
+| `schedule_time` | `02:00` | Daily run time |
+| `default_visibility` | `private` | `private` or `public` for new repos |
+| `auto_commit_message` | `chore: auto-sync` | Commit message for auto-commits |
+| `exclude` | `[]` | Directory names to skip |
+| `log_file` | `~/.local/share/github-sync/github-sync.log` | Log file path |
+| `log_level` | `INFO` | `DEBUG` / `INFO` / `WARNING` / `ERROR` |
+
+### Excluding a project
+
+```yaml
+exclude:
+  - SomeProjectToSkip
+```
+
+---
+
+## Requirements
+
+- Python 3.10+
+- `git` installed
+- `gh` (GitHub CLI) installed — [installation guide](https://cli.github.com)
+
+---
+
+## License
+
+MIT

github_sync_agent-0.1.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+github_sync/__init__.py,sha256=YvuYzWnKtqBb-IqG8HAu-nhIYAsgj9Vmc_b9o7vO-js,22
+github_sync/agent.py,sha256=2WnJCwupDwT3C9bNZLoj2CAvZW-eoqZChqFTk4wNRKw,6692
+github_sync/cli.py,sha256=ndmfTQhK4KbtVEjXWuOg4RLs3UVFpgb0rZAf_YZFWgs,9336
+github_sync/config.py,sha256=BQrSW7DyhcZB6gZnDKkc-W6u1vtD-l76Rn_gW8Egypk,1444
+github_sync/setup.py,sha256=2ZO0ZCCxQ_LyVSdQbWrObwjjBQCDLqdu_IHplUqW0qU,4720
+github_sync_agent-0.1.2.dist-info/METADATA,sha256=u4dfGfpiUf-TQgtldf043Wj1NSZFvTy8fJG2bYj4dFo,2644
+github_sync_agent-0.1.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+github_sync_agent-0.1.2.dist-info/entry_points.txt,sha256=-LmJUTvRzj5cvyS-dEWdipouBj3dgkW6hqrTz1GmyGw,53
+github_sync_agent-0.1.2.dist-info/top_level.txt,sha256=fPYTA83USK1N4JwfouV8zcejgWfWmqRAKQVDCAT8a5I,12
+github_sync_agent-0.1.2.dist-info/RECORD,,

github_sync_agent-0.1.0.dist-info/METADATA

@@ -1,132 +0,0 @@
-Metadata-Version: 2.4
-Name: github-sync-agent
-Version: 0.1.0
-Summary: Sync all your local projects to GitHub automatically
-Author: yuvalavni
-License: MIT
-Project-URL: Homepage, https://github.com/yuvalavni/Agents
-Project-URL: Repository, https://github.com/yuvalavni/Agents
-Keywords: github,git,sync,backup,automation,cli
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Environment :: Console
-Classifier: Topic :: Software Development :: Version Control :: Git
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: click>=8.0
-
-# GitHub Sync Agent
-
-Automatically syncs every project under `/home/yuval/projects` to GitHub (`github.com/yuvalavni`).
-
-For each project it will:
-1. `git init` if not already a repo
-2. Create the GitHub repo if it doesn't exist yet
-3. Ensure the remote uses SSH
-4. Stage + commit any uncommitted changes
-5. Push to `origin`
-
-Runs daily at **02:00** via a systemd user timer, and on-demand via CLI.
-
----
-
-## Directory layout
-
-```
-agents/github-sync/
-├── github_sync_agent.py   # Main script
-├── config.yaml            # GitHub user, projects root, schedule, exclusions
-├── requirements.txt
-├── install.sh             # One-time setup
-├── systemd/
-│   ├── github-sync.service
-│   └── github-sync.timer
-└── logs/
-    └── github-sync.log
-```
-
----
-
-## Quick start
-
-```bash
-cd /home/yuval/projects/Agents/agents/github-sync
-
-# 1. Install (once)
-bash install.sh
-
-# 2. Dry run
-.venv/bin/python github_sync_agent.py --dry-run
-
-# 3. Sync for real
-.venv/bin/python github_sync_agent.py
-```
-
----
-
-## Configuration (`config.yaml`)
-
-| Key | Default | Description |
-|-----|---------|-------------|
-| `github_user` | `yuvalavni` | GitHub username |
-| `projects_root` | `/home/yuval/projects` | Scans all subdirectories here |
-| `schedule_time` | `02:00` | Daily run time |
-| `default_visibility` | `private` | `private` or `public` for new repos |
-| `auto_commit_message` | `chore: auto-sync` | Commit message for auto-commits |
-| `exclude` | `[]` | Directory names to skip |
-| `log_file` | `logs/github-sync.log` | Log file path |
-| `log_level` | `INFO` | `DEBUG` / `INFO` / `WARNING` / `ERROR` |
-
-### Excluding a project
-
-```yaml
-exclude:
-  - SomePrivateProject
-  - TempExperiment
-```
-
----
-
-## CLI reference
-
-```bash
-# Sync all projects
-.venv/bin/python github_sync_agent.py
-
-# Sync a single project
-.venv/bin/python github_sync_agent.py --project Agents
-
-# Preview without making any changes
-.venv/bin/python github_sync_agent.py --dry-run
-
-# Show status of all projects (git, remote, changes, GitHub)
-.venv/bin/python github_sync_agent.py --status
-```
-
----
-
-## Systemd
-
-```bash
-# Trigger immediately
-systemctl --user start github-sync.service
-
-# Check next scheduled run
-systemctl --user list-timers github-sync.timer
-
-# View live logs
-journalctl --user -u github-sync.service -f
-
-# Disable daily timer
-systemctl --user disable --now github-sync.timer
-```
-
----
-
-## Prerequisites
-
-- `git` installed
-- `gh` installed and authenticated (`gh auth status`)
-- SSH key added to GitHub (`gh ssh-key list`)

github_sync_agent-0.1.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-github_sync/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
-github_sync/agent.py,sha256=E21j6AoXXnmtEWKV6LjECMhyfQ78PY9ifyWBKUga3Xk,6391
-github_sync/cli.py,sha256=GFakiYck02S7ZxsKfVqO_bi2Gc427B87kAgzvMUpKLs,9004
-github_sync/config.py,sha256=zywBw0AkDzk1wHamyJ-sbss3DMAXWq7fZeoDKR1fE_s,1306
-github_sync/setup.py,sha256=keV0bBTgADASGBOCmd6Jv8eXqIg_g0uxbBIYpCHaMxA,4461
-github_sync_agent-0.1.0.dist-info/METADATA,sha256=JZR8uNJHQpRgUSfM0ikh_vyHSlNC5cwuAh3rTE5XNUw,3234
-github_sync_agent-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-github_sync_agent-0.1.0.dist-info/entry_points.txt,sha256=-LmJUTvRzj5cvyS-dEWdipouBj3dgkW6hqrTz1GmyGw,53
-github_sync_agent-0.1.0.dist-info/top_level.txt,sha256=fPYTA83USK1N4JwfouV8zcejgWfWmqRAKQVDCAT8a5I,12
-github_sync_agent-0.1.0.dist-info/RECORD,,