nbdevAuto 0.3.73__tar.gz → 0.3.75__tar.gz

{nbdevauto-0.3.73/nbdevAuto.egg-info → nbdevauto-0.3.75}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdevAuto
-Version: 0.3.73
+Version: 0.3.75
 Summary: automating nbdev
 Author-email: Benedict Thekkel <bthekkel1@gmail.com>
 License-Expression: Apache-2.0
@@ -72,7 +72,7 @@ from nbdevAuto.pdf import PDFreader
 | [Functions](00_Functions.ipynb) | Dataset and image helpers: reading a list out of a text file, downloading single images or whole search-driven datasets, verifying and resizing what came back, building the folder layout a classifier expects, running a fastai learner over one image, Kaggle competition and dataset shortcuts, and [`graph`](https://bthek1.github.io/nbdevAuto/functions.html#graph), a `graphviz.Digraph` subclass preloaded with a rounded, filled style |
 | [Automate](01_Automate.ipynb) | The command line surface: the prep/commit/push pipeline, the GitHub and PyPI release halves, the help output that lists them all, and the one-line-per-stage console grid every command reports through |
 | [PDF Reader](02_PDF_reader.ipynb) | [`PDFreader`](https://bthek1.github.io/nbdevAuto/pdf_reader.html#pdfreader), a class that converts a PDF through `pdf2image` and renders page ranges inline when you slice it (`pdf[0:5]`) |
-| [GitHub](03_GitHub.ipynb) | [`ghstatus`](https://bthek1.github.io/nbdevAuto/github.html#ghstatus): reading `.gitmodules`, resolving a token, and asking the GitHub API about every submodule at once - CI runs, Pages deploys, Pages builds, remote `main` shas - plus the `--report` and `--audit` views, the exit codes that keep “absent” apart from “cannot ask”, and `newest_run`, which picks a run by `run_number` because the API’s page order is not a contract |
+| [GitHub](03_GitHub.ipynb) | [`ghstatus`](https://bthek1.github.io/nbdevAuto/github.html#ghstatus): reading `.gitmodules`, resolving a token, and asking the GitHub API about every submodule at once - CI runs, Pages deploys, Pages builds, remote `main` shas - plus the `--report` and `--audit` views, the exit codes that keep “absent” apart from “cannot ask”, and [`newest_run`](https://bthek1.github.io/nbdevAuto/github.html#newest_run), which picks a run by `run_number` because the API’s page order is not a contract |
 | [Fleet](04_Fleet.ipynb) | [`fleet`](https://bthek1.github.io/nbdevAuto/fleet.html#fleet): running one command across every submodule of a superproject. A walker that reports only what did work and counts the rest, plus the verbs built on it - upload, push, copy, status, update and sync |
 
 ------------------------------------------------------------------------
@@ -129,9 +129,9 @@ The parent Knowledge repo’s `justfile` calls [`upload`](https://bthek1.github.
 
 ## Releases
 
-This package publishes itself. A `publish.yaml` workflow runs after CI passes on `main` and uploads to PyPI through Trusted Publishing, so no API token is stored in the repository. It reads `__version__` out of `nbdevAuto/__init__.py` and asks PyPI whether that version already exists: a new version is published, an existing one is skipped without failing the build.
+This package publishes itself. A `publish.yaml` workflow runs after CI passes on `main` and uploads to PyPI through Trusted Publishing, so no API token is stored in the repository. It reads `__version__` out of `nbdevAuto/__init__.py` and asks PyPI whether that version already exists: a new version is published, an existing one is skipped without failing the build. Once PyPI accepts it, the same workflow creates the matching GitHub release (tag `<version>`, title `v<version>`, auto-generated notes) with the built wheel and sdist attached, and skips if that release already exists.
 
-Because [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) bumps the patch version on every push, an ordinary commit made with [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) ships a release. A plain `git commit` leaves the version alone and the workflow skips. `gitrelease`, which bumps the minor version and creates the GitHub release and tag, stays a deliberate manual step.
+Because [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) bumps the patch version on every push, an ordinary commit made with [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) ships a release. A plain `git commit` leaves the version alone and the workflow skips. `gitrelease`, which bumps the minor version and creates the GitHub release and tag, stays a deliberate manual step for minor releases.
 
 ------------------------------------------------------------------------
 

{nbdevauto-0.3.73 → nbdevauto-0.3.75}/README.md

@@ -42,7 +42,7 @@ from nbdevAuto.pdf import PDFreader
 | [Functions](00_Functions.ipynb) | Dataset and image helpers: reading a list out of a text file, downloading single images or whole search-driven datasets, verifying and resizing what came back, building the folder layout a classifier expects, running a fastai learner over one image, Kaggle competition and dataset shortcuts, and [`graph`](https://bthek1.github.io/nbdevAuto/functions.html#graph), a `graphviz.Digraph` subclass preloaded with a rounded, filled style |
 | [Automate](01_Automate.ipynb) | The command line surface: the prep/commit/push pipeline, the GitHub and PyPI release halves, the help output that lists them all, and the one-line-per-stage console grid every command reports through |
 | [PDF Reader](02_PDF_reader.ipynb) | [`PDFreader`](https://bthek1.github.io/nbdevAuto/pdf_reader.html#pdfreader), a class that converts a PDF through `pdf2image` and renders page ranges inline when you slice it (`pdf[0:5]`) |
-| [GitHub](03_GitHub.ipynb) | [`ghstatus`](https://bthek1.github.io/nbdevAuto/github.html#ghstatus): reading `.gitmodules`, resolving a token, and asking the GitHub API about every submodule at once - CI runs, Pages deploys, Pages builds, remote `main` shas - plus the `--report` and `--audit` views, the exit codes that keep “absent” apart from “cannot ask”, and `newest_run`, which picks a run by `run_number` because the API’s page order is not a contract |
+| [GitHub](03_GitHub.ipynb) | [`ghstatus`](https://bthek1.github.io/nbdevAuto/github.html#ghstatus): reading `.gitmodules`, resolving a token, and asking the GitHub API about every submodule at once - CI runs, Pages deploys, Pages builds, remote `main` shas - plus the `--report` and `--audit` views, the exit codes that keep “absent” apart from “cannot ask”, and [`newest_run`](https://bthek1.github.io/nbdevAuto/github.html#newest_run), which picks a run by `run_number` because the API’s page order is not a contract |
 | [Fleet](04_Fleet.ipynb) | [`fleet`](https://bthek1.github.io/nbdevAuto/fleet.html#fleet): running one command across every submodule of a superproject. A walker that reports only what did work and counts the rest, plus the verbs built on it - upload, push, copy, status, update and sync |
 
 ------------------------------------------------------------------------
@@ -99,9 +99,9 @@ The parent Knowledge repo’s `justfile` calls [`upload`](https://bthek1.github.
 
 ## Releases
 
-This package publishes itself. A `publish.yaml` workflow runs after CI passes on `main` and uploads to PyPI through Trusted Publishing, so no API token is stored in the repository. It reads `__version__` out of `nbdevAuto/__init__.py` and asks PyPI whether that version already exists: a new version is published, an existing one is skipped without failing the build.
+This package publishes itself. A `publish.yaml` workflow runs after CI passes on `main` and uploads to PyPI through Trusted Publishing, so no API token is stored in the repository. It reads `__version__` out of `nbdevAuto/__init__.py` and asks PyPI whether that version already exists: a new version is published, an existing one is skipped without failing the build. Once PyPI accepts it, the same workflow creates the matching GitHub release (tag `<version>`, title `v<version>`, auto-generated notes) with the built wheel and sdist attached, and skips if that release already exists.
 
-Because [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) bumps the patch version on every push, an ordinary commit made with [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) ships a release. A plain `git commit` leaves the version alone and the workflow skips. `gitrelease`, which bumps the minor version and creates the GitHub release and tag, stays a deliberate manual step.
+Because [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) bumps the patch version on every push, an ordinary commit made with [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) ships a release. A plain `git commit` leaves the version alone and the workflow skips. `gitrelease`, which bumps the minor version and creates the GitHub release and tag, stays a deliberate manual step for minor releases.
 
 ------------------------------------------------------------------------
 

nbdevauto-0.3.75/nbdevAuto/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.75"

{nbdevauto-0.3.73 → nbdevauto-0.3.75}/nbdevAuto/github.py

@@ -104,17 +104,30 @@ def newest_run(runs):
     numbered = [r for r in runs if getattr(r, "run_number", None) is not None]
     return max(numbered, key=lambda r: r.run_number) if numbered else runs[0]
 
-async def _latest_run(gh, sub, candidates, branch="main"):
-    "Newest run of the first workflow in `candidates` that exists, or None"
+async def _latest_run(gh, sub, candidates, branch="main", head_sha=None):
+    """Newest run of the first workflow in `candidates` that exists, or None.
+
+    With `head_sha`, the run for that exact commit wins, and the branch-wide page is only
+    the fallback for a commit that has no run yet. `newest_run` alone is not enough: on
+    2026-10-05 the branch query for DL_methods returned a page whose highest run was #143
+    (2026-05-13, failure) while #161 (success) was the newest, so the max of a bad page was
+    still a six-month-old FAILURE. Asking for `main`'s own commit cannot be answered with
+    another commit's run."""
     from githubkit.exception import RequestFailed
     for wf in candidates:
         try:
-            r = await gh.rest.actions.async_list_workflow_runs(
-                sub.owner, sub.repo, wf, branch=branch, per_page=10)
+            runs = []
+            if head_sha:
+                r = await gh.rest.actions.async_list_workflow_runs(
+                    sub.owner, sub.repo, wf, head_sha=head_sha, per_page=10)
+                runs = r.parsed_data.workflow_runs
+            if not runs:
+                r = await gh.rest.actions.async_list_workflow_runs(
+                    sub.owner, sub.repo, wf, branch=branch, per_page=10)
+                runs = r.parsed_data.workflow_runs
         except RequestFailed as e:
             if _missing(e): continue
             raise
-        runs = r.parsed_data.workflow_runs
         if runs:
             run = newest_run(runs)
             # conclusion is None while a run is still going, status covers that case
@@ -132,7 +145,7 @@ async def _pages_build(gh, sub):
     return r.parsed_data.status
 
 async def _remote_sha(gh, sub, branch="main", n=7):
-    "Short sha that `branch` points at on the remote, or None"
+    "Sha that `branch` points at on the remote (first `n` chars, all when None), or None"
     from githubkit.exception import RequestFailed
     try: r = await gh.rest.git.async_get_ref(sub.owner, sub.repo, f"heads/{branch}")
     except RequestFailed as e:
@@ -143,11 +156,13 @@ async def _remote_sha(gh, sub, branch="main", n=7):
 # %% ../nbs/03_GitHub.ipynb #4e0878a3-56be-4568-98f8-57ed92512e50
 async def repo_status(gh, sub, root=None):
     "One row: CI run, Pages deploy run, Pages build, and local vs remote sha"
-    ci, deploy, built, remote = await asyncio.gather(
-        _latest_run(gh, sub, CI_WORKFLOWS), _latest_run(gh, sub, PAGES_WORKFLOWS),
-        _pages_build(gh, sub), _remote_sha(gh, sub))
+    # main's full sha first, so the run lookups can ask about that exact commit
+    head = await _remote_sha(gh, sub, n=None)
+    ci, deploy, built = await asyncio.gather(
+        _latest_run(gh, sub, CI_WORKFLOWS, head_sha=head),
+        _latest_run(gh, sub, PAGES_WORKFLOWS, head_sha=head), _pages_build(gh, sub))
     return {"path": sub.path, "owner": sub.owner, "repo": sub.repo,
-            "ci": ci, "deploy": deploy, "built": built, "remote": remote,
+            "ci": ci, "deploy": deploy, "built": built, "remote": head and head[:7],
             "local": local_sha(Path(root or find_root())/sub.path)}
 
 def client(token=None):

{nbdevauto-0.3.73 → nbdevauto-0.3.75/nbdevAuto.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdevAuto
-Version: 0.3.73
+Version: 0.3.75
 Summary: automating nbdev
 Author-email: Benedict Thekkel <bthekkel1@gmail.com>
 License-Expression: Apache-2.0
@@ -72,7 +72,7 @@ from nbdevAuto.pdf import PDFreader
 | [Functions](00_Functions.ipynb) | Dataset and image helpers: reading a list out of a text file, downloading single images or whole search-driven datasets, verifying and resizing what came back, building the folder layout a classifier expects, running a fastai learner over one image, Kaggle competition and dataset shortcuts, and [`graph`](https://bthek1.github.io/nbdevAuto/functions.html#graph), a `graphviz.Digraph` subclass preloaded with a rounded, filled style |
 | [Automate](01_Automate.ipynb) | The command line surface: the prep/commit/push pipeline, the GitHub and PyPI release halves, the help output that lists them all, and the one-line-per-stage console grid every command reports through |
 | [PDF Reader](02_PDF_reader.ipynb) | [`PDFreader`](https://bthek1.github.io/nbdevAuto/pdf_reader.html#pdfreader), a class that converts a PDF through `pdf2image` and renders page ranges inline when you slice it (`pdf[0:5]`) |
-| [GitHub](03_GitHub.ipynb) | [`ghstatus`](https://bthek1.github.io/nbdevAuto/github.html#ghstatus): reading `.gitmodules`, resolving a token, and asking the GitHub API about every submodule at once - CI runs, Pages deploys, Pages builds, remote `main` shas - plus the `--report` and `--audit` views, the exit codes that keep “absent” apart from “cannot ask”, and `newest_run`, which picks a run by `run_number` because the API’s page order is not a contract |
+| [GitHub](03_GitHub.ipynb) | [`ghstatus`](https://bthek1.github.io/nbdevAuto/github.html#ghstatus): reading `.gitmodules`, resolving a token, and asking the GitHub API about every submodule at once - CI runs, Pages deploys, Pages builds, remote `main` shas - plus the `--report` and `--audit` views, the exit codes that keep “absent” apart from “cannot ask”, and [`newest_run`](https://bthek1.github.io/nbdevAuto/github.html#newest_run), which picks a run by `run_number` because the API’s page order is not a contract |
 | [Fleet](04_Fleet.ipynb) | [`fleet`](https://bthek1.github.io/nbdevAuto/fleet.html#fleet): running one command across every submodule of a superproject. A walker that reports only what did work and counts the rest, plus the verbs built on it - upload, push, copy, status, update and sync |
 
 ------------------------------------------------------------------------
@@ -129,9 +129,9 @@ The parent Knowledge repo’s `justfile` calls [`upload`](https://bthek1.github.
 
 ## Releases
 
-This package publishes itself. A `publish.yaml` workflow runs after CI passes on `main` and uploads to PyPI through Trusted Publishing, so no API token is stored in the repository. It reads `__version__` out of `nbdevAuto/__init__.py` and asks PyPI whether that version already exists: a new version is published, an existing one is skipped without failing the build.
+This package publishes itself. A `publish.yaml` workflow runs after CI passes on `main` and uploads to PyPI through Trusted Publishing, so no API token is stored in the repository. It reads `__version__` out of `nbdevAuto/__init__.py` and asks PyPI whether that version already exists: a new version is published, an existing one is skipped without failing the build. Once PyPI accepts it, the same workflow creates the matching GitHub release (tag `<version>`, title `v<version>`, auto-generated notes) with the built wheel and sdist attached, and skips if that release already exists.
 
-Because [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) bumps the patch version on every push, an ordinary commit made with [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) ships a release. A plain `git commit` leaves the version alone and the workflow skips. `gitrelease`, which bumps the minor version and creates the GitHub release and tag, stays a deliberate manual step.
+Because [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) bumps the patch version on every push, an ordinary commit made with [`upload`](https://bthek1.github.io/nbdevAuto/automate.html#upload) ships a release. A plain `git commit` leaves the version alone and the workflow skips. `gitrelease`, which bumps the minor version and creates the GitHub release and tag, stays a deliberate manual step for minor releases.
 
 ------------------------------------------------------------------------
 

nbdevauto-0.3.73/nbdevAuto/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.3.73"