tagdiff 0.1.0__py3-none-any.whl

tagdiff/__init__.py

@@ -0,0 +1,3 @@
+from .core import get_changelog
+
+__all__ = ["get_changelog"]

tagdiff/cli.py

@@ -0,0 +1,46 @@
+import argparse
+import json
+import sys
+
+from tagdiff.core import get_changelog
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Compare GitHub release tags.")
+    parser.add_argument("repo", help="GitHub repo in owner/name format")
+    parser.add_argument("old_version", help="Starting tag")
+    parser.add_argument("new_version", help="Ending tag")
+    parser.add_argument("--structured", action="store_true", help="Extract structured changelog using AI")
+    parser.add_argument("--model", help="AI model to use (e.g. gpt-4o)")
+    parser.add_argument("--output", help="Save result to a JSON file")
+    parser.add_argument("--verbose", action="store_true", help="Show progress during execution")
+    args = parser.parse_args()
+
+    try:
+        result = get_changelog(
+            args.repo, 
+            args.old_version, 
+            args.new_version, 
+            structured=args.structured,
+            model=args.model,
+            verbose=args.verbose
+        )
+    except ValueError as exc:
+        print(json.dumps({"error": str(exc)}))
+        return 1
+
+    formatted_result = json.dumps(result, indent=2)
+    
+    if args.output:
+        with open(args.output, "w") as f:
+            f.write(formatted_result)
+        if args.verbose:
+            print(f"Result saved to {args.output}")
+    else:
+        print(formatted_result)
+        
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

tagdiff/core.py

@@ -0,0 +1,148 @@
+import json
+import os
+import requests
+from concurrent.futures import ThreadPoolExecutor
+
+def fetch_releases(repo, stop_at_tag=None):
+    token = os.getenv("GITHUB_TOKEN")
+    headers = {}
+    if token:
+        headers["Authorization"] = f"token {token}"
+
+    releases = []
+    page = 1
+    while True:
+        url = f"https://api.github.com/repos/{repo}/releases?page={page}&per_page=100"
+        response = requests.get(url, headers=headers, timeout=30)
+        if response.status_code != 200:
+            if response.status_code == 403:
+                raise ValueError("GitHub API rate limit exceeded. Use GITHUB_TOKEN to increase limits.")
+            break
+            
+        data = response.json()
+        if not data:
+            break
+            
+        releases.extend(data)
+        
+        # Check if we found the stop_at_tag
+        if stop_at_tag:
+            found = any(r.get("tag_name") == stop_at_tag for r in data)
+            if found:
+                break
+        
+        page += 1
+        if page > 10: # Safety limit
+            break
+            
+    return releases
+
+
+def get_changes_between_versions(releases, old_version, new_version, structured=False, model=None, verbose=False):
+    changes = {}
+    ordered_releases = list(reversed(releases))
+
+    to_process = []
+    collecting = False
+    for release in ordered_releases:
+        tag = release.get("tag_name")
+        if tag == old_version:
+            collecting = True
+            continue
+
+        if tag == new_version:
+            break
+
+        if collecting:
+            to_process.append(release)
+
+    def process_release(release):
+        tag = release.get("tag_name")
+        published_at = release.get("published_at")
+        changelog = release.get("body")
+        
+        if verbose:
+            print(f"Processing {tag}...")
+
+        change_data = {
+            "published_at": published_at,
+            "changelog": changelog,
+        }
+        
+        if structured and changelog and changelog.strip():
+            structured_data = generate_structured_changelog(changelog, model=model)
+            if structured_data:
+                change_data["structured_changelog"] = structured_data
+        
+        return tag, change_data
+
+    # Parallelize LLM calls
+    if structured and to_process:
+        with ThreadPoolExecutor(max_workers=5) as executor:
+            results = list(executor.map(process_release, to_process))
+            for tag, data in results:
+                changes[tag] = data
+    else:
+        for release in to_process:
+            tag, data = process_release(release)
+            changes[tag] = data
+
+    return changes
+
+
+def get_changelog(repo, old_version, new_version, structured=False, model=None, verbose=False):
+    releases = fetch_releases(repo, stop_at_tag=old_version)
+    if not releases:
+        raise ValueError(f"Could not fetch releases for repo: {repo}")
+
+    changes = get_changes_between_versions(
+        releases, 
+        old_version, 
+        new_version, 
+        structured=structured, 
+        model=model,
+        verbose=verbose
+    )
+
+    return {
+        "repo": repo,
+        "from": old_version,
+        "to": new_version,
+        "changes": changes,
+    }
+
+
+def generate_structured_changelog(changelog_text, model=None):
+    try:
+        from litellm import completion
+    except ImportError:
+        return {"error": "litellm package missing. Install it with 'pip install litellm'"}
+
+    prompt = """
+    You are a changelog assistant.
+    Extract the following from the changelog text:
+    - breaking_changes (list of strings)
+    - features (list of strings)
+    - fixes (list of strings)
+    - deprecations (list of strings)
+    - other (list of strings)
+
+    Return ONLY JSON. Do not use markdown blocks.
+    """
+
+    if not model:
+        model = os.getenv("TAGDIFF_MODEL", "gpt-4o-mini")
+
+    try:
+        response = completion(
+            model=model,
+            messages=[
+                {"role": "system", "content": prompt},
+                {"role": "user", "content": changelog_text}
+            ],
+            response_format={"type": "json_object"}
+        )
+        content = response.choices[0].message.content
+        return json.loads(content)
+    except Exception as e:
+        return {"error": str(e)}

