stsmfa-cli 1.4.6__tar.gz → 1.5.0__tar.gz

{stsmfa_cli-1.4.6 → stsmfa_cli-1.5.0}/PKG-INFO

@@ -1,31 +1,29 @@
 Metadata-Version: 2.1
 Name: stsmfa-cli
-Version: 1.4.6
+Version: 1.5.0
 Summary: A small CLI to help with creating AWS profile for MFA protected sessions
-Home-page: https://github.com/browniebroke/stsmfa-cli
+Author-email: Bruno Alla <alla.brunoo@gmail.com>
 License: MIT
-Author: Bruno Alla
-Author-email: alla.brunoo@gmail.com
-Requires-Python: >=3.9,<4.0
+Project-URL: Bug Tracker, https://github.com/browniebroke/stsmfa-cli/issues
+Project-URL: Changelog, https://github.com/browniebroke/stsmfa-cli/blob/main/CHANGELOG.md
+Project-URL: repository, https://github.com/browniebroke/stsmfa-cli
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
-Requires-Dist: boto3 (>=1.26,<2.0)
-Requires-Dist: rich (>=10.0)
-Requires-Dist: typer (>=0.15.0,<0.16.0)
-Project-URL: Bug Tracker, https://github.com/browniebroke/stsmfa-cli/issues
-Project-URL: Changelog, https://github.com/browniebroke/stsmfa-cli/blob/main/CHANGELOG.md
-Project-URL: Repository, https://github.com/browniebroke/stsmfa-cli
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3<2,>=1.26
+Requires-Dist: rich>=10
+Requires-Dist: typer<1,>=0.15
 
 # STS MFA CLI
 
@@ -38,8 +36,8 @@ Description-Content-Type: text/markdown
   </a>
 </p>
 <p align="center">
-  <a href="https://python-poetry.org/">
-    <img src="https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json" alt="Poetry">
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
   </a>
   <a href="https://github.com/astral-sh/ruff">
     <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
@@ -72,10 +70,10 @@ Via Homebrew:
 brew install browniebroke/tap/stsmfa-cli
 ```
 
-Via pip, pipx, or your favourite Python package manager:
+Via uv, or your favourite Python package manager:
 
 ```bash
-pip install stsmfa-cli
+uv tool install stsmfa-cli
 ```
 
 ## Usage
@@ -94,7 +92,7 @@ mfa_serial = arn:aws:iam::123456789010:mfa/first.last
 When running, for example:
 
 ```bash
-stsmfa --profile my-profile-name 123456
+awsmfa --profile my-profile-name 123456
 ```
 
 This will create a session using the MFA serial defined under `my-profile-name` with the one-time password `123456`, and save the required AWS key, secret and token under as a new profile `my-profile-name-mfa` in you `~/.aws/credentials` file.
@@ -133,4 +131,3 @@ This package was created with
 [Copier](https://copier.readthedocs.io/) and the
 [browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
 project template.
-

{stsmfa_cli-1.4.6 → stsmfa_cli-1.5.0}/README.md

@@ -9,8 +9,8 @@
   </a>
 </p>
 <p align="center">
-  <a href="https://python-poetry.org/">
-    <img src="https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json" alt="Poetry">
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
   </a>
   <a href="https://github.com/astral-sh/ruff">
     <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
@@ -43,10 +43,10 @@ Via Homebrew:
 brew install browniebroke/tap/stsmfa-cli
 ```
 
-Via pip, pipx, or your favourite Python package manager:
+Via uv, or your favourite Python package manager:
 
 ```bash
-pip install stsmfa-cli
+uv tool install stsmfa-cli
 ```
 
 ## Usage
@@ -65,7 +65,7 @@ mfa_serial = arn:aws:iam::123456789010:mfa/first.last
 When running, for example:
 
 ```bash
-stsmfa --profile my-profile-name 123456
+awsmfa --profile my-profile-name 123456
 ```
 
 This will create a session using the MFA serial defined under `my-profile-name` with the one-time password `123456`, and save the required AWS key, secret and token under as a new profile `my-profile-name-mfa` in you `~/.aws/credentials` file.

