Add git-json generator and CLI tool with initial setup

- Implement GitJsonGenerator class to generate comprehensive git information.
- Create CLI interface for generating git json with customizable output path.
- Add .gitignore for IDE files and temporary directories.
- Update README with installation and usage instructions.
- Set up CI/CD workflows for testing and release management.

Author: DarwinsBuddy

.github/codecov.yml

@@ -0,0 +1,21 @@
+codecov:
+  require_ci_to_pass: true
+  max_report_age: false
+coverage:
+  status:
+    project:
+      default:
+        target: 80%
+    patch:
+      default:
+        target: 80%
+component_management:
+  default_rules:
+    statuses:
+      - type: project
+        target: auto
+  individual_components:
+    - component_id: git_json
+      name: git_json
+      paths:
+        - "git_json/**"

.github/workflows/build.yml

@@ -0,0 +1,44 @@
+name: build
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install Poetry
+      uses: snok/[email protected]
+    
+    - name: Install dependencies
+      run: poetry install --with dev
+    
+    - name: Run linting
+      run: poetry run ruff check .
+    
+    - name: Run tests
+      run: poetry run pytest --cov=git_json --cov-report=xml
+    
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        files: ./coverage.xml
+        fail_ci_if_error: false
+        token: ${{ secrets.CODECOV_TOKEN }}
+    
+    - name: Test CLI
+      run: poetry run git-json --package-path test-output

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  release:
+    types: [ created ]
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+    
+    - name: Install Poetry
+      uses: snok/[email protected]
+    
+    - name: Install dependencies
+      run: poetry install --with dev
+    
+    - name: Build package
+      run: poetry build
+
+    - name: Find wheel file
+      id: wheel
+      run: echo "wheel_path=$(ls dist/*.whl)" >> $GITHUB_OUTPUT
+
+    - name: Upload package to release
+      run: gh release upload ${{ github.event.release.tag_name }} ${{ steps.wheel.outputs.wheel_path }}
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Publish to PyPI
+      env:
+        POETRY_PYPI_TOKEN_PYPI: ${{ secrets.PYPI_API_TOKEN }}
+      run: poetry publish

.gitignore

@@ -1,3 +1,6 @@
+.idea
+.vscode
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[codz]

README.md

