iniUts 2.0.2__py3-none-any.whl

iniUts/__init__.py

@@ -0,0 +1,13 @@
+from iniUts.iniUts import IniUts
+from iniUts.config_parser_ini import IniCp
+from iniUts.secret import decrypt, encrypt
+from iniUts.envar import Envar
+
+
+__all__ = [
+    'IniUts',
+    'IniCp',
+    'decrypt',
+    'encrypt',
+    'Envar'
+]

iniUts/config_parser_ini.py

@@ -0,0 +1,55 @@
+import configparser as cp
+
+
+class IniCp:
+
+    def __init__(self, ini_file, encoding=None):
+        self.ini_file = ini_file
+        self.encoding = encoding
+        self.read_ini()
+
+    def read_ini(self):
+        config = cp.RawConfigParser(
+            allow_no_value=True, comment_prefixes=(";", "#"), strict=False
+        )
+        config.optionxform = str
+        if self.encoding:
+            with open(self.ini_file, "r", encoding=self.encoding) as f:
+                config.read_string(f.read())
+        else:
+            config.read(self.ini_file)
+
+        self.config_parser = config
+
+    def write(self, section, key, value):
+        if section not in self.config_parser.sections():
+            self.config_parser[section] = {}
+        self.config_parser[section][key] = value
+        self.config_parser.write(open(self.ini_file, "w", encoding=self.encoding))
+
+    def read(self, section, key):
+        if section not in self.config_parser.sections():
+            raise Exception("Section not found!")
+        if key not in self.config_parser[section]:
+            raise Exception("Key not found!")
+        return self.config_parser[section][key]
+
+    def getSections(self):
+        return list(self.config_parser.sections())
+
+    def getKeys(self, section):
+        if section not in self.config_parser.sections():
+            raise Exception("Section not found!")
+
+        return list(self.config_parser[section])
+
+    def section2Dict(self, section):
+        dc = dict(self.config_parser[section])
+
+        return {x: (y or None) for x, y in dc.items()}
+
+    def __iter__(self):
+        sections = self.getSections()
+        for sect in sections:
+            # Retorna uma tupla (chave, valor) para cada iteração
+            yield sect, self.section2Dict(sect)

iniUts/envar.py

@@ -0,0 +1,17 @@
+from typing import Optional
+import os
+
+
+class Envar:
+    def __init__(self, key: str, default: Optional[str] = None):
+        self.key = key
+        self.default = default
+
+    def get_value(self):
+        if self.default is not None:
+            return os.getenv(self.key, self.default)
+        else:
+            value = os.getenv(self.key)
+            if not value:
+                raise Exception(f"envar '{self.key}' not found!")
+            return value

iniUts/iniUts.py

