osslag 1.0.0__tar.gz → 1.0.1__tar.gz

osslag-1.0.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,54 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Build release distributions
+        run: make build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/osslag
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

osslag-1.0.1/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv/
+
+# Project specific
+cache/
+*.log.*
+
+# Environment variables
+.env
+.env.local
+
+# OS
+.DS_Store
+Thumbs.db
+github_debug.log
+osslag.log
+CLAUDE.md

osslag-1.0.1/.python-version

@@ -0,0 +1 @@
+3.14

osslag-1.0.1/.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: My Module with Args",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "osslag.cli",
+            "console": "integratedTerminal",
+            "justMyCode": false,
+            "args": [
+                "get-metadata",
+                "https://github.com/shanep/demo"
+            ]
+        }
+    ]
+}

osslag-1.0.1/.vscode/settings.json

@@ -0,0 +1,25 @@
+{
+    "python.testing.pytestEnabled": true,
+    "python.testing.unittestEnabled": false,
+    "cSpell.words": [
+        "checkpointed",
+        "creds",
+        "dateutil",
+        "dotenv",
+        "mrsc",
+        "osslag",
+        "relativedelta",
+        "revparse",
+        "rmvconstants",
+        "rmvs",
+        "sboudrias",
+        "snoyberg",
+        "trixie",
+        "venv"
+    ],
+    "outline.collapseItems": "alwaysCollapse",
+    "outline.problems.enabled": true,
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+}

osslag-1.0.1/LICENSE

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

osslag-1.0.1/Makefile

@@ -0,0 +1,52 @@
+VENV ?= .venv
+
+.PHONY: bootstrap install lint fmt typecheck test clean help
+
+help:
+	@echo "Makefile commands:"
+	@echo "  bootstrap   - Check uv installation and sync dependencies"
+	@echo "  install     - Install the package in editable mode"
+	@echo "  lint        - Lint the code using ruff"
+	@echo "  fmt         - Format the code using ruff"
+	@echo "  typecheck   - Type check the code using pyright"
+	@echo "  test        - Run tests using pytest"
+	@echo "  clean       - Clean up build artifacts and caches"
+
+bootstrap:
+	@echo "check the uv installation..."
+	@if ! command -v uv >/dev/null 2>&1; then \
+	  echo "uv not found."; \
+	  echo "Check https://github.com/astral-sh/uv for installation instructions."; \
+	  exit 1; \
+	else \
+	  echo "uv is installed: $$(uv --version)"; \
+	fi
+	@echo "Syncing dependencies using uv..."
+	@uv sync
+
+lint:
+	uv run ruff check .
+
+fmt:
+	uv run ruff format .
+
+typecheck:
+	uv run pyright src tests
+
+test:
+	uv run pytest
+
+install:
+	uv tool install . -e
+
+build:
+	uv build
+
+clean:
+	uv cache clean
+	rm -rf $(VENV)
+	rm -rf *.egg-info
+	find . -type d -name "__pycache__" -exec rm -rf {} +
+	find . -type d -name ".ruff_cache" -exec rm -rf {} +
+	find . -type d -name ".uv" -exec rm -rf {} +
+	find . -type d -name ".pytest_cache" -exec rm -rf {} +

{osslag-1.0.0 → osslag-1.0.1}/PKG-INFO

@@ -1,16 +1,21 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: osslag
-Version: 1.0.0
+Version: 1.0.1
 Summary: Technical Lag tools for Open Source Software Projects
-Keywords: oss,open source,technical lag,software lag,software maintenance
-Author: Shane Panter
 Author-email: Shane Panter <shanepanter@boisestate.edu>
 License: MIT
+Project-URL: Homepage, https://github.com/shanep/osslag
+Project-URL: Issues, https://github.com/shanep/osslag/issues
+Keywords: oss,open source,technical lag,software lag,software maintenance
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: dotenv>=0.9.9
 Requires-Dist: pandas>=3.0.0
+Requires-Dist: pyarrow>=23.0.0
 Requires-Dist: pygit2>=1.19.1
 Requires-Dist: pygithub>=2.8.1
 Requires-Dist: python-dateutil>=2.9.0.post0
@@ -18,16 +23,17 @@ Requires-Dist: python-debian>=1.0.1
 Requires-Dist: requests>=2.32.5
 Requires-Dist: rich>=14.3.1
 Requires-Dist: typer>=0.21.1
-Requires-Python: >=3.14
-Project-URL: Homepage, https://github.com/shanep/osslag
-Project-URL: Issues, https://github.com/shanep/osslag/issues
-Description-Content-Type: text/markdown
+Dynamic: license-file
 
 # OSS-Lag: Open Source Software Lag Dataset
 
 This repository contains code to build a dataset measuring technical lag and
 abandonment of open source packages across multiple Linux distributions.
 
+The algorithms implemented here are described in the following paper:
+
+- [docs/Paper.pdf](docs/Paper.pdf)
+
 
 ## Installation
 

{osslag-1.0.0 → osslag-1.0.1}/README.md

