osslag 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

osslag/metrics/pvac.py

@@ -115,12 +115,8 @@ def version_delta(packages, major_weight, minor_weight, patch_weight):
         if semanticA == "Unknown" or semanticB == "Unknown":
             continue
 
-        weighted_version_A = (
-            (majorA * major_weight) + (minorA * minor_weight) + (patchA * patch_weight)
-        )
-        weighted_version_B = (
-            (majorB * major_weight) + (minorB * minor_weight) + (patchB * patch_weight)
-        )
+        weighted_version_A = (majorA * major_weight) + (minorA * minor_weight) + (patchA * patch_weight)
+        weighted_version_B = (majorB * major_weight) + (minorB * minor_weight) + (patchB * patch_weight)
         version_delta += abs(weighted_version_B - weighted_version_A)
 
     return version_delta

osslag/utils/github_helper.py

@@ -52,11 +52,7 @@ def gh_get_rate_limit_info(github_token: str | None = None) -> dict | None:
         core = rate_limit.resources.core
 
         # core.reset is a datetime object
-        reset_dt = (
-            core.reset
-            if isinstance(core.reset, datetime)
-            else datetime.fromtimestamp(core.reset)
-        )
+        reset_dt = core.reset if isinstance(core.reset, datetime) else datetime.fromtimestamp(core.reset)
         # convert to local timezone
         reset_dt = reset_dt.astimezone()
         # convert to a naive datetime in local time
@@ -164,9 +160,7 @@ def gh_check_repo_exists(owner: str, repo: str) -> GithubAPIResult:
         if response.status_code == 403:
             remaining = response.headers.get("X-RateLimit-Remaining", "?")
             reset_time_str = response.headers.get("X-RateLimit-Reset", "")