@@ -0,0 +1,193 @@
+from datetime import datetime
+import re
+import types
+from iniUts.secret import decrypt, encrypt
+from iniUts.config_parser_ini import IniCp
+from iniUts.envar import Envar
+
+
+class IniUts:
+
+    def __init__(
+        self, ini_prd, ini_dev=None, in_prd=True, encryption_key=None, encoding=None
+    ):
+        self.cp_prd = IniCp(ini_prd, encoding=encoding)
+        self.cp_dev = IniCp(ini_dev, encoding=encoding) if ini_dev else None
+        self.in_prd = in_prd
+        self.encryption_key = encryption_key
+        self.checkKeys()
+
+    def refresh(self):
+        self.cp_prd = IniCp(self.cp_prd.ini_file, encoding=self.cp_prd.encoding)
+        self.cp_dev = (
+            IniCp(self.cp_dev.ini_file, encoding=self.cp_dev.encoding)
+            if self.cp_dev
+            else None
+        )
+
+    # TODAS AS CHAVES DE DEV DEVE CONTER EM PRD
+    def checkKeys(self):
+        if self.cp_dev:
+            # VALIDA AS SESSOES
+            sections_dev = self.cp_dev.getSections()
+            sections_prd = self.cp_prd.getSections()
+            not_sections_in_prd = set(sections_dev) - set(sections_prd)
+            if not_sections_in_prd:
+                raise Exception(
+                    f"could not find {not_sections_in_prd} section at production file, dev ini file must contain same sections as in production ini file"
+                )
+
+            # VALIDA AS CHAVES
+            for sect in sections_dev:
+                keys_dev = self.cp_dev.getKeys(sect)
+                keys_prd = self.cp_prd.getKeys(sect)
+                not_keys_in_prd = set(keys_dev) - set(keys_prd)
+                if not_keys_in_prd:
+                    raise Exception(
+                        f"could not find {not_keys_in_prd} keys in section '{sect}' at production file, dev ini file must contain same sections as in production ini file"
+                    )
+
+    def format_data(self, dtClass, k, v):
+        cls = dtClass.__annotations__[k]
+        if k in dtClass.__CRYPTED_KEYS__:
+            v = decrypt(v, self.encryption_key)
+
+        if cls == tuple:
+            name = f"{str(dtClass)}_{k}"
+            if name not in self.delimiters:
+                isFormatDefined = k in [
+                    x for x in dir(dtClass) if not re.search("__.*__", x)
+                ]
+                delimiter = getattr(dtClass, k) or "," if isFormatDefined else ","
+                self.delimiters[name] = delimiter
+
+            v = tuple(v.split(self.delimiters[name]))
+        elif cls == datetime:
+            name = f"{str(dtClass)}_{k}"
+            if name not in self.dateFormats:
+                isFormatDefined = k in [
+                    x for x in dir(dtClass) if not re.search("__.*__", x)
+                ]
+                delimiter = getattr(dtClass, k) if isFormatDefined else "%Y-%m-%d"
+                self.dateFormats[name] = delimiter
+
+            v = datetime.strptime(v, self.dateFormats[name])
+        elif cls == bool:
+            val = v.strip().lower()
+            v = True if val and val in ["true", "1", "y"] else False
+            v = False if val in ["false", "", "0", "n"] else True
+
+        else:
+            v = cls(v) if v else None
+        return v
+
+    # COLOCA TODOS COMO NONE INICIALMENTE
+    def setup_initial_values(self, dtClass):
+        for k in dtClass.__annotations__:
+            if not hasattr(dtClass, k):
+                setattr(dtClass, k, None)
+        return dtClass
+
+    def section2DataClass(
+        self, section, dtClass, skip_missing=False, empty_as_null=False
+    ):
+        dtClass = self.setup_initial_values(dtClass)
+
+        dtClass.save = types.MethodType(save, dtClass)
+        dtClass.__SECTION__ = section
+        dtClass.__ENVARS__ = [
+            x for x in dtClass.__annotations__ if isinstance(getattr(dtClass, x), Envar)
+        ]
+        dtClass.__INIUTS__ = self
+        dtClass.__CRYPTED_KEYS__ = [
+            x.replace("&_", "") for x in self.cp_prd.getKeys(section) if "&_" in x
+        ]
+        dict_prd = {
+            k.replace("&_", ""): v for k, v in self.cp_prd.section2Dict(section).items()
+        }
+        dict_dev = (
+            {
+                k.replace("&_", ""): v
+                for k, v in self.cp_dev.section2Dict(section).items()
+            }
+            if self.cp_dev and section in self.cp_dev.getSections()
+            else {}
+        )
+
+        # ENCRIPTA VARIAVEIS INICIAIS
+        for k in dtClass.__CRYPTED_KEYS__:
+            # ENCRIPTA VARIAVEIS INICIAIS NO ARQUIVO DE DEV
+            if self.cp_dev:
+                if (
+                    k in dict_dev.keys()
+                    and dict_dev[k]
+                    and dict_dev[k].startswith("&_")
+                ):
+                    cripted_value = encrypt(
+                        dict_dev[k].replace("&_", ""), self.encryption_key
+                    )
+                    dict_dev[k] = cripted_value
+                    self.cp_dev.write(section, "&_" + k, cripted_value)
+
+            # ENCRIPTA VARIAVEIS INICIAIS NO ARQUIVO DE PRD
+            if k in dict_prd.keys() and dict_prd[k] and dict_prd[k].startswith("&_"):
+                cripted_value = encrypt(
+                    dict_prd[k].replace("&_", ""), self.encryption_key
+                )
+                dict_prd[k] = cripted_value
+                self.cp_prd.write(section, "&_" + k, cripted_value)
+
+        for key in dtClass.__annotations__:
+            if key in dtClass.__ENVARS__:
+                v = getattr(dtClass, key).get_value()
+                v = self.format_data(dtClass, key, v)
+                setattr(dtClass, key, v)
+                continue
+            if key in dict_prd.keys():
+                if key in dict_dev.keys() and not self.in_prd:
+                    v = dict_dev.get(key)
+                else:
+                    v = dict_prd.get(key)
+                v = self.format_data(dtClass, key, v)
+                setattr(dtClass, key, v)
+                continue
+            raise Exception(
+                f"Cound not find '{key}' key at section '{section}' in ini file"
+            )
+
+    def link(self, section, skip_missing=False, empty_as_null=False):
+        def wrap(function):
+            self.section2DataClass(section, function, skip_missing, empty_as_null)
+            return function
+
+        return wrap
+
+
+def save(self):
+    ini = self.__INIUTS__
+    types_to_str = [str, int, float, bool]
+    is_str = lambda t: any([t == x for x in types_to_str])
+
+    for k, t in self.__annotations__.items():
+        if k in self.__ENVARS__:
+            continue
+
+        if is_str(t):
+            value = str(getattr(self, k))
+        elif t == tuple:
+            value = getattr(self, k)
+            delimiter = ini.delimiters[f"{str(self)}_{k}"]
+            value = delimiter.join(value)
+        elif t == datetime:
+            value = getattr(self, k)
+            dateFormat = ini.dateFormats[f"{str(self)}_{k}"]
+            value = value.strftime(dateFormat)
+
+        if k in self.__CRYPTED_KEYS__:
+            k = "&_" + k
+            value = encrypt(value, ini.encryption_key)
+
+        if not ini.in_prd and k in ini.cp_dev.getKeys(self.__SECTION__):
+            ini.cp_dev.write(self.__SECTION__, k, value)
+        else:
+            ini.cp_prd.write(self.__SECTION__, k, value)

