iamdata 0.0.1__tar.gz

iamdata-0.0.1/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cloud Copilot
+
+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.

iamdata-0.0.1/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.3
+Name: iamdata
+Version: 0.0.1
+Summary: IAM data for AWS actions, resources, and conditions based on IAM policy documents. Checked for updates daily.
+Project-URL: Homepage, https://github.com/cloud-copilot/iam-data-python
+Project-URL: Issues, https://github.com/cloud-copilot/iam-data-python/issues
+Author-email: David Kerber <dave@cloudcopilot.io>
+License-File: LICENSE.txt
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# 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.
+

iamdata-0.0.1/README.md

@@ -0,0 +1,53 @@
+# 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.
+

iamdata-0.0.1/example.py

@@ -0,0 +1,25 @@
+# from iamdata import IAMData
+# IAMData().services.get_service_keys()
+
+# IAMData().actions.get_actions_for_service("s3")
+# IAMData().actions.action_exists("s3", "GetObject")
+# IAMData().actions.get_action_details("s3", "GetObject")
+
+# IAMData().conditions.get_condition_keys_for_service("s3")
+# IAMData().conditions.condition_key_exists("s3", "s3:AccessGrantsInstanceArn")
+# IAMData().conditions.get_condition_key_details("s3", "s3:AccessGrantsInstanceArn")
+
+# IAMData().resources.get_resource_types_for_service("s3")
+# IAMData().resources.resource_type_exists("s3", "Bucket")
+# IAMData().resources.get_resource_type_details("s3", "Bucket")
+
+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}")