{stsmfa_cli-1.4.6 → stsmfa_cli-1.5.0}/pyproject.toml

@@ -1,46 +1,45 @@
-[build-system]
-build-backend = "poetry.core.masonry.api"
-requires = [ "poetry-core>=1" ]
-
-[tool.poetry]
+[project]
 name = "stsmfa-cli"
-version = "1.4.6"
+version = "1.5.0"
 description = "A small CLI to help with creating AWS profile for MFA protected sessions"
-authors = [ "Bruno Alla <alla.brunoo@gmail.com>" ]
-license = "MIT"
 readme = "README.md"
-repository = "https://github.com/browniebroke/stsmfa-cli"
+license = { text = "MIT" }
+authors = [
+  { name = "Bruno Alla", email = "alla.brunoo@gmail.com" },
+]
+requires-python = ">=3.9"
 classifiers = [
   "Development Status :: 2 - Pre-Alpha",
   "Intended Audience :: Developers",
   "Natural Language :: English",
   "Operating System :: OS Independent",
-  "Topic :: Software Development :: Libraries",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
-]
-packages = [
-  { include = "stsmfa", from = "src" },
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries",
 ]
 
-[tool.poetry.urls]
-"Bug Tracker" = "https://github.com/browniebroke/stsmfa-cli/issues"
-"Changelog" = "https://github.com/browniebroke/stsmfa-cli/blob/main/CHANGELOG.md"
-
-[tool.poetry.scripts]
-stsmfa = "stsmfa.cli:app"
-awsmfa = "stsmfa.cli:app"
-
-[tool.poetry.dependencies]
-python = "^3.9"
-boto3 = "^1.26"
-typer = "^0.15.0"
-rich = ">=10.0"
-
-[tool.poetry.group.dev.dependencies]
-pytest = "^8.0.0"
-pytest-cov = "^6.0.0"
-pyfakefs = "^5.0.0"
-pytest-mock = "^3.10.0"
+dependencies = [
+  "boto3>=1.26,<2",
+  "rich>=10",
+  "typer>=0.15,<1",
+]
+urls."Bug Tracker" = "https://github.com/browniebroke/stsmfa-cli/issues"
+urls.Changelog = "https://github.com/browniebroke/stsmfa-cli/blob/main/CHANGELOG.md"
+urls.repository = "https://github.com/browniebroke/stsmfa-cli"
+scripts.awsmfa = "stsmfa.cli:app"
+scripts.stsmfa = "stsmfa.cli:app"
+
+[dependency-groups]
+dev = [
+  "pyfakefs>=5,<6",
+  "pytest>=8,<9",
+  "pytest-cov>=6,<7",
+  "pytest-mock>=3.10,<4",
+]
 
 [tool.ruff]
 target-version = "py39"
@@ -115,11 +114,16 @@ module = "tests.*"
 allow_untyped_defs = true
 
 [tool.semantic_release]
-version_toml = [ "pyproject.toml:tool.poetry.version" ]
+version_toml = [ "pyproject.toml:project.version" ]
 version_variables = [
   "src/stsmfa/__init__.py:__version__",
 ]
