ssh-profile 0.0.1

Network-aware SSH config profile selector

SSH Profile

Network-aware SSH config profile selector

• Created by Scott Karlin
  • GitLab: https://gitlab.com/sck
  • PyPI: https://pypi.org/user/sckarlin/
• PyPI package: https://pypi.org/project/ssh-profile/
• Free software: MIT License

Features

• TODO: describe your package's key features here

Documentation

• Live site: https://sck.gitlab.io/ssh-profile/
• Preview locally: make docs-serve (serves at http://localhost:8000)

API documentation is auto-generated from docstrings.

Development

To set up for local development:

# Clone the repository
git clone [e-mail]:sck/ssh-profile.git SSH-Profile
cd SSH-Profile

# Create a virtual environment and install all development dependencies
make venv
source venv/bin/activate
make init
make uv.lock
make sync-devci

Run quality checks (format, lint, type check, test):

make qa

Release cycle

1. Edit code and add change notes to the Next Release (TBD) entry in HISTORY.md as you go.

2. When ready to release, upgrade all dependencies and refresh the environment:

   make update
   make sync-devci
   

3. Run the full quality check suite:

   make qa
   

4. In HISTORY.md, replace the Next Release (TBD) heading with the release version and today's date, and verify the change notes are complete.

5. Sync the version to pyproject.toml and uv.lock:

   make set-version
   

6. Commit the release:

   git commit -am "Release X.Y.Z"
   

7. Tag and push. make tag validates version consistency across HISTORY.md, pyproject.toml, and uv.lock; creates an annotated tag; pushes it to origin; and adds a new Next Release (TBD) entry to HISTORY.md:

   make tag
   

   Pushing the tag triggers the GitLab CI/CD publish job, which uploads the package to your selected registry.

8. Commit to open the next development cycle:

   git commit -am "Start next development cycle"
   

9. Go back to step 1.

See Release Checklist for the full recurring workflow.

Author

SSH Profile was created in 2026 by Scott Karlin.

Built with Cookiecutter and the sck/cookiecutter-pypackage-gitlab project template.