iamdata

Name	iamdata JSON
Version	0.1.202412261 JSON
	download
home_page	None
Summary	IAM data for AWS actions, resources, and conditions based on IAM policy documents. Checked for updates daily.
upload_time	2024-12-26 04:44:25
maintainer	None
docs_url	None
author	None
requires_python	>=3.7
license	None
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # IAM Data In Python Package

This is a simple package for utilizing AWS IAM data for Services, Actions, Resources, and Condition Keys. Data is embedded in the python package.

New data is checked against the AWS IAM documentation and updated daily if there are changes.

## Installation
```bash
pip install iam-data
```

## Usage
```python
from iamdata import IAMData

iam_data = IAMData()
print(f"Data Version {iam_data.data_version()} updated at {iam_data.data_updated_at()}")
for service_key in iam_data.services.get_service_keys():
    service_name = iam_data.services.get_service_name(service_key)
    print(f"Getting Actions for {service_name}")
    for action in iam_data.actions.get_actions_for_service(service_key):
        action_details = iam_data.actions.get_action_details(service_key, action)
        print(f"{service_key}:{action} => {action_details}")
```

## API
### Services
* `services.get_service_keys()` - Returns a list of all service keys such as 's3', 'ec2', etc.
* `services.get_service_name(service_key)` - Returns the service name for a given service key.
* `services.service_exists(service_key)` - Returns True if the service key exists.

### Actions
* `actions.get_actions_for_service(service_key)` - Returns an array of all actions for a given service key.
* `actions.get_action_details(service_key, action_key)` - Returns an object with the action details such as `description`, `resourceTypes`, and `conditionKeys`.
* `actions.action_exists(service_key, action_key)` - Returns true if the action exists.

### Resources
* `resources.get_resource_types_for_service(service_key)` - Returns an array of all resource types for a given service key.
* `resources.get_resource_type_details(service_key, resource_type_key)` - Returns an object with the resource type details such as `description`, `arnFormat`, and `conditionKeys`.
* `resources.resource_type_exists(service_key, resource_type_key)` - Returns true if the resource type exists.

### Conditions Keys
* `conditions.get_condition_keys_for_service(service_key)` - Returns an array of all condition keys for a given service key.
* `conditions.get_condition_key_details(service_key, condition_key)` - Returns an object with the condition key details such as `description`, `conditionValueTypes`, and `conditionOperators`.
* `conditions.condition_key_exists(service_key, condition_key)` - Returns true if the condition key exists.

### Version Info
The version is number is formatted as `major.minor.updatedAt`. The updatedAt is the date the data was last updated in the format `YYYYMMDDX` where `X` is a counter to enable publishing more than once per day if necessary. For example version `0.1.202408291` has data updated on August 29th, 2024.

The version can be accessed using the `data_version()` method.

