aws_cfstack


Nameaws_cfstack JSON
Version 2024.1.0.0 PyPI version JSON
download
home_pagehttps://gitlab.com/fer1035_python/modules/pypi-aws_cfstack
SummaryGet AWS CloudFormation stack template and parameters.
upload_time2024-02-02 05:16:18
maintainer
docs_urlNone
authorAhmad Ferdaus Abd Razak
requires_python>=3.6,<4.0
licenseGPL-2.0-only
keywords aws cloudformation stack download backup
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ===============
**aws-cfstack**
===============

Overview
--------

Get AWS CloudFormation stack template and parameters.

Prerequisites
-------------

- *Python >= 3.6*
- *aws-authenticator (https://pypi.org/project/aws-authenticator/) >= 2022.10.1.0*

Required Arguments
------------------

- Output path (to store module artifacts)
- AWS authentication method (profile, iam, or sso)

Conditional Arguments
---------------------

If authenticating with named profiles:

- AWSCLI profile name

If authenticating with IAM acccess key credentials:

- AWS access key id
- AWS secret access key

If authenticating with SSO:

- AWS account ID
- AWS SSO Permission Set (role) name
- AWS SSO login URL

Usage
-----

Installation:

.. code-block:: BASH

   pip3 install aws-cfstack
   # or
   python3 -m pip install aws-cfstack

In Python3 authenticating with named profiles:

.. code-block:: PYTHON

   import aws_cfstack

   aws_cfstack.get_stack(
      '</output/path>',
      'profile',
      profile_name='<profile_name>'
   )

In BASH authenticating with named profiles:

.. code-block:: BASH

   python [/path/to/]aws_cfstack \
   -o </output/path> \
   -m profile \
   -p <profile_name>

Caveat
------

- This module creates files within the specified *output_path*.
- All stack instances whose names start with "**StackSet-**" are filtered out. This module was not intended to work with stack sets, although it can easily be expanded to do so.
- DOS line-endings ("**\r**") are removed from the outputs. Only Unix line-endings ("**\n**") are retained.

            

Raw data

            {
    "_id": null,
    "home_page": "https://gitlab.com/fer1035_python/modules/pypi-aws_cfstack",
    "name": "aws_cfstack",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6,<4.0",
    "maintainer_email": "",
    "keywords": "AWS,CloudFormation,stack,download,backup",
    "author": "Ahmad Ferdaus Abd Razak",
    "author_email": "ahmad.ferdaus.abd.razak@ni.com",
    "download_url": "https://files.pythonhosted.org/packages/82/95/b501f46714027d1d59d964b9be59099ad519b82d77d9eb9dd80b0d6650d6/aws_cfstack-2024.1.0.0.tar.gz",
    "platform": null,
    "description": "===============\n**aws-cfstack**\n===============\n\nOverview\n--------\n\nGet AWS CloudFormation stack template and parameters.\n\nPrerequisites\n-------------\n\n- *Python >= 3.6*\n- *aws-authenticator (https://pypi.org/project/aws-authenticator/) >= 2022.10.1.0*\n\nRequired Arguments\n------------------\n\n- Output path (to store module artifacts)\n- AWS authentication method (profile, iam, or sso)\n\nConditional Arguments\n---------------------\n\nIf authenticating with named profiles:\n\n- AWSCLI profile name\n\nIf authenticating with IAM acccess key credentials:\n\n- AWS access key id\n- AWS secret access key\n\nIf authenticating with SSO:\n\n- AWS account ID\n- AWS SSO Permission Set (role) name\n- AWS SSO login URL\n\nUsage\n-----\n\nInstallation:\n\n.. code-block:: BASH\n\n   pip3 install aws-cfstack\n   # or\n   python3 -m pip install aws-cfstack\n\nIn Python3 authenticating with named profiles:\n\n.. code-block:: PYTHON\n\n   import aws_cfstack\n\n   aws_cfstack.get_stack(\n      '</output/path>',\n      'profile',\n      profile_name='<profile_name>'\n   )\n\nIn BASH authenticating with named profiles:\n\n.. code-block:: BASH\n\n   python [/path/to/]aws_cfstack \\\n   -o </output/path> \\\n   -m profile \\\n   -p <profile_name>\n\nCaveat\n------\n\n- This module creates files within the specified *output_path*.\n- All stack instances whose names start with \"**StackSet-**\" are filtered out. This module was not intended to work with stack sets, although it can easily be expanded to do so.\n- DOS line-endings (\"**\\r**\") are removed from the outputs. Only Unix line-endings (\"**\\n**\") are retained.\n",
    "bugtrack_url": null,
    "license": "GPL-2.0-only",
    "summary": "Get AWS CloudFormation stack template and parameters.",
    "version": "2024.1.0.0",
    "project_urls": {
        "Homepage": "https://gitlab.com/fer1035_python/modules/pypi-aws_cfstack",
        "Repository": "https://gitlab.com/fer1035_python/modules/pypi-aws_cfstack"
    },
    "split_keywords": [
        "aws",
        "cloudformation",
        "stack",
        "download",
        "backup"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1d80b77075fde87c7864f36a881ead0d900475ff4631bfd25679bf2ce4d678ec",
                "md5": "bb9b301b87900325974dcfa1a0581493",
                "sha256": "46b3a7f45ff4c81a5c32d8a6333a599f45cd98e46cd7c2e49c3196d17bc2be1e"
            },
            "downloads": -1,
            "filename": "aws_cfstack-2024.1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bb9b301b87900325974dcfa1a0581493",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6,<4.0",
            "size": 3692,
            "upload_time": "2024-02-02T05:16:17",
            "upload_time_iso_8601": "2024-02-02T05:16:17.047950Z",
            "url": "https://files.pythonhosted.org/packages/1d/80/b77075fde87c7864f36a881ead0d900475ff4631bfd25679bf2ce4d678ec/aws_cfstack-2024.1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8295b501f46714027d1d59d964b9be59099ad519b82d77d9eb9dd80b0d6650d6",
                "md5": "4a029bbfdbf260e0f4acfc593f218070",
                "sha256": "c790305d76389ca7af2b3313a9fc3fe89f180f9d7b0834756dbeebd52487f363"
            },
            "downloads": -1,
            "filename": "aws_cfstack-2024.1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "4a029bbfdbf260e0f4acfc593f218070",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6,<4.0",
            "size": 2972,
            "upload_time": "2024-02-02T05:16:18",
            "upload_time_iso_8601": "2024-02-02T05:16:18.673647Z",
            "url": "https://files.pythonhosted.org/packages/82/95/b501f46714027d1d59d964b9be59099ad519b82d77d9eb9dd80b0d6650d6/aws_cfstack-2024.1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-02 05:16:18",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "fer1035_python",
    "gitlab_project": "modules",
    "lcname": "aws_cfstack"
}
        
Elapsed time: 0.50628s