pygitpub 0.0.59__tar.gz → 0.0.61__tar.gz

{pygitpub-0.0.59 → pygitpub-0.0.61}/.gitignore

@@ -1,8 +1,6 @@
 # generated
-/build/
 /toolchain/
 /dist/
-/target/
 /out/
 /debug/
 /download/
@@ -64,7 +62,7 @@ modules.order
 
 # sphinx
 /docs/_build/
-/docs/.doctrees/environment.pickle
+/docs/.doctrees/
 
 # mdBook build output
 /docs/book/
@@ -77,8 +75,6 @@ modules.order
 # python
 __pycache__/
 *.py[oc]
-*.pyc
-*.pyo
 /wheel/
 /.venv/
 .coverage
@@ -87,7 +83,10 @@ coverage.xml
 *.egg-info/
 
 # mine
-/.pydmt.build.errors
+# error files left by the bashy prompt plugins (.uv.sync.errors,
+# .pydmt.build.errors, ...); unanchored because a sub-project's
+# pyproject root can sit below the git root
+.*.errors
 /.pydmt/
 *.stamp
 *.stamp.*
@@ -147,10 +146,13 @@ build/
 .ipynb_checkpoints/
 
 # c#
+# **/obj/ and **/bin/ match at any depth, which is what .NET output needs
+# (src/<proj>/bin, src/<proj>/obj). The un-globbed [Oo]bj/ and [Bb]in/ that
+# used to follow were redundant with these two and are gone.
 **/obj/
 **/bin/
-[Oo]bj/
-[Bb]in/
+# perl-meta keeps real Perl sources under perl/bin/Meta/, not build output.
+!/perl/bin/
 
 # flash/air
 *.swf
@@ -175,7 +177,6 @@ bin-release/
 .project
 .project.xml
 .idea/
-/.idea/
 build.properties
 
 # spark
@@ -186,24 +187,26 @@ spark-warehouse/
 /.terraform/
 terraform.tfstate
 terraform.tfstate.backup
-/terraform.tfstate
-/terraform.tfstate.backup
 /terraform.lock.hcl
 
 # scala
-target/
-project/
+# Anchored: sbt's build dir is at the repo root. Unanchored, this also
+# swallowed source directories named project/ nested under src/.
+/project/
 
 # rust
 **/*.rs.bk
 **/mutants.out*/
 *.pdb
-debug
+# Anchored: this is the root debug build dir. Unanchored (and without a
+# trailing slash) it matched any file or directory named debug at any depth,
+# including authored example content.
+/debug/
 /.rsconstruct_cache.json
 
 # claude
 /.claude/
-claude/
+/claude/
 .claude/projects/
 .claude/settings.local.json
 
@@ -242,3 +245,36 @@ creds.txt
 
 # rsconstruct
 /.rsconstruct/
+
+# generated website pieces (built into the Pages artifact by CI)
+/docs/output/
+/docs/index.html
+# sphinx html output: the 14 py* repos render docs/ from sphinx/ and publish
+# it as the Pages artifact, so none of it is committed. Listed path by path
+# rather than as /docs/ because the rs* repos keep hand-written mdBook
+# sources there, and several others keep authored html.
+/docs/_modules/
+/docs/_sources/
+/docs/_static/
+/docs/.buildinfo
+/docs/objects.inv
+/docs/searchindex.js
+/docs/.nojekyll
+# sphinx's top-level html. Not a blanket /docs/*.html: js-jschess and the
+# site-personal-* repos keep hand-authored html under docs/. The fixed pages
+# (genindex, modules, search) and the authored-rst pages some repos render
+# (architecture, notes, ...) are listed by name; the one-page-per-module
+# output is /docs/py*.html, since every package here is named py*.
+/docs/architecture.html
+/docs/cli-reference.html
+/docs/development.html
+/docs/genindex.html
+/docs/modules.html
+/docs/notes.html
+/docs/overview.html
+/docs/py*.html
+/docs/quota-guide.html
+/docs/search.html
+
+# per-machine tool resolution cache (absolute paths, not portable)
+/.tools.versions

