Metadata-Version: 2.3
Name: cdk_mate
Version: 0.1.6
Summary: A comprehensive Python toolkit for simplifying AWS CDK deployment workflows across multiple stacks
License: MIT
Author: Sanhe Hu
Author-email: husanhe@gmail.com
Maintainer: Sanhe Hu
Maintainer-email: husanhe@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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
Provides-Extra: auto
Provides-Extra: dev
Provides-Extra: doc
Provides-Extra: test
Requires-Dist: Sphinx (>=7.4.7,<8.0.0) ; extra == "doc"
Requires-Dist: aws-cdk-lib (>=2.179.0,<3.0.0)
Requires-Dist: boto-session-manager (>=1.7.2,<2.0.0)
Requires-Dist: boto3 (>=1.35.99,<2.0.0)
Requires-Dist: build (>=1.2.1,<2.0.0) ; extra == "dev"
Requires-Dist: docfly (==3.0.0) ; extra == "doc"
Requires-Dist: func_args (>=1.0.0,<2.0.0)
Requires-Dist: furo (==2024.8.6) ; extra == "doc"
Requires-Dist: ipython (>=8.18.1,<8.19.0) ; extra == "doc"
Requires-Dist: moto (>=5.0.28,<6.0.0) ; extra == "test"
Requires-Dist: nbsphinx (>=0.8.12,<1.0.0) ; extra == "doc"
Requires-Dist: pygments (>=2.18.0,<3.0.0) ; extra == "doc"
Requires-Dist: pytest (>=8.2.2,<9.0.0) ; extra == "test"
Requires-Dist: pytest-cov (>=6.0.0,<7.0.0) ; extra == "test"
Requires-Dist: rich (>=13.8.1,<14.0.0) ; extra == "dev"
Requires-Dist: rstobj (==1.2.1) ; extra == "doc"
Requires-Dist: sphinx-copybutton (>=0.5.2,<1.0.0) ; extra == "doc"
Requires-Dist: sphinx-design (>=0.6.1,<1.0.0) ; extra == "doc"
Requires-Dist: sphinx-jinja (>=2.0.2,<3.0.0) ; extra == "doc"
Requires-Dist: twine (>=6.0.0,<7.0.0) ; extra == "dev"
Requires-Dist: wheel (>=0.45.0,<1.0.0) ; extra == "dev"
Project-URL: Changelog, https://github.com/MacHu-GWU/cdk_mate-project/blob/main/release-history.rst
Project-URL: Documentation, https://cdk-mate.readthedocs.io/en/latest/
Project-URL: Download, https://pypi.org/pypi/cdk-mate#files
Project-URL: Homepage, https://github.com/MacHu-GWU/cdk_mate-project
Project-URL: Issues, https://github.com/MacHu-GWU/cdk_mate-project/issues
Project-URL: Repository, https://github.com/MacHu-GWU/cdk_mate-project
Description-Content-Type: text/x-rst


.. image:: https://readthedocs.org/projects/cdk-mate/badge/?version=latest
    :target: https://cdk-mate.readthedocs.io/en/latest/
    :alt: Documentation Status

.. image:: https://github.com/MacHu-GWU/cdk_mate-project/actions/workflows/main.yml/badge.svg
    :target: https://github.com/MacHu-GWU/cdk_mate-project/actions?query=workflow:CI

.. image:: https://codecov.io/gh/MacHu-GWU/cdk_mate-project/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/MacHu-GWU/cdk_mate-project

.. image:: https://img.shields.io/pypi/v/cdk-mate.svg
    :target: https://pypi.python.org/pypi/cdk-mate

.. image:: https://img.shields.io/pypi/l/cdk-mate.svg
    :target: https://pypi.python.org/pypi/cdk-mate

.. image:: https://img.shields.io/pypi/pyversions/cdk-mate.svg
    :target: https://pypi.python.org/pypi/cdk-mate

.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
    :target: https://github.com/MacHu-GWU/cdk_mate-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/cdk_mate-project

------

.. image:: https://img.shields.io/badge/Link-API-blue.svg
    :target: https://cdk-mate.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/cdk_mate-project

.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
    :target: https://github.com/MacHu-GWU/cdk_mate-project/issues

.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
    :target: https://github.com/MacHu-GWU/cdk_mate-project/issues

.. image:: https://img.shields.io/badge/Link-Download-blue.svg
    :target: https://pypi.org/pypi/cdk-mate#files


Welcome to ``cdk_mate`` Documentation
==============================================================================
.. image:: https://cdk-mate.readthedocs.io/en/latest/_static/cdk_mate-logo.png
    :target: https://cdk-mate.readthedocs.io/en/latest/

CDK Mate is a comprehensive toolkit for managing AWS CDK deployments across multiple stacks and environments with minimal boilerplate code. It provides a flexible framework for organizing CDK stacks with clear separation between stack definition and deployment concerns. Key features include a powerful stack context management system for handling different environments (dev, test, prod), Python wrappers around CDK CLI commands for automated deployments, utilities for credential management, and best practices for multi-stack project organization. The library simplifies complex infrastructure deployments by enabling consistent configuration across environments while supporting both individual stack development and full environment deployments. CDK Mate helps development teams scale their infrastructure as code implementations while maintaining clean, testable, and maintainable code architecture.


.. _install:

Install
------------------------------------------------------------------------------

``cdk_mate`` is released on PyPI, so all you need is to:

.. code-block:: console

    $ pip install cdk-mate

To upgrade to latest version:

.. code-block:: console

    $ pip install --upgrade cdk-mate