@@ -1 +1,77 @@
-# git-info
+# git-json
+[![codecov](https://codecov.io/github/unenv/git-json/graph/badge.svg?token=0QQ7JROLWL)](https://codecov.io/github/unenv/git-json)
+![PyPI - Version](https://img.shields.io/pypi/v/git-json)
+
+A Python tool to generate comprehensive git information for your projects.
+
+## Installation
+
+```bash
+pip install git-json
+```
+
+## Usage
+
+### Command Line
+
+```bash
+# Generate git info to default 'resources' directory
+git-json
+
+# Generate git info to custom directory
+git-json --package-path my-resources
+```
+
+### Python API
+
+```python
+from git_json import GitJsonGenerator
+
+generator = GitJsonGenerator()
+generator.generate_git_json("output-directory")
+```
+
+### Configuration
+
+You can set a default output path in your `pyproject.toml`:
+
+```toml
+[tool.git-json]
+path = "my-custom-path"
+```
+
+This is useful when using git-json as a poetry script:
+
+```toml
+[tool.poetry.scripts]
+git-json = "git_json.cli:main"
+
+[tool.git-json]
+path = "src/resources"
+```
+
+## Output
+
+Generates a `git.json` file with comprehensive git information including:
+
+- Branch information
+- Commit details (hash, message, author, time)
+- Build information (host, time, user)
+- Repository status (dirty, ahead/behind)
+- Tags and version information
+
+## Development
+
+```bash
+# Install dependencies
+poetry install --with dev
+
+# Run tests
+poetry run pytest
+
+# Run linting
+poetry run ruff check .
+
+# Generate git info
+poetry run git-json
+```

git_json/__init__.py

@@ -0,0 +1,3 @@
+from .generator import GitJsonGenerator
+
+__all__ = ["GitJsonGenerator"]

git_json/cli.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+
+import argparse
+from pathlib import Path
+from .generator import GitJsonGenerator
+
+try:
+    import tomllib
+except ImportError:
+    import tomli as tomllib
+
+def _get_default_path():
+    """Get default path from pyproject.toml or fallback."""
+    try:
+        pyproject_path = Path("pyproject.toml")
+        if pyproject_path.exists():
+            with open(pyproject_path, "rb") as f:
+                data = tomllib.load(f)
+                return data.get("tool", {}).get("git-json", {}).get("path", "resources")
+    except Exception:
+        pass
+    return "resources"
+
+def main():
+    """Generate git info."""
+    parser = argparse.ArgumentParser(description="Generate git info")
+    default_path = _get_default_path()
+    parser.add_argument("--package-path", default=default_path, 
+                       help=f"Package path for git info output (default: {default_path})")
+    args = parser.parse_args()
+    
+    generator = GitJsonGenerator()
+    generator.generate_git_json(args.package_path)
+
+if __name__ == "__main__":
+    main()

git_json/generator.py

@@ -0,0 +1,51 @@
+import json
+import subprocess
+from datetime import datetime
+from pathlib import Path
+
+
+class GitJsonGenerator:
+    def generate_git_json(self, package_path: str = "resources"):
+        target_dir = Path(package_path)
+        target_dir.mkdir(parents=True, exist_ok=True)
+        
+        git_json = {
+            "git.branch": self.run_git_command("git rev-parse --abbrev-ref HEAD"),
+            "git.build.host": subprocess.run("hostname", shell=True, capture_output=True, text=True).stdout.strip(),
+            "git.build.time": datetime.now().strftime("%d.%m.%Y @ %H:%M:%S %Z"),
+            "git.build.user.email": self.run_git_command("git config user.email"),
+            "git.build.user.name": self.run_git_command("git config user.name"),
+            "git.build.version": "1.0.0",
+            "git.closest.tag.commit.count": self.run_git_command("git describe --tags --abbrev=0 --match='*' --always"),
+            "git.closest.tag.name": self.run_git_command("git describe --tags --abbrev=0 --match='*' --always"),
+            "git.commit.author.time": self.run_git_command('git log -1 --format=%ad --date=format:"%d.%m.%Y @ %H:%M:%S "'),
+            "git.commit.committer.time": self.run_git_command('git log -1 --format=%cd --date=format:"%d.%m.%Y @ %H:%M:%S "'),
+            "git.commit.id": self.run_git_command("git rev-parse HEAD"),
+            "git.commit.id.abbrev": self.run_git_command("git rev-parse --short HEAD"),
+            "git.commit.id.describe": self.run_git_command("git describe --always --dirty"),
+            "git.commit.id.describe-short": self.run_git_command("git describe --always --dirty --abbrev=10"),
+            "git.commit.message.full": self.run_git_command("git log -1 --format=%B").replace("\n", "\\n"),
+            "git.commit.message.short": self.run_git_command("git log -1 --format=%s"),
+            "git.commit.time": self.run_git_command('git log -1 --format=%cd --date=format:"%d.%m.%Y @ %H:%M:%S "'),
+            "git.commit.user.email": self.run_git_command("git log -1 --format=%ae"),
+            "git.commit.user.name": self.run_git_command("git log -1 --format=%an"),
+            "git.dirty": "true" if self.run_git_command("git diff --quiet; echo $?") == "1" else "false",
+            "git.local.branch.ahead": self.run_git_command("git rev-list --count HEAD@{upstream}..HEAD 2>/dev/null || echo 0"),
+            "git.local.branch.behind": self.run_git_command("git rev-list --count HEAD...HEAD@{upstream} 2>/dev/null || echo 0"),
+            "git.remote.origin.url": self.run_git_command("git config --get remote.origin.url"),
+            "git.tags": self.run_git_command("git tag --points-at HEAD"),
+            "git.total.commit.count": self.run_git_command("git rev-list --count HEAD")
+        }
+        
+        json_file = target_dir / "git.json"
+        with open(json_file, "w") as f:
+            json.dump(git_json, f, indent=4)
+        
+        print(f"Generated git info: {json_file.absolute()}")
+
+    def run_git_command(self, cmd: str) -> str:
+        try:
+            result = subprocess.run(cmd, shell=True, capture_output=True, text=True, check=True)
+            return result.stdout.strip()
+        except subprocess.CalledProcessError:
+            return ""