iniUts/secret.py

@@ -0,0 +1,58 @@
+import os
+import base64
+from cryptography.hazmat.primitives.ciphers.aead import AESGCM
+from cryptography.hazmat.primitives import hashes
+
+
+# Retorna 32 bytes (SHA-256) da senha (usada como chave final)
+def _derive_key_from_password(password: str) -> bytes:
+    # Hash SHA-256 da senha -> chave de 32 bytes
+    digest = hashes.Hash(hashes.SHA256())
+    digest.update(password.encode("utf-8"))
+    return digest.finalize()
+
+
+# Encripta texto (str) com senha (str). Retorna string Base64 contendo: nonce + ciphertext + tag
+def encrypt(text: str, password: str) -> str:
+    """
+    // text: texto em claro
+    // password: senha/segredo que será transformado em hash (SHA-256) para usar como chave
+    // retorna: base64(nonce || ciphertext || tag)
+    """
+    key = _derive_key_from_password(password)  # 32 bytes
+    aesgcm = AESGCM(key)
+    nonce = os.urandom(12)  # nonce/IV recomendado para GCM: 12 bytes
+    plaintext = text.encode("utf-8")
+    ciphertext = aesgcm.encrypt(nonce, plaintext, None)  # dados adicionais (AAD) = None
+    payload = (
+        nonce + ciphertext
+    )  # armazenar nonce + ciphertext (ciphertext já inclui tag no AESGCM)
+    return base64.b64encode(payload).decode("utf-8")
+
+
+# Decripta string Base64 gerada por encrypt()
+def decrypt(token_b64: str, password: str) -> str:
+    """
+    // token_b64: string retornada por encrypt (base64(nonce||ciphertext||tag))
+    // password: mesma senha usada na encriptação
+    // retorna: texto em claro (str) ou levanta exceção se inválido
+    """
+    key = _derive_key_from_password(password)
+    data = base64.b64decode(token_b64)
+    if len(data) < 12:
+        raise ValueError("Payload inválido")
+    nonce = data[:12]
+    ciphertext = data[12:]
+    aesgcm = AESGCM(key)
+    plaintext = aesgcm.decrypt(nonce, ciphertext, None)
+    return plaintext.decode("utf-8")
+
+
+# Exemplo de uso:
+if __name__ == "__main__":
+    senha = "minha-senha-secreta"
+    texto = "mensagem ultra secreta"
+    cifrado = encrypt(texto, senha)
+    print("Cifrado:", cifrado)
+    dec = decrypt(cifrado, senha)
+    print("Decifrado:", dec)

