lmod-toolkit 0.0.1__tar.gz → 0.0.2__tar.gz

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/.github/workflows/publish-to-test-pypi.yml

@@ -13,13 +13,13 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
       with:
         persist-credentials: false
         fetch-depth: 0  # Fetch all history for all branches and tags
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v7
       with:
         python-version: "3.x"
 
@@ -34,7 +34,7 @@ jobs:
       run: python3 -m build
 
     - name: Store the distribution packages
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: python-package-distributions
         path: dist/
@@ -54,7 +54,7 @@ jobs:
       id-token: write  # IMPORTANT: mandatory for trusted publishing
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v8
       with:
         name: python-package-distributions
         path: dist/
@@ -78,7 +78,7 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v8
       with:
         name: python-package-distributions
         path: dist/

lmod_toolkit-0.0.2/.gitignore

@@ -0,0 +1,216 @@
+# Custom
+*.pyc
+*~
+.DS_Store
+*.swp
+*.old
+_version.py
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
-Name: lmod_toolkit
-Version: 0.0.1
+Name: lmod-toolkit
+Version: 0.0.2
 Summary: ACCESS Lmod Toolkit
-Author-email: Andy Loftus <aloftus@illinois.com>, Eric Blau <blau@globus.org>
+Author-email: Andy Loftus <aloftus@illinois.edu>, Eric Blau <blau@globus.org>
 Project-URL: Repository, https://github.com/access-ci-org/lmod-toolkit
 Keywords: monitoring,information,gathering,publishing
 Classifier: Development Status :: 1 - Planning
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: System :: Monitoring
-Requires-Python: ==3.15.*
+Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 
 # lmod toolkit (LMTK)

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/pyproject.toml

@@ -5,8 +5,8 @@ build-backend = "setuptools.build_meta:__legacy__"
 # see also https://setuptools-git-versioning.readthedocs.io/en/stable/options/version_callback.html
 
 [project]
-name = "lmod_toolkit"
-requires-python = "==3.15.*"
+name = "lmod-toolkit"
+requires-python = ">=3.14"
 dependencies = [
 ]
 dynamic = [
@@ -27,7 +27,7 @@ keywords = [
   "publishing",
 ]
 authors = [
-  {name = "Andy Loftus", email = "aloftus@illinois.com"},
+  {name = "Andy Loftus", email = "aloftus@illinois.edu"},
   {name = "Eric Blau", email = "blau@globus.org"},
 ]
 
@@ -37,7 +37,17 @@ Repository = "https://github.com/access-ci-org/lmod-toolkit"
 [tool.setuptools.dynamic]
 readme = {file = ["README.pypi"], content-type = "text/markdown"}
 
+
+# needed because the package name (lmod-toolkit)
+# doesn't match the import name (lmod_toolkit)
+# [tool.setuptools.packages.find]
+# where = ["src"]
+# include = ["lmod_toolkit*"]
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+
 [tool.setuptools_scm]
-version_file = "lmod_toolkit/_version.py"
-version_scheme = "ipf.build_helper:mk_version"
+version_file = "src/lmod_toolkit/_version.py"
+version_scheme = "ipf.build_helper:mk_version" # a published version must exist in pypi
 local_scheme = "no-local-version"  # local version component not allowed on pypi

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/setup.sh

@@ -68,11 +68,14 @@ install_uv() {
     export UV_UNMANAGED_INSTALL="${UV_DIR}"
     UV_URL=https://raw.githubusercontent.com/"${GH_USER}"/"${GH_REPO}"/refs/heads/"${GH_BRANCH}"/utils/uv_installer.sh
     # allow override of UV_URL (uv installer script)
-    # [[ -n "${IPF_UV_URL}" ]] && UV_URL="${IPF_UV_URL}"
+    [[ -n "${LMTK_UV_URL}" ]] && UV_URL="${LMTK_UV_URL}"
     UV_INSTALLER="${UV_DIR}"/uv_installer.sh
     curl -LsSf --create-dirs "${UV_URL}" -o "${UV_INSTALLER}"
     sh "${UV_INSTALLER}" || die 'failed to install uv'
   }
+  #TODO - would it be useful to have a uv.toml file in {INSTALL_DIR}
+  #TODO - maybe also replace uv with a bash alias to use
+  #       "uv --config-file <PATH_TO_UV_TOML>"
 }
 
 
