nomenclature-sdk 1.0.5__cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

nomenclature_sdk/__init__.py

@@ -0,0 +1,24 @@
+from .client import NomenclatureClient
+from .models import (
+    ConnectionOptions,
+    DBInfo,
+    NomenclatureKey,
+    NomenclatureItem,
+    NomenclatureFoundStatus,
+    FieldCompareResult,
+    NomenclatureCheckResult,
+)
+from .errors import ConnectionError, QueryError
+
+__all__ = [
+    "NomenclatureClient",
+    "ConnectionOptions",
+    "DBInfo",
+    "NomenclatureKey",
+    "NomenclatureItem",
+    "NomenclatureFoundStatus",
+    "FieldCompareResult",
+    "NomenclatureCheckResult",
+    "ConnectionError",
+    "QueryError",
+]

nomenclature_sdk/__init__.pyi

@@ -0,0 +1,5 @@
+from .client import NomenclatureClient as NomenclatureClient
+from .errors import ConnectionError as ConnectionError, QueryError as QueryError
+from .models import ConnectionOptions as ConnectionOptions, DBInfo as DBInfo, FieldCompareResult as FieldCompareResult, NomenclatureCheckResult as NomenclatureCheckResult, NomenclatureFoundStatus as NomenclatureFoundStatus, NomenclatureItem as NomenclatureItem, NomenclatureKey as NomenclatureKey
+
+__all__ = ['NomenclatureClient', 'ConnectionOptions', 'DBInfo', 'NomenclatureKey', 'NomenclatureItem', 'NomenclatureFoundStatus', 'FieldCompareResult', 'NomenclatureCheckResult', 'ConnectionError', 'QueryError']

nomenclature_sdk/_internal.pyi

@@ -0,0 +1,6 @@
+from .errors import QueryError as QueryError
+from .models import DBInfo as DBInfo, FieldCompareResult as FieldCompareResult, NomenclatureCheckResult as NomenclatureCheckResult, NomenclatureFoundStatus as NomenclatureFoundStatus, NomenclatureItem as NomenclatureItem, NomenclatureKey as NomenclatureKey
+
+def fetch_db_info(conn) -> DBInfo: ...
+def get_field_compare_result(input_value: str, nomenclature_value: str) -> FieldCompareResult: ...
+def check_nomenclature(conn, items: list[NomenclatureItem]) -> list[NomenclatureCheckResult]: ...

nomenclature_sdk/client.pyi

@@ -0,0 +1,8 @@
+from ._internal import check_nomenclature as check_nomenclature, fetch_db_info as fetch_db_info
+from .connection import open_connection as open_connection
+from .models import ConnectionOptions as ConnectionOptions, DBInfo as DBInfo, NomenclatureCheckResult as NomenclatureCheckResult, NomenclatureItem as NomenclatureItem
+
+class NomenclatureClient:
+    def __init__(self, options: ConnectionOptions) -> None: ...
+    def get_db_info(self) -> DBInfo: ...
+    def check_nomenclature(self, items: list[NomenclatureItem]) -> list[NomenclatureCheckResult]: ...

nomenclature_sdk/connection.pyi

@@ -0,0 +1,4 @@
+from .errors import ConnectionError as ConnectionError
+from .models import ConnectionOptions as ConnectionOptions
+
+def open_connection(opts: ConnectionOptions): ...

nomenclature_sdk/errors.py

@@ -0,0 +1,9 @@
+class SDKError(Exception):
+    """Базовая ошибка SDK"""
+
+class ConnectionError(SDKError):
+    pass
+
+
+class QueryError(SDKError):
+    pass

nomenclature_sdk/errors.pyi

@@ -0,0 +1,3 @@
+class SDKError(Exception): ...
+class ConnectionError(SDKError): ...
+class QueryError(SDKError): ...

nomenclature_sdk/models.py