iniuts-2.0.2.dist-info/METADATA

@@ -0,0 +1,339 @@
+Metadata-Version: 2.4
+Name: iniUts
+Version: 2.0.2
+Summary: Ini file manipulator
+Home-page: 
+Author: Melque Lima
+Author-email: melque_ex@yahoo.com.br
+License: MIT
+Keywords: iniUts
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+License-File: LICENCE.txt
+Requires-Dist: cryptography>=3.4.7
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+# Ini Uts
+#
+### Installation
+
+```sh
+pip install iniUts
+```
+
+## GitHub
+https://github.com/ZdekPyPi/IniUts
+
+
+## Usage
+#
+<!-- //==================================================== -->
+## read
+##### test.ini file
+```ini
+[Person]
+name    = myname
+age     = 31
+amount  = 20.3
+friends = friend1,friend2,friend3
+dob     = 1991-12-23
+```
+##### python code
+```py
+from iniUts import IniUts
+
+ini = IniUts('test.ini')
+data = ini.read('Person','name')
+
+print(result)
+```
+##### output
+```py
+"myname"
+```
+
+<!-- //==================================================== -->
+## write
+##### test.ini file
+```ini
+[PERSON]
+name    = myname
+```
+##### python code
+```py
+from iniUts import IniUts
+
+ini = IniUts('test.ini')
+ini.write('PERSON','last_name','mylastname')
+
+```
+##### test.ini file
+```ini
+[PERSON]
+name      = myname
+last_name = mylastname
+```
+<!-- //==================================================== -->
+## getKeys
+##### test.ini file
+```ini
+[PERSON]
+name      = myname
+last_name = mylastname
+```
+##### python code
+```py
+from iniUts import IniUts
+
+ini = IniUts('test.ini')
+keys = ini.getKeys("PERSON")
+print(keys)
+```
+##### output
+```py
+['name','last_name']
+```
+
+<!-- //==================================================== -->
+## Section2Dict
+##### test.ini file
+```ini
+[PERSON]
+name    = myname
+age     = 31
+amount  = 20.3
+friends = friend1,friend2,friend3
+dob     = 1991-12-23
+```
+##### python code
+```py
+from iniUts import IniUts
+
+ini = IniUts('test.ini')
+ini.Section2Dict('PERSON')
+print(Person)
+
+```
+##### output
+```py
+{
+    "name"    = "myname"
+    "age"     = "31"
+    "amount"  = "20.3"
+    "friends" = "friend1,friend2,friend3"
+    "dob"     = "1991-12-23"
+}
+
+```
+<!-- //==================================================== -->
+## link
+##### test.ini file
+```ini
+[PERSON]
+name    = myname
+age     = 31
+amount  = 20.3
+friends = friend1,friend2,friend3
+dob     = 1991-12-23
+```
+##### python code
+```py
+from iniUts import IniUts
+from datetime import datetime
+from dataclasses import dataclass
+
+ini = IniUts('test.ini')
+
+@ini.link('PERSON')
+class Person():
+    name   : str
+    age    : int
+    amount : float
+    friends: tuple = ','
+    dob    : datetime = "%Y-%m-%d"
+
+print(Person.name)
+print(Person.age)
+print(Person.amount)
+print(Person.friends)
+print(Person.dob)
+
+```
+##### output
+```py
+myname
+31
+20.3
+("friend1","friend2","friend3")
+datetime.datetime(1991, 12, 2, 0, 0)
+
+```
+
+# ENCRYPTION
+
+<!-- //==================================================== -->
+## Using Encryption
+##### test.ini file
+```ini
+[CREDENTIALS]
+username = myuser
+&_password = &_mypassword123
+&_api_key  = &_secret_api_key_12345
+```
+##### python code
+```py
+from iniUts import IniUts
+
+# Initialize with encryption key
+ini = IniUts('test.ini', encryption_key="my_secure_encryption_key_32_chars")
+
+@ini.link('CREDENTIALS')
+class Credentials():
+    username: str
+    password: str
+    api_key : str
+
+print(Credentials.username)
+print(Credentials.password)
+print(Credentials.api_key)
+
+# Save encrypted values back to file
+Credentials.password = "new_secure_password"
+Credentials.save()
+```
+##### output
+```py
+myuser
+mypassword123
+secret_api_key_12345
+```
+
+**Note:** When using encryption, the values in the INI file will be encrypted. The encryption key must be provided every time you read or write to the file.
+
+# ENVIORNMENT CHANGING
+
+<!-- //==================================================== -->
+## Link
+##### prd.ini file
+```ini
+[PERSON] 
+name    = myName # Will be changed in DEV
+age     = 31
+amount  = 20.3
+friends = friend1,friend2,friend3
+dob     = 1991-12-23
+
+[CONFIG]
+ip    = <some_ip>
+path  = <some_path> # Will be changed in DEV
+
+```
+##### dev.ini file
+```ini
+[PERSON] #change only PERSON name
+name    = myOtherName
+
+[CONFIG] #change only CONFIG path
+path    = <another_path>
+
+```
+
+##### python code
+```py
+from iniUts import IniUts,envar
+from datetime import datetime
+from dataclasses import dataclass
+
+
+ini = IniUts('prd.ini','dev.ini',in_prd=True) #CHANGE S WILL BE MADE IF IN DEVELOPMENT MODE
+
+@ini.link('PERSON')
+class Person():
+    name   : str
+    age    : int
+    amount : float
+    friends: tuple = ','
+    dob    : datetime = "%Y-%m-%d"
+    mode   : envar(key='MODE',default='DEV')
+
+@ini.link('CONFIG')
+class Config():
+    ip   : str
+    path : str
+
+
+print(Person.name)
+print(Person.age)
+print(Config.ip)
+print(Config.path)
+
+```
+##### output
+```py
+#==================== IN PRD
+myName
+31
+<some_ip>
+<some_path>
+#==================== IN DEV
+myOtherName
+16
+<some_ip>
+<some_path>
+
+```
+
+
+
+
+
+
+Change Log
+==========
+
+1.0.0 (2023-04-26)
+------------------
+- First Release
+
+1.0.1 (2023-04-26)
+------------------
+- Bug Fixed
+
+1.0.2 (2023-04-26)
+------------------
+- Upercase Bug Fixed
+
+1.0.3 (2023-04-26)
+------------------
+- Upercase Write Bug Fixed
+
+1.0.4 (2023-04-28)
+------------------
+- Update Class bug fixed
+
+1.0.6 (2023-04-28)
+------------------
+- empty_as_null
+
+
+1.0.7 (2023-04-28)
+------------------
+- changing enviornment
+
+
+1.3.0 (2025-12-01)
+------------------
+- encription and decription

