lmod-toolkit 0.0.1__tar.gz

lmod_toolkit-0.0.1/.github/workflows/publish-to-test-pypi.yml

@@ -0,0 +1,88 @@
+# Adapted from:
+# https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
+
+name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distribution 📦
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
+        fetch-depth: 0  # Fetch all history for all branches and tags
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+
+    - name: Install pypa/build
+      run: >-
+        python3 -m
+        pip install
+        build
+        --user
+
+    - name: Build a binary wheel and a source tarball
+      run: python3 -m build
+
+    - name: Store the distribution packages
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+
+  publish-to-pypi:
+    name: >-
+      Publish Python 🐍 distribution 📦 to PyPI
+    if: startsWith(github.ref, 'refs/tags/')  # only publish to PyPI on tag pushes
+    needs:
+    - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/ipf
+    permissions:
+      id-token: write  # IMPORTANT: mandatory for trusted publishing
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+
+
+  publish-to-testpypi:
+    name: Publish Python 🐍 distribution 📦 to TestPyPI
+    needs:
+    - build
+    runs-on: ubuntu-latest
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/ipf
+
+    permissions:
+      id-token: write  # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Publish distribution 📦 to TestPyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/

lmod_toolkit-0.0.1/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: lmod_toolkit
+Version: 0.0.1
+Summary: ACCESS Lmod Toolkit
+Author-email: Andy Loftus <aloftus@illinois.com>, 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.*
+Description-Content-Type: text/markdown
+
+# lmod toolkit (LMTK)
+Tools for working with lmod
+
+## Project Home
+https://github.com/access-ci-org/lmod-toolkit
+
+## Quick Install
+1. ` curl -o lmtk-setup.sh
+https://raw.githubusercontent.com/access-ci-org/lmod-toolkit/refs/heads/main/setup.sh
+`
+1. bash lmtk-setup.sh
+
+## Installation Guide
+https://github.com/access-ci-org/lmod-toolkit

lmod_toolkit-0.0.1/README.md

@@ -0,0 +1,7 @@
+# lmod toolkit
+Tools for working with lmod
+
+## Install
+` curl -o lmtk-setup.sh
+https://raw.githubusercontent.com/access-ci-org/lmod-toolkit/refs/heads/main/setup.sh
+`

lmod_toolkit-0.0.1/README.pypi

@@ -0,0 +1,14 @@
+# lmod toolkit (LMTK)
+Tools for working with lmod
+
+## Project Home
+https://github.com/access-ci-org/lmod-toolkit
+
+## Quick Install
+1. ` curl -o lmtk-setup.sh
+https://raw.githubusercontent.com/access-ci-org/lmod-toolkit/refs/heads/main/setup.sh
+`
+1. bash lmtk-setup.sh
+
+## Installation Guide
+https://github.com/access-ci-org/lmod-toolkit

lmod_toolkit-0.0.1/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = [ "setuptools >= 80", "setuptools-scm >= 8.3", "ipf >= 1.9" ]
+build-backend = "setuptools.build_meta:__legacy__"
+# __legacy__ enables access to function in the local package
+# see also https://setuptools-git-versioning.readthedocs.io/en/stable/options/version_callback.html
+
+[project]
+name = "lmod_toolkit"
+requires-python = "==3.15.*"
+dependencies = [
+]
+dynamic = [
+  "version",
+  "readme",
+]
+description = "ACCESS Lmod Toolkit"
+license-files = ["LICEN[CS]E*"]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Programming Language :: Python :: 3",
+  "Topic :: System :: Monitoring",
+]
+keywords = [
+  "monitoring",
+  "information",
+  "gathering",
+  "publishing",
+]
+authors = [
+  {name = "Andy Loftus", email = "aloftus@illinois.com"},
+  {name = "Eric Blau", email = "blau@globus.org"},
+]
+
+[project.urls]
+Repository = "https://github.com/access-ci-org/lmod-toolkit"
+
+[tool.setuptools.dynamic]
+readme = {file = ["README.pypi"], content-type = "text/markdown"}
+
+[tool.setuptools_scm]
+version_file = "lmod_toolkit/_version.py"
+version_scheme = "ipf.build_helper:mk_version"
+local_scheme = "no-local-version"  # local version component not allowed on pypi

