معرفی شرکت ها
awstanding-1.2.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Load parameters from AWS Parameter Store
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | awstanding-1.2.0 |
| نام | awstanding |
| نسخه کتابخانه | 1.2.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Juan Ignacio Sánchez Sampayo |
| ایمیل نویسنده | jiss2891@gmail.com |
| آدرس صفحه اصلی | https://github.com/jiss2891/awstanding |
| آدرس اینترنتی | https://pypi.org/project/awstanding/ |
| مجوز | - |
# AWStanding
Easily load variables from AWS Parameter store into environment variables.
# Why to use AWStanding?
Despite it's built on top of Boto3, it has the following key features that eases the development process:
* Simpler API
* Error Handling
* Pagination handling when needed (Saves you a buch of boilerplate)
* Dynamic Parameters (variables that listen to updates on AWS)
* S3 Integration made easy with Download/Upload methods
# Installation
```shell script
pip install awstanding
```
I personally recommend using pipenv:
```shell script
pipenv install awstanding
```
# Quickstart
```python
from awstanding.parameter_store import load_parameters
load_parameters({'/some/path/to/something/stored': 'IMPORTANT_SETTING'})
import os
print(os.environ.get('IMPORTANT_SETTING'))
'super-important-value'
```
# Using with python-decouple
```python
import os
from awstanding.parameter_store import load_parameters
from decouple import config
load_parameters({'/some/path/to/something/stored': 'IMPORTANT_SETTING'})
IMPORTANT_SETTING = config('IMPORTANT_SETTING', default='some-default')
print(IMPORTANT_SETTING)
'super-important-value'
```
# Not allowing missing parameters
```python
from awstanding.parameter_store import load_parameters
# A call like this one:
load_parameters({'/not/defined/parameter': 'IMPORTANT_SETTING'}, allow_invalid=False)
# will raise a ParameterNotFoundException, and you can handle it as follows:
from awstanding.exceptions import ParameterNotFoundException
try:
load_parameters({'/not/defined/parameter': 'IMPORTANT_SETTING'}, allow_invalid=False)
except ParameterNotFoundException as e:
# perform any cleanup action..
```
# Performance
| Amount of parameters | Missing parameters | AWStanding | SSM client calls |
| --- | --- | --- | ---|
| 40 | 0 | ~3.1s| ~15.5s |
| 40 | 0 | ~2.4s| ~15.3s |
| 40 | 0 | ~4.6s| ~14.5s |
| 40 | 0 | ~2.5s| ~15.5s |
| 40 | 1 | ~2.1s| error: ParameterNotFound |
| 40 | 20 | ~2.2s| error: ParameterNotFound |
| 40 | 40 | ~2.1s| error: ParameterNotFound |
| 80 | 40 | ~3.5s| error: ParameterNotFound |
| 80 | 40 | ~3.9s| (using try..except) ~32.7s |
# Loading paths
Suppose you have defined these variables in ParameterStore:
```python
'/stripe/price/'
'/stripe/webhook/' # (Let's not define this one just for demonstration)
```
You can leverage on the good naming and perform a path variable loading as follows:
```python
import os
from awstanding.parameter_store import load_path
load_path('/stripe', '/spotify')
STRIPE_PRICE = os.environ.get('STRIPE_PRICE', 'fallback_value')
STRIPE_WEBHOOK = os.environ.get('STRIPE_WEBHOOK', 'fallback_value')
SPOTIFY_API_KEY = os.environ.get('SPOTIFY_API_KEY', 'fallback_value')
print(f'price: {STRIPE_PRICE}, webhook: {STRIPE_WEBHOOK}, spotify: {SPOTIFY_API_KEY}')
>>> price: price_1xxxxxxxxxxxxxxxxxxxxxxx, webhook: fallback_value, spotify: fallback_value
```
# Dynamic Parameters
You can define dynamic parameters that uploads themselves each time they are used, so you can update
any parameter without re-deploy your service.
```python
from awstanding.parameter_store import DynamicParameter
IMPORTANT_SETTING = DynamicParameter('/test/parameter')
print(IMPORTANT_SETTING)
>>> OriginalValue
# Someone updates /test/parameter on AWS...
print(IMPORTANT_SETTING)
>>> NewValue
```
## Supported operations
Some useful operations are supported by the class itself, emulating built-in str class:
```python
from awstanding.parameter_store import DynamicParameter
IMPORTANT_SETTING = DynamicParameter('/test/parameter')
# Equality comparison
equal = IMPORTANT_SETTING == 'SomeString'
# Length
length = len(IMPORTANT_SETTING)
# Concatenation (Right and Left)
concat = '~' + IMPORTANT_SETTING + '~'
# You can always convert the parameter to string to get full string capabilities:
str_IMPORTANT_SETTING = str(IMPORTANT_SETTING) # Have in mind this will "freeze" the value, so don't overwrite IMPORTANT_SETTING
```
# S3 Integration
## Download files from S3
```python
from awstanding.s3 import Bucket
bucket = Bucket('BUCKET_NAME_HERE')
bucket.download("path/to/file.ext", './some/local/file.ext')
```
## Upload files to S3
```python
from awstanding.s3 import Bucket
bucket = Bucket('BUCKET_NAME_HERE')
bucket.upload('/some/local/file.ext', "some/s3/logical/path.ext")
```
There's not file type restriction any other that the set by AWS/boto3 itself.
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl awstanding-1.2.0:
pip install awstanding-1.2.0.whl
نصب پکیج tar.gz awstanding-1.2.0:
pip install awstanding-1.2.0.tar.gz