tagdiff-0.1.0.dist-info/METADATA

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: tagdiff
+Version: 0.1.0
+Summary: Compare GitHub release changelogs between tags
+Author-email: ar9av <ar9avg@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 ar9av
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/ar9av/tagdiff
+Project-URL: Bug Tracker, https://github.com/ar9av/tagdiff/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: litellm>=1.0.0
+Dynamic: license-file
+
+# TagDiff
+
+TagDiff compares GitHub release notes between two version tags.
+
+## What It Does
+- Fetches releases from GitHub for a repository
+- Compares releases between `old_version` and `new_version`
+- Returns a JSON changelog result
+- Uses one shared core function for package, CLI, and Docker
+
+## Project Structure
+- `tagdiff/core.py`: shared logic (`get_changelog`)
+- `tagdiff/cli.py`: CLI wrapper
+- `tagdiff/__init__.py`: package export
+- `pyproject.toml`: package + CLI entrypoint config
+- `Dockerfile`: Docker image setup
+- `startup.txt`: quick start commands
+
+## Install
+```powershell
+python -m pip install .
+```
+
+## Run (CLI)
+```powershell
+tagdiff owner/repo old_version new_version
+```
+
+Example:
+```powershell
+tagdiff psf/requests v2.31.0 v2.32.0
+```
+
+## Run (Module)
+```powershell
+python -m tagdiff.cli psf/requests v2.31.0 v2.32.0
+```
+
+## Run (Docker)
+```powershell
+docker build -t tagdiff-local .
+docker run --rm tagdiff-local psf/requests v2.31.0 v2.32.0
+```
+
+## Use Core Function Directly
+```python
+from tagdiff import get_changelog
+
+result = get_changelog("psf/requests", "v2.31.0", "v2.32.0")
+print(result)
+```

tagdiff-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+tagdiff/__init__.py,sha256=QNTGJ0ooySGskoiFKVhlUgIypTmqLnHXyj2589Gw284,61
+tagdiff/cli.py,sha256=GPxNTXooKr4dFjdeXVq9uU5EG7jgZ3BtWqTiheg3VEY,1428
+tagdiff/core.py,sha256=aSTiZenUXQakcC3D5pQtEOk_tl_5Xurk3t43rTW_C6s,4285
+tagdiff-0.1.0.dist-info/licenses/LICENSE,sha256=P2FV1z_xATK0LC3b72iVe6JDUySez_SqauaeiyOL5bE,1062
+tagdiff-0.1.0.dist-info/METADATA,sha256=fV_RQ8AT1miEIhGO9kDzJ-CGN95_gZaKojjocO6AtxY,2951
+tagdiff-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+tagdiff-0.1.0.dist-info/entry_points.txt,sha256=OsP2pz8DllOtipMbATYQV5GFodp4WqGbHvjKEE7ewqg,45
+tagdiff-0.1.0.dist-info/top_level.txt,sha256=AgdPSp8nqVotdkXEE41dPdGT23d1SCwl_69zeR8XS7Y,8
+tagdiff-0.1.0.dist-info/RECORD,,

tagdiff-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tagdiff-0.1.0.dist-info/entry_points.txt

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

tagdiff-0.1.0.dist-info/licenses/LICENSE

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

tagdiff-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tagdiff