-            error_msg = (
-                f"Rate limited (remaining: {remaining}, resets: {reset_time_str})"
-            )
+            error_msg = f"Rate limited (remaining: {remaining}, resets: {reset_time_str})"
             return GithubAPIResult(
                 data={"owner": owner, "repo": repo},
                 error=error_msg,
@@ -182,9 +176,7 @@ def gh_check_repo_exists(owner: str, repo: str) -> GithubAPIResult:
                     error_msg = error_data["message"]
             except Exception:
                 pass
-            return GithubAPIResult(
-                data={"owner": owner, "repo": repo}, error=error_msg, success=False
-            )
+            return GithubAPIResult(data={"owner": owner, "repo": repo}, error=error_msg, success=False)
 
         # Other errors
         error_msg = f"HTTP {response.status_code}"
@@ -195,18 +187,12 @@ def gh_check_repo_exists(owner: str, repo: str) -> GithubAPIResult:
         except Exception:
             pass
         logger.warning(f"GitHub API error for {owner}/{repo}: {error_msg}")
-        return GithubAPIResult(
-            data={"owner": owner, "repo": repo}, error=error_msg, success=False
-        )
+        return GithubAPIResult(data={"owner": owner, "repo": repo}, error=error_msg, success=False)
     except requests.RequestException as e:
-        return GithubAPIResult(
-            data={"owner": owner, "repo": repo}, error=str(e), success=False
-        )
+        return GithubAPIResult(data={"owner": owner, "repo": repo}, error=str(e), success=False)
 
 
-def fetch_github_repo_metadata(
-    repo_url: str, github_token: str | None = None
-) -> pd.DataFrame:
+def fetch_github_repo_metadata(repo_url: str, github_token: str | None = None) -> pd.DataFrame:
     """Fetch GitHub repo metadata given repo URL and token.
 
     Handles rate limiting by catching RateLimitExceededException and waiting
@@ -218,9 +204,7 @@ def fetch_github_repo_metadata(
         raise ValueError(f"Invalid repository URL: {repo_url}")
 
     # Configure GitHub client with explicit timeout (30 seconds)
-    github_client = (
-        Github(github_token, timeout=30) if github_token else Github(timeout=30)
-    )
+    github_client = Github(github_token, timeout=30) if github_token else Github(timeout=30)
     repo_obj = github_client.get_repo(f"{owner}/{repo}")
     data = {
         "repo_url": repo_url,

osslag/utils/vcs.py

@@ -72,9 +72,7 @@ def normalize_https_repo_url(url: str) -> NormalizeRepoResult:
         clean_url = f"https://github.com/{match.group(1)}/{match.group(2)}"
         return NormalizeRepoResult(clean_url, None)
 
-    return NormalizeRepoResult(
-        None, "URL does not match expected git repository patterns"
-    )
+    return NormalizeRepoResult(None, "URL does not match expected git repository patterns")
 
 
 def ensure_dir(p: str | os.PathLike) -> pathlib.Path:
@@ -115,9 +113,7 @@ def extract_owner_name_repo(repo_url: str) -> RepoOwnerName:
     if repo_url_normalized and repo_url_normalized.url is not None:
         parts = repo_url_normalized.url.split("/")
         if len(parts) < 2:
-            logger.error(
-                "Could not extract owner/repo from URL: call normalize_repo_url first"
-            )
+            logger.error("Could not extract owner/repo from URL: call normalize_repo_url first")
             return RepoOwnerName(None, None)
         owner = parts[-2]
         repo = parts[-1]
@@ -206,15 +202,11 @@ def clone_repo(
         github_token = os.getenv("GITHUB_TOKEN")
         github_username = os.getenv("GITHUB_USERNAME")
         if github_token and github_username:
-            callbacks = pygit2.RemoteCallbacks(
-                pygit2.UserPass(github_username, github_token)
-            )
+            callbacks = pygit2.RemoteCallbacks(pygit2.UserPass(github_username, github_token))
         else:
             callbacks = None
 
-        repo_obj = pygit2.clone_repository(
-            sanitize_url.url, dest_dir, callbacks=callbacks, bare=False
-        )
+        repo_obj = pygit2.clone_repository(sanitize_url.url, dest_dir, callbacks=callbacks, bare=False)
 
         # Checkout specific branch if requested
         if branch:
@@ -274,9 +266,7 @@ def construct_repo_local_path(
     Examples:
         >>> construct_repo_local_path("https://github.com/owner/repo", "./cache")
         None  # if not cloned yet
-        >>> construct_repo_local_path(
-        ...     "https://github.com/owner/repo", "./cache", must_exist=False
-        ... )
+        >>> construct_repo_local_path("https://github.com/owner/repo", "./cache", must_exist=False)
         PosixPath('./cache/owner--repo')
 
     """
@@ -289,9 +279,7 @@ def construct_repo_local_path(
         return None
 
     REPOS_CACHE_DIR = os.getenv("REPOS_CACHE_DIR") or str(cache_dir)
-    local_repo_path = (
-        pathlib.Path(REPOS_CACHE_DIR) / f"{repo_owner.owner}--{repo_owner.name}"
-    )
+    local_repo_path = pathlib.Path(REPOS_CACHE_DIR) / f"{repo_owner.owner}--{repo_owner.name}"
     if must_exist and not local_repo_path.exists():
         return None
     if local_repo_path.exists():
@@ -332,10 +320,7 @@ def label_trivial_commits(
             return True
 
         # Documentation-only change if all files are .md files
-        rval = all(
-            isinstance(f, str) and pathlib.PurePosixPath(f).suffix.lower() == ".md"
-            for f in files
-        )
+        rval = all(isinstance(f, str) and pathlib.PurePosixPath(f).suffix.lower() == ".md" for f in files)
         return rval
 
     commits_df[label_column] = commits_df[files_column].apply(_is_trivial)
@@ -388,9 +373,7 @@ def load_commits(
 
     git_dir = repo_path / ".git"
     if not git_dir.exists():
-        raise FileNotFoundError(
-            f"Not a Git repository (missing .git directory): {repo_path}"
-        )
+        raise FileNotFoundError(f"Not a Git repository (missing .git directory): {repo_path}")
 
     try:
         repo = pygit2.Repository(str(repo_path))
@@ -406,16 +389,12 @@ def load_commits(
                     ref = repo.references[f"refs/remotes/origin/{branch}"]
                     start_id = ref.peel(pygit2.Commit).id
                 except KeyError as e:
-                    raise ValueError(
-                        f"Branch '{branch}' not found in {repo_path}"
-                    ) from e
+                    raise ValueError(f"Branch '{branch}' not found in {repo_path}") from e
         else:
             try:
                 start_id = repo.head.peel(pygit2.Commit).id
             except pygit2.GitError as e:
-                raise ValueError(
-                    f"Repository has no HEAD (empty repository?): {repo_path}"
-                ) from e
+                raise ValueError(f"Repository has no HEAD (empty repository?): {repo_path}") from e
 
         def _changed_paths(c: pygit2.Commit) -> list[str]:
             """Return list of paths touched by the commit (optimized, skips merge commits)."""
@@ -431,18 +410,14 @@ def load_commits(
                 if c.parents:
                     # Diff from parent to commit (shows what changed in this commit)
                     # context_lines=0 skips computing context around changes
-                    diff = c.parents[0].tree.diff_to_tree(
-                        c.tree, flags=flags, context_lines=0
-                    )
+                    diff = c.parents[0].tree.diff_to_tree(c.tree, flags=flags, context_lines=0)
                 else:
                     # Initial commit - diff against empty tree
                     diff = c.tree.diff_to_tree(flags=flags, context_lines=0)
 
                 # Extract paths directly with list comprehension
                 # new_file.path is set for adds/modifies, old_file.path for deletes
-                return [
-                    delta.new_file.path or delta.old_file.path for delta in diff.deltas
-                ]
+                return [delta.new_file.path or delta.old_file.path for delta in diff.deltas]
             except Exception:
                 return []
 
@@ -480,12 +455,8 @@ def load_commits(
                 continue
             row = {
                 "hash": str(commit.id),
-                "author": _safe_str(
-                    lambda c=commit: c.author.name if c.author else None
-                ),
-                "email": _safe_str(
-                    lambda c=commit: c.author.email if c.author else None
-                ),
+                "author": _safe_str(lambda c=commit: c.author.name if c.author else None),
+                "email": _safe_str(lambda c=commit: c.author.email if c.author else None),
                 "message": _safe_str(lambda c=commit: c.message),
                 "timestamp": commit.commit_time,
                 "date": datetime.fromtimestamp(commit.commit_time),
@@ -524,12 +495,8 @@ def find_upstream_version_tag_commit(
     version_tag_patterns = [
         re.compile(rf"^v{re.escape(version)}$"),  # v1.2.3
         re.compile(rf"^{re.escape(version)}$"),  # 1.2.3
-        re.compile(
-            rf"^release[-_]?{re.escape(version)}$"
-        ),  # release-1.2.3 or release_1.2.3
-        re.compile(
-            rf"^version[-_]?{re.escape(version)}$"
-        ),  # version-1.2.3 or version_1.2.3
+        re.compile(rf"^release[-_]?{re.escape(version)}$"),  # release-1.2.3 or release_1.2.3
+        re.compile(rf"^version[-_]?{re.escape(version)}$"),  # version-1.2.3 or version_1.2.3
     ]
 
     for _, row in commits.iterrows():

{osslag-1.0.0.dist-info → osslag-1.0.1.dist-info}/METADATA

@@ -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.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+osslag/__init__.py,sha256=cwlK7jN7SyU_ao6nLWTJxjOX-5WzTEdZJrcwrTnRgeI,212
+osslag/cli.py,sha256=IswvyAStwEUt8VRhCelULd51UAViwsD7klwDOi8P6eM,51110
+osslag/distro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osslag/distro/debian.py,sha256=iCItgoK4H59fbBl-wB4MYREiHKziN3LrGP8PMATyveY,12561
+osslag/distro/fedora.py,sha256=kJwwGSr6Sw2lZW82gnzEUYHog9lrKJCy3Johu9ZjC2M,1168
+osslag/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osslag/metrics/malta.py,sha256=aElue_1_NWcWzSdCffI2bhe13mPsRCKXVgjVnJx4r-o,30668
+osslag/metrics/pvac.py,sha256=L04fKxKAgWDB-mPUwNQCwp7R6UiaPSSKgiPiGVmV35o,6088
+osslag/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osslag/utils/github_helper.py,sha256=MU40G0EjRTGBenQTFpQm_nUL5rvBKvYp7mEIiafWhsE,8576
+osslag/utils/vcs.py,sha256=m8U4is6k5uXsLr-KRzcVrb2tWJ2bDsbi44iXkB9QTIc,18717
+osslag-1.0.1.dist-info/licenses/LICENSE,sha256=ohKRn422C1u0QfHnJgBh_YHgTfLySo4ncRuw_T32yzE,1072
+osslag-1.0.1.dist-info/METADATA,sha256=Ur48ahgiXroiBOvVde-Ttkqdnqu3Qotouy-mu_IPAqI,1451
+osslag-1.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+osslag-1.0.1.dist-info/entry_points.txt,sha256=LfxP6PyXpMTwnuATQp2hZ0iIOOAXarQlz0pMIQU-NRU,43
+osslag-1.0.1.dist-info/top_level.txt,sha256=5RYA9YhTanChK5jQFElHU_4kMqiqWkZXyCEpRmtvIyk,7
+osslag-1.0.1.dist-info/RECORD,,

{osslag-1.0.0.dist-info → osslag-1.0.1.dist-info}/WHEEL

@@ -1,4 +1,5 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.28
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
+

{osslag-1.0.0.dist-info → osslag-1.0.1.dist-info}/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 osslag = osslag.cli:main
-

osslag-1.0.1.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+osslag

osslag-1.0.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-osslag/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osslag/cli.py,sha256=APVFUBACfJ-PRs9pwvD359aaCRd4w6KCZcAjGdTWNoM,52658
-osslag/distro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osslag/distro/debian.py,sha256=sjodEtq8rboTkWfywn3wrbC-RiDmIURev7XvB9KJ_Ig,12867
-osslag/distro/fedora.py,sha256=88b9gIMUaixCwsjQpX5oBK654tFLVI_8Bv3QwwdV3Yo,1174
-osslag/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osslag/metrics/malta.py,sha256=ToT4imGHXHkws-y9m9qUMn913OMakRF1qPMiXR-wGEI,19563
-osslag/metrics/pvac.py,sha256=tfkMbYFS6Mk-pEocu6sMOIoniD5to0QA-p8OyXW2lyo,6136
-osslag/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osslag/utils/github_helper.py,sha256=vsWPoSqKEcNaa_1MdUJlWJhP4CCwW-Es4CyodOr7tUs,8752
-osslag/utils/vcs.py,sha256=EMtHgZ6ftQVn-B9H0D6gUhWK-YjGBp05ArAymcH7V4w,19203
-osslag-1.0.0.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
-osslag-1.0.0.dist-info/entry_points.txt,sha256=-MrR4OE3-FnFkYTVyMYLbhwzpLBKgTtrDvCyvHUQqP8,44
-osslag-1.0.0.dist-info/METADATA,sha256=o1c5-RahYQoECta_PLJlukYme-azqzKTuikE4DlJ5z8,1290
-osslag-1.0.0.dist-info/RECORD,,