augint-library 1.9.0

A template library for Python library projects using Poetry and Semantic Release.

Augmenting Integrations Library Template Repository

---

📚 Project Resources

📖 Current Documentation	🧪 Test report for last release

---

Pre-requisites

Install Poetry, AWS CLI, and SAM CLI

Google it and follow the instructions for your platform.

Secret Management

Install chezmoi and age

winget install twpayne.chezmoi
winget install --id FiloSottile.age

Don't forget to setup chezmoi to use age for encryption and github for remote storage.

Set up your AWS OIDC provider (once per account)

Run this once per AWS account (safe to re-run; will no-op if it exists):

aws iam create-open-id-connect-provider `
  --url https://token.actions.githubusercontent.com `
  --client-id-list sts.amazonaws.com

---

⚡ Getting Started

Very important: Grab your PyPi and TestPyPi names right away, they may not be available later!

---

Configure Trusted Publisher on PyPI and TestPyPI

• Go to PyPI Trusted Publishers
• Click Add a trusted publisher, link this repo, and authorize publishing from main
• Repeat on TestPyPI Trusted Publishers for dev

---

Bootstrap your project

Run the bootstrap script to set up your project:

# Complete setup (creates .env and AWS resources)
python bootstrap.py setup

# Or run steps individually:
python bootstrap.py init      # Create .env file
python bootstrap.py aws       # Set up AWS pipeline resources and fix trust policy

The bootstrap script will:

1. Auto-detect your GitHub info from git remote
2. Create a .env file with all required variables
3. Run sam pipeline bootstrap and capture the generated ARNs
4. Automatically fix the trust policy for GitHub Actions OIDC

Manual setup steps

1. Fill in your GitHub token in .env

2. Save your .env file to chezmoi:

   chezmoi add .env
   chezmoi git add .
   chezmoi git commit -- -am "Add .env file for your-repo-name"
   

3. Replace template names:

   • Search and replace augint-library → your project name
   • Search and replace augint_library → your module name
   • Rename directory: src/augint_library → src/<your_module_name>
   • Clear contents of CHANGELOG.md
   • Set version to 0.0.0 in pyproject.toml

4. Initialize development environment:

   poetry install
   poetry lock
   pre-commit install
   pre-commit install --install-hooks
   pre-commit run --all-files
   

5. Push secrets to GitHub:

   ai-gh-push
   

6. Push your repo! Don't for get to set your repository's branch protection rules to require a successful run of the pipeline before merging PRs.

7. To use Claude Code remember to have this in your environment one way or another:

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

Helpful Commands

# "source" an .env file in PowerShell
get-content .env | foreach {
    $name, $value = $_.split('=')
    if ([string]::IsNullOrWhiteSpace($name) -or $name.Contains('#')) {
        # skip empty or comment line in ENV file
        return
    }
    set-content env:\$name $value
}