sysnet-pyutils 1.0.8__py3-none-any.whl → 1.1.1__py3-none-any.whl

sysnet_pyutils/data_utils.py

@@ -3,8 +3,7 @@ from typing import Union, List, Any
 
 import pytz
 
-from utils import is_valid_email, TZ
-
+from sysnet_pyutils.utils import is_valid_email, TZ
 
 def get_dict_value(data: dict, item_name: str) -> Union[Any, None]:
     """

sysnet_pyutils/models/__init__.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+File name: 
+Author:         "SYSNET s.r.o."<rjaeger@sysnet.cz>
+Created:    
+Version:        1.0.0
+Description:
+"""

sysnet_pyutils/models/general.py

@@ -0,0 +1,262 @@
+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
+
+from sysnet_pyutils.utils import local_now
+
+
+class ApiError(Exception):
+    def __init__(self, code: int = 500, message: str = None):
+        self.code = code
+        self.message = message
+
+
+class ErrorModel(BaseModel):
+    code: int
+    message: str
+
+
+class UserType(BaseModel):
+    identifier: Optional[str] = Field(
+        default=None,
+        description='identifikátor uživatele (PID nebo UUID)',
+        examples=['ABC123456789'],
+    )
+    name: Optional[str] = Field(
+        default=None, description='Jméno uživatele', examples=['Jiří Novák']
+    )
+    dn: Optional[str] = Field(
+        default=None,
+        description='Příznačné jméno (distinguished name) LDAP',
+        examples=['cn=Jiří Novák, o=AOPK, c=CZ'],
+    )
+    email: Optional[EmailStr] = Field(default=None, description='Adresa elektronické pošty', examples=['jiri.novak@aopk.cz'])
+    phone: Optional[str] = Field(default=None, description='Telefonní číslo uživatele')
+    name_first: Optional[str] = Field(default=None, description='Křestní jméno uživatele', examples=['Jiří'])
+    name_last: Optional[str] = Field(default=None, description='Příjmení uživatele', examples=['Novák'])
+    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'
+
+    @classmethod
+    def has_value(cls, value):
+        return value in cls._value2member_map_
+
+
+class CodeValueType(BaseModel):
+    # kód/hodnota
+    code: Optional[str] = Field(default=None, description='Kód položky', examples=['CZ'])
+    value: Optional[str] = Field(default=None, description='Hodnota položky', examples=['Česká republika / Czech republic'])
+
+    def __eq__(self, other):
+        if not isinstance(other, CodeValueType):
+            return NotImplemented
+        return self.code == other.code and self.value == other.value
+
+    def load_data(self, data: Tuple[Any, Any]):
+        self.code = data[0]
+        self.value = data[1]
+        return self
+
+class RegionalValueType(CodeValueType):
+    # kód/hodnota/rok/kraj
+    year: Optional[int] = Field(default=None, description='Rok platnotsi položky', examples=[2022])
+    region: Optional[str] = Field(default=None, description='Kraj platnosti položky', examples=['Středočeský kraj'])
+
+
+class TimeLimitedType(CodeValueType):
+    # kód/hodnota
+    date_from: Optional[datetime] = Field(default=None, description='Platí od data')
+    date_to: Optional[datetime] = Field(default=None, description='Platí do data')
+
+
+class LogItemType(BaseModel):
+    # položka logu
+    timestamp: datetime = Field(default=local_now(), description='Časová značka logu')
+    originator: Optional[str] = Field(default='SYSTEM', description='Zdroj logu', examples=['<NAME>'])
+    message: Optional[str] = Field(default=None, description='Zpráva logu', examples=['Autorizováno'])
+
+
+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')
+    message: Optional[str] = Field(default=None, description='Zpráva logu', examples=['Autorizováno'])
+
+
+class AclType(BaseModel):
+    name: Optional[str] = Field(
+        default=None,
+        description='Uživatelské jméno nebo název role',
+        examples=['jan.novak@email.com'],
+    )
+    level: Optional[AclLevelEnum] = Field(
+        default=None, description='Úroveň přístupu (reader, writer, manager)'
+    )
+    can_delete: Optional[bool] = Field(
+        default=False, description='Oprávnění odstraňovat dokumenty'
+    )
+
+
+class MetadataTypeEntry(BaseModel):
+    title: Optional[str] = Field(default=None, description='Název dokumentu')
+    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')
+    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')
+
+
+class MetadataTypeBase(BaseModel):
+    title: Optional[str] = Field(default=None, description='Název dokumentu')
+    id_no: Optional[str] = Field(default=None, description='Číslo dokumentu', examples=['23CZ123456'])
+    id_no_local: Optional[str] = Field(default=None, description='Lokální číslo dokumentu', examples=['23CZ123456'])
+    id_no_list: Optional[List[str]] = Field(default=None, description='Seznam všech čísel dokumentu', examples=['23CZ123456'])
+    creator: Optional[str] = Field(
+        default=None,
+        description='Tvůrce dokumentu - Subjekt primárně odpovědný za vytvoření dokument.',
+        examples=['CN=Jan Novák/O=CITES/C=CZ'],
+    )
+    created_by_official: Optional[bool] = Field(default=False, description='Vytvořeno úředníkem')
+    contributor: Optional[UserType] = Field(default=None, description='Přispěvatel (podílí se na obsahu dokumentu)')
+    acl: Optional[List[AclType]] = Field(default=None, description='seznam přístupových práv')
+
+
+class MetadataType(MetadataTypeBase):
+    date_created: Optional[datetime] = Field(
+        default=local_now(),
+        description='Datum a čas vytvoření dokumentu',
+        examples=['2023-04-20T05:12:03Z'],
+    )
+    date_modified: Optional[datetime] = Field(
+        default=local_now(),
+        description='Datum a čas poslední úpravy dokumentu',
+        examples=['2023-04-20T05:12:03Z'],
+    )
+    date_authorized: Optional[datetime] = Field(
+        default=None,
+        description='Datum a čas autorizace',
+        examples=['2023-04-20T05:12:03Z'],
+    )
+    date_archived: Optional[datetime] = Field(
+        default=None,
+        description='Datum a čas archivace',
+        examples=['2023-04-20T05:12:03Z'],
+    )
+    date_deleted: Optional[datetime] = Field(
+        default=None,
+        description='Datum a čas odstranění',
+        examples=['2023-04-20T05:12:03Z'],
+    )
+    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')
+    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_history: Optional[List[ContainerHistoryItemType]] = Field(default=None, description='Historie kontejnerů')
+
+
+class ListTypeBase(BaseModel):
+    start: Optional[int] = Field(default=None, description='Počáteční dokument na stránce', examples=[0])
+    page_size: Optional[int] = Field(default=None, description='Velikost stránky', examples=[10])
+    page: Optional[int] = Field(default=None, description='Požadovaná stránka', examples=[0])
+    count: Optional[int] = Field(default=None, description='celkový počet vrácených položek', examples=[25])
+
+
+class LinkedType(BaseModel):
+    # Identifikace pevně provázaného dokumemtu (nadřízený nebo jinak provázaný)
+    title: Optional[str] = Field(default=None, description='Název provázaného dokumentu', examples=['Žádost o vydání permitu'])
+    code: Optional[str] = Field(default=None, description='Kód vazby', examples=['CRŽP', 'CITS', 'IPPC'])
+    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'])
+
+
+class GeoPointJtskType(BaseModel):
+    x: Optional[float] = Field(default=None, description='JTSK - X', examples=[-1182833.13])
+    y: Optional[float] = Field(default=None, description='JTSK - Y', examples=[-784886.70])
+
+
+class GeoPointType(BaseModel):
+    lat: Optional[float] = Field(default=None, description='WGS84 - latitude', examples=[-4.3202115])
+    lon: Optional[float] = Field(default=None, description='WGS84 - longitude', examples=[55.7520211])
+
+
+class MapSheet50Type(BaseModel):
+    # objekt mapový list 1:50000
+    id: Optional[str] = Field(default=None, description='Identifikátor mapového listu', examples=['03-44'])
+    name: Optional[str] = Field(default=None, description='Název mapového listu', examples=['Dvůr Králové'])
+
+
+class BasinType(BaseModel):
+    # objekt povodí
+    id: Optional[int] = Field(default=None, description='Identifikátor', examples=[4236])
+    id_1: Optional[int] = Field(default=None, description='Identifikátor', examples=[1])
+    id_2: Optional[int] = Field(default=None, description='Identifikátor', examples=[11])
+    id_3: Optional[int] = Field(default=None, description='Identifikátor', examples=[49])
+    chp: Optional[str] = Field(default=None, description='', examples=['1-11-04-0300-0-00'])
+    chp_d: Optional[str] = Field(default=None, description='', examples=['1-11-04-0300-0-00'])
+    chp_u: Optional[str] = Field(default=None, description='', examples=['1-11-04-0300-0-00'])
+    basin_name_1: Optional[str] = Field(default=None, description='naz_pov_1', examples=['povodí Labe'])
+    basin_name_2: Optional[str] = Field(default=None, description='naz_pov_2', examples=['Berounka od Úslavy po ústí'])
+    basin_name_3: Optional[str] = Field(default=None, description='naz_pov_3', examples=['Litavka a Berounka od Litavky po Loděnici'])
+    stream_name: Optional[str] = Field(default=None, description='naz_tok', examples=['Červený potok'])
+    stream_name_2: Optional[str] = Field(default=None, description='naz_tok_2', examples=[''])
+
+
+class LocationType(BaseModel):
+    # Lokalita
+    ruian_adm: Optional[int] = Field(default=None, description='Kód adresního místa RUIAN', examples=[21844895])
+    ruian_adm_name: Optional[str] = Field(default=None, description='Název adresního místa RUIAN', examples=['Kaplanova 1931/1, 14800 Praha 11'])
+    basin: Optional[BasinType] = Field(default=None, description='Povodí')
+    sheet50: Optional[MapSheet50Type] = Field(default=None, description='Mapový list')
+    street: Optional[str] = Field(default=None, description='Ulice nebo část obce a číslo popisné, evidenční, orientační', examples=['Kolmá 53/1230'])
+    city: Optional[str] = Field(default=None, description='Název obce', examples=['Slepičí Lhota'])
+    zip: Optional[str] = Field(default=None, description='PSČ', examples=['987 22'])
+    region: Optional[str] = Field(default=None, description='Kraj', examples=['Středočeský kraj'])
+    country: Optional[CodeValueType] = Field(default=None, description='Stát', examples=[{'code': 'SK', 'value': 'Slovensko'}])
+    address_list: Optional[list[str]] = Field(default=None, description='Seznam adresních položek', examples=['Kolmá 53/1230', 'Slepičí Lhota', '987 22', 'CZ'])
+    note: Optional[str] = Field(default=None, description='Poznámka', examples=['Parcela číslo 113/7'])
+    wgs: Optional[GeoPointType] = Field(default=None, description='WGS84')
+    jtsk: Optional[GeoPointJtskType] = Field(default=None, description='JTSK')
+
+
+class PersonBaseType(BaseModel):
+    # Osoba z Registru osob
+    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')
+    ico: Optional[str] = Field(default=None, description='IČO osoby')
+    name: Optional[str] = Field(default=None, description='Název osoby', examples=['B.A.R. Reptofilia'])
+    email: Optional[EmailStr] = Field(default=None, description='Email osoby')
+    address: Optional[str] = Field(default=None, description='Adresa osoby', examples=['Ulice Závodu Míru 2\n87423 Otrokovice'])
+    country: Optional[CodeValueType] = Field(default=None, description='Země adresy osoby')
+    main_person: Optional[LinkedType] = Field(default=None, description='Odkaz na hlavní osobu do registru')
+    linked_persons: Optional[list[LinkedType]] = Field(default=None, description='Odkaz na další osoby do registru')
+
+
+class WorkflowType(BaseModel):
+    # Položka životního cyklu
+    node_code: Optional[str] = Field(default=None, description='Kód schvalovacího  uzlu (APPROVE, AUTHORIZE, REJECT, ...)', examples=['APPROVE', 'AUTHORIZE', 'REJECT'])
+    node_name: Optional[str] = Field(default=None, description='Název schvalovacího  uzlu (schválení, autorizace, ...)', examples=['Schválení'])
+    responsible: Optional[PersonBaseType] = Field(default=None, description='Odpovědná osoba')
+    date_execution: Optional[datetime] = Field(default=local_now(), description='Datum provedení')
+    executor: Optional[UserType] = Field(default='SYSTEM', description='Uživatel, který provedl událost')
+    status_from: Optional[str] = Field(default=None, description='Předchozí stav')
+    status_to: Optional[str] = Field(default=None, description='Následný stav')

