amochka 0.1.2.1__tar.gz → 0.1.4__tar.gz

{amochka-0.1.2.1 → amochka-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: amochka
-Version: 0.1.2.1
+Version: 0.1.4
 Summary: Библиотека для работы с API amoCRM
 Home-page: UNKNOWN
 Author: Timurka

{amochka-0.1.2.1 → amochka-0.1.4}/amochka/client.py

@@ -22,7 +22,7 @@ class Deal(dict):
 
     Обеспечивает два способа доступа к кастомным полям:
       1. get(key): при обращении по названию (строкой) или по ID поля (integer)
-         возвращает текстовое значение поля (например, «Гурина Юлия»).
+         возвращает текстовое значение поля (например, «Дурина Юлия»).
       2. get_id(key): возвращает идентификатор выбранного варианта (enum_id) для полей типа select.
          Если в данных enum_id отсутствует, производится поиск в переданной конфигурации полей,
          сравнение выполняется без учёта регистра и лишних пробелов.
@@ -41,9 +41,11 @@ class Deal(dict):
                 values = field.get("values")
                 if field_name and values and isinstance(values, list) and len(values) > 0:
                     key_name = field_name.lower().strip()
-                    # Сохраняем текстовое значение для доступа по названию
-                    self._custom[key_name] = values[0].get("value")
-                    logger.debug(f"Set custom field '{key_name}' = {self._custom[key_name]}")
+                    stored_value = values[0].get("value")
+                    stored_enum_id = values[0].get("enum_id")  # может быть None для некоторых полей
+                    # Сохраняем полную информацию (и для get() и для get_id())
+                    self._custom[key_name] = {"value": stored_value, "enum_id": stored_enum_id}
+                    logger.debug(f"Set custom field '{key_name}' = {{'value': {stored_value}, 'enum_id': {stored_enum_id}}}")
                 field_id = field.get("field_id")
                 if field_id is not None and values and isinstance(values, list) and len(values) > 0:
                     stored_value = values[0].get("value")
@@ -80,7 +82,7 @@ class Deal(dict):
     def get_id(self, key, default=None):
         """
         Возвращает идентификатор выбранного варианта (enum_id) для кастомного поля.
-        Если значение enum_id отсутствует в данных, производится поиск в конфигурации полей,
+        Если значение enum_id отсутствует в данных, производится поиск в конфигурации кастомных полей,
         сравнение значения выполняется без учёта регистра и пробелов.
 
         :param key: Название поля (строка) или ID поля (integer).
@@ -99,7 +101,6 @@ class Deal(dict):
             enum_id = stored.get("enum_id")
             if enum_id is not None:
                 return enum_id
-            # Если enum_id отсутствует, пробуем найти его в конфигурации кастомных полей
             if self._custom_config:
                 field_def = None
                 if isinstance(key, int):
@@ -112,7 +113,6 @@ class Deal(dict):
                 if field_def:
                     enums = field_def.get("enums") or []
                     for enum in enums:
-                        # Сравниваем текстовое значение без учёта регистра и лишних пробелов
                         if enum.get("value", "").lower().strip() == stored.get("value", "").lower().strip():
                             return enum.get("id", default)
         return default
@@ -132,23 +132,45 @@ class AmoCRMClient:
     Дополнительно можно задать уровень логирования через параметр log_level,
     либо полностью отключить логирование, установив disable_logging=True.
     """
-    def __init__(self, base_url, token_file=None, cache_file=None, log_level=logging.INFO, disable_logging=False):
+    def __init__(
+        self, 
+        base_url, 
+        token_file=None, 
+        cache_file=None, 
+        log_level=logging.INFO, 
+        disable_logging=False,
+        cache_enabled=True,
+        cache_storage='file',         # 'file' или 'memory'
+        cache_hours=24                # время жизни кэша в часах, или None для бесконечного кэша
+    ):
         """
-        Инициализирует клиента, задавая базовый URL, токен авторизации и файл кэша для кастомных полей.
-
+        Инициализирует клиента, задавая базовый URL, токен авторизации и настройки кэша для кастомных полей.
+        
         :param base_url: Базовый URL API amoCRM.
         :param token_file: Файл, содержащий токен авторизации.
         :param cache_file: Файл для кэширования данных кастомных полей.
         :param log_level: Уровень логирования (например, logging.DEBUG, logging.INFO).
         :param disable_logging: Если True, логирование будет отключено.
+        :param cache_enabled: Если False, кэширование отключается (остальные параметры игнорируются).
+        :param cache_storage: 'file' для файлового кэша, 'memory' для кэша только в оперативной памяти.
+        :param cache_hours: Время жизни кэша в часах. Если None – кэш считается бесконечным.
         """
         self.base_url = base_url.rstrip('/')
         domain = self.base_url.split("//")[-1].split(".")[0]
         self.domain = domain
         self.token_file = token_file or os.path.join(os.path.expanduser('~'), '.amocrm_token.json')
-        if not cache_file:
-            cache_file = f"custom_fields_cache_{self.domain}.json"
-        self.cache_file = cache_file
+        
+        # Если выбран файловый кэш, определяем имя файла, иначе он не используется
+        if cache_storage.lower() == 'file':
+            if not cache_file:
+                cache_file = f"custom_fields_cache_{self.domain}.json"
+            self.cache_file = cache_file
+        else:
+            self.cache_file = None
+        self.cache_enabled = cache_enabled
+        self.cache_storage = cache_storage.lower()  # 'file' или 'memory'
+        self.cache_hours = cache_hours
+        
         self.token = self.load_token()
         self._custom_fields_mapping = None
 
@@ -233,10 +255,15 @@ class AmoCRMClient:
 
     def _save_custom_fields_cache(self, mapping):
         """
-        Сохраняет кэшированное отображение кастомных полей в файл.
-
-        :param mapping: Словарь с отображением кастомных полей.
+        Сохраняет кэш кастомных полей в файл, если используется файловый кэш.
+        Если кэширование отключено или выбран кэш в памяти, операция пропускается.
         """
+        if not self.cache_enabled:
+            logger.debug("Caching disabled; cache not saved.")
+            return
+        if self.cache_storage != 'file':
+            logger.debug("Using memory caching; no file cache saved.")
+            return
         cache_data = {"last_updated": time.time(), "mapping": mapping}
         with open(self.cache_file, "w") as f:
             json.dump(cache_data, f)
@@ -244,10 +271,15 @@ class AmoCRMClient:
 
     def _load_custom_fields_cache(self):
         """
-        Загружает кэш кастомных полей из файла.
-
-        :return: Кэшированные данные или None, если не удалось загрузить.
+        Загружает кэш кастомных полей из файла, если используется файловый кэш.
+        Если кэширование отключено или выбран кэш в памяти, возвращает None.
         """
+        if not self.cache_enabled:
+            logger.debug("Caching disabled; no cache loaded.")
+            return None
+        if self.cache_storage != 'file':
+            logger.debug("Using memory caching; cache will be kept in memory only.")
+            return None
         if os.path.exists(self.cache_file):
             with open(self.cache_file, "r") as f:
                 try:
@@ -259,26 +291,27 @@ class AmoCRMClient:
                     return None
         return None
 
-    def get_custom_fields_mapping(self, force_update=False, cache_duration_hours=24):
+    def get_custom_fields_mapping(self, force_update=False):
         """
         Возвращает словарь отображения кастомных полей для сделок.
-        Если данные кэшированы и не устарели, возвращает кэш; иначе выполняет серию запросов,
-        чтобы получить все страницы (с лимитом 250 полей на запрос).
-
-        :param force_update: Принудительное обновление кэша.
-        :param cache_duration_hours: Время жизни кэша в часах.
-        :return: Словарь mapping, где ключи – ID полей, а значения – их модели.
+        Если данные кэшированы и не устарели, возвращает кэш; иначе выполняет запросы для получения данных.
         """
-        if not force_update:
-            if self._custom_fields_mapping:
-                return self._custom_fields_mapping
-            cache_data = self._load_custom_fields_cache()
-            if cache_data:
-                last_updated = cache_data.get("last_updated", 0)
-                if time.time() - last_updated < cache_duration_hours * 3600:
+        if not force_update and self._custom_fields_mapping is not None:
+            return self._custom_fields_mapping
+
+        cache_data = self._load_custom_fields_cache() if self.cache_enabled else None
+        if cache_data:
+            last_updated = cache_data.get("last_updated", 0)
+            if self.cache_hours is not None:
+                if time.time() - last_updated < self.cache_hours * 3600:
                     self._custom_fields_mapping = cache_data.get("mapping")
                     logger.debug("Using cached custom fields mapping.")
                     return self._custom_fields_mapping
+            else:
+                # Бесконечный кэш – не проверяем срок
+                self._custom_fields_mapping = cache_data.get("mapping")
+                logger.debug("Using cached custom fields mapping (infinite cache).")
+                return self._custom_fields_mapping
 
         mapping = {}
         page = 1
@@ -297,7 +330,8 @@ class AmoCRMClient:
 
         logger.debug("Custom fields mapping fetched (содержимое маппинга не выводится полностью).")
         self._custom_fields_mapping = mapping
-        self._save_custom_fields_cache(mapping)
+        if self.cache_enabled:
+            self._save_custom_fields_cache(mapping)
         return mapping
 
     def find_custom_field_id(self, search_term):
@@ -347,14 +381,11 @@ class AmoCRMClient:
                 payload[key] = value
                 logger.debug(f"Standard field {key} set to {value}")
             else:
-                # Если значение integer, интерпретируем как enum_id для полей типа select,
-                # иначе как текстовое значение.
                 if isinstance(value, int):
                     field_value_dict = {"enum_id": value}
                 else:
                     field_value_dict = {"value": value}
                 try:
-                    # Если ключ уже число, считаем его field_id
                     field_id = int(key)
                     custom_fields.append({"field_id": field_id, "values": [field_value_dict]})
                     logger.debug(f"Custom field by id {field_id} set to {value}")

{amochka-0.1.2.1 → amochka-0.1.4}/amochka.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: amochka
-Version: 0.1.2.1
+Version: 0.1.4
 Summary: Библиотека для работы с API amoCRM
 Home-page: UNKNOWN
 Author: Timurka

{amochka-0.1.2.1 → amochka-0.1.4}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='amochka',
-    version='0.1.2.1',
+    version='0.1.4',
     packages=find_packages(),
     install_requires=[
          'requests',