@@ -83,7 +86,7 @@ mk_venv() {
     export UV_NO_CACHE=1
     export UV_MANAGED_PYTHON=1
     # allow override python version
-    # [[ -n "${IPF_UV_PYTHON}" ]] && UV_PYTHON="${IPF_UV_PYTHON}"
+    [[ -n "${LMTK_UV_PYTHON}" ]] && UV_PYTHON="${LMTK_UV_PYTHON}"
     export UV_PYTHON
     "$UV" venv "$VENV"
     success "Python venv created at '$VENV'"
@@ -115,26 +118,18 @@ is_pre_release_allowed() {
 }
 
 
-install_pre_release() {
-  [[ $DEBUG -eq $YES ]] && set -x
-  is_pre_release_allowed || return
-  "${V_PYTHON}" -m pip install \
-    --upgrade \
-    --no-cache-dir \
-    --pre \
-    --no-deps \
-    --index-url https://test.pypi.org/simple/ \
-    lmod_toolkit"${LMTK_INSTALL_VERSION:+==$LMTK_INSTALL_VERSION}" \
-    && success "Installed dev version of lmod_toolkit"
-}
-
-
 install_lmod_toolkit() {
   [[ $DEBUG -eq $YES ]] && set -x
-  "${V_PYTHON}" -m pip install \
-    --upgrade \
-    lmod_toolkit"${LMTK_INSTALL_VERSION:+==$LMTK_INSTALL_VERSION}" \
-    && success "Ipf and dependencies installed"
+  export UV_DEFAULT_INDEX=https://pypi.org/simple
+  is_pre_release_allowed && {
+    export UV_INDEX=https://test.pypi.org/simple
+    export UV_PRERELEASE=allow
+  }
+  pushd "${INSTALL_DIR}"
+  "${UV}" pip install \
+    lmod-toolkit"${LMTK_INSTALL_VERSION:+==$LMTK_INSTALL_VERSION}"
+  popd
+
 }
 
 
@@ -176,6 +171,8 @@ install_uv
 
 mk_venv
 
+install_lmod_toolkit
+
 # update_files
 
 # mk_symlinks

lmod_toolkit-0.0.2/src/lmod_toolkit/__init__.py

@@ -0,0 +1 @@
+from . import lmod_config

lmod_toolkit-0.0.2/src/lmod_toolkit/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.0.2'
+__version_tuple__ = version_tuple = (0, 0, 2)
+
+__commit_id__ = commit_id = 'gdfb2970e9'

{lmod_toolkit-0.0.1/src/lmod-toolkit → lmod_toolkit-0.0.2/src/lmod_toolkit}/build_helper.py

@@ -1,5 +1,12 @@
 from setuptools_scm.version import ScmVersion, guess_next_version
 import time
+
+# import this module as part of build-system requires in pyproject.toml
+# It must already exist on pypi as a published pkg for the build-system
+# to be able to inlcude it...
+# so for the very first time, use a different one (such as from ipf)
+# in pyproject.toml, then once published, update pyproject.toml to use this one
+
 def mk_version( version: ScmVersion ) -> str:
     # setuptools_scm template options
     # see also https://github.com/pypa/setuptools-scm/blob/main/setuptools-scm/src/setuptools_scm/version.py especially "def meta( ... )"

lmod_toolkit-0.0.2/src/lmod_toolkit/lmod_config.py

@@ -0,0 +1,34 @@
+import json
+import subprocess
+import pprint
+import functools
+
+__all__ = [
+    'Lmod_Config',
+]
+
+class Lmod_Config :
+    def __init__( self ):
+        self.raw = None
+        self.config = None
+        self._load()
+
+    def _load( self ):
+        cmds = [ 'bash', '-l', '-c', 'module --config_json' ]
+        result = subprocess.run(
+            cmds,
+            capture_output=True,  # Captures both stdout and stderr
+            text=True             # Returns strings instead of bytes
+        )
+        # pprint.pprint( ['STDOUT', result.stdout] )
+        # pprint.pprint( ['STDERR', result.stderr] )
+        self.config = json.loads( result.stderr )
+
+    @functools.cached_property
+    def get_key( self, key ):
+        return self.config[ key ]
+
+
+if __name__ == '__main__':
+    lmc = Lmod_Config()
+    pprint.pprint( lmc.config )

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/src/lmod_toolkit.egg-info/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
-Name: lmod_toolkit
-Version: 0.0.1
+Name: lmod-toolkit
+Version: 0.0.2
 Summary: ACCESS Lmod Toolkit
-Author-email: Andy Loftus <aloftus@illinois.com>, Eric Blau <blau@globus.org>
+Author-email: Andy Loftus <aloftus@illinois.edu>, Eric Blau <blau@globus.org>
 Project-URL: Repository, https://github.com/access-ci-org/lmod-toolkit
 Keywords: monitoring,information,gathering,publishing
 Classifier: Development Status :: 1 - Planning
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: System :: Monitoring
-Requires-Python: ==3.15.*
+Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 
 # lmod toolkit (LMTK)

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/src/lmod_toolkit.egg-info/SOURCES.txt

@@ -1,15 +1,18 @@
+.gitignore
 README.md
 README.pypi
 pyproject.toml
 setup.sh
 .github/workflows/publish-to-test-pypi.yml
-src/lmod-toolkit/__init__.py
-src/lmod-toolkit/build_helper.py
-src/lmod-toolkit/lmod_config.py
+src/lmod_toolkit/__init__.py
+src/lmod_toolkit/_version.py
+src/lmod_toolkit/build_helper.py
+src/lmod_toolkit/lmod_config.py
 src/lmod_toolkit.egg-info/PKG-INFO
 src/lmod_toolkit.egg-info/SOURCES.txt
 src/lmod_toolkit.egg-info/dependency_links.txt
 src/lmod_toolkit.egg-info/scm_file_list.json
 src/lmod_toolkit.egg-info/scm_version.json
 src/lmod_toolkit.egg-info/top_level.txt
+utils/quickstart.sh
 utils/uv_installer.sh

{lmod_toolkit-0.0.1 → lmod_toolkit-0.0.2}/src/lmod_toolkit.egg-info/scm_file_list.json

@@ -1,13 +1,15 @@
 {
   "files": [
     ".github/workflows/publish-to-test-pypi.yml",
+    ".gitignore",
     "README.md",
     "README.pypi",
     "pyproject.toml",
     "setup.sh",
-    "src/lmod-toolkit/__init__.py",
-    "src/lmod-toolkit/build_helper.py",
-    "src/lmod-toolkit/lmod_config.py",
+    "src/lmod_toolkit/__init__.py",
+    "src/lmod_toolkit/build_helper.py",
+    "src/lmod_toolkit/lmod_config.py",
+    "utils/quickstart.sh",
     "utils/uv_installer.sh"
   ]
 }

lmod_toolkit-0.0.2/src/lmod_toolkit.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.0.2",
+  "distance": 0,
+  "node": "gdfb2970e9e02eaebf8fa0c5fdb108c4ea816f8a7",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-11-12"
+}

