env-use 1.0.0__tar.gz

env_use-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main, master]
+  push:
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up uv with Python ${{ matrix.python-version }}
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          uv sync --all-extras --dev
+
+      - name: Run Pyrefly type checking
+        run: uv run pyrefly check use_env/ tests/
+
+      - name: Run ruff check
+        run: uv run ruff check use_env/ tests/
+
+      - name: Run ruff format check
+        run: uv run ruff format --check use_env/ tests/
+
+      - name: Run pytest with coverage
+        run: uv run pytest --cov=use_env --cov-report=xml --cov-report=term tests/
+
+      - name: Upload coverage report
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false

env_use-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,187 @@
+name: Release
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    types: [closed]
+    branches: [main, master]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  prepare_release_pr:
+    if: github.event_name == 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install semantic-release
+        run: |
+          python -m pip install --upgrade pip
+          pip install python-semantic-release
+
+      - name: Prepare release changes
+        run: |
+          semantic-release version --no-commit --no-tag --no-push --no-vcs-release --skip-build
+
+      - name: Build release PR metadata
+        id: release_meta
+        run: |
+          if git diff --quiet && git diff --cached --quiet; then
+            echo "No release changes detected. Skipping release PR update."
+            echo "should_release=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          CHANGED_FILES="$( { git diff --name-only; git diff --name-only --cached; } | sort -u )"
+
+          if ! echo "$CHANGED_FILES" | grep -q '^CHANGELOG\.md$'; then
+            echo "Expected CHANGELOG.md to be updated for release PR."
+            exit 1
+          fi
+
+          if ! echo "$CHANGED_FILES" | grep -q '^pyproject\.toml$'; then
+            echo "Expected pyproject.toml to be updated for release PR."
+            exit 1
+          fi
+
+          VERSION="$(python - <<'PY'
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          PY
+          )"
+
+          LAST_TAG="$(git describe --tags --abbrev=0 --match 'v*' 2>/dev/null || true)"
+          if [ -n "$LAST_TAG" ]; then
+            RANGE="${LAST_TAG}..HEAD"
+          else
+            RANGE="HEAD"
+          fi
+
+          git log --no-merges --pretty='- %s (%h)' ${RANGE} > /tmp/release_commits.md
+          if [ ! -s /tmp/release_commits.md ]; then
+            echo "- No user-facing commits detected." > /tmp/release_commits.md
+          fi
+
+          {
+            echo "## Release v${VERSION}"
+            echo
+            echo "This PR prepares release \`v${VERSION}\`."
+            echo
+            echo "### Included commits"
+            cat /tmp/release_commits.md
+            echo
+            echo "### Files updated by release automation"
+            echo "- CHANGELOG.md"
+            echo "- pyproject.toml"
+          } > /tmp/release_pr_body.md
+
+          echo "should_release=true" >> "$GITHUB_OUTPUT"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Create or update release PR
+        if: steps.release_meta.outputs.should_release == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "chore(release): prepare release"
+          branch: "release/${{ github.ref_name }}"
+          base: "${{ github.ref_name }}"
+          title: "chore(release): v${{ steps.release_meta.outputs.version }}"
+          body-path: /tmp/release_pr_body.md
+          labels: release
+          delete-branch: false
+
+  tag_release:
+    if: |
+      github.event_name == 'pull_request' &&
+      github.event.pull_request.merged == true &&
+      startsWith(github.event.pull_request.head.ref, 'release/') &&
+      contains(github.event.pull_request.labels.*.name, 'release')
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.compute_tag.outputs.tag }}
+    steps:
+      - name: Checkout merged commit
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.merge_commit_sha }}
+          fetch-depth: 0
+
+      - name: Configure git author
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Compute tag
+        id: compute_tag
+        run: |
+          VERSION="$(python - <<'PY'
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          PY
+          )"
+          echo "tag=v${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Create and push version tag
+        run: |
+          TAG="${{ steps.compute_tag.outputs.tag }}"
+
+          if git rev-parse "${TAG}" >/dev/null 2>&1; then
+            echo "Tag ${TAG} already exists. Skipping."
+            exit 0
+          fi
+
+          git tag "${TAG}" "${{ github.event.pull_request.merge_commit_sha }}"
+          git push origin "${TAG}"
+
+  publish_release:
+    if: github.event_name == 'pull_request' && needs.tag_release.result == 'success'
+    needs: [tag_release]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout tagged commit
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.tag_release.outputs.tag }}
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+          python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          python -m twine upload dist/*
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ needs.tag_release.outputs.tag }}
+          generate_release_notes: true
+          files: dist/*

env_use-1.0.0/.gitignore

@@ -0,0 +1,11 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.DS_Store

env_use-1.0.0/.gitmessage

@@ -0,0 +1,15 @@
+# <type>(<scope>): <subject>
+#
+# <body>
+#
+# <footer>
+#
+# Types: feat, fix, docs, style, refactor, perf, test, chore
+# Examples:
+#   feat(provider): add AWS Secrets Manager support
+#   fix: resolve environment variable caching issue
+#   docs: update installation instructions
+#
+# Breaking changes:
+#   feat!: remove deprecated provider
+#   BREAKING CHANGE: description of the change

env_use-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,23 @@
+repos:
+  - repo: local
+    hooks:
+      - id: pyrefly-check
+        name: Pyrefly type check
+        entry: uv run pyrefly check use_env/ tests/
+        language: system
+        pass_filenames: false
+      - id: ruff-check
+        name: Ruff lint
+        entry: uv run ruff check use_env/ tests/
+        language: system
+        pass_filenames: false
+      - id: ruff-format
+        name: Ruff format
+        entry: uv run ruff format use_env/ tests/
+        language: system
+        pass_filenames: false
+      - id: pytest
+        name: PyTest
+        entry: uv run pytest
+        language: system
+        pass_filenames: false

env_use-1.0.0/.python-version

@@ -0,0 +1 @@
+3.12

env_use-1.0.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.0 (2026-03-03)
+
+- Initial Release
+
+## v0.1.0 (2026-03-03)
+
+- Repository history reset
+- Project/package baseline set to `env-use` at `0.1.0`

env_use-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,116 @@
+# Contributing to use-env
+
+Thank you for your interest in contributing! This document outlines the guidelines for contributing to this project.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork
+3. Create a feature branch
+
+## Development Setup
+
+```bash
+# Clone and install
+git clone https://github.com/YOUR_USERNAME/use-env.git
+cd use-env
+uv sync --all-extras --dev
+
+# Run tests
+pytest
+
+# Run linters
+pyrefly check use_env/ tests/
+ruff check use_env/ tests/
+ruff format use_env/ tests/
+```
+
+## Commit Message Convention
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/) for automatic versioning and changelog generation.
+
+### Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **style**: Changes that do not affect the meaning of the code (white-space, formatting, etc)
+- **refactor**: A code change that neither fixes a bug nor adds a feature
+- **perf**: A code change that improves performance
+- **test**: Adding missing tests or correcting existing tests
+- **chore**: Changes to the build process or auxiliary tools
+
+### Examples
+
+```
+feat: add AWS Secrets Manager provider
+
+fix: resolve environment variable caching issue
+
+docs: update installation instructions
+
+refactor: improve provider registry lookup performance
+
+BREAKING CHANGE: the provider interface has been updated
+```
+
+### Breaking Changes
+
+Breaking changes must be indicated by:
+1. Starting the footer with `BREAKING CHANGE:`
+2. Using a `!` after the type/scope
+
+```
+feat!: remove deprecated vault CLI provider
+
+BREAKING CHANGE: The vault CLI provider has been removed.
+Use the azure-keyvault provider instead.
+```
+
+## Pull Requests
+
+1. Ensure all tests pass
+2. Ensure linting passes
+3. Update documentation if needed
+4. Add tests for new features
+5. Keep commits atomic and properly formatted
+
+## Release Process
+
+Releases are automatically handled by [python-semantic-release](https://python-semantic-release.readthedocs.io/) plus GitHub Actions.
+
+Release flow:
+1. Commits merge into `main`/`master`.
+2. The release workflow runs semantic-release versioning and updates a release PR branch (`release/main` or `release/master`).
+3. When the release PR is merged, the workflow creates and pushes a `vX.Y.Z` tag from the merged commit.
+4. The publish workflow triggers on that tag.
+5. The publish workflow uploads to PyPI and creates the GitHub Release.
+
+## Code Style
+
+- Follow PEP 8 (enforced by ruff)
+- Add type hints to all functions
+- Write docstrings for public APIs
+- Keep functions small and focused
+
+## Testing
+
+All new features should include tests:
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=use_env --cov-report=xml
+```