sysnet-pyutils 1.1.5__py3-none-any.whl → 1.2.1__py3-none-any.whl

sysnet_pyutils/ident.py

@@ -9,6 +9,7 @@
 # -------------------------------------------------------------------------------
 import os
 import uuid
+from typing import Optional
 
 import sysnet_pyutils.barcode as barcode
 
@@ -53,7 +54,7 @@ def generate_tiny_uuid():
     return out[-ID_LENGTH:]
 
 
-def generate_id12(three_char_prefix: str) -> str:
+def generate_id12(three_char_prefix: Optional[str]) -> str:
     """
     Vygeneruje 12místný alfanumerický identifikátor s pevným prefixem
 
@@ -105,7 +106,7 @@ def correct_pid(pid: str) -> str:
 
 def generate_pid() -> str:
     """
-    Vybeneruje nový PID
+    Vygeneruje nový PID
 
     :return:    PID
     """

sysnet_pyutils/models/general.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from datetime import datetime
 from enum import Enum
 from typing import Optional, List, Tuple, Any
-from uuid import UUID
 
 from pydantic import BaseModel, Field, EmailStr
 
@@ -42,16 +41,20 @@ class UserType(BaseModel):
     name_full: Optional[str] = Field(default=None, description='Úplné jméno uživatele', examples=['MUDr. Jiří Novák, PhD.'])
 
 
-class AclLevelEnum(Enum):
-    READ = 'R'
-    WRITE = 'W'
-    MANAGE = 'M'
+class BaseEnum(Enum):
+    pass
 
     @classmethod
     def has_value(cls, value):
         return value in cls._value2member_map_
 
 
+class AclLevelEnum(BaseEnum):
+    READ = 'R'
+    WRITE = 'W'
+    MANAGE = 'M'
+
+
 class CodeValueType(BaseModel):
     # kód/hodnota
     code: Optional[str] = Field(default=None, description='Kód položky', examples=['CZ'])
@@ -90,7 +93,8 @@ class ContainerHistoryItemType(BaseModel):
     # položka historie zařazení do kontejnerů
     timestamp: datetime = Field(default=local_now(), description='Časová značka logu')
     originator: Optional[str] = Field(default='SYSTEM', description='Zdroj logu', examples=['<NAME>'])
-    container: Optional[UUID] = Field(default=None, description='Identifikátor kontejneru')
+    # container: Optional[UUID] = Field(default=None, description='Identifikátor kontejneru')
+    container: Optional[str] = Field(default=None, description='Identifikátor kontejneru')
     message: Optional[str] = Field(default=None, description='Zpráva logu', examples=['Autorizováno'])
 
 
@@ -113,7 +117,8 @@ class MetadataTypeEntry(BaseModel):
     id_no: Optional[str] = Field(default=None, description='Číslo dokumentu', examples=['23CZ123456'])
     unid: Optional[str] = Field(default=None, description='Domino universal ID', examples=['3005277CB984B7FFC12587890060E2BF'])
     pid: Optional[str] = Field(default=None, description='Unique identifier', examples=['MBOA7HNBDJTR'])
-    uuid: Optional[UUID] = Field(default=None, description='Unique identifier')
+    # uuid: Optional[UUID] = Field(default=None, description='Unique identifier')
+    uuid: Optional[str] = Field(default=None, description='Unique identifier')
     form: Optional[str] = Field(default=None, description='Formulář', examples=['certificate'])
     authorized: Optional[bool] = Field(default=False, description='Dokument byl autorizován')
     archived: Optional[bool] = Field(default=False, description='Dokument byl archivován')
@@ -163,13 +168,15 @@ class MetadataType(MetadataTypeBase):
     )
     unid: Optional[str] = Field(default=None, description='Domino universal ID', examples=['3005277CB984B7FFC12587890060E2BF'])
     pid: Optional[str] = Field(default=None, description='Unique identifier', examples=['MBOA7HNBDJTR'])
-    uuid: Optional[UUID] = Field(default=None, description='Unique identifier')
+    # uuid: Optional[UUID] = Field(default=None, description='Unique identifier')
+    uuid: Optional[str] = Field(default=None, description='Unique identifier')
     form: Optional[str] = Field(default=None, description='Formulář', examples=['certificate'])
     authorized: Optional[bool] = Field(default=False, description='Dokument byl autorizován')
     archived: Optional[bool] = Field(default=False, description='Dokument byl archivován')
     deleted: Optional[bool] = Field(default=False, description='Dokument byl odstraněn')
     has_attachments: Optional[bool] = Field(default=False, description='Dokument má/nemá přílohy')
-    container: Optional[UUID] = Field(default=None, description='Identifikátor kontejneru, do kterého je dokument zařazen.')
+    # container: Optional[UUID] = Field(default=None, description='Identifikátor kontejneru, do kterého je dokument zařazen.')
+    container: Optional[str] = Field(default=None, description='Identifikátor kontejneru, do kterého je dokument zařazen.')
     container_history: Optional[List[Optional[ContainerHistoryItemType]]] = Field(default=None, description='Historie kontejnerů')
 
 
@@ -187,7 +194,8 @@ class LinkedType(BaseModel):
     id: Optional[str] = Field(default=None, description='Hlavní identifikátor', examples=['0c282c62-1918-4fbe-ad2c-e49a021f4801'])
     unid: Optional[str] = Field(default=None, description='Domino universal ID', examples=['3005277CB984B7FFC12587890060E2BF'])
     pid: Optional[str] = Field(default=None, description='PID (dvanáctimístný identifikátor', examples=['MBOA7HNBDJTR'])
-    uuid: Optional[UUID] = Field(default=None, description='Jednoznačný identifikátor', examples=['0c282c62-1918-4fbe-ad2c-e49a021f4801'])
+    # uuid: Optional[UUID] = Field(default=None, description='Jednoznačný identifikátor', examples=['0c282c62-1918-4fbe-ad2c-e49a021f4801'])
+    uuid: Optional[str] = Field(default=None, description='Jednoznačný identifikátor', examples=['0c282c62-1918-4fbe-ad2c-e49a021f4801'])
 
 
 class GeoPointJtskType(BaseModel):
@@ -250,7 +258,8 @@ class PersonBaseType(PersonCoreType):
     identifier: Optional[str] = Field(default=None, description='Hlavní jednoznačný identifikátor')
     unid: Optional[str] = Field(default=None, description='Domino universal ID', examples=['3005277CB984B7FFC12587890060E2BF'])
     pid: Optional[str] = Field(default=None, description='Unique identifier', examples=['MBOA7HNBDJTR'])
-    uuid: Optional[UUID] = Field(default=None, description='Unique identifier (UUID)')
+    # uuid: Optional[UUID] = Field(default=None, description='Unique identifier (UUID)')
+    uuid: Optional[str] = Field(default=None, description='Unique identifier (UUID)')
     main_person: Optional[LinkedType] = Field(default=None, description='Odkaz na hlavní osobu do registru')
     linked_persons: Optional[List[Optional[LinkedType]]] = Field(default=None, description='Odkaz na další osoby do registru')
 

sysnet_pyutils/utils.py

@@ -7,7 +7,7 @@ import secrets
 import sys
 import traceback
 from datetime import datetime, timedelta, date
-from typing import Tuple, Union, List, Any
+from typing import Tuple, Union, List, Any, Optional
 from urllib.parse import quote
 from uuid import UUID, uuid4, uuid1
 
@@ -16,7 +16,7 @@ import pytz
 import xmltodict
 import yaml
 
-from sysnet_pyutils.ident import generate_pid, check_pid, correct_pid, generate_id12
+from sysnet_pyutils.ident import generate_pid, check_pid, correct_pid, generate_id12, PID_PREFIX
 
 TZ = os.getenv('TZ', 'Europe/Prague')
 DEBUG = os.getenv("DEBUG", 'True').lower() in ('true', '1', 't')
@@ -177,6 +177,10 @@ def api_keys_init(agenda: str='main', amount: int =4) -> List[dict]:
     return out
 
 
+def uuid_factory():
+    return str(uuid4())
+
+
 def uuid_next(uuid_type: int = 4) -> UUID:
     """
     Vygeneruje UUID