{sysnet_pyutils-1.0.8.dist-info → sysnet_pyutils-1.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: sysnet-pyutils
-Version: 1.0.8
+Version: 1.1.1
 Summary: Python Utilities
 Author-email: Data Developer <info@sysnet.cz>
 Project-URL: Homepage, https://github.com/SYSNET-CZ/pyutils
@@ -21,6 +21,7 @@ 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
 
 # sysnet-pyutils
 
@@ -322,6 +323,15 @@ Vhodné pro MongoDB pro ukládání položek typu datum.
 Kontrola validity emailové adresy
 * param email: hodnota 
 * return: True/False
+--------------------------------------------------------------------------------------------------------------------------------
+
+### verze 1.1.0
+
+* #### Přidán obecný datový slovník SYSNET do balíku models.general
+
+Datový slovník je vytvořen pomocí pydantic a je plně kompatibilní s FastAPI. 
+Obsahuje základní datové typy, které se používají ve všech aplikacích SYSNET. 
+
 
 
 ## Systémové proměnné

{sysnet_pyutils-1.0.8.dist-info → sysnet_pyutils-1.1.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 sysnet_pyutils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sysnet_pyutils/barcode.py,sha256=5dM1ISvVVP966JQxGiZBUYJoPx_jgzWEpEQ2uIOxTd4,2622
-sysnet_pyutils/data_utils.py,sha256=isIlaEKIGK2_7my06oTAcvxCwTMCXy0g83HPbAl-V_Y,9660
+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
@@ -8,8 +8,10 @@ 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-1.0.8.dist-info/LICENSE,sha256=bx5iLIKjgAdYQ7sISn7DsfHRKkoCUm1154sJJKhgqnU,35184
-sysnet_pyutils-1.0.8.dist-info/METADATA,sha256=B3ShZ6xRs2VbdtYtehJplL6DLielN95s8t20N1jYnXw,14307
-sysnet_pyutils-1.0.8.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-sysnet_pyutils-1.0.8.dist-info/top_level.txt,sha256=ZKTltQWbLlWBXw4oovo1w7ui-JQ1WoyECqMSWdBj6XE,15
-sysnet_pyutils-1.0.8.dist-info/RECORD,,
+sysnet_pyutils/models/__init__.py,sha256=oozOr_DKhenkM9BDaPOmtbLXhP5vtMUCjBPEjZDW4GQ,167
+sysnet_pyutils/models/general.py,sha256=jqvPoKa6jKXfPLubNSSJZpSpIUG5Sw8A_zwDRlEp8VQ,14706
+sysnet_pyutils-1.1.1.dist-info/LICENSE,sha256=bx5iLIKjgAdYQ7sISn7DsfHRKkoCUm1154sJJKhgqnU,35184
+sysnet_pyutils-1.1.1.dist-info/METADATA,sha256=lj6VZ1NHlDcVLQSoOBr11_XSOVULaF3DTA4IotTnHeY,14744
+sysnet_pyutils-1.1.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+sysnet_pyutils-1.1.1.dist-info/top_level.txt,sha256=ZKTltQWbLlWBXw4oovo1w7ui-JQ1WoyECqMSWdBj6XE,15
+sysnet_pyutils-1.1.1.dist-info/RECORD,,