fix linter

Author: Miskler

src/openinflation_dataclass/__init__.py

@@ -1,4 +1,4 @@
-"""Pydantic-модели для категорий, товаров и географии ретейла."""
+"""Pydantic models for products, categories, and retail geolocation."""
 
 __version__ = "0.1.0"
 

src/openinflation_dataclass/card.py

@@ -8,22 +8,22 @@
 
 
 class WholesalePrice(NetworkModel):
-    """Цена за единицу при оптовом пороге."""
+    """Wholesale unit price threshold."""
 
     from_items: int | float
     price: float
 
 
 class MetaData(NetworkModel):
-    """Дополнительные метаданные товара."""
+    """Additional product metadata."""
 
     name: str
     alias: str
     value: float | int | str
 
 
 class Card(NetworkModel):
-    """Карточка товара из источника."""
+    """Product card model from a source catalog."""
 
     sku: str
     plu: str | None
@@ -57,14 +57,14 @@ class Card(NetworkModel):
     wholesale_price: list[WholesalePrice]
     price_unit: Literal["BYN", "RUB", "USD", "EUR", "AED"]
 
-    # Гайд на единицы:
-    # Шоколад 200г:
+    # Unit guide:
+    # Chocolate 200 g:
     #   unit="PCE", available_count=15, package_quantity=0.2, package_unit="KGM"
-    # Молоко 1л:
+    # Milk 1 L:
     #   unit="PCE", available_count=10, package_quantity=1, package_unit="LTR"
-    # Картошка на развес:
+    # Potatoes by weight:
     #   unit="KGM", available_count=12.7, package_quantity=None, package_unit=None
-    # Водомат:
+    # Water vending:
     #   unit="LTR", available_count=29.2, package_quantity=0.5, package_unit="LTR"
     unit: Literal["PCE", "KGM", "LTR"]
     available_count: int | float | None
@@ -78,8 +78,14 @@ class Card(NetworkModel):
 
     @model_validator(mode="after")
     def validate_business_rules(self) -> Card:
-        if self.unit == "PCE" and self.available_count is not None and type(self.available_count) is not int:
-            raise ValueError("Для unit='PCE' поле available_count должно быть int.")
+        is_piece_unit = self.unit == "PCE"
+        has_count = self.available_count is not None
+        count_is_int = type(self.available_count) is int
+
+        if is_piece_unit and has_count and not count_is_int:
+            raise ValueError("For unit='PCE', available_count must be int.")
         if (self.package_quantity is None) != (self.package_unit is None):
-            raise ValueError("package_quantity и package_unit должны быть заполнены вместе или оба быть None.")
+            raise ValueError(
+                "package_quantity and package_unit must be set together or both set to None."
+            )
         return self

src/openinflation_dataclass/geolocation.py

@@ -13,11 +13,11 @@
 def _validate_hhmm(value: str, field_name: str) -> None:
     if re.fullmatch(r"(?:[01]\d|2[0-3]):[0-5]\d", value):
         return
-    raise ValueError(f"{field_name} должно быть во времени формата HH:MM, получено: {value!r}")
+    raise ValueError(f"{field_name} must match HH:MM format, got: {value!r}")
 
 
 class Schedule(NetworkModel):
-    """Время открытия/закрытия в формате HH:MM."""
+    """Opening/closing time in HH:MM format."""
 
     open_from: str
     closed_from: str
@@ -31,7 +31,7 @@ def validate_hhmm(cls, value: str, info: object) -> str:
 
 
 class AdministrativeUnit(NetworkModel):
-    """Административная единица, в рамках которой расположен объект."""
+    """Administrative unit where the retail entity is located."""
 
     settlement_type: Literal["village", "city"]
     name: str
@@ -43,7 +43,7 @@ class AdministrativeUnit(NetworkModel):
 
 
 class RetailUnit(NetworkModel):
-    """Торговая точка: магазин, ПВЗ или склад."""
+    """Retail entity: store, pickup point, or warehouse."""
 
     retail_type: Literal["pickup_point", "store", "warehouse"]
     code: str

src/openinflation_dataclass/serialization.py

@@ -9,13 +9,13 @@
 
 
 def to_json(value: Any, *, ensure_ascii: bool = False) -> str:
-    """Сериализует pydantic-модели/структуры в JSON-строку для передачи по сети."""
+    """Serialize pydantic models/structures to a JSON string."""
     normalized = TypeAdapter(Any).dump_python(value, mode="json")
     return json.dumps(normalized, ensure_ascii=ensure_ascii, separators=(",", ":"))
 
 
 def from_json(payload: str | bytes | bytearray, model: type[T] | Any) -> T:
-    """Десериализует JSON-строку в указанный pydantic-тип."""
+    """Deserialize a JSON payload into a target pydantic type."""
     if isinstance(payload, (bytes, bytearray)):
         payload = payload.decode("utf-8")
     raw = json.loads(payload)

src/openinflation_dataclass/tree.py

@@ -6,7 +6,7 @@
 
 
 class Category(NetworkModel):
-    """Категория товаров с иерархией вложенности."""
+    """Product category with nested children."""
 
     uid: str
     alias: str

src/openinflation_dataclass/types.py

@@ -17,9 +17,9 @@ def _bytesio_from_network(value: Any) -> BytesIO:
         try:
             raw = base64.b64decode(value.encode("ascii"), validate=True)
         except (ValueError, UnicodeEncodeError, binascii.Error) as exc:
-            raise ValueError("Некорректная base64-строка для BytesIO.") from exc
+            raise ValueError("Invalid base64 string for BytesIO.") from exc
         return BytesIO(raw)
-    raise TypeError(f"Ожидался BytesIO/base64-строка/bytes, получено: {type(value)!r}")
+    raise TypeError(f"Expected BytesIO/base64 string/bytes, got: {type(value)!r}")
 
 
 def _bytesio_to_network(value: BytesIO) -> str:
@@ -34,7 +34,7 @@ def _bytesio_to_network(value: BytesIO) -> str:
 
 
 class NetworkModel(BaseModel):
-    """Базовая pydantic-модель для сетевых сущностей."""
+    """Base pydantic model for network-facing entities."""
 
     model_config = ConfigDict(
         extra="forbid",