ubdcc 0.3.1__py3-none-any.whl

ubdcc/__init__.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ¯\_(ツ)_/¯
+#
+# File: packages/ubdcc/ubdcc/__init__.py
+#
+# Project website: https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster
+# Github: https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster
+# Documentation: https://oliver-zehentleitner.github.io/unicorn-binance-depth-cache-cluster
+# PyPI: https://pypi.org/project/ubdcc
+#
+# License: MIT
+# https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/blob/master/LICENSE
+#
+# Author: Oliver Zehentleitner
+#
+# Copyright (c) 2024-2026, Oliver Zehentleitner (https://about.me/oliver-zehentleitner)
+# All rights reserved.
+
+__version__ = "0.2.0"

ubdcc/__main__.py

@@ -0,0 +1,3 @@
+from ubdcc.cli import main
+
+main()

ubdcc/cli.py

@@ -0,0 +1,534 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ¯\_(ツ)_/¯
+#
+# File: packages/ubdcc/ubdcc/cli.py
+#
+# Project website: https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster
+# Github: https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster
+# Documentation: https://oliver-zehentleitner.github.io/unicorn-binance-depth-cache-cluster
+# PyPI: https://pypi.org/project/ubdcc
+#
+# License: MIT
+# https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/blob/master/LICENSE
+#
+# Author: Oliver Zehentleitner
+#
+# Copyright (c) 2024-2026, Oliver Zehentleitner (https://about.me/oliver-zehentleitner)
+# All rights reserved.
+
+import argparse
+import os
+import signal
+import socket
+import subprocess
+import sys
+import time
+
+import requests
+
+from ubdcc import __version__
+
+STATE_FILE = ".ubdcc"
+DEFAULT_MGMT_PORT = 42080
+
+
+def save_port(port):
+    with open(STATE_FILE, "w") as f:
+        f.write(str(port))
+
+
+def load_port():
+    try:
+        with open(STATE_FILE, "r") as f:
+            return int(f.read().strip())
+    except (FileNotFoundError, ValueError):
+        return None
+
+
+def get_mgmt_port(args):
+    """Resolve mgmt port: --port flag > state file > default."""
+    if args.port is not None:
+        return args.port
+    saved = load_port()
+    if saved is not None:
+        return saved
+    return DEFAULT_MGMT_PORT
+
+
+def is_port_free(port, host='127.0.0.1'):
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        try:
+            s.bind((host, port))
+            return True
+        except OSError:
+            return False
+
+
+def find_free_port(start=42080):
+    port = start
+    while not is_port_free(port):
+        port += 1
+    return port
+
+
+def wait_for_cluster(mgmt_port, expected_pods, timeout=120):
+    """Poll get_cluster_info until all expected pods are registered."""
+    url = f"http://127.0.0.1:{mgmt_port}/get_cluster_info"
+    start_time = time.time()
+    while time.time() - start_time < timeout:
+        try:
+            response = requests.get(url, timeout=5)
+            data = response.json()
+            if data.get('result') == 'OK' and data.get('db', {}).get('pods'):
+                registered = len(data['db']['pods'])
+                if registered >= expected_pods:
+                    return data
+        except (requests.exceptions.ConnectionError, requests.exceptions.Timeout):
+            pass
+        time.sleep(1)
+    return None
+
+
+def cmd_start(args):
+    mgmt_port = args.port if args.port else find_free_port(DEFAULT_MGMT_PORT)
+    dcn_count = args.dcn
+    logdir = args.logdir if args.logdir else os.getcwd()
+    os.makedirs(logdir, exist_ok=True)
+    save_port(mgmt_port)
+
+    print(f"UBDCC Cluster Manager v{__version__}")
+    print(f"Starting cluster with mgmt port {mgmt_port}, {dcn_count} DCN(s)...")
+    print(f"Log directory: {logdir}")
+
+    processes = []
+    cwd = os.getcwd()
+    dcn_counter = [0]  # mutable for closure access
+
+    def spawn_mgmt():
+        log = open(os.path.join(logdir, "ubdcc-mgmt.log"), "a")
+        proc = subprocess.Popen(
+            [sys.executable, "-c",
+             f"import os; from ubdcc_mgmt.Mgmt import Mgmt; Mgmt(cwd='{cwd}', mgmt_port={mgmt_port})"],
+            stdout=log, stderr=subprocess.STDOUT
+        )
+        # Remove old mgmt from processes list
+        for i, (name, p, l) in enumerate(processes):
+            if name == "mgmt":
+                processes.pop(i)
+                break
+        processes.append(("mgmt", proc, log))
+        return proc.pid
+
+    def spawn_restapi():
+        log = open(os.path.join(logdir, "ubdcc-restapi.log"), "a")
+        proc = subprocess.Popen(
+            [sys.executable, "-c",
+             f"import os; from ubdcc_restapi.RestApi import RestApi; RestApi(cwd='{cwd}', mgmt_port={mgmt_port})"],
+            stdout=log, stderr=subprocess.STDOUT
+        )
+        # Remove old restapi from processes list
+        for i, (name, p, l) in enumerate(processes):
+            if name == "restapi":
+                processes.pop(i)
+                break
+        processes.append(("restapi", proc, log))
+        return proc.pid
+
+    def spawn_dcn():
+        dcn_counter[0] += 1
+        nr = dcn_counter[0]
+        log = open(os.path.join(logdir, f"ubdcc-dcn-{nr}.log"), "a")
+        proc = subprocess.Popen(
+            [sys.executable, "-c",
+             f"import os; from ubdcc_dcn.DepthCacheNode import DepthCacheNode; "
+             f"DepthCacheNode(cwd='{cwd}', mgmt_port={mgmt_port})"],
+            stdout=log, stderr=subprocess.STDOUT
+        )
+        processes.append((f"dcn-{nr}", proc, log))
+        return nr, proc.pid
+
+    # Start mgmt
+    pid = spawn_mgmt()
+    print(f"  mgmt started (PID {pid})")
+
+    # Start restapi
+    pid = spawn_restapi()
+    print(f"  restapi started (PID {pid})")
+
+    # Start DCNs
+    for i in range(dcn_count):
+        nr, pid = spawn_dcn()
+        print(f"  dcn-{nr} started (PID {pid})")
+
+    expected_pods = 1 + dcn_count  # restapi + DCNs (mgmt doesn't register itself)
+    print(f"\nWaiting for {expected_pods} pods to register with mgmt...")
+
+    cluster_info = wait_for_cluster(mgmt_port, expected_pods)
+    if cluster_info:
+        print(f"Cluster is ready!\n")
+        print_status_table(cluster_info, mgmt_port=mgmt_port)
+    else:
+        print("Warning: Timeout waiting for all pods to register. Check the logs.")
+
+    print(f"\nType 'help' for available commands, Ctrl+C or 'stop' to shut down.\n")
+
+    # Interactive console
+    def do_shutdown():
+        print("\nShutting down cluster...")
+        shutdown_all(mgmt_port)
+        for name, proc, log in processes:
+            proc.terminate()
+            log.close()
+        try:
+            os.remove(STATE_FILE)
+        except FileNotFoundError:
+            pass
+        sys.exit(0)
+
+    signal.signal(signal.SIGINT, lambda sig, frame: do_shutdown())
+    signal.signal(signal.SIGTERM, lambda sig, frame: do_shutdown())
+
+    while True:
+        try:
+            raw = input("ubdcc> ").strip()
+        except (KeyboardInterrupt, EOFError):
+            do_shutdown()
+
+        if not raw:
+            continue
+        parts = raw.split(None, 1)
+        cmd = parts[0].lower()
+        arg = parts[1] if len(parts) > 1 else None
+
+        if cmd in ('status', '/status'):
+            try:
+                response = requests.get(f"http://127.0.0.1:{mgmt_port}/get_cluster_info", timeout=5)
+                data = response.json()
+                if data.get('result') == 'OK':
+                    print()
+                    print_status_table(data, mgmt_port=mgmt_port)
+                    print()
+            except requests.exceptions.ConnectionError:
+                print("Cannot connect to mgmt.")
+        elif cmd in ('stop', '/stop', 'quit', 'exit'):
+            do_shutdown()
+        elif cmd in ('add-dcn', '/add-dcn'):
+            count = int(arg) if arg else 1
+            for _ in range(count):
+                nr, pid = spawn_dcn()
+                print(f"  dcn-{nr} started (PID {pid})")
+            print(f"Waiting for registration...")
+            time.sleep(3)
+        elif cmd in ('remove-dcn', '/remove-dcn'):
+            if not arg:
+                print("Usage: remove-dcn <count|pod-name>")
+            else:
+                try:
+                    count = int(arg)
+                    remove_dcn_by_count(mgmt_port, count, processes)
+                except ValueError:
+                    remove_dcn(mgmt_port, arg, processes)
+        elif cmd in ('restart', '/restart'):
+            if not arg:
+                print("Usage: restart <pod-name|mgmt|restapi>")
+            elif arg in ('ubdcc-mgmt', 'mgmt'):
+                try:
+                    requests.get(f"http://127.0.0.1:{mgmt_port}/shutdown", timeout=5)
+                except requests.exceptions.ConnectionError:
+                    pass
+                for name, proc, log in processes:
+                    if name == "mgmt":
+                        proc.wait(timeout=10)
+                        break
+                pid = spawn_mgmt()
+                print(f"  mgmt restarted (PID {pid})")
+                print("  Waiting for mgmt to come up...")
+                for _ in range(30):
+                    try:
+                        requests.get(f"http://127.0.0.1:{mgmt_port}/test", timeout=2)
+                        print("  mgmt is ready!")
+                        break
+                    except requests.exceptions.ConnectionError:
+                        time.sleep(1)
+            elif arg in ('ubdcc-restapi', 'restapi'):
+                try:
+                    data = requests.get(f"http://127.0.0.1:{mgmt_port}/get_cluster_info", timeout=5).json()
+                    for uid, pod in data.get('db', {}).get('pods', {}).items():
+                        if pod.get('ROLE') == 'ubdcc-restapi':
+                            requests.get(f"http://127.0.0.1:{pod['API_PORT_REST']}/shutdown", timeout=3)
+                            break
+                except requests.exceptions.ConnectionError:
+                    pass
+                for name, proc, log in processes:
+                    if name == "restapi":
+                        proc.wait(timeout=10)
+                        break
+                pid = spawn_restapi()
+                print(f"  restapi restarted (PID {pid})")
+            else:
+                restart_pod(mgmt_port, arg)
+                nr, pid = spawn_dcn()
+                print(f"  dcn-{nr} respawned (PID {pid})")
+        elif cmd in ('help', '/help', '?'):
+            print()
+            print("Available commands:")
+            print("  status            Show cluster status")
+            print("  add-dcn [count]   Spawn new DCN process(es)")
+            print("  remove-dcn <count|name> Stop and remove DCN(s)")
+            print("  restart <name>    Restart a specific pod")
+            print("  stop              Shut down the cluster")
+            print("  help              Show this help")
+            print()
+        else:
+            print(f"Unknown command: {cmd}. Type 'help' for available commands.")
+
+
+def cmd_status(args):
+    mgmt_port = get_mgmt_port(args)
+    url = f"http://127.0.0.1:{mgmt_port}/get_cluster_info"
+    try:
+        response = requests.get(url, timeout=5)
+        data = response.json()
+        if data.get('result') == 'OK':
+            print_status_table(data, mgmt_port=mgmt_port)
+        else:
+            print(f"Error: {data.get('message', 'Unknown error')}")
+    except requests.exceptions.ConnectionError:
+        print(f"Cannot connect to mgmt on port {mgmt_port}. Is the cluster running?")
+
+
+def cmd_stop(args):
+    mgmt_port = get_mgmt_port(args)
+    shutdown_all(mgmt_port)
+
+
+def cmd_restart(args):
+    mgmt_port = get_mgmt_port(args)
+    restart_pod(mgmt_port, args.name)
+
+
+def remove_dcn_by_count(mgmt_port, count, processes):
+    """Stop N DCN pods."""
+    url = f"http://127.0.0.1:{mgmt_port}/get_cluster_info"
+    try:
+        response = requests.get(url, timeout=5)
+        data = response.json()
+    except requests.exceptions.ConnectionError:
+        print(f"Cannot connect to mgmt on port {mgmt_port}.")
+        return
+
+    pods = data.get('db', {}).get('pods', {})
+    dcns = [(uid, pod) for uid, pod in pods.items() if pod.get('ROLE') == 'ubdcc-dcn']
+    if count > len(dcns):
+        print(f"Only {len(dcns)} DCN(s) running, cannot remove {count}.")
+        return
+
+    removed = 0
+    for uid, pod in dcns:
+        if removed >= count:
+            break
+        port = pod['API_PORT_REST']
+        name = pod['NAME']
+        try:
+            requests.get(f"http://127.0.0.1:{port}/shutdown", timeout=5)
+            print(f"  Removed: {name} (port {port})")
+            removed += 1
+        except requests.exceptions.ConnectionError:
+            print(f"  Warning: Could not reach {name} on port {port}")
+
+
+def remove_dcn(mgmt_port, target, processes):
+    """Stop a DCN pod and remove it from the process list."""
+    url = f"http://127.0.0.1:{mgmt_port}/get_cluster_info"
+    try:
+        response = requests.get(url, timeout=5)
+        data = response.json()
+    except requests.exceptions.ConnectionError:
+        print(f"Cannot connect to mgmt on port {mgmt_port}.")
+        return
+
+    pods = data.get('db', {}).get('pods', {})
+    for uid, pod in pods.items():
+        if pod['NAME'] == target or uid == target:
+            if pod.get('ROLE') != 'ubdcc-dcn':
+                print(f"'{target}' is not a DCN. Use 'remove-dcn' only for DCN pods.")
+                return
+            port = pod['API_PORT_REST']
+            name = pod['NAME']
+            try:
+                requests.get(f"http://127.0.0.1:{port}/shutdown", timeout=5)
+                print(f"  Removed: {name} (port {port})")
+            except requests.exceptions.ConnectionError:
+                print(f"  Warning: Could not reach {name} on port {port}")
+            # Remove from local process list
+            for i, (pname, proc, log) in enumerate(processes):
+                if proc.poll() is not None or pname.startswith('dcn'):
+                    # Can't match by name since local names differ from pod names
+                    # Just clean up dead processes
+                    pass
+            return
+
+    print(f"Pod '{target}' not found. Use 'status' to see available pods.")
+
+
+def restart_pod(mgmt_port, target):
+    """Send shutdown to a specific pod by name or UID."""
+    # Handle mgmt separately — it doesn't register itself in the pod list
+    if target in ('ubdcc-mgmt', 'mgmt'):
+        try:
+            requests.get(f"http://127.0.0.1:{mgmt_port}/shutdown", timeout=5)
+            print(f"Shutdown signal sent to mgmt on port {mgmt_port}.")
+            print(f"Note: Restart the process manually or re-run 'ubdcc start'.")
+        except requests.exceptions.ConnectionError:
+            print(f"Cannot connect to mgmt on port {mgmt_port}.")
+        return
+
+    url = f"http://127.0.0.1:{mgmt_port}/get_cluster_info"
+    try:
+        response = requests.get(url, timeout=5)
+        data = response.json()
+    except requests.exceptions.ConnectionError:
+        print(f"Cannot connect to mgmt on port {mgmt_port}. Is the cluster running?")
+        return
+
+    pods = data.get('db', {}).get('pods', {})
+    for uid, pod in pods.items():
+        if pod['NAME'] == target or uid == target:
+            port = pod['API_PORT_REST']
+            name = pod['NAME']
+            try:
+                requests.get(f"http://127.0.0.1:{port}/shutdown", timeout=5)
+                print(f"Shutdown signal sent to '{name}' on port {port}.")
+                print(f"Note: Restart the process manually or re-run 'ubdcc start'.")
+            except requests.exceptions.ConnectionError:
+                print(f"Cannot connect to '{name}' on port {port}.")
+            return
+
+    print(f"Pod '{target}' not found. Use 'status' to see available pods.")
+
+
+def shutdown_all(mgmt_port):
+    """Shutdown all pods via their /shutdown endpoints."""
+    url = f"http://127.0.0.1:{mgmt_port}/get_cluster_info"
+    try:
+        response = requests.get(url, timeout=5)
+        data = response.json()
+    except requests.exceptions.ConnectionError:
+        print(f"Cannot connect to mgmt on port {mgmt_port}.")
+        return
+
+    pods = data.get('db', {}).get('pods', {})
+    for uid, pod in pods.items():
+        port = pod['API_PORT_REST']
+        name = pod['NAME']
+        try:
+            requests.get(f"http://127.0.0.1:{port}/shutdown", timeout=3)
+            print(f"  Shutdown: {name} ({pod['ROLE']}) on port {port}")
+        except requests.exceptions.ConnectionError:
+            print(f"  Warning: Could not reach {name} on port {port}")
+
+    # Shutdown mgmt last
+    try:
+        requests.get(f"http://127.0.0.1:{mgmt_port}/shutdown", timeout=3)
+        print(f"  Shutdown: mgmt on port {mgmt_port}")
+    except requests.exceptions.ConnectionError:
+        print(f"  Warning: Could not reach mgmt on port {mgmt_port}")
+
+    print("Cluster shutdown complete.")
+
+
+def print_status_table(data, mgmt_port=42080):
+    """Print a formatted status table from cluster info."""
+    pods = data.get('db', {}).get('pods', {})
+
+    print(f"{'ROLE':<16} {'NAME':<20} {'PORT':<8} {'STATUS':<10} {'VERSION'}")
+    print("-" * 70)
+
+    # Get mgmt info via /test endpoint
+    try:
+        mgmt_response = requests.get(f"http://127.0.0.1:{mgmt_port}/test", timeout=3)
+        mgmt_data = mgmt_response.json()
+        mgmt_name = mgmt_data.get('app', {}).get('name', '?')
+        mgmt_version = mgmt_data.get('app', {}).get('version', '?')
+        print(f"{'ubdcc-mgmt':<16} {mgmt_name:<20} {mgmt_port:<8} {'running':<10} {mgmt_version}")
+    except requests.exceptions.ConnectionError:
+        print(f"{'ubdcc-mgmt':<16} {'?':<20} {mgmt_port:<8} {'down':<10} {'?'}")
+
+    # Sort: restapi first, then dcn
+    role_order = {'ubdcc-restapi': 0, 'ubdcc-dcn': 1}
+    sorted_pods = sorted(pods.values(), key=lambda p: (role_order.get(p.get('ROLE', ''), 9), p.get('NAME', '')))
+
+    restapi_port = None
+    for pod in sorted_pods:
+        role = pod.get('ROLE', '?')
+        name = pod.get('NAME', '?')
+        port = pod.get('API_PORT_REST', '?')
+        status = pod.get('STATUS', '?')
+        version = pod.get('VERSION', '?')
+        print(f"{role:<16} {name:<20} {port:<8} {status:<10} {version}")
+        if role == 'ubdcc-restapi' and restapi_port is None:
+            restapi_port = port
+
+    depthcaches = data.get('db', {}).get('depthcaches', {})
+    dc_count = sum(len(markets) for markets in depthcaches.values())
+    print(f"\nDepthCaches: {dc_count}")
+    print(f"Version: {data.get('version', '?')}")
+    if restapi_port:
+        print(f"\nREST API: http://127.0.0.1:{restapi_port}/")
+        print(f"Cluster info: http://127.0.0.1:{restapi_port}/get_cluster_info")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog='ubdcc',
+        description='UNICORN Binance DepthCache Cluster — Cluster Manager\n'
+                    'https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster',
+        epilog='Interactive shell commands (available inside "ubdcc start"):\n'
+               '  add-dcn [count]       Spawn new DCN process(es)\n'
+               '  remove-dcn <count|name> Stop and remove DCN(s)\n'
+               '  status                Show cluster status\n'
+               '  restart <name>        Restart a specific pod\n'
+               '  stop                  Shut down the cluster\n'
+               '  help                  Show available shell commands',
+        formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+    parser.add_argument('-v', '--version', action='version', version=f'ubdcc {__version__}')
+
+    subparsers = parser.add_subparsers(dest='command', help='Available commands')
+
+    # start
+    start_parser = subparsers.add_parser('start', help='Start the cluster')
+    start_parser.add_argument('--dcn', type=int, default=1, help='Number of DCN processes (default: 1)')
+    start_parser.add_argument('--port', type=int, default=None, help='Mgmt port (default: 42080 or next free)')
+    start_parser.add_argument('--logdir', type=str, default=None, help='Log directory (default: current directory)')
+
+    # status
+    status_parser = subparsers.add_parser('status', help='Show cluster status')
+    status_parser.add_argument('--port', type=int, default=None, help='Mgmt port (default: 42080)')
+
+    # stop
+    stop_parser = subparsers.add_parser('stop', help='Stop the cluster')
+    stop_parser.add_argument('--port', type=int, default=None, help='Mgmt port (default: 42080)')
+
+    # restart
+    restart_parser = subparsers.add_parser('restart', help='Restart a specific pod')
+    restart_parser.add_argument('name', help='Pod name or UID to restart')
+    restart_parser.add_argument('--port', type=int, default=None, help='Mgmt port (default: 42080)')
+
+    args = parser.parse_args()
+
+    if args.command == 'start':
+        cmd_start(args)
+    elif args.command == 'status':
+        cmd_status(args)
+    elif args.command == 'stop':
+        cmd_stop(args)
+    elif args.command == 'restart':
+        cmd_restart(args)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