@@ -0,0 +1,128 @@
+from dataclasses import dataclass
+from typing import List, Optional
+from enum import Enum
+
+@dataclass(frozen=True)
+class ConnectionOptions:
+    """
+    Опции для подключения к базе данных
+
+    Attributes:
+        server: Имя или IP-адрес сервера БД.
+        database: Имя базы данных, к которой выполняется подключение.
+        user: Имя пользователя SQL Server.
+        password: Пароль пользователя.
+        encrypt: Использовать ли шифрование соединения (TLS).
+        port: TCP-порт SQL Server. По умолчанию: 1433.
+        trust_server_certificate: Доверять ли сертификату сервера без проверки цепочки.
+        timeout: Таймаут подключения в секундах.
+    """
+    server: str
+    database: str
+    user: str
+    password: str
+    encrypt: bool = True
+    port: int = 1433
+    trust_server_certificate: bool = False
+    timeout: int = 5
+
+@dataclass(frozen=True)
+class DBInfo:
+    """
+    Информация о базе данных
+
+    Attributes:
+        nomenclature_count_rows: Количество записей в номенклатурном справочнике.
+        manufacturer_synonym_count_rows: Количество синонимов для производителей.
+        user_fields: Пользовательские поля
+    """
+    nomenclature_count_rows: int
+    manufacturer_synonym_count_rows: int
+    user_fields: List[str]
+
+@dataclass(frozen=True)
+class NomenclatureKey:
+    """
+    Ключ номенклатуры.
+
+    Attributes:
+        manufacturer: Производитель товара.
+        identifier: Идентификатор товара.
+    """
+    manufacturer: str
+    identifier: str
+
+@dataclass(frozen=True)
+class NomenclatureItem:
+    """
+    Товар номенклатуры.
+
+    Attributes:
+        key: Ключ номенклатуры.
+        article: Артикул.
+        arths_codeicle: Код ТН ВЭД.
+        product_name: Наименвоание товара.
+        product_details: Характеристики товара.
+        product_model: Модель товара.
+        product_brand: Марка товара.
+    """
+    key: NomenclatureKey
+    article: Optional[str]
+    hs_code: Optional[str]
+    product_name: Optional[str]
+    product_details: Optional[str] = None
+    product_model: Optional[str] = None
+    product_brand: Optional[str] = None
+
+class NomenclatureFoundStatus(Enum):
+    """
+    Статус найденности.
+
+    Attributes:
+        FOUND_BY_MANUFACTURER_AND_IDENTIFIER = 1: Товар найден по производителю и идентификатору.
+        FOUND_BY_MANUFACTURER_SYNONYM_AND_IDENTIFIER = 2: Товар найден по синониму производителя и идентификатору.
+        NOT_FOUND = 3: Товар не найден.
+    """
+    FOUND_BY_MANUFACTURER_AND_IDENTIFIER = 1
+    FOUND_BY_MANUFACTURER_SYNONYM_AND_IDENTIFIER = 2
+    NOT_FOUND = 3
+
+@dataclass(frozen=True)
+class FieldCompareResult:
+    """
+    Результат сравнения поля.
+
+    Attributes:
+        input_value: Входящие данные.
+        nomenclature_value: Данные из номенклатурного справочника.
+        is_equal: Данные идентичны.
+    """
+    input_value: str
+    nomenclature_value: str
+    is_equal: bool
+
+@dataclass(frozen=True)
+class NomenclatureCheckResult:
+    """
+    Результат сравнения товара.
+
+    Attributes:
+        key: люч номенклатуры.
+        article: Артикул.
+        arths_codeicle: Код ТН ВЭД.
+        product_name: Наименвоание товара.
+        product_details: Характеристики товара.
+        product_model: Модель товара.
+        product_brand: Марка товара.
+        found_status: Статус найденности.
+        is_equal: Данные идентичны.
+    """
+    key: NomenclatureKey
+    article: FieldCompareResult
+    hs_code: FieldCompareResult
+    product_name: FieldCompareResult
+    product_details: FieldCompareResult
+    product_model: FieldCompareResult
+    product_brand: FieldCompareResult
+    found_status: NomenclatureFoundStatus
+    is_equal: bool

nomenclature_sdk/models.pyi