lmod_toolkit-0.0.2/src/lmod_toolkit.egg-info/top_level.txt

@@ -0,0 +1 @@
+lmod_toolkit

lmod_toolkit-0.0.2/utils/quickstart.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/bash
+
+set -x
+
+# =========================
+# customize these as needed
+# =========================
+
+# where to save the installer script
+LMTK_SETUP="${HOME}"/lmtk-setup.sh
+
+# set to an absolute path (default is $HOME/ipf)
+LMTK_INSTALL_DIR="${HOME}"/lmod-toolkit
+
+# dont actually do anything, just print out a list of commands
+# that can be run manually
+# MANUAL=yes
+
+# set to "yes" or leave unset (defaults to latest)
+LMTK_ALLOW_PRE_RELEASE=yes
+
+# specify an exact version of LMTK
+# get version string from
+#    https://pypi.org/project/lmod-toolkit/#history      (production releases)
+# OR https://test.pypi.org/project/lmod-toolkit/#history (pre-release versions)
+# LMTK_INSTALL_VERSION=0.0.2.dev1794287670
+# LMTK_INSTALL_VERSION=0.0.2
+
+# either a branch name or leave unset (defaults to main)
+LMTK_GIT_BRANCH=poc
+
+# specify a specific version of python if needed
+# LMTK_UV_PYTHON=3.15
+
+# =====================================
+# shouldn't need to touch anything else
+# =====================================
+
+
+[[ -z "${LMTK_GIT_BRANCH}" ]] && LMTK_GIT_BRANCH=main
+URL_BASE='https://raw.githubusercontent.com/access-ci-org/lmod-toolkit/refs/heads'
+LMTK_SETUP_URL="${URL_BASE}"/"${LMTK_GIT_BRANCH}"/setup.sh
+LMTK_UV_URL="${URL_BASE}"/"${LMTK_GIT_BRANCH}"/utils/uv_installer.sh
+# LMTK_BIN="${LMTK_INSTALL_DIR}"/bin
+VENV="${LMTK_INSTALL_DIR}"/.venv
+
+###
+# MAIN
+###
+
+# make exports (used by setup script)
+export LMTK_UV_URL
+export LMTK_INSTALL_DIR
+[[ -n "${LMTK_ALLOW_PRE_RELEASE}" ]] && export LMTK_ALLOW_PRE_RELEASE
+[[ -n "${LMTK_UV_PYTHON}" ]] && export LMTK_UV_PYTHON
+[[ -n "${LMTK_INSTALL_VERSION}" ]] && export LMTK_INSTALL_VERSION
+
+# set ACTION if doing manual run
+if [[ -n "${MANUAL}" ]] ; then
+  ACTION=echo
+  set +x
+  echo 'COMMANDS THAT WOULD HAVE BEEN RUN'
+  echo '---------------------------------'
+fi
+
+# stop anything running
+# [[ -x "${IPF_BIN}"/wfm ]] && ${ACTION} bash "${IPF_BIN}"/wfm stop
+
+# cleanup any existing installs
+${ACTION} rm -rf "${LMTK_INSTALL_DIR}"
+# ${ACTION} rm -rf "${HOME}"/.cache/pip #shouldn't need this anymore since switched to UV
+
+# get new setup script
+${ACTION} rm -f "${LMTK_SETUP}"
+${ACTION} curl -o "${LMTK_SETUP}" "${LMTK_SETUP_URL}"
+# and run it
+${ACTION} bash "${LMTK_SETUP}"
+
+# validate install
+# ${ACTION} "${VENV}"/bin/python --version
+# ${ACTION} "${VENV}"/bin/python -m pip freeze

lmod_toolkit-0.0.1/src/lmod-toolkit/lmod_config.py

@@ -1,4 +0,0 @@
-import json
-
-if __name__ == '__main__':
-    pass

lmod_toolkit-0.0.1/src/lmod_toolkit.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.0.1",
-  "distance": 0,
-  "node": "g7caa8c7349c61bcde9f19609377db4f72366ff84",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-11-10"
-}

lmod_toolkit-0.0.1/src/lmod_toolkit.egg-info/top_level.txt

@@ -1 +0,0 @@
-lmod-toolkit