deps: apply tmpl

Author: drmingdrmer

.github/workflows/python-package.yml

@@ -17,10 +17,10 @@ jobs:
         # python-3.6 in it: https://github.com/actions/setup-python/issues/544#issuecomment-1320295576
         # To fix it: use os: [ubuntu-20.04] instead
         os: [ubuntu-latest]
-        python-version: [3.7, 3.8]
+        python-version: [3.9, "3.10", 3.11, 3.12]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v5
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v2
       with:
@@ -34,6 +34,11 @@ jobs:
     - name: Install npm dependencies
       run: |
         if [ -f package.json ]; then npm install; fi
+
+        # manually add module binary path to github ci
+        echo "add node module path: $GITHUB_WORKSPACE/node_modules/.bin/"
+        echo "$GITHUB_WORKSPACE/node_modules/.bin/" >> $GITHUB_PATH
+
     - name: Install apt dependencies
       run: |
         if [ -f packages.txt ]; then cat packages.txt | xargs sudo apt-get install; fi
@@ -50,9 +55,14 @@ jobs:
         cd ..
         python setup.py install
         cd -
-        sudo env "PATH=$PATH:$(npm bin)" pytest -v
 
-    - uses: actions/upload-artifact@v2
+        if [ -f sudo_test ]; then
+          sudo env "PATH=$PATH" pytest -v
+        else
+          pytest -v
+        fi
+
+    - uses: actions/upload-artifact@v4
       if: failure()
       with:
         path: test/
@@ -63,10 +73,10 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: [3.7, 3.8]
+        python-version: [3.9, "3.10", 3.11, 3.12]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v5
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v2
       with:
@@ -89,10 +99,10 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: [3.7, 3.8]
+        python-version: [3.9, "3.10", 3.11, 3.12]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v5
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v2

.github/workflows/python-publish.yml

@@ -14,9 +14,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
         python-version: '3.x'
     - name: Install dependencies

_building/README.md

@@ -14,7 +14,7 @@ vcs/pykit3/k3handy/
 
 # Publish python package:
 
-- `make release` does the following steps:
+- `make build_setup_py` does the following steps:
     - Builds the `setup.py` and commit it.
     - Add a git tag with the name of `"v" + __init__.__ver__`.
 

_building/__init__.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # coding: utf-8
 
-import imp
+import importlib.util
 import sys
 
 # sys.path.insert(0, os.path.abspath('..'))
@@ -13,10 +13,10 @@
 # __url__ = 'https://requests.readthedocs.io'
 # __version__ = '2.23.0'
 
-__author__ = 'Zhang Yanpo'
-__author_email__ = 'drdr.xp@gmail.com'
-__license__ = 'MIT'
-__copyright__ = 'Copyright 2020 Zhang Yanpo'
+__author__ = "Zhang Yanpo"
+__author_email__ = "drdr.xp@gmail.com"
+__license__ = "MIT"
+__copyright__ = "Copyright 2020 Zhang Yanpo"
 
 
 # Configuration file for the Sphinx documentation builder.
@@ -31,14 +31,14 @@
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
-    'sphinx.ext.napoleon',
+    "sphinx.ext.napoleon",
     # "sphinx.ext.intersphinx",
     # "sphinx.ext.todo",
     # "sphinx.ext.viewcode",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -54,7 +54,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'alabaster'
+html_theme = "alabaster"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -63,19 +63,57 @@
 html_static_path = []
 
 
+def load_parent_package():
+    """
+    Load the parent directory as a package module.
+
+    Returns:
+        tuple: (package_name, package_module)
+    """
+    import os
+
+    parent_dir = os.path.dirname(os.path.dirname(__file__))
+    if parent_dir not in sys.path:
+        sys.path.insert(0, parent_dir)
+
+    # Read the __init__.py file to get the package name
+    init_file = os.path.join(parent_dir, "__init__.py")
+    package_name = None
+
+    with open(init_file, "r") as f:
+        for line in f:
+            if line.strip().startswith("__name__"):
+                # Extract package name from __name__ = "package_name"
+                package_name = line.split("=")[1].strip().strip("\"'")
+                break
+
+    if not package_name:
+        # Fallback: use directory name
+        package_name = os.path.basename(parent_dir)
+
+    # Load the module with proper package context using importlib
+    spec = importlib.util.spec_from_file_location(package_name, init_file)
+    pkg = importlib.util.module_from_spec(spec)
+    sys.modules[package_name] = pkg  # Add to sys.modules so relative imports work
+    spec.loader.exec_module(pkg)
+
+    return package_name, pkg
+
+
 def sphinx_confs():
     """
-        Load repo dir as a package
+    Load repo dir as a package
 
-        `readthedocs` use branch name as dir!
-        Thus the following does not work::
+    `readthedocs` use branch name as dir!
+    Thus the following does not work::
 
-            import pk3proc
+        import pk3proc
     """
 
     print("sys.path:", sys.path)
 
