hiptech-toolkit 1.0.0__tar.gz

hiptech_toolkit-1.0.0/LICENSE

@@ -0,0 +1,29 @@
+HIPTECH PROPRIETARY SOFTWARE LICENSE
+
+Copyright © 2026 – Present
+HIPTECH Solution Company Limited
+All rights reserved.
+
+This software and its accompanying documentation (the "Software")
+are the exclusive and proprietary property of HIPTECH Solution
+Company Limited.
+
+No part of this Software may be copied, modified, reproduced,
+distributed, sublicensed, or transmitted in any form or by any
+means, without the prior written permission of HIPTECH Solution
+Company Limited.
+
+The Software is provided "AS IS", without warranty of any kind,
+express or implied, including but not limited to warranties of
+merchantability, fitness for a particular purpose, and
+non-infringement.
+
+In no event shall HIPTECH Solution Company Limited be liable for any
+claim, damages, or other liability, whether in an action of contract,
+tort, or otherwise, arising from, out of, or in connection with the
+Software or its use.
+
+For licensing or usage inquiries, please contact:
+
+Email: hiptech@hiptechvn.com  
+Website: https://hiptechvn.com

hiptech_toolkit-1.0.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: hiptech-toolkit
+Version: 1.0.0
+Summary: Reusable HTTP and authentication toolkit by HIPTECH
+Author-email: HIPTECH Solution Company Limited <hiptech@hiptechvn.com>
+Maintainer-email: Bùi Đức Tuấn <tuanbd@hiptechvn.com>
+Project-URL: Homepage, https://hiptechvn.com
+Project-URL: Repository, https://github.com/buiductuan-hiptech/toolkit.git
+Project-URL: Issues, https://github.com/buiductuan-hiptech/toolkit.git/issues
+Keywords: http,api,toolkit,integration,hiptech
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+<p align="center">
+  <img src="./assets/icon.png" width="160" />
+</p>
+
+<h1 align="center">HIPTECH Toolkit</h1>
+
+<p align="center">
+  Internal Python toolkit by HIPTECH Solution Company Limited
+</p>
+
+[![Odoo Version](https://img.shields.io/badge/Odoo-19.x-blue)](https://www.odoo.com)
+[![License](https://img.shields.io/badge/License-Proprietary-red)]()
+[![Status](https://img.shields.io/badge/Status-Active-green)]()
+
+**HIPTECH Toolkit** is a proprietary Python utility library developed and owned by  
+**HIPTECH Solution Company Limited**.
+
+The toolkit provides standardized, reusable components for internal software
+development, including Odoo modules, backend services, and third-party system
+integrations.
+
+---
+
+## Purpose
+
+The purpose of this library is to:
+
+- Centralize common technical utilities
+- Enforce consistent API integration patterns
+- Reduce duplicated code across projects
+- Improve maintainability and code quality
+
+This package is intended **strictly for internal or licensed use**.
+
+---
+
+## Features
+
+- HTTP client abstraction with retry and timeout handling
+- Authentication helpers (Bearer, custom headers, signatures)
+- Manager and service layers for external API integrations
+- Designed for enterprise and Odoo-based architectures
+
+---
+
+## Package Structure
+
+```text
+hiptech/
+    └── http/
+        ├── __init__.py
+        ├── auth.py
+        ├── connector.py
+        └── manager.py
+```
+
+## 🧩 Usage Example
+
+```py
+
+from hiptech.http import ConnectorRegistry
+
+
+# New Connection
+conn = ConnectorRegistry(
+    base_url="https://api.example.com",
+    token="YOUR_TOKEN"
+)
+
+response = manager.get("/v1/users")
+
+# Cleanup connection
+ConnectorRegistry.cleanup()
+
+```

hiptech_toolkit-1.0.0/README.md

@@ -0,0 +1,75 @@
+<p align="center">
+  <img src="./assets/icon.png" width="160" />
+</p>
+
+<h1 align="center">HIPTECH Toolkit</h1>
+
+<p align="center">
+  Internal Python toolkit by HIPTECH Solution Company Limited
+</p>
+
+[![Odoo Version](https://img.shields.io/badge/Odoo-19.x-blue)](https://www.odoo.com)
+[![License](https://img.shields.io/badge/License-Proprietary-red)]()
+[![Status](https://img.shields.io/badge/Status-Active-green)]()
+
+**HIPTECH Toolkit** is a proprietary Python utility library developed and owned by  
+**HIPTECH Solution Company Limited**.
+
+The toolkit provides standardized, reusable components for internal software
+development, including Odoo modules, backend services, and third-party system
+integrations.
+
+---
+
+## Purpose
+
+The purpose of this library is to:
+
+- Centralize common technical utilities
+- Enforce consistent API integration patterns
+- Reduce duplicated code across projects
+- Improve maintainability and code quality
+
+This package is intended **strictly for internal or licensed use**.
+
+---
+
+## Features
+
+- HTTP client abstraction with retry and timeout handling
+- Authentication helpers (Bearer, custom headers, signatures)
+- Manager and service layers for external API integrations
+- Designed for enterprise and Odoo-based architectures
+
+---
+
+## Package Structure
+
+```text
+hiptech/
+    └── http/
+        ├── __init__.py
+        ├── auth.py
+        ├── connector.py
+        └── manager.py
+```
+
+## 🧩 Usage Example
+
+```py
+
+from hiptech.http import ConnectorRegistry
+
+
+# New Connection
+conn = ConnectorRegistry(
+    base_url="https://api.example.com",
+    token="YOUR_TOKEN"
+)
+
+response = manager.get("/v1/users")
+
+# Cleanup connection
+ConnectorRegistry.cleanup()
+
+```

hiptech_toolkit-1.0.0/hiptech/__init__.py

@@ -0,0 +1,2 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited

hiptech_toolkit-1.0.0/hiptech/haravan/__init__.py

@@ -0,0 +1,7 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited
+
+# -*- coding: utf-8 -*-
+from .connector import HaravanAPIConnector
+
+__all__ = ["HaravanAPIConnector"]

hiptech_toolkit-1.0.0/hiptech/haravan/connector.py

@@ -0,0 +1,142 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited
+
+# -*- coding: utf-8 -*-
+import time
+import logging
+from typing import Optional, Dict
+import requests
+from ..http.connector import BaseAPIConnector
+
+_logger = logging.getLogger(__name__)
+
+
+class HaravanAPIConnector(BaseAPIConnector):
+    def __init__(
+        self,
+        base_url: str,
+        timeout: int = 30,
+        default_headers: Optional[Dict[str, str]] = None,
+        retries: int = 3,
+        backoff_factor: float = 0.5,
+        auth=None,
+        rate_limit_retry: bool = True,
+        rate_limit_max_wait: int = 60,
+    ):
+        """
+        Initialize Haravan API Connector
+        
+        Args:
+            base_url: Base URL for the API
+            timeout: Request timeout in seconds
+            default_headers: Default headers for all requests
+            retries: Number of retries on error
+            backoff_factor: Backoff factor for retry
+            auth: Authentication strategy
+            rate_limit_retry: Whether to retry on rate limit (429)
+            rate_limit_max_wait: Maximum wait time for rate limit (seconds)
+        """
+        super().__init__(
+            base_url=base_url,
+            timeout=timeout,
+            default_headers=default_headers,
+            retries=retries,
+            backoff_factor=backoff_factor,
+            auth=auth,
+        )
+        self.rate_limit_retry = rate_limit_retry
+        self.rate_limit_max_wait = rate_limit_max_wait
+
+    def _handle_rate_limit(self, response: requests.Response) -> Optional[int]:
+        """
+        Handle rate limit response by reading headers from 429 response
+        """
+        if response.status_code != 429:
+            return None
+        
+        if not self.rate_limit_retry:
+            return None
+        
+        retry_after = response.headers.get("Retry-After")
+        if retry_after:
+            try:
+                wait_time = int(retry_after)
+                # Cap at max_wait
+                wait_time = min(wait_time, self.rate_limit_max_wait)
+                _logger.warning(
+                    "Rate limit hit (429), waiting %d seconds from Retry-After header: %s",
+                    wait_time,
+                    retry_after
+                )
+                return wait_time
+            except (ValueError, TypeError) as e:
+                _logger.warning(
+                    "Invalid Retry-After header value: %s, error: %s",
+                    retry_after,
+                    e
+                )
+        
+        # Default wait time if no header available
+        default_wait = 5
+        _logger.warning(
+            "Rate limit hit (429), no Retry-After header found. "
+            "Using default wait time: %d seconds. Headers: %s",
+            default_wait,
+            dict(response.headers)
+        )
+        return default_wait
+
+    def request(
+        self,
+        method: str,
+        endpoint: str,
+        *,
+        params=None,
+        data=None,
+        json=None,
+        headers=None,
+        timeout=None,
+        max_rate_limit_retries: int = 3,
+    ):
+        """
+        Make HTTP request with rate limit handling
+        """
+        # Retry loop for rate limiting
+        rate_limit_retries = 0
+        resp = None
+        while rate_limit_retries <= max_rate_limit_retries:
+            resp = super().request(
+                method=method,
+                endpoint=endpoint,
+                params=params,
+                data=data,
+                json=json,
+                headers=headers,
+                timeout=timeout,
+            )
+
+            # Handle rate limit - read wait time from headers
+            if resp.status_code == 429:
+                wait_time = self._handle_rate_limit(resp)
+                if wait_time and rate_limit_retries < max_rate_limit_retries:
+                    time.sleep(wait_time)
+                    rate_limit_retries += 1
+                    continue
+                else:
+                    # Max retries reached or should not retry
+                    url = f"{self.base_url}/{endpoint.lstrip('/')}"
+                    _logger.error(
+                        "Rate limit exceeded after %d retries: %s %s",
+                        rate_limit_retries,
+                        method.upper(),
+                        url
+                    )
+                    # Raise error for rate limit
+                    resp.raise_for_status()
+                    return resp
+
+            return resp
+
+        if resp is None:
+            raise RuntimeError("No response received after rate limit retries")
+        return resp

hiptech_toolkit-1.0.0/hiptech/http/__init__.py

@@ -0,0 +1,7 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited
+
+# -*- coding: utf-8 -*-
+from .manager import ConnectorRegistry
+
+__all__ = ["ConnectorRegistry"]

hiptech_toolkit-1.0.0/hiptech/http/auth.py

@@ -0,0 +1,119 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited
+
+# -*- coding: utf-8 -*-
+from abc import ABC, abstractmethod
+import base64
+from typing import Dict
+
+
+class BaseAuthStrategy(ABC):
+    """
+    Base authentication strategy interface.
+
+    All authentication strategies must implement `get_headers`.
+    """
+
+    @abstractmethod
+    def get_headers(self) -> Dict[str, str]:
+        """
+        Return HTTP headers used for authentication.
+        """
+        raise NotImplementedError
+
+
+class NoAuthStrategy(BaseAuthStrategy):
+    """
+    No authentication.
+    Useful for public or internal APIs.
+    """
+
+    def get_headers(self) -> Dict[str, str]:
+        return {}
+
+
+class BasicAuthStrategy(BaseAuthStrategy):
+    """
+    HTTP Basic Authentication strategy.
+    """
+
+    def __init__(self, username: str, password: str):
+        self.username = username
+        self.password = password
+
+    def get_headers(self) -> Dict[str, str]:
+        raw = f"{self.username}:{self.password}".encode("utf-8")
+        token = base64.b64encode(raw).decode("utf-8")
+        return {
+            "Authorization": f"Basic {token}",
+        }
+
+
+class BearerAuthStrategy(BaseAuthStrategy):
+    """
+    Bearer token authentication strategy (JWT, OAuth access token, etc).
+    """
+
+    def __init__(self, token: str):
+        self.token = token
+
+    def get_headers(self) -> Dict[str, str]:
+        return {
+            "Authorization": f"Bearer {self.token}",
+        }
+
+
+class ApiKeyAuthStrategy(BaseAuthStrategy):
+    """
+    API Key authentication strategy.
+    """
+
+    def __init__(self, api_key: str, header_name: str = "X-API-KEY"):
+        self.api_key = api_key
+        self.header_name = header_name
+
+    def get_headers(self) -> Dict[str, str]:
+        return {
+            self.header_name: self.api_key,
+        }
+
+
+class OAuth2AuthStrategy(BaseAuthStrategy):
+    """
+    OAuth2 authentication strategy.
+
+    Note:
+        Token refresh / grant flow should be implemented internally
+        and NOT exposed in the public toolkit API.
+    """
+
+    def __init__(self, access_token: str):
+        self.access_token = access_token
+
+    def get_headers(self) -> Dict[str, str]:
+        return {
+            "Authorization": f"Bearer {self.access_token}",
+        }
+
+
+class CustomHeaderAuthStrategy(BaseAuthStrategy):
+    """
+    Custom header-based authentication strategy.
+    """
+
+    def __init__(self, headers: Dict[str, str]):
+        self.headers = dict(headers)
+
+    def get_headers(self) -> Dict[str, str]:
+        return dict(self.headers)
+
+
+__all__ = [
+    "BaseAuthStrategy",
+    "NoAuthStrategy",
+    "BasicAuthStrategy",
+    "BearerAuthStrategy",
+    "ApiKeyAuthStrategy",
+    "OAuth2AuthStrategy",
+    "CustomHeaderAuthStrategy",
+]

hiptech_toolkit-1.0.0/hiptech/http/connector.py

@@ -0,0 +1,109 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited
+
+
+# -*- coding: utf-8 -*-
+import time
+import logging
+from typing import Any, Dict, Optional
+import requests
+from requests.adapters import HTTPAdapter
+from urllib3.util.retry import Retry
+
+_logger = logging.getLogger(__name__)
+
+
+class BaseAPIConnector:
+    def __init__(
+        self,
+        base_url: str,
+        timeout: int = 30,
+        default_headers: Optional[Dict[str, str]] = None,
+        retries: int = 3,
+        backoff_factor: float = 0.5,
+        auth=None,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.default_headers = default_headers or {}
+        self.auth = auth
+
+        self.session = requests.Session()
+        self._init_retry(retries, backoff_factor)
+
+    def _init_retry(self, retries: int, backoff_factor: float):
+        retry = Retry(
+            total=retries,
+            read=retries,
+            connect=retries,
+            status=retries,
+            backoff_factor=backoff_factor,
+            status_forcelist=(429, 500, 502, 503, 504),
+            allowed_methods=frozenset(
+                ["GET", "POST", "PUT", "DELETE", "PATCH"]),
+            raise_on_status=False,
+        )
+        adapter = HTTPAdapter(
+            max_retries=retry, pool_connections=10, pool_maxsize=10)
+        self.session.mount("http://", adapter)
+        self.session.mount("https://", adapter)
+
+    def build_headers(self) -> Dict[str, str]:
+        headers = {}
+        headers.update(self.default_headers)
+
+        if self.auth:
+            headers.update(self.auth.get_headers())
+
+        return headers
+
+    def request(
+        self,
+        method: str,
+        endpoint: str,
+        *,
+        params=None,
+        data=None,
+        json=None,
+        headers=None,
+        timeout=None,
+    ):
+        url = f"{self.base_url}/{endpoint.lstrip('/')}"
+
+        req_headers = self.build_headers()
+        if headers:
+            req_headers.update(headers)
+
+        start = time.time()
+        resp = self.session.request(
+            method=method.upper(),
+            url=url,
+            params=params,
+            data=data,
+            json=json,
+            headers=req_headers,
+            timeout=timeout or self.timeout,
+        )
+        elapsed = time.time() - start
+
+        _logger.info(
+            "API %s %s -> %s (%.2fs)",
+            method.upper(),
+            url,
+            resp.status_code,
+            elapsed,
+        )
+
+        return resp
+
+    def get(self, endpoint, **kw):
+        return self.request("GET", endpoint, **kw)
+
+    def post(self, endpoint, **kw):
+        return self.request("POST", endpoint, **kw)
+
+    def put(self, endpoint, **kw):
+        return self.request("PUT", endpoint, **kw)
+
+    def delete(self, endpoint, **kw):
+        return self.request("DELETE", endpoint, **kw)

hiptech_toolkit-1.0.0/hiptech/http/manager.py

@@ -0,0 +1,45 @@
+# Proprietary and Confidential
+# Copyright (c) HIPTECH Solution Company Limited
+
+# -*- coding: utf-8 -*-
+import time
+from threading import Lock
+from .connector import BaseAPIConnector
+from .auth import BasicAuthStrategy
+
+
+class ConnectorRegistry:
+    _lock = Lock()
+    _cache = {}
+    _last_used = {}
+    _TTL = 60 * 30
+
+    @classmethod
+    def factory(cls, base_url, username, password):
+        key = (base_url, username)
+
+        now = time.time()
+        with cls._lock:
+            conn = cls._cache.get(key)
+
+            if not conn:
+                auth = BasicAuthStrategy(username, password)
+                conn = BaseAPIConnector(base_url=base_url, auth=auth)
+                cls._cache[key] = conn
+
+            cls._last_used[key] = now
+            return conn
+
+    @classmethod
+    def cleanup(cls):
+        now = time.time()
+        with cls._lock:
+            for key in list(cls._cache.keys()):
+                last = cls._last_used.get(key, 0)
+                if now - last > cls._TTL:
+                    conn = cls._cache.pop(key)
+                    cls._last_used.pop(key, None)
+                    try:
+                        conn.session.close()
+                    except Exception:
+                        pass

hiptech_toolkit-1.0.0/hiptech_toolkit.egg-info/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: hiptech-toolkit
+Version: 1.0.0
+Summary: Reusable HTTP and authentication toolkit by HIPTECH
+Author-email: HIPTECH Solution Company Limited <hiptech@hiptechvn.com>
+Maintainer-email: Bùi Đức Tuấn <tuanbd@hiptechvn.com>
+Project-URL: Homepage, https://hiptechvn.com
+Project-URL: Repository, https://github.com/buiductuan-hiptech/toolkit.git
+Project-URL: Issues, https://github.com/buiductuan-hiptech/toolkit.git/issues
+Keywords: http,api,toolkit,integration,hiptech
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+<p align="center">
+  <img src="./assets/icon.png" width="160" />
+</p>
+
+<h1 align="center">HIPTECH Toolkit</h1>
+
+<p align="center">
+  Internal Python toolkit by HIPTECH Solution Company Limited
+</p>
+
+[![Odoo Version](https://img.shields.io/badge/Odoo-19.x-blue)](https://www.odoo.com)
+[![License](https://img.shields.io/badge/License-Proprietary-red)]()
+[![Status](https://img.shields.io/badge/Status-Active-green)]()
+
+**HIPTECH Toolkit** is a proprietary Python utility library developed and owned by  
+**HIPTECH Solution Company Limited**.
+
+The toolkit provides standardized, reusable components for internal software
+development, including Odoo modules, backend services, and third-party system
+integrations.
+
+---
+
+## Purpose
+
+The purpose of this library is to:
+
+- Centralize common technical utilities
+- Enforce consistent API integration patterns
+- Reduce duplicated code across projects
+- Improve maintainability and code quality
+
+This package is intended **strictly for internal or licensed use**.
+
+---
+
+## Features
+
+- HTTP client abstraction with retry and timeout handling
+- Authentication helpers (Bearer, custom headers, signatures)
+- Manager and service layers for external API integrations
+- Designed for enterprise and Odoo-based architectures
+
+---
+
+## Package Structure
+
+```text
+hiptech/
+    └── http/
+        ├── __init__.py
+        ├── auth.py
+        ├── connector.py
+        └── manager.py
+```
+
+## 🧩 Usage Example
+
+```py
+
+from hiptech.http import ConnectorRegistry
+
+
+# New Connection
+conn = ConnectorRegistry(
+    base_url="https://api.example.com",
+    token="YOUR_TOKEN"
+)
+
+response = manager.get("/v1/users")
+
+# Cleanup connection
+ConnectorRegistry.cleanup()
+
+```

hiptech_toolkit-1.0.0/hiptech_toolkit.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+hiptech/__init__.py
+hiptech/haravan/__init__.py
+hiptech/haravan/connector.py
+hiptech/http/__init__.py
+hiptech/http/auth.py
+hiptech/http/connector.py
+hiptech/http/manager.py
+hiptech_toolkit.egg-info/PKG-INFO
+hiptech_toolkit.egg-info/SOURCES.txt
+hiptech_toolkit.egg-info/dependency_links.txt
+hiptech_toolkit.egg-info/requires.txt
+hiptech_toolkit.egg-info/top_level.txt

hiptech_toolkit-1.0.0/hiptech_toolkit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hiptech_toolkit-1.0.0/hiptech_toolkit.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28

hiptech_toolkit-1.0.0/hiptech_toolkit.egg-info/top_level.txt

@@ -0,0 +1 @@
+hiptech

hiptech_toolkit-1.0.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hiptech-toolkit"
+version = "1.0.0"
+description = "Reusable HTTP and authentication toolkit by HIPTECH"
+readme = "README.md"
+requires-python = ">=3.9"
+license-files = ["LICENSE"]
+authors = [{ name = "HIPTECH Solution Company Limited", email = "hiptech@hiptechvn.com" }]
+maintainers = [
+    {name = "Bùi Đức Tuấn", email="tuanbd@hiptechvn.com"},
+]
+keywords = ["http", "api", "toolkit", "integration", "hiptech"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+dependencies = [
+  "requests>=2.28",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["hiptech*"]
+
+[project.urls]
+Homepage = "https://hiptechvn.com"
+Repository = "https://github.com/buiductuan-hiptech/toolkit.git"
+Issues = "https://github.com/buiductuan-hiptech/toolkit.git/issues"

hiptech_toolkit-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+