@@ -191,6 +195,13 @@ def uuid_next(uuid_type: int = 4) -> UUID:
     return out
 
 
+def pid_factory(prefix=None) -> str:
+    p = PID_PREFIX
+    if prefix not in [None, ''] and len(prefix) > 2:
+        p = prefix[:3].upper()
+    return generate_id12(three_char_prefix=p)
+
+
 def pid_next() -> str:
     """
     Vygeneruje korektní PID
@@ -865,7 +876,7 @@ def timestamp(local=False) -> str:
     return out.strftime('%Y%m%d%H%M%S')
 
 
-def local_datetime(value=None) -> datetime:
+def local_datetime(value=None) -> Optional[datetime]:
     """
     Vrací datum a čas v lokální
 

{sysnet_pyutils-1.1.5.dist-info → sysnet_pyutils-1.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: sysnet-pyutils
-Version: 1.1.5
+Version: 1.2.1
 Summary: Python Utilities
 Author-email: Data Developer <info@sysnet.cz>
 Project-URL: Homepage, https://github.com/SYSNET-CZ/pyutils
@@ -11,7 +11,7 @@ Classifier: License :: Free For Home Use
 Classifier: Natural Language :: Czech
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: PyYAML>=6.0.1
@@ -21,7 +21,8 @@ Requires-Dist: xmltodict>=0.13.0
 Requires-Dist: boto3>=1.34.34
 Requires-Dist: botocore>=1.34.34
 Requires-Dist: pymongo>=4.7.2
-Requires-Dist: pydantic>=2.10.6
+Requires-Dist: pydantic[email]>=2.10.6
+Dynamic: license-file
 
 # sysnet-pyutils
 
@@ -64,7 +65,7 @@ Vygeneruje API klíč
 Vygeneruje slovník API key {API Key: name}
 * param name:    Název API klíče
 * param length:  Délka API klíče
-* return:    Slovník {API Key: name}
+* return: Slovník {API Key: name}
 ----------------------------------------------------------------
 #### api_keys_init(agenda='main', amount=4):
 Vygeneruje klíče pro API
@@ -78,19 +79,19 @@ Konvertuje hex string na int
 * return: int
 --------------------------------------------------------
 #### cron_to_dict(cron):
-Konvertuje cron text do do slovníku
+Konvertuje cron text do slovníku
 * param cron: cron text (například '35 21 * * *')
 * return:    dict of cron
 --------------------------------------------------------
 #### cs_bool(value=None):
 Vrátí českou textovou hodnotu 'ano'/'ne' pokud je bool(value) True/False
-* param value:  Obecný objekt
+* param value: Obecný objekt
 * return:    'ano' or 'ne'
 --------------------------------------------------------
 #### date_to_datetime(date_value):
 Konvertuje date na datetime v lokální časové zóně
 * param date_value:  hodnota  
-* return:        hodnota date v lokální časové zóně
+* return: hodnota date v lokální časové zóně
 --------------------------------------------------------
 #### decode_b64_string(b64_data: str, encoding='utf-8'):
 Dekóduje base64 data na string
@@ -139,13 +140,13 @@ Vytvoří sha383 checksum ze zdrojového textu
 ----------------------------------------------------------------
 #### id12_next(three_char_prefix=None):
 Vygeneruje korektní 12místný alfanumerický identifikátor s pevným prefixem
-* param three_char_prefix:   Tříznakový prefix identifikátoru
-* return:    12místný alfanumerický identifikátor
+* param three_char_prefix: Tříznakový prefix identifikátoru
+* return: 12místný alfanumerický identifikátor
 ----------------------------------------------------------------
 #### increment_date(date_str=None, days=1):
 Inkrementuje datum v textovém formátu ISO o daný počet dní
 * param date_str:    ISO datum v textovém formátu ISO
-* param days:        počet dní
+* param days: počet dní
 * return:        ISO datum v textovém formátu ISO
 ----------------------------------------------------------------
 #### is_base64(body):
@@ -267,12 +268,12 @@ pravidel viz https://github.com/martinblech/xmltodict
 #### order_to_cites(order: int):
 Konvertuje celočíselnou hodnotu na písmennou
 * param order: celočíselná hodnota např. 1458
-* return:    znaková hodnota např. 'BDB'
+* return: znaková hodnota např. 'BDB'
 --------------------------------------------------------------------------------------------------------------------------------
 #### cites_to_order(cites: str):
 Konvertuje písmennou hodnotu na celočíselnou
-* param cites:   znaková hodnota např. 'BDB' 
-* return:    celočíselná hodnota např. 1458
+* param cites: znaková hodnota např. 'BDB' 
+* return: celočíselná hodnota např. 1458
 --------------------------------------------------------------------------------------------------------------------------------
 ### verze 1.0.5
 
@@ -347,3 +348,8 @@ která naplní atribut **identifier** z unid, pid nebo uuid.
 * **LOG_FORMAT**: Formát logování. Implicitně `'%(asctime)s - %(levelname)s in %(module)s: %(message)s'`
 * **LOG_DATE_FORMAT**: Formát data pro logování. Implicitně `'%d.%m.%Y %H:%M:%S'`
 * **PID_PREFIX**: PID prefix. Implicitně `'SNT'`
+
+### verze 1.2.0
+
+1. Místo typu `UUID` se v modelu používá pouze `str`. Je tomu tak kvůli ukládání do **MongoDb**.
+2. Doplněn abstraktní typ `BaseEnum`, který obsahuje metodu `has_value`. 

{sysnet_pyutils-1.1.5.dist-info → sysnet_pyutils-1.2.1.dist-info}/RECORD

@@ -3,15 +3,15 @@ sysnet_pyutils/barcode.py,sha256=5dM1ISvVVP966JQxGiZBUYJoPx_jgzWEpEQ2uIOxTd4,262
 sysnet_pyutils/data_utils.py,sha256=foePXYsPJyl7zdzb4RENO937uNV5G05GdW_En6ql4kw,9673
 sysnet_pyutils/domino.py,sha256=dGmg9d1PMPOyA_ysXBHVu_zabKGCJEuno3Yw3DexExQ,2671
 sysnet_pyutils/geo.py,sha256=smAkRfobvKqjr3_UIjU5huDbnkb3_edD_xmv4R0r5Q0,2938
-sysnet_pyutils/ident.py,sha256=GyNPF_LNqssMtMzuegpL1GK-0B-ysDiH18kYAdiE2hg,2807
+sysnet_pyutils/ident.py,sha256=OkGne8xLEFd2zNdIm7HTPJ_K-fIN9rz7tOR-H0PWDRE,2845
 sysnet_pyutils/log.py,sha256=SFuCPvFTg31LFvnyG24hCTe73FonfS0_FaAHRBhEvlw,2165
 sysnet_pyutils/ses.py,sha256=WJzs0y2QnF4XGDGjls_W0p0v6DJ4fZ4_97m3XbzpaFw,2713
 sysnet_pyutils/tools.py,sha256=ZioHvUIufrhuJyZLdPnuMUD8Li5LTljSMSCxqRnKIi4,377
-sysnet_pyutils/utils.py,sha256=Y95MyEuZlSlTVsQ2rOArdkTN7xqcGsCA7RA6VoBHSSk,23257
+sysnet_pyutils/utils.py,sha256=4dOqlP8JhKaIzWlbYw4PLckBf1SigBJK-MzK1EWTgYk,23523
 sysnet_pyutils/models/__init__.py,sha256=oozOr_DKhenkM9BDaPOmtbLXhP5vtMUCjBPEjZDW4GQ,167
-sysnet_pyutils/models/general.py,sha256=Rv4xBU19lp02fEKDVowFJSDNNZszKg8YaF4z1RO-kGg,15297
-sysnet_pyutils-1.1.5.dist-info/LICENSE,sha256=bx5iLIKjgAdYQ7sISn7DsfHRKkoCUm1154sJJKhgqnU,35184
-sysnet_pyutils-1.1.5.dist-info/METADATA,sha256=Z1P9jatiq9NSbYnLfoigaK5FOktfg4LRhKfm9gTeKAg,15083
-sysnet_pyutils-1.1.5.dist-info/WHEEL,sha256=nn6H5-ilmfVryoAQl3ZQ2l8SH5imPWFpm1A5FgEuFV4,91
-sysnet_pyutils-1.1.5.dist-info/top_level.txt,sha256=ZKTltQWbLlWBXw4oovo1w7ui-JQ1WoyECqMSWdBj6XE,15
-sysnet_pyutils-1.1.5.dist-info/RECORD,,
+sysnet_pyutils/models/general.py,sha256=cvAO-_RxZVv_It2rLRFiFEJCYEwApggqIG9KMKDDKhc,15928
+sysnet_pyutils-1.2.1.dist-info/licenses/LICENSE,sha256=bx5iLIKjgAdYQ7sISn7DsfHRKkoCUm1154sJJKhgqnU,35184
+sysnet_pyutils-1.2.1.dist-info/METADATA,sha256=IQl54ywb0jyWSVeJ2yu4bHYMBwGeB2UtunTubtErSxM,15285
+sysnet_pyutils-1.2.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+sysnet_pyutils-1.2.1.dist-info/top_level.txt,sha256=ZKTltQWbLlWBXw4oovo1w7ui-JQ1WoyECqMSWdBj6XE,15
+sysnet_pyutils-1.2.1.dist-info/RECORD,,

{sysnet_pyutils-1.1.5.dist-info → sysnet_pyutils-1.2.1.dist-info}/WHEEL

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