@@ -3,6 +3,10 @@
 This repository contains code to build a dataset measuring technical lag and
 abandonment of open source packages across multiple Linux distributions.
 
+The algorithms implemented here are described in the following paper:
+
+- [docs/Paper.pdf](docs/Paper.pdf)
+
 
 ## Installation
 

osslag-1.0.1/docs/RELEASING.md

@@ -0,0 +1,95 @@
+# Releasing osslag
+
+This document describes how to release a new version of osslag.
+
+## Versioning
+
+This project uses [setuptools-scm](https://github.com/pypa/setuptools-scm) for automatic versioning based on git tags. The version is derived directly from git tags at build time.
+
+### Version Format
+
+- **Release versions**: `1.0.0`, `1.1.0`, `2.0.0` (from tags like `v1.0.0`)
+- **Development versions**: `1.0.1.dev6+gde04e13` (6 commits after v1.0.0, at commit de04e13)
+- **Dirty versions**: `1.0.1.dev6+gde04e13.d20260204` (uncommitted changes present)
+
+## Release Process
+
+### 1. Prepare the Release
+
+Ensure all changes are committed and tests pass:
+
+```bash
+# Run tests
+uv run pytest
+
+# Run linting
+uv run ruff check src/ tests/
+
+# Run type checking
+uv run pyright
+```
+
+### 2. Create the Release
+
+Choose the appropriate version number following [Semantic Versioning](https://semver.org/):
+
+- **MAJOR** (1.0.0 → 2.0.0): Breaking API changes
+- **MINOR** (1.0.0 → 1.1.0): New features, backwards compatible
+- **PATCH** (1.0.0 → 1.0.1): Bug fixes, backwards compatible
+
+Create and push the tag:
+
+```bash
+# Create an annotated tag
+git tag -a v1.1.0 -m "Release v1.1.0"
+
+# Push the tag
+git push origin v1.1.0
+```
+
+### 3. Create GitHub Release
+
+1. Go to the [GitHub Releases page](https://github.com/shanep/osslag/releases)
+2. Click "Draft a new release"
+3. Select the tag you just created (e.g., `v1.1.0`)
+4. Set the release title (e.g., "v1.1.0")
+5. Add release notes describing changes
+6. Click "Publish release"
+
+## Verifying the Release
+
+After releasing, verify the version is correct:
+
+```bash
+# Install the released version
+pip install osslag==1.1.0
+
+# Check the version
+python -c "from osslag import get_version; print(get_version())"
+```
+
+## Troubleshooting
+
+### Version shows `.dev` suffix after tagging
+
+Make sure you're on the tagged commit:
+
+```bash
+git checkout v1.1.0
+uv pip install -e .
+```
+
+### Version not updating
+
+Reinstall the package to pick up the new version:
+
+```bash
+uv pip install -e . --force-reinstall
+```
+
+### Checking what version will be generated
+
+```bash
+# See what version setuptools-scm will generate
+python -m setuptools_scm
+```

osslag-1.0.1/env.template

@@ -0,0 +1,13 @@
+
+# ====== GitHub configuration ======
+GITHUB_USERNAME=john
+GITHUB_TOKEN=tbd
+
+# ====== Other configuration ======
+MAX_WORKERS=10
+CACHE_DIR=$HOME/cache
+REPOS_CACHE_DIR=$HOME/cache/repos
+
+# Logging
+LOG_LEVEL=INFO
+LOG_FILE=osslag.log

{osslag-1.0.0 → osslag-1.0.1}/pyproject.toml

@@ -1,13 +1,13 @@
 [build-system]
-requires = ["uv_build>=0.9.28,<0.10.0"]
-build-backend = "uv_build"
+requires = ["setuptools>=64", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
 
 [project.scripts]
 osslag = "osslag.cli:main"
 
 [project]
 name = "osslag"
-version = "1.0.0"
+dynamic = ["version"]
 description = "Technical Lag tools for Open Source Software Projects"
 readme = "README.md"
 authors = [
@@ -25,6 +25,7 @@ classifiers = [
 dependencies = [
     "dotenv>=0.9.9",
     "pandas>=3.0.0",
+    "pyarrow>=23.0.0",
     "pygit2>=1.19.1",
     "pygithub>=2.8.1",
     "python-dateutil>=2.9.0.post0",
@@ -63,8 +64,15 @@ dev = [
 ]
 
 
+[tool.setuptools_scm]
+# Version is derived from git tags (e.g., v1.0.2 -> 1.0.2)
+# For development builds, adds .devN+gHASH suffix
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
 [tool.ruff]
-line-length = 88
+line-length = 120
 indent-width = 4
 
 

osslag-1.0.1/setup.cfg

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

osslag-1.0.1/src/osslag/__init__.py

@@ -0,0 +1,9 @@
+from importlib.metadata import version
+
+__version__ = version("osslag")
+__all__ = ["__version__", "get_version"]
+
+
+def get_version() -> str:
+    """Return the current version of osslag."""
+    return __version__