{pygitpub-0.0.59 → pygitpub-0.0.61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pygitpub
-Version: 0.0.59
+Version: 0.0.61
 Summary: Pygitpub will help you work with github
 Project-URL: Homepage, https://github.com/veltzer/pygitpub
 Project-URL: Bug Tracker, https://github.com/veltzer/pygitpub/issues
@@ -19,9 +19,10 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Utilities
-Requires-Python: >=3.12
+Requires-Python: >=3.14
+Requires-Dist: lupa
 Requires-Dist: pyapikey
 Requires-Dist: pygithub
 Requires-Dist: pylogconf
@@ -29,6 +30,9 @@ Requires-Dist: pytconf
 Requires-Dist: pyyaml
 Description-Content-Type: text/markdown
 
+<!-- This file is generated. Do not edit it by hand: your changes will be
+     lost on the next build. Edit the template it is rendered from, or the
+     values that template reads, and build again. -->
 # *pygitpub* project by Mark Veltzer
 
 description: Pygitpub will help you work with github
@@ -37,7 +41,7 @@ project website: https://veltzer.github.io/pygitpub
 
 author: Mark Veltzer
 
-version: 0.0.59
+version: 0.0.61
 
 ![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
 
@@ -66,7 +70,6 @@ version: 0.0.59
 ## contact me
 
 [mailto](mailto:mark.veltzer@gmail.com)
-![gitter](https://img.shields.io/gitter/room/veltzer/mark.veltzer)
 ![discord](https://img.shields.io/discord/719336281624281119)
 ![discord](https://img.shields.io/discord/719336282194444302)
 

{pygitpub-0.0.59 → pygitpub-0.0.61}/README.md

@@ -1,3 +1,6 @@
+<!-- This file is generated. Do not edit it by hand: your changes will be
+     lost on the next build. Edit the template it is rendered from, or the
+     values that template reads, and build again. -->
 # *pygitpub* project by Mark Veltzer
 
 description: Pygitpub will help you work with github
@@ -6,7 +9,7 @@ project website: https://veltzer.github.io/pygitpub
 
 author: Mark Veltzer
 
-version: 0.0.59
+version: 0.0.61
 
 ![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
 
@@ -35,7 +38,6 @@ version: 0.0.59
 ## contact me
 
 [mailto](mailto:mark.veltzer@gmail.com)
-![gitter](https://img.shields.io/gitter/room/veltzer/mark.veltzer)
 ![discord](https://img.shields.io/discord/719336281624281119)
 ![discord](https://img.shields.io/discord/719336282194444302)
 

{pygitpub-0.0.59 → pygitpub-0.0.61}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pygitpub"
-version = "0.0.59"
-requires-python = ">=3.12"
+version = "0.0.61"
+requires-python = ">=3.14"
 authors = [
 	{ name = "Mark Veltzer", email = "mark.veltzer@gmail.com" }
 ]
@@ -26,7 +26,7 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Utilities",
     "License :: OSI Approved :: MIT License",
 ]
@@ -36,6 +36,16 @@ dependencies = [
     "PyGithub",
     "pyapikey",
     "pyyaml",
+    "lupa",
+]
+
+[dependency-groups]
+dev = [
+    "mypy",
+    "pylint",
+    "pytest",
+    "ruff",
+    "sphinx",
 ]
 
 [project.urls]
@@ -74,10 +84,23 @@ exclude = [
 ]
 
 [tool.mypy]
-python_version = "3.12"
+python_version = "3.14"
 warn_return_any = true
 warn_unused_configs = true
+mypy_path = "src:python:scripts"
+explicit_package_bases = true
+namespace_packages = true
 
+# Third-party libraries without type stubs; `foo.*` also matches `foo` itself.
+[[tool.mypy.overrides]]
+module = [
+    "github.*",
+    "lupa.*",
+    "pyapikey.*",
+    "pylogconf.*",
+    "pytconf.*",
+]
+ignore_missing_imports = true
 [tool.hatch.envs.default]
 installer = "uv"
 

{pygitpub-0.0.59 → pygitpub-0.0.61}/src/pygitpub/main.py

@@ -16,12 +16,13 @@ from pytconf.registry import the_registry
 
 import pygitpub.static
 from pygitpub.configs import AFFILIATIONS, ConfigAlgo, ConfigGithub, ConfigOutput
-from pygitpub.utils.importlib import import_file
+from pygitpub.utils.lua import config_path, load_lua_file
 from pygitpub.utils.misc import delete, get_all_git_repos
 
 
 def get_base_dir() -> str:
-    return os.path.expanduser(ConfigAlgo.base_dir)
+    base_dir: str = ConfigAlgo.base_dir
+    return os.path.expanduser(base_dir)
 
 
 def get_repo_folder(repo) -> str:
@@ -84,25 +85,25 @@ def fix_metadata() -> None:
             continue
         os.chdir(folder)
         # print(f"doing [{folder}]...")
-        file_path = "config/project.py"
+        file_path = config_path("project")
         if not os.path.isfile(file_path):
             os.chdir(orig_folder)
             continue
-        mod = import_file(file_path)
-        if not hasattr(mod, "description_short"):
+        project = load_lua_file(file_path)
+        if "DESCRIPTION_SHORT" not in project:
             os.chdir(orig_folder)
             continue
-        description_short = mod.description_short
+        description_short = project["DESCRIPTION_SHORT"]
         if description_short != repo.description:
             print(f"in {folder}...")
             print(f"description_short is [{description_short}]")
             print(f"repo.description is [{repo.description}]")
             repo.edit(description=description_short)
-        if not hasattr(mod, "keywords"):
+        if "KEYWORDS" not in project:
             print(f"{folder} no keywords")
             os.chdir(orig_folder)
             continue
-        keywords = mod.keywords
+        keywords = project["KEYWORDS"]
         if set(keywords) != set(repo.get_topics()):
             print(f"in {folder}...")
             print(f"keywords is [{keywords}]")
@@ -193,15 +194,17 @@ def repos_list() -> None:
 
 
 @register_endpoint(
-    description="Cleanup old failing or un-needed runs in all workflows in all repositories",
+    description="Cleanup old failing or un-needed runs, deployments, and releases in all repositories",
     configs=[
         ConfigGithub,
         ConfigOutput,
         ConfigAlgo,
     ],
 )
-def runs_cleanup() -> None:
+def cleanup() -> None:
+    # pylint: disable=too-many-branches
     for repo in yield_repos():
+        # 1. Cleanup workflow runs
         for workflow in repo.get_workflows():
             existing = 0
             for run in workflow.get_runs():
@@ -215,7 +218,9 @@ def runs_cleanup() -> None:
                 if run.head_branch != "master":
                     delete_it = True
                 # if its not a paged build and it failed then delete it
-                if workflow.name != "pages-build-deployment" and run.conclusion == "failure":
+                if workflow.name != "pages-build-deployment" and run.conclusion in (
+                    "failure", "cancelled", "timed_out", "startup_failure", "action_required"
+                ):
                     delete_it = True
                 if existing >= 4:
                     delete_it = True
@@ -225,6 +230,46 @@ def runs_cleanup() -> None:
                 else:
                     existing += 1
 
+        # 2. Cleanup deployments
+        existing_deployments = 0
+        for deployment in repo.get_deployments():
+            state = None
+            for status in deployment.get_statuses():
+                state = status.state
+                break
+
+            delete_it = False
+            if state in ("failure", "error") or existing_deployments >= 4:
+                delete_it = True
+            else:
+                existing_deployments += 1
+
+            if delete_it:
+                print(f"deleting deployment {repo.name} {deployment.id}")
+                try:
+                    deployment.create_status("inactive")
+                except github.GithubException as e:
+                    print(f"Failed to deactivate deployment: {e}")
+                try:
+                    # pylint: disable=protected-access
+                    status, _, _ = deployment._requester.requestJson("DELETE", deployment.url)
+                    if status != 204:
+                        print(f"Failed to delete deployment: HTTP {status}")
+                except github.GithubException as e:
+                    print(f"Failed to delete deployment: {e}")
+
+        # 3. Cleanup releases
+        existing_releases = 0
+        for release in repo.get_releases():
+            if existing_releases >= 4:
+                print(f"deleting release {repo.name} {release.title}")
+                try:
+                    release.delete_release()
+                except github.GithubException as e:
+                    print(f"Failed to delete release: {e}")
+            else:
+                existing_releases += 1
+
 
 @register_endpoint(
     description="Show all runs in all workflows in all repos",

{pygitpub-0.0.59 → pygitpub-0.0.61}/src/pygitpub/static.py

@@ -1,5 +1,5 @@
 """ version which can be consumed from within the module """
-VERSION_STR = "0.0.59"
+VERSION_STR = "0.0.61"
 DESCRIPTION = "Pygitpub will help you work with github"
 APP_NAME = "pygitpub"
 LOGGER_NAME = "pygitpub"

pygitpub-0.0.61/src/pygitpub/utils/lua.py

@@ -0,0 +1,68 @@
+"""
+Load "config/*.lua" data files.
+
+The config files used to be python modules loaded via importlib; they are now
+lua data files (config/project.lua and friends). A file is run in a fresh lua
+runtime and the globals it declares are returned as a plain dict.
+"""
+
+import os.path
+from typing import Any
+
+# lupa exposes LuaRuntime through a module level __getattr__ that points at the
+# bundled lua version (lupa.lua54, lupa.lua55, ...), so it cannot be imported
+# by name. Going through the package attribute works for any bundled version.
+import lupa
+
+CONFIG_FOLDER = "config"
+
+
+def lua_to_python(value: Any) -> Any:
+    """
+    Recursively convert a lua value into its python equivalent.
+
+    Lua has a single table type, so a table is a list if its keys are exactly
+    1..n and a dict otherwise. An empty table becomes an empty list, which
+    matches how the config files use them.
+    """
+    if not hasattr(value, "values"):
+        return value
+    keys = list(value.keys())
+    if keys == list(range(1, len(keys) + 1)):
+        return [lua_to_python(x) for x in value.values()]
+    return {k: lua_to_python(value[k]) for k in keys}
+
+
+def config_path(name: str) -> str:
+    """ return the path of a config file by its short name ("project") """
+    return os.path.join(CONFIG_FOLDER, f"{name}.lua")
+
+
+def load_lua_file(path: str) -> dict[str, Any]:
+    """
+    Run a lua file and return the globals it declared as a dict.
+
+    Raises FileNotFoundError if the file does not exist.
+    """
+    if not os.path.isfile(path):
+        raise FileNotFoundError(path)
+    runtime = lupa.LuaRuntime()
+    with open(path, encoding="utf-8") as stream:
+        runtime.execute(stream.read())
+    globals_table = runtime.globals()
+    values = {}
+    for key in globals_table:
+        # skip the lua standard library, we only want what the file declared
+        if key in _LUA_BUILTINS:
+            continue
+        values[key] = lua_to_python(globals_table[key])
+    return values
+
+
+_LUA_BUILTINS = frozenset({
+    "_G", "_VERSION", "assert", "collectgarbage", "coroutine", "debug", "dofile",
+    "error", "getmetatable", "io", "ipairs", "load", "loadfile", "math", "next",
+    "os", "package", "pairs", "pcall", "print", "python", "rawequal", "rawget",
+    "rawlen", "rawset", "require", "select", "setmetatable", "string", "table",
+    "tonumber", "tostring", "type", "utf8", "warn", "xpcall",
+})

pygitpub-0.0.59/src/pygitpub/utils/importlib.py

@@ -1,16 +0,0 @@
-""" importlib.py """
-
-import importlib.util
-
-
-def module_exists(module_name):
-    """ return if a module exists or not """
-    spec = importlib.util.find_spec(module_name)
-    return spec is not None
-
-
-def import_file(file_path):
-    spec = importlib.util.spec_from_file_location("foo", file_path)
-    mod = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(mod)
-    return mod