ubdcc-0.3.1.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: ubdcc
+Version: 0.3.1
+Summary: UNICORN Binance DepthCache Cluster — cluster manager and meta-package
+Home-page: https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster
+Author: Oliver Zehentleitner
+Author-email: 
+License: MIT
+Project-URL: Howto, https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster#howto
+Project-URL: Documentation, https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster
+Project-URL: Wiki, https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/wiki
+Project-URL: Author, https://www.linkedin.com/in/oliver-zehentleitner
+Project-URL: Changes, https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/blob/master/packages/ubdcc/CHANGELOG.md
+Project-URL: License, https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/blob/master/LICENSE
+Project-URL: Issue Tracker, https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/issues
+Project-URL: Telegram, https://t.me/unicorndevs
+Keywords: binance,depth cache,cluster,order book
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ubdcc-mgmt
+Requires-Dist: ubdcc-restapi
+Requires-Dist: ubdcc-dcn
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+[![GitHub Release](https://img.shields.io/github/release/oliver-zehentleitner/unicorn-binance-depth-cache-cluster.svg?label=github)](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/releases)
+[![GitHub Downloads](https://img.shields.io/github/downloads/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/total?color=blue)](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/releases)
+[![PyPi Release](https://img.shields.io/pypi/v/ubdcc?color=blue)](https://pypi.org/project/ubdcc/)
+[![PyPi Downloads](https://pepy.tech/badge/ubdcc)](https://pepy.tech/project/ubdcc)
+[![License](https://img.shields.io/badge/license-MIT-blue)](https://oliver-zehentleitner.github.io/unicorn-binance-depth-cache-cluster/license.html)
+[![Supported Python Version](https://img.shields.io/pypi/pyversions/ubdcc.svg)](https://www.python.org/downloads/)
+[![PyPI - Status](https://img.shields.io/pypi/status/ubdcc.svg)](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/issues)
+[![Build and Publish PyPi](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/actions/workflows/build_wheels_ubdcc.yml/badge.svg)](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/actions/workflows/build_wheels_ubdcc.yml)
+[![Read the Docs](https://img.shields.io/badge/read-%20docs-yellow)](https://oliver-zehentleitner.github.io/unicorn-binance-depth-cache-cluster)
+[![Github](https://img.shields.io/badge/source-github-cbc2c8)](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/tree/master/packages/ubdcc)
+[![Telegram](https://img.shields.io/badge/community-telegram-41ab8c)](https://t.me/unicorndevs)
+
+# UNICORN Binance DepthCache Cluster
+
+The `ubdcc` package is the all-in-one installer and cluster manager for the 
+[UNICORN Binance DepthCache Cluster](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster).
+
+## What you get
+
+- **All components installed**: `ubdcc-mgmt`, `ubdcc-restapi`, `ubdcc-dcn` and their dependencies
+- **`ubdcc` command**: Cluster manager to start, stop and monitor your UBDCC instance (work in progress)
+
+## Quick Start
+
+```bash
+pip install ubdcc
+```
+
+This installs everything you need. Start the cluster:
+
+```bash
+ubdcc start --dcn 4
+```
+
+This starts 1 mgmt + 1 restapi + 4 DCN processes and drops you into an interactive console where you can monitor 
+and manage the cluster (`status`, `stop`, `restart <name>`, `help`).
+
+The REST API is available at `http://127.0.0.1:42081/`.
+
+### Development (without pip install)
+
+When working on the source code, run directly from the package directory:
+
+```bash
+cd packages/ubdcc
+python -m ubdcc start --dcn 4
+python -m ubdcc status
+python -m ubdcc stop
+```
+
+For full documentation, architecture overview, REST API reference and Kubernetes setup, see the 
+[main project README](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster).
+
+## How to report Bugs or suggest Improvements?
+[List of planned features](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement) - click ![thumbs-up](https://raw.githubusercontent.com/oliver-zehentleitner/unicorn-binance-suite/master/images/misc/thumbup.png) if you need one of them or suggest a new feature!
+
+Before you report a bug, [try the latest release](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster#installation-and-upgrade). If the issue still exists, provide the error trace, OS 
+and Python version and explain how to reproduce the error. A demo script is appreciated.
+
+If you don't find an issue related to your topic, please open a new [issue](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/issues)!
+
+[Report a security bug!](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/security/policy)
+
+## Contributing
+[UNICORN Binance DepthCache Cluster](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster) is an open 
+source project which welcomes contributions which can be anything from simple documentation fixes and reporting dead links to new features. To 
+contribute follow 
+[this guide](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/blob/master/CONTRIBUTING.md).
+ 
+### Contributors
+[![Contributors](https://contributors-img.web.app/image?repo=oliver-zehentleitner/unicorn-binance-depth-cache-cluster)](https://github.com/oliver-zehentleitner/unicorn-binance-depth-cache-cluster/graphs/contributors)
+
+We ![love](https://raw.githubusercontent.com/oliver-zehentleitner/unicorn-binance-suite/master/images/misc/heart.png) open source!
+
+## Disclaimer
+This project is for informational purposes only. You should not construe this information or any other material as 
+legal, tax, investment, financial or other advice. Nothing contained herein constitutes a solicitation, recommendation, 
+endorsement or offer by us or any third party provider to buy or sell any securities or other financial instruments in 
+this or any other jurisdiction in which such solicitation or offer would be unlawful under the securities laws of such 
+jurisdiction.
+
+### If you intend to use real money, use it at your own risk!
+
+Under no circumstances will we be responsible or liable for any claims, damages, losses, expenses, costs or liabilities 
+of any kind, including but not limited to direct or indirect damages for loss of profits.

ubdcc-0.3.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+ubdcc/__init__.py,sha256=Jj7rFspXn8HVd2jNgKSHeNtIdjDBP1bf2CMIYak1OLM,704
+ubdcc/__main__.py,sha256=0zN_oeN02xzMGvpVDK6l-9IDKKxcSknpKs8wM0ZVgnk,35
+ubdcc/cli.py,sha256=pwWQIUEcJ0Y-XFIRcYVYzmbZr6wyHtQ0R2QTYxkj6jA,20124
+ubdcc-0.3.1.dist-info/licenses/LICENSE,sha256=ucnbASA25rhSF9cHkE9Eb-q58uXbYLtdaZyyVkjSn9M,1123
+ubdcc-0.3.1.dist-info/METADATA,sha256=Pr0pLk56bPh186F7s8voKjw8Usx9YDte0ZO68uu6ZjE,7868
+ubdcc-0.3.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ubdcc-0.3.1.dist-info/entry_points.txt,sha256=dtVonT-ML3jK0oxr2hD9hifJBzcaA2EGs5FsIc8f_Vs,41
+ubdcc-0.3.1.dist-info/top_level.txt,sha256=xUIKyETAc7TVepxCLkHXfiD8-e65oNVs52VGSRPO_jU,6
+ubdcc-0.3.1.dist-info/RECORD,,

ubdcc-0.3.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ubdcc-0.3.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ubdcc = ubdcc.cli:main

ubdcc-0.3.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026, Oliver Zehentleitner (https://about.me/oliver-zehentleitner)
+
+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 above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

ubdcc-0.3.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+ubdcc