@@ -0,0 +1,57 @@
+from dataclasses import dataclass
+from enum import Enum
+
+@dataclass(frozen=True)
+class ConnectionOptions:
+    server: str
+    database: str
+    user: str
+    password: str
+    encrypt: bool = ...
+    port: int = ...
+    trust_server_certificate: bool = ...
+    timeout: int = ...
+
+@dataclass(frozen=True)
+class DBInfo:
+    nomenclature_count_rows: int
+    manufacturer_synonym_count_rows: int
+    user_fields: list[str]
+
+@dataclass(frozen=True)
+class NomenclatureKey:
+    manufacturer: str
+    identifier: str
+
+@dataclass(frozen=True)
+class NomenclatureItem:
+    key: NomenclatureKey
+    article: str | None
+    hs_code: str | None
+    product_name: str | None
+    product_details: str | None = ...
+    product_model: str | None = ...
+    product_brand: str | None = ...
+
+class NomenclatureFoundStatus(Enum):
+    FOUND_BY_MANUFACTURER_AND_IDENTIFIER = 1
+    FOUND_BY_MANUFACTURER_SYNONYM_AND_IDENTIFIER = 2
+    NOT_FOUND = 3
+
+@dataclass(frozen=True)
+class FieldCompareResult:
+    input_value: str
+    nomenclature_value: str
+    is_equal: bool
+
+@dataclass(frozen=True)
+class NomenclatureCheckResult:
+    key: NomenclatureKey
+    article: FieldCompareResult
+    hs_code: FieldCompareResult
+    product_name: FieldCompareResult
+    product_details: FieldCompareResult
+    product_model: FieldCompareResult
+    product_brand: FieldCompareResult
+    found_status: NomenclatureFoundStatus
+    is_equal: bool

nomenclature_sdk-1.0.5.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: nomenclature_sdk
+Version: 1.0.5
+Description-Content-Type: text/markdown
+Requires-Dist: pyodbc
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+
+# SDK for nomenclature reference book

nomenclature_sdk-1.0.5.dist-info/RECORD

@@ -0,0 +1,18 @@
+nomenclature_sdk/__init__.py,sha256=Bu4OpP2NX0qgbak_9aaAmYmLmmtgut7rvgkFgWWv034,526
+nomenclature_sdk/__init__.pyi,sha256=3uIUMgRVAa8NhKSTyViaHYdlBTrBLhHsxzvm0EcgawM,652
+nomenclature_sdk/_internal.cpython-310-x86_64-linux-gnu.so,sha256=9qbu0nA52NtIKqDLNLPEZtmAjJCuhWIXvT6LZ9VYnDo,650976
+nomenclature_sdk/_internal.pyi,sha256=DMlWAZQAHv4oC4Nxn0TXWMzSX1BTS72ewK6qXbHn4SM,539
+nomenclature_sdk/client.cpython-310-x86_64-linux-gnu.so,sha256=WeuJZElnsd2b4I9gNybinj9m6NscR54MTp4Vz32-8sc,363200
+nomenclature_sdk/client.pyi,sha256=AMRuFP0sQSZMJlTPuBJlavHUNE-SfezjjTAcPSo-gSo,556
+nomenclature_sdk/connection.cpython-310-x86_64-linux-gnu.so,sha256=gv1qkmnxvjV9LqE-OKuvMoFctgb-cdqpuDm4uMR3oR0,359064
+nomenclature_sdk/connection.pyi,sha256=e5bdhi0JNc5WvBN_PwVqcpgA1Ps4PlDZ7-6JTzxB8kA,165
+nomenclature_sdk/errors.py,sha256=kH9GaerHr0tzWQhA5HQ7axOVdU9a-Uf9d5aGmbMgNs0,150
+nomenclature_sdk/errors.pyi,sha256=CMiixLBEyXFL-TxoF4guGESeyfCBWEXm_4n5FtOAUng,100
+nomenclature_sdk/models.py,sha256=KyUribTZSS9eFnWKFmEHz-2Gu_oQAzaSUAEagjG4k8k,4510
+nomenclature_sdk/models.pyi,sha256=rZkKnZS8uQ-kQnOdhPG4QCgzrQsWhVSMeTsi7yG2Z2w,1403
+nomenclature_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nomenclature_sdk-1.0.5.dist-info/METADATA,sha256=jRVx-Aif85I0rj2WAQ6tvqHP2nfmx6eCCNxOcuSREFE,239
+nomenclature_sdk-1.0.5.dist-info/WHEEL,sha256=DZl4yYurviXJJQsilHH1qAzCRDsdz--oNtDZ-hUrZUk,190
+nomenclature_sdk-1.0.5.dist-info/top_level.txt,sha256=uHbf-ALtRk-W-p4cK_15xxDvMUsTDfA53i-3VXJ2woU,23
+nomenclature_sdk-1.0.5.dist-info/RECORD,,

nomenclature_sdk-1.0.5.dist-info/WHEEL

@@ -0,0 +1,7 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-manylinux_2_17_x86_64
+Tag: cp310-cp310-manylinux2014_x86_64
+Tag: cp310-cp310-manylinux_2_28_x86_64
+

nomenclature_sdk-1.0.5.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+nomenclature_sdk
+tests