Metadata-Version: 2.1
Name: spdb
Version: 1.1.0
Summary: Sassy Python Database (and auth) utils
Author-email: Mrybs <mrybs2@gmail.com>
Project-URL: Homepage, https://github.com/mrybs/spdb
Project-URL: Bug Tracker, https://github.com/mrybs/spdb/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# =============================================

# Sassy Python Database(auth and parsing) utils

# =============================================

LICENSE: The MIT License


## Requirements

## ============

- Python 3.7 or higher
- pyotp
- qrcode
- setuptools


## Usage 

## =====

	import spdb

### Database

------------
	spdb.Database(path: str)  # Create Database object
	spdb.Database.create_tables(tables_names: list[str]) -> None  # Create tables if not exists
	spdb.Database.execute(code) -> str  # Execute sqlite3 code
	spdb.Database.read_json(name: str, data_id: str) -> dict  # Read data by ID as dict
	spdb.Database.read_object(Class: class, name: str, data_id: str) -> Class  # Read data by ID as object
	spdb.Database.write_json(name: str, data_id: str, data: dict) -> None  # Write dict by ID
	spdb.Database.write_object(name: str, object_id: str, object: Class) -> None  # Write object by ID
	spdb.Database.delete_dict(name: str, dict_id: str) -> None  # Delete dict by ID
	spdb.Database.delete_json(name: str, json_id: str) -> None  # Delete JSON by ID
	spdb.Database.delete_object(name: str, object_id: str) -> None  # Delete object by ID

	Static:
		spdb.Database.object_to_dict(object: Class) -> dict  # Convert object into dict
		spdb.Database.object_to_json(object: Class) -> dict  # Convert object into JSON-compatible dict
		spdb.Database.dict_to_object(Class: class, Dict: dict) -> Class  # Convert dict into object
		spdb.Database.dict_to_json(Dict: dict) -> dict  # Convert dict into JSON-compatible dict
		spdb.Database.json_to_object(Class: class, JSON: dict) -> Class  # Convert JSON into object

### TOTP - HOTP

---------------
	spdb.OTP(token: str=None, app_name: str=None)  # Create OTP object
	spdb.OTP.now() -> str  # Get TOTP code
	stdb.OTP.at(index: int) -> str  # Get HOTP code
	stdb.OTP.time_verify(code: str) -> bool  # Verify TOTP code
	stdb.OTP.counter_verify(index: int, code: str) -> bool  # Verify HOTP code
	stdb.OTP.TQR(name: str) ->  # Get TOTP QR-code for Google Authentificator
	stdb.OTP.HQR(name: str) ->  # Get HOTP QR-code for Google Authentificator

	Static:
		stdb.OTP.generate_token() -> str  # Generate random token

### Token Generator

-------------------
	stdb.TokenGenerator(code: str)  # Create TokenGenerator object
	stdb.TokenGenerator.gen(type: str, ID: str, key: str) -> str  # Generate token

	Static:
		stdb.TokenGenerator.parse_token(token: str) -> dict  # Parse token


### REstr

---------

	stdb.REstr(string: str='')  # Create REstr object
	stdb.REstr.replace(find: str/REstr, to: str/REstr) -> REstr  # Replace substring
	stdb.REstr.toReplaced(find: str/REstr, to: str/REstr) -> REstr  # Get replaced REstr
	stdb.REstr.clean(find: str/REstr) -> REstr  # Removes all matches 
	stdb.REstr.toCleaned(find: str/REstr) -> REstr  # Get removed all matches REstr
	stdb.REstr.isReplacing(find: str/REstr, to: str/REstr='') -> bool  # Will be changes when replacing?
	stdb.REstr.isMatches(find: str/REstr) -> bool  # Is entire REstr equal find regular expression?
	stdb.REstr.matches(find: str/REstr) -> int  # Count of matches
	stdb.REstr.match(find: str/REstr) -> re.Match  # The same as re.match
	stdb.REstr.setFromStr(string: str) -> REstr  # Sets new REstr from str
	stdb.REstr.toStr() -> str  # Converts REstr to str
	stdb.REstr.len() -> int  # Length of REstr
	stdb.REstr.at(index: int/tuple) -> REstr  # The same as str slicer
	stdb.REstr.join(array: list[str]/list[REstr]) ->  # The same as str join()
	stdb.REstr.convertFrom(var: Class) -> REstr  # Convert from any class to REstr
	stdb.REstr.convertTo(Class: class) -> Class  # Convert from REstr to any class

	Static:
		stdb.REstr.fromStr(string: str) -> REstr  # Create REstr object from str
		stdb.REstr.strOrREstr(string: str/REstr) -> REstr  # Converts str to REstr if type(string) == str


### Text Validator

------------------
	stdb.TextValidator(min: int=4, max: int=64, regexp: str=r'([A-z]|[0-9]|_|-)+')  # Create TextValidator object
	stdb.TextValidator.check(text: REstr) -> bool  # Check text for conditions


### Quotes

----------

	stdb.Quotes(open_quote: REstr=REstr.fromStr('<%'), close_quote: REstr=REstr.fromStr('%>'), validator: TextValidator=TextValidator())  # Create Quotes object
	stdb.Quotes.replace(text: REstr, data: dict) -> REstr  # Replaces entries
	stdb.Quotes.clean(text: REstr) -> REstr  # Removes all entires
	stdb.Quotes.replace_all(text: REstr, data: dict) -> REstr  # The same as stdb.Quotes.replace and stdb.Quotes.clean
	stdb.Quotes.count(text: REstr) -> int  # Count of all entries
	stdb.Quotes.count_trash(text: REstr, data: dict) -> int  # Count of all not replaced entries


### Utils

---------
	stdb.utils.sha256(text: str) -> str  # Get sha256 from text
	stdb.utils.b32encode(text: str) -> str  # Encode str into base32 str
	stdb.utils.random_text(length: int=None) -> str  # Get random text
	stdb.utils.random_sha256() -> str  # Get random sha256 str
	stdb.utils.random_b32 -> str  # Get random base32 str