There is also `date_updated_at()` which returns the date the data was last updated.


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "iamdata",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "David Kerber <dave@cloudcopilot.io>",
    "download_url": "https://files.pythonhosted.org/packages/b4/3b/038eb79260369a4532a38e60c33ca0de0f28e820b9e7a89d6f1519ab28ac/iamdata-0.1.202412261.tar.gz",
    "platform": null,
    "description": "# IAM Data In Python Package\n\nThis is a simple package for utilizing AWS IAM data for Services, Actions, Resources, and Condition Keys. Data is embedded in the python package.\n\nNew data is checked against the AWS IAM documentation and updated daily if there are changes.\n\n## Installation\n```bash\npip install iam-data\n```\n\n## Usage\n```python\nfrom iamdata import IAMData\n\niam_data = IAMData()\nprint(f\"Data Version {iam_data.data_version()} updated at {iam_data.data_updated_at()}\")\nfor service_key in iam_data.services.get_service_keys():\n    service_name = iam_data.services.get_service_name(service_key)\n    print(f\"Getting Actions for {service_name}\")\n    for action in iam_data.actions.get_actions_for_service(service_key):\n        action_details = iam_data.actions.get_action_details(service_key, action)\n        print(f\"{service_key}:{action} => {action_details}\")\n```\n\n## API\n### Services\n* `services.get_service_keys()` - Returns a list of all service keys such as 's3', 'ec2', etc.\n* `services.get_service_name(service_key)` - Returns the service name for a given service key.\n* `services.service_exists(service_key)` - Returns True if the service key exists.\n\n### Actions\n* `actions.get_actions_for_service(service_key)` - Returns an array of all actions for a given service key.\n* `actions.get_action_details(service_key, action_key)` - Returns an object with the action details such as `description`, `resourceTypes`, and `conditionKeys`.\n* `actions.action_exists(service_key, action_key)` - Returns true if the action exists.\n\n### Resources\n* `resources.get_resource_types_for_service(service_key)` - Returns an array of all resource types for a given service key.\n* `resources.get_resource_type_details(service_key, resource_type_key)` - Returns an object with the resource type details such as `description`, `arnFormat`, and `conditionKeys`.\n* `resources.resource_type_exists(service_key, resource_type_key)` - Returns true if the resource type exists.\n\n### Conditions Keys\n* `conditions.get_condition_keys_for_service(service_key)` - Returns an array of all condition keys for a given service key.\n* `conditions.get_condition_key_details(service_key, condition_key)` - Returns an object with the condition key details such as `description`, `conditionValueTypes`, and `conditionOperators`.\n* `conditions.condition_key_exists(service_key, condition_key)` - Returns true if the condition key exists.\n\n### Version Info\nThe version is number is formatted as `major.minor.updatedAt`. The updatedAt is the date the data was last updated in the format `YYYYMMDDX` where `X` is a counter to enable publishing more than once per day if necessary. For example version `0.1.202408291` has data updated on August 29th, 2024.\n\nThe version can be accessed using the `data_version()` method.\n\nThere is also `date_updated_at()` which returns the date the data was last updated.\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "IAM data for AWS actions, resources, and conditions based on IAM policy documents. Checked for updates daily.",
    "version": "0.1.202412261",
    "project_urls": {
        "Homepage": "https://github.com/cloud-copilot/iam-data-python",
        "Issues": "https://github.com/cloud-copilot/iam-data-python/issues"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "10aaed7279a4083745004d9061e155ca0b4204ea2c647ad5ac880e2bf1fe2a25",
                "md5": "5039bf18a098e36da3d1ea48dca2de96",
                "sha256": "dd0ddb25a32b646183b23d6e8eb65e4b36ffe4aa014d9654f4bbbbdf2f0912d8"
            },
            "downloads": -1,
            "filename": "iamdata-0.1.202412261-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5039bf18a098e36da3d1ea48dca2de96",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 1114528,
            "upload_time": "2024-12-26T04:44:22",
            "upload_time_iso_8601": "2024-12-26T04:44:22.858574Z",
            "url": "https://files.pythonhosted.org/packages/10/aa/ed7279a4083745004d9061e155ca0b4204ea2c647ad5ac880e2bf1fe2a25/iamdata-0.1.202412261-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b43b038eb79260369a4532a38e60c33ca0de0f28e820b9e7a89d6f1519ab28ac",
                "md5": "84b942ff5fee9cdd3482a06c020c3442",
                "sha256": "fc8125230487b8dd53efbedd8cba69adb66cd9634c2b3d195e3cc65fa48e2f99"
            },
            "downloads": -1,
            "filename": "iamdata-0.1.202412261.tar.gz",
            "has_sig": false,
            "md5_digest": "84b942ff5fee9cdd3482a06c020c3442",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 686209,
            "upload_time": "2024-12-26T04:44:25",
            "upload_time_iso_8601": "2024-12-26T04:44:25.753971Z",
            "url": "https://files.pythonhosted.org/packages/b4/3b/038eb79260369a4532a38e60c33ca0de0f28e820b9e7a89d6f1519ab28ac/iamdata-0.1.202412261.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-26 04:44:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cloud-copilot",
    "github_project": "iam-data-python",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "iamdata"
}