pybinbot 0.4.4__tar.gz

pybinbot-0.4.4/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS 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 THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pybinbot-0.4.4/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

pybinbot-0.4.4/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: pybinbot
+Version: 0.4.4
+Summary: Utility functions for the binbot project.
+Author-email: Carlos Wu <carkodw@gmail.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic[email]>=2.0.0
+Requires-Dist: numpy==2.2.0
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: pymongo==4.6.3
+Requires-Dist: pandas-stubs>=2.3.3.251219
+Requires-Dist: requests>=2.32.5
+Requires-Dist: kucoin-universal-sdk>=1.3.0
+Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: python-dotenv>=1.2.1
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.2; extra == "dev"
+Requires-Dist: ruff>=0.11.12; extra == "dev"
+Requires-Dist: mypy>=1.19.1; extra == "dev"
+Requires-Dist: types-requests>=2.32.4.20260107; extra == "dev"
+Requires-Dist: httpx>=0.28.1; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.3.0; extra == "dev"
+Dynamic: license-file
+
+# PyBinbot
+
+Utility functions for the binbot project. Most of the code here is not runnable, there's no server or individual scripts, you simply move code to here when it's used in both binbot and binquant.
+
+``pybinbot`` is the public API module for the distribution.
+
+This module re-exports the internal ``shared`` and ``models`` packages and the most commonly used helpers and enums so consumers can simply::
+
+        from pybinbot import round_numbers, ExchangeId
+
+The implementation deliberately avoids importing heavy third-party libraries at module import time.
+
+
+## Installation
+
+```bash
+uv sync --extra dev
+```
+
+`--extra dev` also installs development tools like ruff and mypy
+
+
+## Publishing
+
+1. Save your changes and do the usual Git flow (add, commit, don't push the changes yet).
+2. Bump the version, choose one of these:
+
+```bash
+make bump-patch
+```
+or 
+
+```bash
+make bump-minor
+```
+
+or
+
+```bash
+make bump-major
+```
+
+3. Git tag the version for Github. This will read the bump version. There's a convenience command:
+```
+make tag
+```
+
+4. `git commit --amend`. This is to put these new changes in the previous commit so we don't dup uncessary commits. Then `git push`
+
+
+For further commands take a look at the `Makefile` such as testing `make test`

pybinbot-0.4.4/README.md

@@ -0,0 +1,51 @@
+# PyBinbot
+
+Utility functions for the binbot project. Most of the code here is not runnable, there's no server or individual scripts, you simply move code to here when it's used in both binbot and binquant.
+
+``pybinbot`` is the public API module for the distribution.
+
+This module re-exports the internal ``shared`` and ``models`` packages and the most commonly used helpers and enums so consumers can simply::
+
+        from pybinbot import round_numbers, ExchangeId
+
+The implementation deliberately avoids importing heavy third-party libraries at module import time.
+
+
+## Installation
+
+```bash
+uv sync --extra dev
+```
+
+`--extra dev` also installs development tools like ruff and mypy
+
+
+## Publishing
+
+1. Save your changes and do the usual Git flow (add, commit, don't push the changes yet).
+2. Bump the version, choose one of these:
+
+```bash
+make bump-patch
+```
+or 
+
+```bash
+make bump-minor
+```
+
+or
+
+```bash
+make bump-major
+```
+
+3. Git tag the version for Github. This will read the bump version. There's a convenience command:
+```
+make tag
+```
+
+4. `git commit --amend`. This is to put these new changes in the previous commit so we don't dup uncessary commits. Then `git push`
+
+
+For further commands take a look at the `Makefile` such as testing `make test`

pybinbot-0.4.4/pybinbot/__init__.py

@@ -0,0 +1,161 @@
+"""Public API for the ``pybinbot`` distribution.
+
+This package exposes a flat, convenient API for common types, enums and
+models, while still allowing access to the structured subpackages via
+``pybinbot.shared`` and ``pybinbot.models``.
+"""
+
+from pybinbot.shared.maths import (
+    format_ts,
+    interval_to_millisecs,
+    round_numbers,
+    round_numbers_ceiling,
+    round_numbers_floor,
+    supress_notation,
+    supress_trailling,
+    zero_remainder,
+)
+from pybinbot.shared.timestamps import (
+    ms_to_sec,
+    round_timestamp,
+    sec_to_ms,
+    timestamp,
+    timestamp_to_datetime,
+    ts_to_day,
+    ts_to_humandate,
+)
+from pybinbot.shared.enums import (
+    AutotradeSettingsDocument,
+    BinanceKlineIntervals,
+    BinanceOrderModel,
+    CloseConditions,
+    DealType,
+    ExchangeId,
+    KafkaTopics,
+    KucoinKlineIntervals,
+    MarketDominance,
+    OrderSide,
+    OrderStatus,
+    OrderType,
+    QuoteAssets,
+    Status,
+    Strategy,
+    TimeInForce,
+    TrendEnum,
+    UserRoles,
+)
+from pybinbot.shared.indicators import Indicators
+from pybinbot.shared.heikin_ashi import HeikinAshi
+from pybinbot.shared.logging_config import configure_logging
+from pybinbot.shared.types import Amount
+from pybinbot.shared.cache import cache
+from pybinbot.shared.handlers import handle_binance_errors, aio_response_handler
+from pybinbot.models.bot_base import BotBase
+from pybinbot.models.deal import DealBase
+from pybinbot.models.order import OrderBase
+from pybinbot.models.signals import HABollinguerSpread, SignalsConsumer
+from pybinbot.models.routes import StandardResponse
+from pybinbot.apis.binance.base import BinanceApi
+from pybinbot.apis.binbot.base import BinbotApi
+from pybinbot.apis.binbot.exceptions import (
+    BinbotErrors,
+    QuantityTooLow,
+    IsolateBalanceError,
+    DealCreationError,
+    MarginShortError,
+    MarginLoanNotFound,
+    DeleteOrderError,
+    LowBalanceCleanupError,
+    SaveBotError,
+    InsufficientBalance,
+)
+from pybinbot.apis.kucoin.base import KucoinApi
+from pybinbot.apis.kucoin.exceptions import KucoinErrors
+from pybinbot.apis.binance.exceptions import (
+    BinanceErrors,
+    InvalidSymbol,
+    NotEnoughFunds,
+)
+
+
+from . import models, shared, apis
+
+__all__ = [
+    # subpackages
+    "shared",
+    "models",
+    "apis",
+    # models
+    "BotBase",
+    "OrderBase",
+    "DealBase",
+    "StandardResponse",
+    "HABollinguerSpread",
+    "SignalsConsumer",
+    # misc
+    "Amount",
+    "configure_logging",
+    "cache",
+    "handle_binance_errors",
+    "aio_response_handler",
+    # maths helpers
+    "supress_trailling",
+    "round_numbers",
+    "round_numbers_ceiling",
+    "round_numbers_floor",
+    "supress_notation",
+    "interval_to_millisecs",
+    "format_ts",
+    "zero_remainder",
+    # timestamp helpers
+    "timestamp",
+    "round_timestamp",
+    "ts_to_day",
+    "ms_to_sec",
+    "sec_to_ms",
+    "ts_to_humandate",
+    "timestamp_to_datetime",
+    # dataframes
+    "Indicators",
+    "HeikinAshi",
+    # enums
+    "CloseConditions",
+    "KafkaTopics",
+    "DealType",
+    "BinanceOrderModel",
+    "Status",
+    "Strategy",
+    "OrderType",
+    "TimeInForce",
+    "OrderSide",
+    "OrderStatus",
+    "TrendEnum",
+    "BinanceKlineIntervals",
+    "KucoinKlineIntervals",
+    "AutotradeSettingsDocument",
+    "UserRoles",
+    "QuoteAssets",
+    "ExchangeId",
+    "HABollinguerSpread",
+    "SignalsConsumer",
+    "MarketDominance",
+    # exchange apis
+    "BinbotApi",
+    "BinanceApi",
+    "KucoinApi",
+    "KucoinErrors",
+    # exceptions
+    "BinanceErrors",
+    "InvalidSymbol",
+    "NotEnoughFunds",
+    "BinbotErrors",
+    "QuantityTooLow",
+    "IsolateBalanceError",
+    "MarginShortError",
+    "MarginLoanNotFound",
+    "DeleteOrderError",
+    "LowBalanceCleanupError",
+    "DealCreationError",
+    "SaveBotError",
+    "InsufficientBalance",
+]