-build_command = "pip install poetry && poetry build"
+build_command = """
+pip install uv
+uv lock
+git add uv.lock
+uv build
+"""
 
 [tool.semantic_release.changelog]
 exclude_commit_patterns = [

stsmfa_cli-1.5.0/setup.cfg

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

stsmfa_cli-1.5.0/setup.py

@@ -0,0 +1,9 @@
+#!/usr/bin/env python
+
+# This is a shim to allow GitHub to detect the package, build is done with poetry
+# Taken from https://github.com/Textualize/rich
+
+import setuptools
+
+if __name__ == "__main__":
+    setuptools.setup(name="stsmfa-cli")

stsmfa_cli-1.5.0/src/stsmfa/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.5.0"

stsmfa_cli-1.5.0/src/stsmfa_cli.egg-info/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.1
+Name: stsmfa-cli
+Version: 1.5.0
+Summary: A small CLI to help with creating AWS profile for MFA protected sessions
+Author-email: Bruno Alla <alla.brunoo@gmail.com>
+License: MIT
+Project-URL: Bug Tracker, https://github.com/browniebroke/stsmfa-cli/issues
+Project-URL: Changelog, https://github.com/browniebroke/stsmfa-cli/blob/main/CHANGELOG.md
+Project-URL: repository, https://github.com/browniebroke/stsmfa-cli
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3<2,>=1.26
+Requires-Dist: rich>=10
+Requires-Dist: typer<1,>=0.15
+
+# STS MFA CLI
+
+<p align="center">
+  <a href="https://github.com/browniebroke/stsmfa-cli/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/browniebroke/stsmfa-cli/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://codecov.io/gh/browniebroke/stsmfa-cli">
+    <img src="https://img.shields.io/codecov/c/github/browniebroke/stsmfa-cli.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
+  </a>
+  <a href="https://github.com/astral-sh/ruff">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/stsmfa-cli/">
+    <img src="https://img.shields.io/pypi/v/stsmfa-cli.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/stsmfa-cli.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/stsmfa-cli.svg?style=flat-square" alt="License">
+</p>
+
+---
+
+**Source Code**: <a href="https://github.com/browniebroke/stsmfa-cli" target="_blank">https://github.com/browniebroke/stsmfa-cli </a>
+
+---
+
+Creating temporary profiles for multi-factor auth (MFA) protected accounts using AWS STS is too hard. This is a small CLI that helps with that.
+
+## Installation
+
+Via Homebrew:
+
+```bash
+brew install browniebroke/tap/stsmfa-cli
+```
+
+Via uv, or your favourite Python package manager:
+
+```bash
+uv tool install stsmfa-cli
+```
+
+## Usage
+
+The CLI is a simple command `stsmfa` that creates a profile for a temporary session protected by MFA.
+
+Assuming your `~/.aws/credentials` file looks like this:
+
+```ini
+[my-profile-name]
+aws_access_key_id = AKIAXXXXX
+aws_secret_access_key = xxxx
+mfa_serial = arn:aws:iam::123456789010:mfa/first.last
+```
+
+When running, for example:
+
+```bash
+awsmfa --profile my-profile-name 123456
+```
+
+This will create a session using the MFA serial defined under `my-profile-name` with the one-time password `123456`, and save the required AWS key, secret and token under as a new profile `my-profile-name-mfa` in you `~/.aws/credentials` file.
+
+Now to use that session, you just need to set `AWS_PROFILE=my-profile-name-mfa`.
+
+If your MFA serial is defined under the default profile, you don't need to specify the `--profile` option.
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://browniebroke.com/"><img src="https://avatars.githubusercontent.com/u/861044?v=4?s=80" width="80px;" alt="Bruno Alla"/><br /><sub><b>Bruno Alla</b></sub></a><br /><a href="https://github.com/browniebroke/stsmfa-cli/commits?author=browniebroke" title="Code">💻</a> <a href="#ideas-browniebroke" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/browniebroke/stsmfa-cli/commits?author=browniebroke" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.

stsmfa_cli-1.5.0/src/stsmfa_cli.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+src/stsmfa/__init__.py
+src/stsmfa/__maIn__.py
+src/stsmfa/cli.py
+src/stsmfa/py.typed
+src/stsmfa_cli.egg-info/PKG-INFO
+src/stsmfa_cli.egg-info/SOURCES.txt
+src/stsmfa_cli.egg-info/dependency_links.txt
+src/stsmfa_cli.egg-info/entry_points.txt
+src/stsmfa_cli.egg-info/requires.txt
+src/stsmfa_cli.egg-info/top_level.txt
+tests/test_cli.py

stsmfa_cli-1.5.0/src/stsmfa_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

stsmfa_cli-1.5.0/src/stsmfa_cli.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+awsmfa = stsmfa.cli:app
+stsmfa = stsmfa.cli:app

stsmfa_cli-1.5.0/src/stsmfa_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+boto3<2,>=1.26
+rich>=10
+typer<1,>=0.15

stsmfa_cli-1.5.0/src/stsmfa_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+stsmfa

stsmfa_cli-1.5.0/tests/test_cli.py

@@ -0,0 +1,87 @@
+from pathlib import Path
+
+import pytest
+from click.exceptions import Exit
+
+from stsmfa.cli import run
+
+HOME_PATH = Path.home()
+CREDS_PATH = Path.home() / ".aws" / "credentials"
+
+
+class TestRun:
+    @pytest.fixture()
+    def rich_print(self, mocker):
+        return mocker.patch("stsmfa.cli.print")
+
+    def test_no_file(self, fs, rich_print):
+        with pytest.raises(Exit):
+            run(token="123456", profile="dummy", mfa_profile="")  # noqa: S106
+        rich_print.assert_called_once_with(
+            f"[red]Credentials file not found at {CREDS_PATH}[/red]"
+        )
+
+    def test_profile_missing(self, fs, rich_print):
+        fs.create_file(CREDS_PATH)
+        with pytest.raises(Exit):
+            run(token="123456", profile="dummy", mfa_profile="")  # noqa: S106
+        rich_print.assert_called_once_with(
+            "[red]Profile dummy not found in credentials file " f"{CREDS_PATH}[/red]"
+        )
+
+    def test_mfa_device_missing(self, fs, rich_print):
+        fs.create_file(CREDS_PATH, contents="[dummy]\n")
+        with pytest.raises(Exit):
+            run(token="123456", profile="dummy", mfa_profile="")  # noqa: S106
+        rich_print.assert_called_once_with(
+            "[red]Profile dummy does not have an mfa_serial configured[/red]"
+        )
+
+    def test_get_sts_error(self, fs, rich_print, mocker):
+        fs.create_file(
+            CREDS_PATH,
+            contents="[dummy]\nmfa_serial = arn:aws:iam::123456789012:mfa/dummy\n",
+        )
+
+        boto3 = mocker.patch("stsmfa.cli.boto3")
+        sts = boto3.Session.return_value.client.return_value
+        sts.get_session_token.side_effect = Exception("SOME ERROR")
+
+        with pytest.raises(Exit):
+            run(token="123456", profile="dummy", mfa_profile="")  # noqa: S106
+
+        rich_print.assert_called_once_with(
+            "[red]Error getting session token: SOME ERROR[/red]"
+        )
+
+    def test_get_sts_ok(self, fs, rich_print, mocker):
+        fs.create_file(
+            CREDS_PATH,
+            contents="[dummy]\nmfa_serial = arn:aws:iam::123456789012:mfa/dummy\n",
+        )
+
+        boto3 = mocker.patch("stsmfa.cli.boto3")
+        sts = boto3.Session.return_value.client.return_value
+        sts.get_session_token.return_value = {
+            "Credentials": {
+                "AccessKeyId": "AKSOMEACCESSKEY",
+                "SecretAccessKey": "SOMESECRET",
+                "SessionToken": "SOMETOKEN",
+            }
+        }
+
+        run(token="123456", profile="dummy", mfa_profile="")  # noqa: S106
+
+        rich_print.assert_called_once_with(
+            f"[green]All written to dummy-mfa profile in {CREDS_PATH}[/green]"
+        )
+        assert Path(CREDS_PATH).read_text() == (
+            "[dummy]\n"
+            "mfa_serial = arn:aws:iam::123456789012:mfa/dummy\n"
+            "\n"
+            "[dummy-mfa]\n"
+            "aws_access_key_id = AKSOMEACCESSKEY\n"
+            "aws_secret_access_key = SOMESECRET\n"
+            "aws_session_token = SOMETOKEN\n"
+            "\n"
+        )

stsmfa_cli-1.4.6/src/stsmfa/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.4.6"