-    pkg = imp.load_source("foo", '../../__init__.py')
+    package_name, pkg = load_parent_package()
+
     return (
         pkg.__name__,
         pkg,

_building/build_readme.py

@@ -2,40 +2,41 @@
 # coding: utf-8
 
 import doctest
-import imp
 import os
 import sys
 
 import jinja2
 import yaml
 
+from __init__ import load_parent_package
+
 # xxx/_building/build_readme.py
 this_base = os.path.dirname(__file__)
 
 j2vars = {}
 
 # let it be able to find indirectly dependent package locally
 # e.g.: `k3fs` depends on `k3confloader`
-sys.path.insert(0, os.path.abspath('..'))
+sys.path.insert(0, os.path.abspath(".."))
 
 # load package name from __init__.py
-pkg = imp.load_source("_foo", '__init__.py')
-j2vars["name"] = pkg.__name__
+package_name, pkg = load_parent_package()
+j2vars["name"] = package_name
 
 
 def get_gh_config():
-    with open('.github/settings.yml', 'r') as f:
+    with open(".github/settings.yml", "r") as f:
         cont = f.read()
 
     cfg = yaml.safe_load(cont)
-    tags = cfg['repository']['topics'].split(',')
+    tags = cfg["repository"]["topics"].split(",")
     tags = [x.strip() for x in tags]
-    cfg['repository']['topics'] = tags
+    cfg["repository"]["topics"] = tags
     return cfg
 
 
 cfg = get_gh_config()
-j2vars['description'] = cfg['repository']['description']
+j2vars["description"] = cfg["repository"]["description"]
 
 
 def get_examples(pkg):
@@ -44,41 +45,41 @@ def get_examples(pkg):
     es = parser.get_examples(doc)
     rst = []
     for e in es:
-        rst.append('>>> ' + e.source.strip())
+        rst.append(">>> " + e.source.strip())
         rst.append(e.want.strip())
 
-    rst = '\n'.join(rst)
+    rst = "\n".join(rst)
 
-    for fn in ("synopsis.txt",
-               "synopsis.py",
-               ):
+    for fn in (
+        "synopsis.txt",
+        "synopsis.py",
+    ):
         try:
-            with open(fn, 'r') as f:
-                rst += '\n' + f.read()
+            with open(fn, "r") as f:
+                rst += "\n" + f.read()
 
         except FileNotFoundError:
             pass
 
     return rst
 
 
-j2vars['synopsis'] = get_examples(pkg)
-j2vars['package_doc'] = pkg.__doc__
+j2vars["synopsis"] = get_examples(pkg)
+j2vars["package_doc"] = pkg.__doc__
 
 
 def render_j2(tmpl_path, tmpl_vars, output_path):
-    template_loader = jinja2.FileSystemLoader(searchpath='./')
-    template_env = jinja2.Environment(loader=template_loader,
-                                      undefined=jinja2.StrictUndefined)
+    template_loader = jinja2.FileSystemLoader(searchpath="./")
+    template_env = jinja2.Environment(
+        loader=template_loader, undefined=jinja2.StrictUndefined
+    )
     template = template_env.get_template(tmpl_path)
 
     txt = template.render(tmpl_vars)
 
-    with open(output_path, 'w') as f:
+    with open(output_path, "w") as f:
         f.write(txt)
 
 
 if __name__ == "__main__":
-    render_j2('_building/README.md.j2',
-              j2vars,
-              'README.md')
+    render_j2("_building/README.md.j2", j2vars, "README.md")