lmod_toolkit-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lmod_toolkit-0.0.1/setup.sh

@@ -0,0 +1,183 @@
+#!/bin/bash
+
+YES=0 #no touchee
+NO=1  #no touchee
+
+
+# ###
+# User might want to change these, though should use environment vars
+
+INSTALL_DIR="${LMTK_INSTALL_DIR:-$HOME/lmod-toolkit}"
+DEBUG=$YES
+VERBOSE=$YES
+
+# END OF USER CONFIGURABLE SECTION
+# ###
+
+
+# NO USER CHANGES AFTER THIS
+
+GH_USER=access-ci-org
+GH_REPO=lmod-toolkit
+GH_BRANCH=main
+UV_PYTHON=3.15 #python version preferred by lmod-toolkit
+UV_DIR="${INSTALL_DIR}"/uv
+UV="${UV_DIR}"/uv
+VENV="$INSTALL_DIR"/.venv
+V_PYTHON="$VENV"/bin/python
+# SITE_PACKAGES=  #created by mk_venv()
+# LMTK_PATH=       #created by mk_venv()
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+NC='\033[0m'  # No Color
+
+
+err() {
+	echo -e "${RED}✗ ERROR: $*${NC}"
+}
+
+
+success() {
+  echo -e "${GREEN}✓ $*${NC}"
+}
+
+
+die() {
+  err "$*"
+  echo "from (${BASH_SOURCE[1]} [${BASH_LINENO[0]}] ${FUNCNAME[1]})"
+  kill 0
+  exit 99
+}
+
+
+log() {
+  [[ $VERBOSE -eq $YES ]] || return 0
+  echo "INFO $*" >&2
+}
+
+
+debug() {
+  [[ $DEBUG -eq $YES ]] || return 0
+  echo "DEBUG (${BASH_SOURCE[1]} [${BASH_LINENO[0]}] ${FUNCNAME[1]}) $*"
+}
+
+
+install_uv() {
+  [[ $DEBUG -eq $YES ]] && set -x
+  [[ -f "${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}"
+    UV_INSTALLER="${UV_DIR}"/uv_installer.sh
+    curl -LsSf --create-dirs "${UV_URL}" -o "${UV_INSTALLER}"
+    sh "${UV_INSTALLER}" || die 'failed to install uv'
+  }
+}
+
+
+mk_venv() {
+  [[ $DEBUG -eq $YES ]] && set -x
+  [[ -d "$VENV" ]] || {
+    export UV_PYTHON_INSTALL_DIR="${UV_DIR}"/python
+    export UV_NO_CACHE=1
+    export UV_MANAGED_PYTHON=1
+    # allow override python version
+    # [[ -n "${IPF_UV_PYTHON}" ]] && UV_PYTHON="${IPF_UV_PYTHON}"
+    export UV_PYTHON
+    "$UV" venv "$VENV"
+    success "Python venv created at '$VENV'"
+    # "${V_PYTHON}" -m ensurepip
+    # success "Ensure native pip is available"
+    # "${V_PYTHON}" -m pip install --upgrade pip
+    # success "Updated to latest pip version"
+  }
+  SITE_PACKAGES=$(
+    "$V_PYTHON" -c 'import sysconfig; print(sysconfig.get_paths()["purelib"])'
+  )
+  LMTK_PATH="$SITE_PACKAGES"/lmod_toolkit
+}
+
+
+is_pre_release_allowed() {
+  # to install the latest pre-release version: export LMTK_ALLOW_PRE_RELEASE=yes
+  [[ $DEBUG -eq $YES ]] && set -x
+  local _retval=$NO
+  if [[  "$LMTK_ALLOW_PRE_RELEASE" == "yes" \
+      || "$LMTK_ALLOW_PRE_RELEASE" == "YES" \
+      || "$LMTK_ALLOW_PRE_RELEASE" == "Y" \
+      || "$LMTK_ALLOW_PRE_RELEASE" == "y" \
+      || "$LMTK_ALLOW_PRE_RELEASE" -eq 1
+     ]] ; then
+     _retval=$YES
+   fi
+  return $_retval
+}
+
+
+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"
+}
+
+
+update_files() {
+  [[ $DEBUG -eq $YES ]] && set -x
+  # Update any files that need INSTALL_DIR
+  local _pattern='___INSTALL_DIR___'
+  local _replacement="$INSTALL_DIR"
+  grep -r --files-with-matches -F "$_pattern" "$LMTK_PATH" \
+  | while read; do
+      sed -i -e "s?$_pattern?$_replacement?" "$REPLY"
+    done
+}
+
+
+mk_symlinks() {
+  [[ $DEBUG -eq $YES ]] && set -x
+  pushd "$INSTALL_DIR"
+  local _symlink_dirs=( bin etc configure lib var )
+  # for d in "${_symlink_dirs[@]}"; do
+  #   [[ -L $d ]] || ln -s "$LMTK_PATH"/$d
+  # done
+  popd
+  pushd "$INSTALL_DIR"/bin
+  ln -s "${V_PYTHON}"
+  popd
+}
+
+
+restore_config_links() {
+  [[ $DEBUG -eq $YES ]] && set -x
+  /bin/bash "$INSTALL_DIR"/bin/save_configs.sh
+}
+
+
+[[ $DEBUG -eq $YES ]] && set -x
+
+install_uv
+
+mk_venv
+
+# update_files
+
+# mk_symlinks
+
+# restore_config_links

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