iniuts-2.0.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+iniUts/__init__.py,sha256=_qvnk6lBUg9LtHPoOz4R-6L103Vo2wwGwMvwbVlR3LA,234
+iniUts/config_parser_ini.py,sha256=ToPJZTsS-5Oh2U-7UVEi7SzaN0KOUjr0Fy_sT1DVv4M,1777
+iniUts/envar.py,sha256=URXpMed5Yg8PQxqAMwlA8u3lMQdBjRBgweRqJyCVelA,459
+iniUts/iniUts.py,sha256=LfHzb8uD7It4jMyyT_d_9FDzvMdnPkrdSCLe2DWLkZ8,7225
+iniUts/secret.py,sha256=pCRamcKp0oidOOxyyjjpmA7AQyxllOc4ARBaUIrqt3U,2092
+iniuts-2.0.2.dist-info/licenses/LICENCE.txt,sha256=GUH9WcKnuaaIagVs7XjWYP1X3egwKzk9rPq_8JVK3Lw,1051
+iniuts-2.0.2.dist-info/METADATA,sha256=UmbXdm8Ju3Zrcx4Dgv2Yzs3vFVCwJ0aDdHQmwvQ_yZY,5735
+iniuts-2.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+iniuts-2.0.2.dist-info/top_level.txt,sha256=1FCLwhTWytEuBDJNbNfuzVBmR3EOHnYNuGLtuuupjPc,7
+iniuts-2.0.2.dist-info/RECORD,,

iniuts-2.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

iniuts-2.0.2.dist-info/licenses/LICENCE.txt

@@ -0,0 +1,8 @@
+
+Copyright 2021 Melque Lima
+
+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.

iniuts-2.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+iniUts