Function of finding dict by keys in list added
Project description
The most useful package for you, young s7_it programer :)
How to use it
logging
# Import necessary functions
from divinegift.logger import log_info, log_err, log_warning, set_loglevel
# info msg
log_info('Your message')
# error msg
log_err('Error msg',
src='Error source', # e.g. str(sys.argv[0])
mode=['telegram', 'email'] # May be empty
channel={ "telegram": -1001343660695, "email_to": ["youremail@s7.ru"]}) # You can add "email_cc" for add copy_to address
# error msg with out sending problem to external system
log_err('Error msg', src='Error src')
Pass log_level and log_name through cmd arguments
To specify log_level and log_name to your app you can send it through arguments:
if __name__ == '__main__':
# Get all args from cmd:
args = get_args()
# Get log_level, log_name, log_dir
lp = get_log_param(args)
# Set log_level and log_name:
set_loglevel(lp.get('log_level'), lp.get('log_name'), lp.get('log_dir'))
You should pass your args by pairs: key value, e.g. --log_level INFO Available variants for logging are:
- --log_level or shortcut is -ll
- --log_name or shortcut is -ln
- --log_dir or shortcut is -ld
log_level could be DEBUG, INFO, WARNING, ERROR
Example of start apps with arguments:
python test.py -ll INFO -ln test.log
Config parsing (json)
from divinegift.main import Settings # Necessary imports
settings = {}
# You should use divinegift.logger.set_loglevel before config parsing
s = Settings()
s.parse_settings('./settings.conf')
settings = s.get_settings()
Config example
{
"log_level": "INFO",
"log_name": "YourAwesomeProject.log",
"monitoring": [
"telegram",
"email"
],
"monitoring_channel": {
"telegram": -1001343660695,
"email_to": [
"aims.control@s7.ru"
]
}
}
Working with DB (sqlalchemy)
You should define dict with db_conn creditional. For example:
Oracle
Install oracle driver:
pip install cx_oracle
db_conn = {
"db_user": "dbuser", # username
"db_pass": "dbpass", # password
"db_host": "dbhost", # host (ip, fqdn). could be empty if we connect via tns
"db_port": "", # port (string). could be empty if we connect via tns
"db_name": "dbname", # database name
"db_schm": "", # db scheme if not equal username
"dialect": "oracle" # if use cx_Oracle or oracle+another_dialect
}
MSSQL
Install mssql driver:
pip install sqlalchemy-pytds
db_conn = {
"db_user": "dbuser", # username
"db_pass": "dbpass", # password
"db_host": "", # host (ip, fqdn). could be empty if we connect via tns
"db_port": "", # port (string). could be empty if we connect via tns
"db_name": "dbname", # database name
"db_schm": "", # db scheme if not equal username
"dialect": "mssql+pytds" # mssql dialect
}
Postgres
Install postgres driver:
pip install psycopg2
db_conn = {
"db_user": "dbuser", # username
"db_pass": "dbpass", # password
"db_host": "", # host (ip, fqdn). could be empty if we connect via tns
"db_port": "", # port (string). could be empty if we connect via tns
"db_name": "dbname", # database name
"db_schm": "", # db scheme if not equal username
"dialect": "postgresql+psycopg2" # dialect
}
Create connect
For create connect you should use function divinegift.smain.get_conn.
from divinegift.db import get_conn, close_conn
engine, conn, metadata = get_conn(db_conn) # db_conn - variable which was described above
If you need to call stored procedure with db cursors you should use raw connection.
from divinegift.db import get_raw_conn
conn = get_raw_conn(db_conn) # db_conn - variable which was described above
Get data from sript (file or just string)
When you got "conn" variable you can get data from file or from str variable directly.
result = get_data('path/to/scripts/some_script.sql', db_conn)
# or you can use str variable:
script = 'select * from dual'
result = get_data(script, db_conn)
print(result)
>>>[{'dummy': 'X'}]
You can use specific encoding for your files (by default it's 'cp1251'). Just put it into args:
result = get_data('path/to/scripts/some_script.sql', db_conn, encoding='utf8')
Also you can add some variables into your script (e.g. date) and then you can pass it into function:
script = """select * from dual
where dummy = '$param'"""
parameters = {'param': 'X'}
result = get_data(script, db_conn, **parameters)
# Or another variant
result = get_data(script, db_conn, param='X')
print(result)
>>>[{'dummy': 'X'}]
Run script without getting data
You can run script without recieving data. You should use divinegift.db.run_script for this like get_data, e.g.:
run_script('path/to/scripts/some_script.sql', db_conn)
Sending email
You can use function divinegift.sender.send_email
You should set your msg, subject and list of recipients. Simple example:
from divinegift.sender import send_email
send_email('Test message', 'Test subject', TO=['your@domain.com'])
You can specify TO, CC, BCC, HOST, FROM and attachments. Also you can send it like html-message or like text.
You should pass list of attachments files with absolute path to it. You can use function divinegift.main.get_list_files for get it. For sending email with attahment(s):
from divinegift.main import get_list_files
from divinegift.sender import send_email
attachment_list = get_list_files('/path/to/files', add_path=True)
send_email('Hello! This are files in attach', 'Test sending attachments', ['your@domain.com'], attachments=attachment_list)
# Also you can send only one file:
attachment = '/path/to/file/file_name'
send_email('Hello! There is file in attach', 'File', ['your@domain.com'], attachments=attachment)
If you set IS_HTML to False (by default it is True), you could send an email like simple text message, not html
Work with JSON
You can simple parse and create JSONs
To create json you should use divinegift.main.create_json To parse it you shoul use divinegift.main.parse_json
For example:
from divinegift.main import create_json, parse_json
A = {'key1': 'data1', 'key2': 'data2'}
create_json('json_file_name.json', A)
B = parse_json('json_file_name.json')
print(B)
>>> {'key1': 'data1', 'key2': 'data2'}
Transliterate strings between Russian and English and back
From version 1.0.8 you can use transliterate library to transliterate strings between languages
Example:
from divinegift.translit import translit
name = 'SHEVCHENKO ANDREY'
name_r = translit(name, 'ru_ext')
name_e = translit(name_r, 'ru_ext', reversed=True)
name_r_cap = translit(name, 'ru_ext').capitalize()
name_r_low = translit(name, 'ru_ext').lower()
print(f'From English to Russian: {name}\t->\t{name_r}')
print(f'From Russian to English: {name_r}\t->\t{name_e}')
print(f'Capitalize : {name}\t->\t{name_r_cap}')
print(f'Lower : {name}\t->\t{name_r_low}')
Code from above will show next:
From English to Russian: SHEVCHENKO ANDREY -> ШЕВЧЕНКО АНДРЕЙ
From Russian to English: ШЕВЧЕНКО АНДРЕЙ -> SHEVCHENKO ANDREI
Capitalize : SHEVCHENKO ANDREY -> Шевченко андрей
Lower : SHEVCHENKO ANDREY -> шевченко андрей
Encryption
From version 1.0.10 you can use encryption module
Simple example
Example:
from divinegift.cipher import get_key, get_cipher, encrypt_str, decrypt_str
cipher_key = get_key()
cipher = get_cipher(cipher_key)
text = 'qwerty1234!!'
text_enc = encrypt_str(text, cipher)
print(text_enc)
text_dec = decrypt_str(text_enc, cipher)
print(text_dec)
Code above will output next:
gAAAAABcanXfhUr9i__R_24rPyrHzZoMgQSTYiBmx9ZtVqdcMiGZPOxoSz4gkAW0Y9TDWpAJ6jzAjPo-mrK_IcJcdByyfWrbhQ==
qwerty1234!!
If you use parameter get_str=False in functions encrypt_str and decrypt_str than this functions will returns binary string
Works with key in file
Save your key in file by write_key function:
from divinegift.cipher import get_key, write_key
cipher_key = get_key()
write_key('key.ck', cipher_key)
Read your key file by read_key function:
from divinegift.cipher import read_key
cipher_key = read_key('key.ck')
Caesar
You can use caesar encrypt/decrypt:
from divinegift.cipher import caesar_code
text = caesar_code('Hello, World!', shift=5)
print(text)
It will output next:
Mjqqt, 1twqi!
Easy encription/decryption database-passwords for more security
Before all you should encrypt your file with settings. Use next code to do this once:
from divinegift.main import Settings
s = Settings()
s.parse_settings('settings.conf')
s.initialize_cipher()
s.encrypt_password('db_conn') # db_conn - name of db connection in settings.conf which contains "db_pass"
s.save_settings('settings.conf')
After that your password in section 'db_conn' will automaticaly encrypted. If you have more db-connections just add s.encrypt_password('db_conn_name_you_have') before saving fucntion
Next you must use decruption function in your code to use connection:
from divinegift.main import Settings
s = Settings()
s.parse_settings('settings.conf')
s.decrypt_password('db_conn') # db_conn - name of db connection in settings.conf which contains "db_pass"
Live templates. Start create your app as easy as possible
From version 1.0.11 you can create files from templates. You should use module templator for this.
Example: Create tmp.py with following text and run it:
from divinegift.templator import create_config, create_console, create_gui, add_email_config
# create console app, or main logic (you can omit the file extension, '.py' will add automaticaly.):
create_console('your_awesome_name.py')
# or
create_console() # it will create 'main.py' file
# create QT-app:
create_gui(your_awesome_name.py')
# or
create_console() # it will create 'main_gui.py' file
# create config file:
create_config('your_config_name.conf')
# or
create_config() # it will create 'settings.conf' file
# After creating file with config you can add email section on it:
add_email_config('your_config_name.conf')
# or
add_email_config() # it will add email section to 'settings.conf'
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file divinegift-1.2.3.4.tar.gz
.
File metadata
- Download URL: divinegift-1.2.3.4.tar.gz
- Upload date:
- Size: 27.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.30.0 CPython/3.7.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1497230b797d77fa323b1e81b2fb3af96c0ef80a60f7edf0668274b07295f484 |
|
MD5 | b597ca005aa176c0de9b62f3ae463585 |
|
BLAKE2b-256 | 45628bbb0605775865f6e4c55eba76646fe1037f8396b4434debefb4de604e2e |
File details
Details for the file divinegift-1.2.3.4-py3-none-any.whl
.
File metadata
- Download URL: divinegift-1.2.3.4-py3-none-any.whl
- Upload date:
- Size: 24.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.30.0 CPython/3.7.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45cc94c9d440fdac9e3768856b76e45914d5f7009bb30cc1eef216a99c07bd32 |
|
MD5 | 9cdb5b0d37d8161b327f20f885a5414a |
|
BLAKE2b-256 | 9e509bce8b1fe43cdc0fcb2a6860b1da66624615c6142edd07007924e473955b |