ezgit-sync 0.1.0__py3-none-any.whl

autogit/__init__.py

@@ -0,0 +1 @@
+"""Top-level package for auto_git."""

autogit/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+if __name__ == "__main__":
+    app()

autogit/autogit.py

@@ -0,0 +1,139 @@
+"""Main module for autogit."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+# ANSI Escape Sequences for Terminal Styling
+COLOR_RESET = "\033[0m"
+BOLD = "\033[1m"
+DIM = "\033[2m"
+
+COLOR_GREEN = "\033[92m"
+COLOR_YELLOW = "\033[93m"
+COLOR_RED = "\033[91m"
+COLOR_CYAN = "\033[96m"
+
+
+def log_success(message: str) -> None:
+    """Prints a styled success message."""
+    print(f"{COLOR_GREEN}{BOLD}[SUCCESS]{COLOR_RESET} {message}")
+
+
+def log_warning(message: str) -> None:
+    """Prints a styled warning message."""
+    print(f"{COLOR_YELLOW}{BOLD}[WARNING]{COLOR_RESET} {message}")
+
+
+def log_info(message: str) -> None:
+    """Prints a styled info message."""
+    print(f"{COLOR_CYAN}{BOLD}[INFO]{COLOR_RESET} {message}")
+
+
+def log_error_with_reasons(title: str, reasons: list[str], raw_error: str | None = None) -> None:
+    """Formats and prints error explanations with probable causes and solutions."""
+    sys.stderr.write(f"\n{COLOR_RED}{BOLD}[ERROR] {title}{COLOR_RESET}\n")
+    sys.stderr.write(f"{BOLD}Possible Reasons & Solutions:{COLOR_RESET}\n")
+    for reason in reasons:
+        sys.stderr.write(f"  • {reason}\n")
+    
+    if raw_error:
+        sys.stderr.write(f"\n{DIM}Raw Git Error Details:\n{raw_error.strip()}{COLOR_RESET}\n")
+    sys.stderr.write("\n")
+
+
+def run_git(args: list[str], repo_root: Path) -> str:
+    """Executes a git command and returns its stripped stdout."""
+    result = subprocess.run(
+        ["git", *args],
+        cwd=repo_root,
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+    return result.stdout.strip()
+
+
+def verify_git_repository(repo_root: Path) -> bool:
+    """Checks if the current working directory is inside a valid Git repository."""
+    try:
+        run_git(["rev-parse", "--is-inside-work-tree"], repo_root)
+        return True
+    except subprocess.CalledProcessError:
+        log_error_with_reasons(
+            title=f"The directory '{repo_root.name}' is not a valid Git repository.",
+            reasons=[
+                "Git is not initialized in this directory. Run 'git init' to create a new repository.",
+                "You might be running the command in the wrong folder. Navigate to your project root.",
+            ],
+        )
+        return False
+
+
+def get_current_branch(repo_root: Path) -> str:
+    """Retrieves the name of the currently active branch."""
+    try:
+        branch = run_git(["rev-parse", "--abbrev-ref", "HEAD"], repo_root)
+        if branch == "HEAD":
+            raise RuntimeError("DETACHED_HEAD")
+        return branch
+    except (subprocess.CalledProcessError, RuntimeError) as exc:
+        raw_err = exc.stderr if isinstance(exc, subprocess.CalledProcessError) else str(exc)
+        log_error_with_reasons(
+            title="Failed to determine active Git branch.",
+            reasons=[
+                "This repository might be completely empty (no commits yet). Create an initial commit first: 'git add . && git commit -m \"initial commit\"'",
+                "Your repository might be in a 'detached HEAD' state. Switch to a branch using 'git checkout <branch-name>'.",
+            ],
+            raw_error=raw_err,
+        )
+        raise exc
+
+
+def pull_remote_changes(repo_root: Path, branch: str) -> bool:
+    """Pulls recent changes from the remote repository."""
+    log_info(f"Pulling latest updates from origin/{branch}...")
+    try:
+        run_git(["pull", "origin", branch], repo_root)
+        return True
+    except subprocess.CalledProcessError as exc:
+        log_error_with_reasons(
+            title=f"Failed to pull changes from origin/{branch}.",
+            reasons=[
+                "There might be merge conflicts between local and remote files. Resolve conflicts manually.",
+                "The remote branch 'origin/{branch}' might not exist yet on the remote server.",
+                "You might be offline or lack permission to access the remote repository.",
+            ],
+            raw_error=exc.stderr,
+        )
+        return False
+
+
+def has_local_changes(repo_root: Path) -> bool:
+    """Checks if there are uncommitted local modifications."""
+    status = run_git(["status", "--porcelain"], repo_root)
+    return bool(status)
+
+
+def sync_local_changes(repo_root: Path, branch: str, commit_message: str) -> None:
+    """Stages, commits, and pushes local changes to the remote repository."""
+    log_info("Staging and committing local changes...")
+    run_git(["add", "-A"], repo_root)
+    run_git(["commit", "-m", commit_message], repo_root)
+
+    log_info(f"Pushing updates to origin/{branch}...")
+    try:
+        run_git(["push", "origin", branch], repo_root)
+    except subprocess.CalledProcessError as exc:
+        log_error_with_reasons(
+            title=f"Failed to push changes to origin/{branch}.",
+            reasons=[
+                "Remote contains commits that you do not have locally. Try pulling first.",
+                "You may not have write permissions for this remote repository.",
+                "Your authentication credentials (SSH key or GitHub token) might be missing or expired.",
+            ],
+            raw_error=exc.stderr,
+        )
+        raise exc

autogit/cli.py

@@ -0,0 +1,60 @@
+"""Console script for autogit."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from autogit.autogit import (
+    get_current_branch,
+    has_local_changes,
+    log_error,
+    log_success,
+    log_warning,
+    pull_remote_changes,
+    sync_local_changes,
+    verify_git_repository,
+)
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Console script for autogit."""
+    parser = argparse.ArgumentParser(
+        description="Pull remote updates, stage, commit, and push the current repository to GitHub."
+    )
+    parser.add_argument(
+        "-m",
+        "--message",
+        default="Sync updates",
+        help="Commit message to use when creating the commit.",
+    )
+    args = parser.parse_args(argv)
+    repo_root = Path.cwd()
+
+    if not verify_git_repository(repo_root):
+        log_error(f"The current directory '{repo_root}' is not a valid Git repository.")
+        return 1
+
+    try:
+        branch = get_current_branch(repo_root)
+
+        if not pull_remote_changes(repo_root, branch):
+            return 1
+
+        if not has_local_changes(repo_root):
+            log_warning("No new local changes to commit after pulling updates.")
+            return 0
+
+        sync_local_changes(repo_root, branch, args.message)
+
+        log_success(f"Successfully synchronized repository with origin/{branch}.")
+        return 0
+
+    except Exception as exc:
+        log_error(f"An error occurred during synchronization: {exc}")
+        return 1
+
+app = main
+if __name__ == "__main__":
+    sys.exit(main())

autogit/py.typed

@@ -0,0 +1 @@
+# Marker file for PEP 561

autogit/utils.py

@@ -0,0 +1,2 @@
+def do_something_useful() -> None:
+    print("Replace this with a utility function")

ezgit_sync-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: ezgit-sync
+Version: 0.1.0
+Summary: This package is a basic git automator for deep learning and machine learning tasks.
+Project-URL: bugs, https://github.com/hasanaliozkan-dev/autogit/issues
+Project-URL: changelog, https://github.com/hasanaliozkan-dev/autogit/releases
+Project-URL: documentation, https://hasanaliozkan-dev.github.io/autogit/
+Project-URL: homepage, https://github.com/hasanaliozkan-dev/autogit
+Author-email: Hasan Ali Özkan <hasanaliozkan@mu.edu.tr>
+Maintainer-email: Hasan Ali Özkan <hasanaliozkan@mu.edu.tr>
+License: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: rich
+Requires-Dist: typer
+Description-Content-Type: text/markdown
+
+# auto_git
+
+![PyPI version](https://img.shields.io/pypi/v/autogit.svg)
+
+This package is a basic git automator for deep learning and machine learning tasks.
+
+* [GitHub](https://github.com/hasanaliozkan-dev/autogit/) | [PyPI](https://pypi.org/project/autogit/) | [Documentation](https://hasanaliozkan-dev.github.io/autogit/)
+* Created by [Hasan Ali Özkan](https://hasanaliozkan-dev.github.io/) | GitHub [@hasanaliozkan-dev](https://github.com/hasanaliozkan-dev) | PyPI [@hasanaliozkan](https://pypi.org/user/hasanaliozkan/)
+* MIT License
+
+## Features
+
+* TODO
+
+## Documentation
+
+Documentation is built with [Zensical](https://zensical.org/) and deployed to GitHub Pages.
+
+* **Live site:** https://hasanaliozkan-dev.github.io/autogit/
+* **Preview locally:** `just docs-serve` (serves at http://localhost:8000)
+* **Build:** `just docs-build`
+
+API documentation is auto-generated from docstrings using [mkdocstrings](https://mkdocstrings.github.io/).
+
+Docs deploy automatically on push to `main` via GitHub Actions. To enable this, go to your repo's Settings > Pages and set the source to **GitHub Actions**.
+
+## Development
+
+To set up for local development:
+
+```sh
+# Clone your fork
+git clone git@github.com:your_username/autogit.git
+cd autogit
+
+# Install dependencies
+uv sync
+
+# Create a branch for development
+git checkout -b feature/new-awesome-feature
+```
+
+This installs the CLI globally but with live updates - any changes you make to the source code are immediately available when you run `autogit`.
+
+Run tests:
+
+```bash
+uv run pytest
+```
+
+Run quality checks (format, lint, type check, test):
+
+```bash
+just qa
+```
+
+## Author
+
+auto_git was created in 2026 by Hasan Ali Özkan.
+
+Built with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [audreyfeldroy/cookiecutter-pypackage](https://github.com/audreyfeldroy/cookiecutter-pypackage) project template.

ezgit_sync-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+autogit/__init__.py,sha256=NnmvoOhzsrQhG-0n-m1mVAqsP8U5n7FATgJrPuVtiB0,38
+autogit/__main__.py,sha256=Qd-f8z2Q2vpiEP2x6PBFsJrpACWDVxFKQk820MhFmHo,59
+autogit/autogit.py,sha256=WVykX1qGJyCskO9Phs6-b7C1Wx_0p6BpUyESZXDcJvc,5194
+autogit/cli.py,sha256=pKiWmBagVYzaPWWkOT60iu54mzj1x7V2LD7KU4zE2kc,1557
+autogit/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26
+autogit/utils.py,sha256=HppGIYjTTn56wTOArW3kxDDc2bMnrGVBQB2DIaoLnI4,85
+ezgit_sync-0.1.0.dist-info/METADATA,sha256=LlJ7xJX8rc9xk5_IECmemyVj5QubpMfiwg1UtXMgiks,2696
+ezgit_sync-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+ezgit_sync-0.1.0.dist-info/entry_points.txt,sha256=f3gTyjE1mWQc45DlNd5ry0yEQnRRAwl1irLam9cGvTw,45
+ezgit_sync-0.1.0.dist-info/licenses/LICENSE,sha256=OCptpIILuJZlFEE1yk_SKTrMfXvGHgTXSD07s-RM1bI,1074
+ezgit_sync-0.1.0.dist-info/RECORD,,

ezgit_sync-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

ezgit_sync-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+autogit = autogit.cli:main

ezgit_sync-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026, Hasan Ali Özkan
+
+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.