simple_aws_ssm_parameter_store 0.3.0__tar.gz

simple_aws_ssm_parameter_store-0.3.0/AUTHORS.rst

@@ -0,0 +1,15 @@
+.. _about_author:
+
+About the Author
+------------------------------------------------------------------------------
+::
+
+   (\ (\
+   ( -.-)o
+   o_(")(")
+
+**Sanhe Hu** is a seasoned software engineer with a deep passion for Python development since 2010. As an author and maintainer of `150+ open-source Python projects <https://pypi.org/user/machugwu/>`_, with over `15 million monthly downloads <https://github.com/MacHu-GWU>`_, I bring a wealth of experience to the table. As a Senior Solution Architect and Subject Matter Expert in AI, Data, Amazon Web Services, Cloud Engineering, DevOps, I thrive on helping clients with platform design, enterprise architecture, and strategic roadmaps.
+
+Talk is cheap, show me the code:
+
+- My Github: https://github.com/MacHu-GWU

simple_aws_ssm_parameter_store-0.3.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sanhe Hu <husanhe@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

simple_aws_ssm_parameter_store-0.3.0/PKG-INFO

@@ -0,0 +1,238 @@
+Metadata-Version: 2.4
+Name: simple_aws_ssm_parameter_store
+Version: 0.3.0
+Summary: A Pythonic wrapper library for AWS SSM Parameter Store with enhanced error handling, existence testing, idempotent operations, and comprehensive tag management.
+Author-email: Sanhe Hu <husanhe@gmail.com>
+Maintainer-email: Sanhe Hu <husanhe@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project
+Project-URL: Documentation, https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project
+Project-URL: Issues, https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/issues
+Project-URL: Changelog, https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/blob/main/release-history.rst
+Project-URL: Download, https://pypi.org/pypi/simple-aws-ssm-parameter-store#files
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <4.0,>=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+License-File: AUTHORS.rst
+Requires-Dist: boto3<2.0.0,>=1.35.99
+Requires-Dist: func-args<2.0.0,>=1.0.2
+Provides-Extra: dev
+Requires-Dist: rich<15.0.0,>=14.3.4; extra == "dev"
+Requires-Dist: boto3-stubs[ssm]<2.0.0,>=1.35.99; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest<10.0.0,>=9.1.1; extra == "test"
+Requires-Dist: pytest-cov<8.0.0,>=7.1.0; extra == "test"
+Requires-Dist: moto<6.0.0,>=5.0.0; extra == "test"
+Provides-Extra: doc
+Requires-Dist: Sphinx<9.0.0,>=8.2.3; extra == "doc"
+Requires-Dist: sphinx-copybutton<1.0.0,>=0.5.2; extra == "doc"
+Requires-Dist: sphinx-design<1.0.0,>=0.7.0; extra == "doc"
+Requires-Dist: sphinx-jinja<3.0.0,>=2.0.2; extra == "doc"
+Requires-Dist: furo==2025.12.19; extra == "doc"
+Requires-Dist: pygments<3.0.0,>=2.18.0; extra == "doc"
+Requires-Dist: ipython<8.19.0,>=8.18.1; extra == "doc"
+Requires-Dist: ipykernel<8.0.0,>=7.3.0; extra == "doc"
+Requires-Dist: nbsphinx<1.0.0,>=0.9.8; extra == "doc"
+Requires-Dist: rstobj<3.0.0,>=2.0.0; extra == "doc"
+Requires-Dist: docfly<4.0.0,>=3.0.3; extra == "doc"
+Provides-Extra: mise
+Requires-Dist: PyGithub<3.0.0,>=2.8.0; extra == "mise"
+Requires-Dist: httpx2<3.0.0,>=2.13.1; extra == "mise"
+Dynamic: license-file
+
+
+.. image:: https://readthedocs.org/projects/simple-aws-ssm-parameter-store/badge/?version=latest
+    :target: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/actions?query=workflow:CI
+
+.. image:: https://codecov.io/gh/MacHu-GWU/simple_aws_ssm_parameter_store-project/branch/main/graph/badge.svg
+    :target: https://codecov.io/gh/MacHu-GWU/simple_aws_ssm_parameter_store-project
+
+.. image:: https://img.shields.io/pypi/v/simple-aws-ssm-parameter-store.svg
+    :target: https://pypi.python.org/pypi/simple-aws-ssm-parameter-store
+
+.. image:: https://img.shields.io/pypi/l/simple-aws-ssm-parameter-store.svg
+    :target: https://pypi.python.org/pypi/simple-aws-ssm-parameter-store
+
+.. image:: https://img.shields.io/pypi/pyversions/simple-aws-ssm-parameter-store.svg
+    :target: https://pypi.python.org/pypi/simple-aws-ssm-parameter-store
+
+.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/blob/main/release-history.rst
+
+.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project
+
+------
+
+.. image:: https://img.shields.io/badge/Link-API-blue.svg
+    :target: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/py-modindex.html
+
+.. image:: https://img.shields.io/badge/Link-Install-blue.svg
+    :target: `install`_
+
+.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project
+
+.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Download-blue.svg
+    :target: https://pypi.org/pypi/simple-aws-ssm-parameter-store#files
+
+
+Welcome to ``simple_aws_ssm_parameter_store`` Documentation
+==============================================================================
+.. image:: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/_static/simple_aws_ssm_parameter_store-logo.png
+    :target: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/
+
+``simple_aws_ssm_parameter_store`` is a small, Pythonic layer over the boto3 SSM client for `AWS Systems Manager Parameter Store <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html>`_. It does not replace boto3: every function takes your own ``ssm_client`` and smooths over the parts of the raw API that are awkward to use.
+
+What it gives you over the raw client:
+
+- **Existence check without exceptions:** ``get_parameter`` returns ``None`` instead of raising ``ParameterNotFound``.
+- **Idempotent delete:** ``delete_parameter`` returns ``True`` or ``False`` and is safe to call twice.
+- **Writes only on change:** ``put_parameter_if_changed`` skips the write when the parameter already matches, so re-running a script does not use up the 100 versions SSM keeps per parameter.
+- **Tags as a dict:** get, add, replace, or remove tags with plain ``dict[str, str]`` instead of ``[{"Key": ..., "Value": ...}]`` lists.
+- **A typed result:** a ``Parameter`` object with properties such as ``value``, ``version``, ``arn``, and ``aws_account_id``.
+
+
+Quick Tour
+------------------------------------------------------------------------------
+Every public name is imported from ``simple_aws_ssm_parameter_store.api``:
+
+.. code-block:: python
+
+    import boto3
+    from simple_aws_ssm_parameter_store.api import ParameterType
+    from simple_aws_ssm_parameter_store.api import get_parameter
+    from simple_aws_ssm_parameter_store.api import put_parameter_if_changed
+    from simple_aws_ssm_parameter_store.api import delete_parameter
+
+    ssm_client = boto3.client("ssm")
+
+**Read a parameter, or learn that it does not exist**
+
+.. code-block:: python
+
+    param = get_parameter(ssm_client, "/app/database/password", with_decryption=True)
+    if param is None:
+        print("not found")
+    else:
+        print(param.value, param.version, param.is_secure_string_type)
+
+**Write only when the value changed**
+
+.. code-block:: python
+
+    before, after = put_parameter_if_changed(
+        ssm_client=ssm_client,
+        name="/app/database/host",
+        value="prod-db.example.com",
+        type=ParameterType.STRING,
+        tags={"Team": "platform"},  # the full tag set, synced on every call
+    )
+
+The result tells you what happened:
+
+==========================  =========================================
+``(before, after)``         Meaning
+==========================  =========================================
+``(None, Parameter)``       Created, ``after.version == 1``
+``(Parameter, None)``       Already matched, nothing written
+``(Parameter, Parameter)``  Changed, from ``before.version`` to ``after.version``
+==========================  =========================================
+
+Every argument you pass is compared, not only the value, and a ``SecureString`` is compared by its decrypted value. Running the same call again writes nothing.
+
+**Delete, whether or not it exists**
+
+.. code-block:: python
+
+    delete_parameter(ssm_client, "/app/temp/config")  # True: it was deleted
+    delete_parameter(ssm_client, "/app/temp/config")  # False: it was already gone
+
+**Manage tags as a dict**
+
+.. code-block:: python
+
+    from simple_aws_ssm_parameter_store.api import get_parameter_tags
+    from simple_aws_ssm_parameter_store.api import update_parameter_tags
+    from simple_aws_ssm_parameter_store.api import put_parameter_tags
+    from simple_aws_ssm_parameter_store.api import remove_parameter_tags
+
+    name = "/app/config"
+
+    update_parameter_tags(ssm_client, name, {"Env": "prod", "Team": "platform"})
+    # tags are now {"Env": "prod", "Team": "platform"}
+
+    put_parameter_tags(ssm_client, name, {"Env": "prod", "Owner": "alice"})
+    # tags are now {"Env": "prod", "Owner": "alice"}
+
+    remove_parameter_tags(ssm_client, name, ["Owner"])
+    # tags are now {"Env": "prod"}
+
+    put_parameter_tags(ssm_client, name, {})
+    # tags are now {}
+
+    get_parameter_tags(ssm_client, name)  # read them back as a dict
+
+- ``update_parameter_tags`` adds or overwrites the given keys and keeps the others.
+- ``put_parameter_tags`` makes the given dict the full tag set; ``{}`` removes every tag.
+- ``remove_parameter_tags`` removes only the given keys.
+
+Learn more:
+
+- `Getting Started <https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/01-Getting-Started/index.html>`_: every function, run step by step with real output.
+- `Design Notes <https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/02-Design-Notes/index.html>`_: why the functions behave this way, and the cases to watch for.
+- `API reference <https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/py-modindex.html>`_: every argument.
+
+
+.. _install:
+
+Install
+------------------------------------------------------------------------------
+
+``simple_aws_ssm_parameter_store`` is released on PyPI and needs Python 3.11 or newer:
+
+.. code-block:: console
+
+    $ pip install simple-aws-ssm-parameter-store
+
+To upgrade to latest version:
+
+.. code-block:: console
+
+    $ pip install --upgrade simple-aws-ssm-parameter-store
+
+
+.. _use-with-ai-coding-agents:
+
+Use with AI Coding Agents
+------------------------------------------------------------------------------
+
+This repo ships an `Agent Skill <https://code.claude.com/docs/en/skills>`_ that documents the public API of ``simple_aws_ssm_parameter_store``, so an AI coding agent such as Claude Code can use the library without reading its source. It lives in `.claude/skills/pypi-simple_aws_ssm_parameter_store <https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/tree/main/.claude/skills/pypi-simple_aws_ssm_parameter_store>`_. To use it in your project, copy it into your project's ``.claude/skills/`` folder. Run this from your project's root:
+
+.. code-block:: console
+
+    $ git clone --depth 1 https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project.git /tmp/simple_aws_ssm_parameter_store-project
+    $ mkdir -p .claude/skills
+    $ cp -R /tmp/simple_aws_ssm_parameter_store-project/.claude/skills/pypi-simple_aws_ssm_parameter_store .claude/skills/

simple_aws_ssm_parameter_store-0.3.0/README.rst

@@ -0,0 +1,184 @@
+
+.. image:: https://readthedocs.org/projects/simple-aws-ssm-parameter-store/badge/?version=latest
+    :target: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/actions?query=workflow:CI
+
+.. image:: https://codecov.io/gh/MacHu-GWU/simple_aws_ssm_parameter_store-project/branch/main/graph/badge.svg
+    :target: https://codecov.io/gh/MacHu-GWU/simple_aws_ssm_parameter_store-project
+
+.. image:: https://img.shields.io/pypi/v/simple-aws-ssm-parameter-store.svg
+    :target: https://pypi.python.org/pypi/simple-aws-ssm-parameter-store
+
+.. image:: https://img.shields.io/pypi/l/simple-aws-ssm-parameter-store.svg
+    :target: https://pypi.python.org/pypi/simple-aws-ssm-parameter-store
+
+.. image:: https://img.shields.io/pypi/pyversions/simple-aws-ssm-parameter-store.svg
+    :target: https://pypi.python.org/pypi/simple-aws-ssm-parameter-store
+
+.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/blob/main/release-history.rst
+
+.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project
+
+------
+
+.. image:: https://img.shields.io/badge/Link-API-blue.svg
+    :target: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/py-modindex.html
+
+.. image:: https://img.shields.io/badge/Link-Install-blue.svg
+    :target: `install`_
+
+.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project
+
+.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Download-blue.svg
+    :target: https://pypi.org/pypi/simple-aws-ssm-parameter-store#files
+
+
+Welcome to ``simple_aws_ssm_parameter_store`` Documentation
+==============================================================================
+.. image:: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/_static/simple_aws_ssm_parameter_store-logo.png
+    :target: https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/
+
+``simple_aws_ssm_parameter_store`` is a small, Pythonic layer over the boto3 SSM client for `AWS Systems Manager Parameter Store <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html>`_. It does not replace boto3: every function takes your own ``ssm_client`` and smooths over the parts of the raw API that are awkward to use.
+
+What it gives you over the raw client:
+
+- **Existence check without exceptions:** ``get_parameter`` returns ``None`` instead of raising ``ParameterNotFound``.
+- **Idempotent delete:** ``delete_parameter`` returns ``True`` or ``False`` and is safe to call twice.
+- **Writes only on change:** ``put_parameter_if_changed`` skips the write when the parameter already matches, so re-running a script does not use up the 100 versions SSM keeps per parameter.
+- **Tags as a dict:** get, add, replace, or remove tags with plain ``dict[str, str]`` instead of ``[{"Key": ..., "Value": ...}]`` lists.
+- **A typed result:** a ``Parameter`` object with properties such as ``value``, ``version``, ``arn``, and ``aws_account_id``.
+
+
+Quick Tour
+------------------------------------------------------------------------------
+Every public name is imported from ``simple_aws_ssm_parameter_store.api``:
+
+.. code-block:: python
+
+    import boto3
+    from simple_aws_ssm_parameter_store.api import ParameterType
+    from simple_aws_ssm_parameter_store.api import get_parameter
+    from simple_aws_ssm_parameter_store.api import put_parameter_if_changed
+    from simple_aws_ssm_parameter_store.api import delete_parameter
+
+    ssm_client = boto3.client("ssm")
+
+**Read a parameter, or learn that it does not exist**
+
+.. code-block:: python
+
+    param = get_parameter(ssm_client, "/app/database/password", with_decryption=True)
+    if param is None:
+        print("not found")
+    else:
+        print(param.value, param.version, param.is_secure_string_type)
+
+**Write only when the value changed**
+
+.. code-block:: python
+
+    before, after = put_parameter_if_changed(
+        ssm_client=ssm_client,
+        name="/app/database/host",
+        value="prod-db.example.com",
+        type=ParameterType.STRING,
+        tags={"Team": "platform"},  # the full tag set, synced on every call
+    )
+
+The result tells you what happened:
+
+==========================  =========================================
+``(before, after)``         Meaning
+==========================  =========================================
+``(None, Parameter)``       Created, ``after.version == 1``
+``(Parameter, None)``       Already matched, nothing written
+``(Parameter, Parameter)``  Changed, from ``before.version`` to ``after.version``
+==========================  =========================================
+
+Every argument you pass is compared, not only the value, and a ``SecureString`` is compared by its decrypted value. Running the same call again writes nothing.
+
+**Delete, whether or not it exists**
+
+.. code-block:: python
+
+    delete_parameter(ssm_client, "/app/temp/config")  # True: it was deleted
+    delete_parameter(ssm_client, "/app/temp/config")  # False: it was already gone
+
+**Manage tags as a dict**
+
+.. code-block:: python
+
+    from simple_aws_ssm_parameter_store.api import get_parameter_tags
+    from simple_aws_ssm_parameter_store.api import update_parameter_tags
+    from simple_aws_ssm_parameter_store.api import put_parameter_tags
+    from simple_aws_ssm_parameter_store.api import remove_parameter_tags
+
+    name = "/app/config"
+
+    update_parameter_tags(ssm_client, name, {"Env": "prod", "Team": "platform"})
+    # tags are now {"Env": "prod", "Team": "platform"}
+
+    put_parameter_tags(ssm_client, name, {"Env": "prod", "Owner": "alice"})
+    # tags are now {"Env": "prod", "Owner": "alice"}
+
+    remove_parameter_tags(ssm_client, name, ["Owner"])
+    # tags are now {"Env": "prod"}
+
+    put_parameter_tags(ssm_client, name, {})
+    # tags are now {}
+
+    get_parameter_tags(ssm_client, name)  # read them back as a dict
+
+- ``update_parameter_tags`` adds or overwrites the given keys and keeps the others.
+- ``put_parameter_tags`` makes the given dict the full tag set; ``{}`` removes every tag.
+- ``remove_parameter_tags`` removes only the given keys.
+
+Learn more:
+
+- `Getting Started <https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/01-Getting-Started/index.html>`_: every function, run step by step with real output.
+- `Design Notes <https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/02-Design-Notes/index.html>`_: why the functions behave this way, and the cases to watch for.
+- `API reference <https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/py-modindex.html>`_: every argument.
+
+
+.. _install:
+
+Install
+------------------------------------------------------------------------------
+
+``simple_aws_ssm_parameter_store`` is released on PyPI and needs Python 3.11 or newer:
+
+.. code-block:: console
+
+    $ pip install simple-aws-ssm-parameter-store
+
+To upgrade to latest version:
+
+.. code-block:: console
+
+    $ pip install --upgrade simple-aws-ssm-parameter-store
+
+
+.. _use-with-ai-coding-agents:
+
+Use with AI Coding Agents
+------------------------------------------------------------------------------
+
+This repo ships an `Agent Skill <https://code.claude.com/docs/en/skills>`_ that documents the public API of ``simple_aws_ssm_parameter_store``, so an AI coding agent such as Claude Code can use the library without reading its source. It lives in `.claude/skills/pypi-simple_aws_ssm_parameter_store <https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/tree/main/.claude/skills/pypi-simple_aws_ssm_parameter_store>`_. To use it in your project, copy it into your project's ``.claude/skills/`` folder. Run this from your project's root:
+
+.. code-block:: console
+
+    $ git clone --depth 1 https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project.git /tmp/simple_aws_ssm_parameter_store-project
+    $ mkdir -p .claude/skills
+    $ cp -R /tmp/simple_aws_ssm_parameter_store-project/.claude/skills/pypi-simple_aws_ssm_parameter_store .claude/skills/

simple_aws_ssm_parameter_store-0.3.0/pyproject.toml

@@ -0,0 +1,128 @@
+# [project] table: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+[project]
+name = "simple_aws_ssm_parameter_store"
+# Bump before each release (https://semver.org/), then ``mise run inst`` to update ``uv.lock``.
+version = "0.3.0"
+description = "A Pythonic wrapper library for AWS SSM Parameter Store with enhanced error handling, existence testing, idempotent operations, and comprehensive tag management."
+# An SPDX license expression (PEP 639); keep ``LICENSE.txt`` in sync.
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license-and-license-files
+# Valid identifiers: https://spdx.org/licenses/
+license = "MIT"
+license-files = ["LICENSE.txt", "AUTHORS.rst"]
+authors = [
+    { name = "Sanhe Hu", email = "husanhe@gmail.com" },
+]
+maintainers = [
+    { name = "Sanhe Hu", email = "husanhe@gmail.com" },
+]
+keywords = []
+readme = "README.rst"
+requires-python = ">=3.11,<4.0"
+# Read: https://pypi.org/classifiers/
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS",
+    "Operating System :: Unix",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+# --- Dependencies ---
+# Edit these lists, then ``mise run inst`` to update ``uv.lock`` and ``.venv``.
+dependencies = [
+    "boto3>=1.35.99,<2.0.0", # AWS SDK for Python
+    "func-args>=1.0.2,<2.0.0", # Pythonic API helpers
+]
+
+# --- Optional dependencies (extras) ---
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#dependencies-optional-dependencies
+# Each one must support every Python version in ``requires-python``.
+[project.optional-dependencies]
+
+# local development
+dev = [
+    "rich>=14.3.4,<15.0.0",
+    "boto3-stubs[ssm]>=1.35.99,<2.0.0", # type stubs for the SSM client
+]
+
+# tests and coverage
+test = [
+    "pytest>=9.1.1,<10.0.0",
+    "pytest-cov>=7.1.0,<8.0.0",
+    "moto>=5.0.0,<6.0.0", # mock AWS services in unit tests
+]
+
+# docs build
+doc = [
+    "Sphinx>=8.2.3,<9.0.0", # held below 9 until its autodoc rewrite is verified
+    "sphinx-copybutton>=0.5.2,<1.0.0", # copy button on code blocks
+    "sphinx-design>=0.7.0,<1.0.0", # cards, tabs, grids
+    "sphinx-jinja>=2.0.2,<3.0.0", # jinja in reST
+    "furo==2025.12.19", # theme
+    "pygments>=2.18.0,<3.0.0", # syntax highlighting
+    "ipython>=8.18.1,<8.19.0", # notebook execution
+    "ipykernel>=7.3.0,<8.0.0", # notebook kernel
+    "nbsphinx>=0.9.8,<1.0.0", # notebooks as doc pages
+    "rstobj>=2.0.0,<3.0.0", # reST from Python
+    "docfly>=3.0.3,<4.0.0", # toctree and API reference
+]
+
+# mise tasks
+mise = [
+    "PyGithub>=2.8.0,<3.0.0", # GitHub API client
+    "httpx2>=2.13.1,<3.0.0", # Codecov and Read the Docs APIs
+]
+
+[project.urls]
+Homepage = "https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project"
+Documentation = "https://simple-aws-ssm-parameter-store.readthedocs.io/en/latest/"
+Repository = "https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project"
+Issues = "https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/issues"
+Changelog = "https://github.com/MacHu-GWU/simple_aws_ssm_parameter_store-project/blob/main/release-history.rst"
+Download = "https://pypi.org/pypi/simple-aws-ssm-parameter-store#files"
+
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#creating-executable-scripts
+[project.scripts]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = [
+    "simple_aws_ssm_parameter_store*",
+]
+exclude = [
+    "simple_aws_ssm_parameter_store.tests",
+    "simple_aws_ssm_parameter_store.tests.*",
+    "simple_aws_ssm_parameter_store.docs",
+    "simple_aws_ssm_parameter_store.docs.*",
+]
+
+# --- ruff: ``mise run format`` / ``mise run lint`` ---
+[tool.ruff]
+extend-exclude = [
+    "simple_aws_ssm_parameter_store/vendor",
+    ".claude/skills/*/assets", # templates, not valid Python
+]
+
+[tool.ruff.lint.per-file-ignores]
+# re-export modules
+"**/__init__.py" = ["F401"]
+"**/api.py" = ["F401"]
+
+# --- pytest 9+ native table ---
+# Read: https://docs.pytest.org/en/stable/reference/customize.html#pyproject-toml
+[tool.pytest]
+testpaths = ["tests"]
+# strict = true # only with a pinned pytest
+# filterwarnings = ["error"]
+# markers = ["slow: tests that take more than a few seconds"]
+
+# --- Build (``mise run build``); setuptools 77+ for PEP 639 ``license`` ---
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"

simple_aws_ssm_parameter_store-0.3.0/setup.cfg

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

simple_aws_ssm_parameter_store-0.3.0/simple_aws_ssm_parameter_store/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

simple_aws_ssm_parameter_store-0.3.0/simple_aws_ssm_parameter_store/api.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+
+from .constants import ParameterType
+from .constants import ParameterTier
+from .constants import ResourceType
+from .constants import DEFAULT_KMS_KEY
+from .utils import encode_tags
+from .utils import decode_tags
+from .model import Parameter
+from .client import get_parameter
+from .client import put_parameter_if_changed
+from .client import delete_parameter
+from .client import get_parameter_tags
+from .client import remove_parameter_tags
+from .client import update_parameter_tags
+from .client import put_parameter_tags