# pyawsopstoolkit
Welcome to pyawsopstoolkit! This Python package is your all-in-one solution for managing Amazon Web Services (AWS)
operations efficiently. Whether you're a seasoned AWS user or just getting started, this toolkit offers a comprehensive
set of features and enhancements to streamline your AWS interactions.
## Features
- **Session Management**: Seamlessly integrate session management classes into your application ecosystem, empowering
refined control over workflow dynamics.
- **Assume Role Function**: Access a versatile function for assuming roles, augmenting security and flexibility within
your AWS operations.
- **Subpackages**:
- **Validator Functions**: Validate AWS ARNs, IAM policy formats, and more with ease, ensuring the correctness of
crucial parameters.
- **Advance Search**: Harness advanced search capabilities to efficiently navigate and filter AWS resources,
streamlining resource discovery and management.
- **Security Risks/Vulnerabilities**: Safeguard your AWS infrastructure by proactively identifying and addressing
security threats and vulnerabilities. Leverage dedicated tools to detect misconfigurations, insecure permissions,
and
potential entry points for cyberattacks. Stay vigilant with continuous monitoring and auditing to maintain a
robust
security posture and mitigate risks effectively.
- **Insights**: Gain comprehensive insights into various aspects of your AWS infrastructure to maintain optimal
hygiene
and clean up unused or obsolete resources.
## What's Next?
Stay tuned as we continue to evolve this toolkit! We're constantly working on adding new features and enhancements to
make your AWS-related workflows even more efficient and productive. Watch this space for updates and upcoming additions.
## Getting Started
Ready to supercharge your AWS operations? Let's get started with **pyawsopstoolkit**!
### Installation
Install **pyawsopstoolkit** via pip:
```bash
pip install pyawsopstookit
```
### Usage
Import the package in your Python script:
```python
import pyawsopstoolkit
```
Now you're all set to harness the power of **pyawsopstoolkit** in your AWS workflows!
# Documentation
## pyawsopstoolkit
### Credentials
The **Credentials** class represents a set of AWS credentials, including an access key, secret access key, token, and
optional expiry datetime.
#### Constructors
- `Credentials(access_key: str, secret_access_key: str, token: str, expiry: Optional[datetime] = None) -> None`:
Initializes a **Credentials** object with the provided access key, secret access key, token, and expiry datetime if
available.
#### Methods
- `to_dict() -> dict`: Returns a dictionary representation of the **Credentials** object.
#### Usage
```python
from pyawsopstoolkit.credentials import Credentials
# Create a Credentials object
creds = Credentials(access_key='access_key', secret_access_key='secret_access_key', token='token')
# Access individual attributes
print(creds.access_key) # Output: access_key
print(creds.secret_access_key) # Output: secret_access_key
print(creds.token) # Output: token
# Print the Credentials object
print(creds)
# Output: Credentials(access_key="access_key",secret_access_key="secret_access_key",token="token",expiry=None)
# Convert Credentials object to dictionary
print(creds.to_dict())
# Output:
# {
# "access_key": "access_key",
# "secret_access_key": "secret_access_key",
# "token": "token",
# "expiry": None
# }
```
### Account
The **Account** class represents an AWS account with various attributes. This class provides basic functionality for
managing an AWS account.
#### Constructors
- `Account(number: str) -> None`: Initializes an **Account** object with the provided account number.
#### Methods
- `to_dict() -> dict`: Returns a dictionary representation of the **Account** object.
#### Usage
```python
from pyawsopstoolkit.account import Account
# Create an Account object
account = Account('123456789012')
# Access the account number attribute
print(account.number) # Output: 123456789012
```
### Session
The **Session** class represents a boto3 Session with various attributes, offering functionality to manage sessions.
Additionally, it provides the option to assume a session.
#### Constructors
- `Session(profile_name: Optional[str] = None, credentials: Optional[ICredentials] = None, region_code: Optional[str] = 'eu-west-1', cert_path: Optional[str] = None) -> None`:
Initializes a **Session** object for AWS with optional parameters for profile name, credentials, and region code.
#### Methods
- `get_session() -> boto3.Session`: Returns the **boto3.Session** object based on the specified parameters within
the class object. This method prioritizes the profile name, followed by credentials. It verifies the session validity
by performing a quick S3 list buckets action.
- `get_config() -> botocore.config.Config`: Returns the **botocore.config.Config** based on the specified region
code within the class object.
- `get_account() -> IAccount`: Returns the AWS account number based on the **get_session** with specified parameters
within the class object.
- `get_credentials_for_profile() -> ICredentials`: Returns the AWS credentials (access key, secret access key, and
token) based on the **get_session** with specified parameters within the class object.
- `assume_role(role_arn: str, role_session_name: Optional[str] = 'AssumeSession', policy_arns: Optional[list] = None, policy: Optional[Union[str, dict]] = None, duration_seconds: Optional[int] = 3600, tags: Optional[list] = None) -> ISession`:
Returns the **ISession** object for the assumed role based on the specified parameters.
#### Usage
```python
from pyawsopstoolkit.session import Session
# Initialize a Session object with a profile name
profile_name = 'default'
session = Session(profile_name=profile_name)
# Get boto3 Session
boto3_session = session.get_session()
print(boto3_session) # Output: Session(region_name='eu-west-1')
# Get AWS account number
account = session.get_account()
print(account.number) # Output: 123456789012
# Get botocore config
config = session.get_config()
print(config) # Output: <botocore.config.Config object at 0x0000022097630040>
# Get credentials for profile
creds = session.get_credentials_for_profile()
print(
creds) # Output: Credentials(access_key="access_key",secret_access_key="secret_access_key",token=None,expiry=None)
```
## pyawsopstoolkit_validators
For detailed information and usage examples, please refer
to [pyawsopstoolkit_validators](https://github.com/coldsofttech/pyawsopstoolkit-validators)
# License
Please refer to the [MIT License](LICENSE) within the project for more information.
# Contributing
We welcome contributions from the community! Whether you have ideas for new features, bug fixes, or enhancements, feel
free to open an issue or submit a pull request on [GitHub](https://github.com/coldsofttech/pyawsopstoolkit).
Raw data
{
"_id": null,
"home_page": "https://github.com/coldsofttech/pyawsopstoolkit.git",
"name": "pyawsopstoolkit",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "aws, toolkit, operations, tools, development, python, session-management, utilities, enhancements, integration, amazon-web-services",
"author": "coldsofttech",
"author_email": null,
"download_url": null,
"platform": null,
"description": "# pyawsopstoolkit\n\nWelcome to pyawsopstoolkit! This Python package is your all-in-one solution for managing Amazon Web Services (AWS)\noperations efficiently. Whether you're a seasoned AWS user or just getting started, this toolkit offers a comprehensive\nset of features and enhancements to streamline your AWS interactions.\n\n## Features\n\n- **Session Management**: Seamlessly integrate session management classes into your application ecosystem, empowering\n refined control over workflow dynamics.\n- **Assume Role Function**: Access a versatile function for assuming roles, augmenting security and flexibility within\n your AWS operations.\n- **Subpackages**:\n - **Validator Functions**: Validate AWS ARNs, IAM policy formats, and more with ease, ensuring the correctness of\n crucial parameters.\n - **Advance Search**: Harness advanced search capabilities to efficiently navigate and filter AWS resources,\n streamlining resource discovery and management.\n - **Security Risks/Vulnerabilities**: Safeguard your AWS infrastructure by proactively identifying and addressing\n security threats and vulnerabilities. Leverage dedicated tools to detect misconfigurations, insecure permissions,\n and\n potential entry points for cyberattacks. Stay vigilant with continuous monitoring and auditing to maintain a\n robust\n security posture and mitigate risks effectively.\n - **Insights**: Gain comprehensive insights into various aspects of your AWS infrastructure to maintain optimal\n hygiene\n and clean up unused or obsolete resources.\n\n## What's Next?\n\nStay tuned as we continue to evolve this toolkit! We're constantly working on adding new features and enhancements to\nmake your AWS-related workflows even more efficient and productive. Watch this space for updates and upcoming additions.\n\n## Getting Started\n\nReady to supercharge your AWS operations? Let's get started with **pyawsopstoolkit**!\n\n### Installation\n\nInstall **pyawsopstoolkit** via pip:\n\n```bash\npip install pyawsopstookit\n```\n\n### Usage\n\nImport the package in your Python script:\n\n```python\nimport pyawsopstoolkit\n```\n\nNow you're all set to harness the power of **pyawsopstoolkit** in your AWS workflows!\n\n# Documentation\n\n## pyawsopstoolkit\n\n### Credentials\n\nThe **Credentials** class represents a set of AWS credentials, including an access key, secret access key, token, and\noptional expiry datetime.\n\n#### Constructors\n\n- `Credentials(access_key: str, secret_access_key: str, token: str, expiry: Optional[datetime] = None) -> None`:\n Initializes a **Credentials** object with the provided access key, secret access key, token, and expiry datetime if\n available.\n\n#### Methods\n\n- `to_dict() -> dict`: Returns a dictionary representation of the **Credentials** object.\n\n#### Usage\n\n```python\nfrom pyawsopstoolkit.credentials import Credentials\n\n# Create a Credentials object\ncreds = Credentials(access_key='access_key', secret_access_key='secret_access_key', token='token')\n\n# Access individual attributes\nprint(creds.access_key) # Output: access_key\nprint(creds.secret_access_key) # Output: secret_access_key\nprint(creds.token) # Output: token\n\n# Print the Credentials object\nprint(creds)\n# Output: Credentials(access_key=\"access_key\",secret_access_key=\"secret_access_key\",token=\"token\",expiry=None)\n\n# Convert Credentials object to dictionary\nprint(creds.to_dict())\n# Output:\n# {\n# \"access_key\": \"access_key\",\n# \"secret_access_key\": \"secret_access_key\",\n# \"token\": \"token\",\n# \"expiry\": None\n# }\n```\n\n### Account\n\nThe **Account** class represents an AWS account with various attributes. This class provides basic functionality for\nmanaging an AWS account.\n\n#### Constructors\n\n- `Account(number: str) -> None`: Initializes an **Account** object with the provided account number.\n\n#### Methods\n\n- `to_dict() -> dict`: Returns a dictionary representation of the **Account** object.\n\n#### Usage\n\n```python\nfrom pyawsopstoolkit.account import Account\n\n# Create an Account object\naccount = Account('123456789012')\n\n# Access the account number attribute\nprint(account.number) # Output: 123456789012\n```\n\n### Session\n\nThe **Session** class represents a boto3 Session with various attributes, offering functionality to manage sessions.\nAdditionally, it provides the option to assume a session.\n\n#### Constructors\n\n- `Session(profile_name: Optional[str] = None, credentials: Optional[ICredentials] = None, region_code: Optional[str] = 'eu-west-1', cert_path: Optional[str] = None) -> None`:\n Initializes a **Session** object for AWS with optional parameters for profile name, credentials, and region code.\n\n#### Methods\n\n- `get_session() -> boto3.Session`: Returns the **boto3.Session** object based on the specified parameters within\n the class object. This method prioritizes the profile name, followed by credentials. It verifies the session validity\n by performing a quick S3 list buckets action.\n- `get_config() -> botocore.config.Config`: Returns the **botocore.config.Config** based on the specified region\n code within the class object.\n- `get_account() -> IAccount`: Returns the AWS account number based on the **get_session** with specified parameters\n within the class object.\n- `get_credentials_for_profile() -> ICredentials`: Returns the AWS credentials (access key, secret access key, and\n token) based on the **get_session** with specified parameters within the class object.\n- `assume_role(role_arn: str, role_session_name: Optional[str] = 'AssumeSession', policy_arns: Optional[list] = None, policy: Optional[Union[str, dict]] = None, duration_seconds: Optional[int] = 3600, tags: Optional[list] = None) -> ISession`:\n Returns the **ISession** object for the assumed role based on the specified parameters.\n\n#### Usage\n\n```python\nfrom pyawsopstoolkit.session import Session\n\n# Initialize a Session object with a profile name\nprofile_name = 'default'\nsession = Session(profile_name=profile_name)\n\n# Get boto3 Session\nboto3_session = session.get_session()\nprint(boto3_session) # Output: Session(region_name='eu-west-1')\n\n# Get AWS account number\naccount = session.get_account()\nprint(account.number) # Output: 123456789012\n\n# Get botocore config\nconfig = session.get_config()\nprint(config) # Output: <botocore.config.Config object at 0x0000022097630040>\n\n# Get credentials for profile\ncreds = session.get_credentials_for_profile()\nprint(\n creds) # Output: Credentials(access_key=\"access_key\",secret_access_key=\"secret_access_key\",token=None,expiry=None)\n```\n\n## pyawsopstoolkit_validators\n\nFor detailed information and usage examples, please refer\nto [pyawsopstoolkit_validators](https://github.com/coldsofttech/pyawsopstoolkit-validators)\n\n# License\n\nPlease refer to the [MIT License](LICENSE) within the project for more information.\n\n# Contributing\n\nWe welcome contributions from the community! Whether you have ideas for new features, bug fixes, or enhancements, feel\nfree to open an issue or submit a pull request on [GitHub](https://github.com/coldsofttech/pyawsopstoolkit).\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This extensive package, AWS Ops Toolkit, offers a wide range of features and enhancements designed to streamline and",
"version": "0.1.19",
"project_urls": {
"Homepage": "https://github.com/coldsofttech/pyawsopstoolkit.git"
},
"split_keywords": [
"aws",
" toolkit",
" operations",
" tools",
" development",
" python",
" session-management",
" utilities",
" enhancements",
" integration",
" amazon-web-services"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f4f720cec82b19d6ccfef795cabddc9991b5850d1999fab2cba9f31bea7d28e2",
"md5": "7c05ba4fc495871fb6e2ca36178b71b1",
"sha256": "07993adddb3eb6399b4ec1f49c21e0f1f27971e414a6925c7f26d16c24fa77c2"
},
"downloads": -1,
"filename": "pyawsopstoolkit-0.1.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7c05ba4fc495871fb6e2ca36178b71b1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 10164,
"upload_time": "2024-08-10T21:21:34",
"upload_time_iso_8601": "2024-08-10T21:21:34.681437Z",
"url": "https://files.pythonhosted.org/packages/f4/f7/20cec82b19d6ccfef795cabddc9991b5850d1999fab2cba9f31bea7d28e2/pyawsopstoolkit-0.1.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-10 21:21:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "coldsofttech",
"github_project": "pyawsopstoolkit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pyawsopstoolkit_validators",
"specs": [
[
"==",
"0.1.0"
]
]
},
{
"name": "boto3",
"specs": [
[
"==",
"1.34.158"
]
]
},
{
"name": "botocore",
"specs": [
[
"==",
"1.34.158"
]
]
}
],
"lcname": "pyawsopstoolkit"
}
JSON