@@ -0,0 +1,23 @@
+from setuptools_scm.version import ScmVersion, guess_next_version
+import time
+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( ... )"
+    # '{branch}',
+    # '{dirty}',
+    # '{distance}',
+    # '{node}',
+    # '{node_date}',
+    # '{time}',
+    # SPEACIAL NAMES
+    # '{guessed}', #from version.py:format_next_version(...)
+
+    final = 'unknown'
+    if version.exact :
+        final = version.format_with( '{tag}' )
+    else :
+        # unix timestamp as dev qualifier, ensures it's always unique
+        # to comply with test.pypi.org requirement to NEVER re-use a version
+        fmt_str = '{guessed}.dev' + str(int(time.time()))
+        final = version.format_next_version( guess_next_version, fmt_str )
+    return final

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

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

lmod_toolkit-0.0.1/src/lmod_toolkit.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: lmod_toolkit
+Version: 0.0.1
+Summary: ACCESS Lmod Toolkit
+Author-email: Andy Loftus <aloftus@illinois.com>, 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.*
+Description-Content-Type: text/markdown
+
+# lmod toolkit (LMTK)
+Tools for working with lmod
+
+## Project Home
+https://github.com/access-ci-org/lmod-toolkit
+
+## Quick Install
+1. ` curl -o lmtk-setup.sh
+https://raw.githubusercontent.com/access-ci-org/lmod-toolkit/refs/heads/main/setup.sh
+`
+1. bash lmtk-setup.sh
+
+## Installation Guide
+https://github.com/access-ci-org/lmod-toolkit

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

@@ -0,0 +1,15 @@
+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.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/uv_installer.sh

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,13 @@
+{
+  "files": [
+    ".github/workflows/publish-to-test-pypi.yml",
+    "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",
+    "utils/uv_installer.sh"
+  ]
+}

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

@@ -0,0 +1,8 @@
+{
+  "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

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