wiz-trader 0.10.0__tar.gz → 0.11.0__tar.gz

{wiz_trader-0.10.0/src/wiz_trader.egg-info → wiz_trader-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiz_trader
-Version: 0.10.0
+Version: 0.11.0
 Summary: A Python SDK for connecting to the Wizzer.
 Home-page: https://bitbucket.org/wizzer-tech/quotes_sdk.git
 Author: Pawan Wagh
@@ -132,7 +132,7 @@ quotes_client = QuotesClient(log_level="debug")  # Only override log level
 
 ## Quotes Client
 
-The `QuotesClient` enables you to connect to Wizzer's WebSocket server for real-time market data.
+The `QuotesClient` enables you to connect to Wizzer's WebSocket server for real‑time market data using **plain synchronous** callbacks—no `async def` required.
 
 ### Quotes Client Initialization
 
@@ -145,214 +145,155 @@ from wiz_trader import QuotesClient
 client = QuotesClient(
     base_url="wss://websocket-url/quotes",
     token="your-jwt-token",
-    log_level="info",  # Options: "error", "info", "debug"
-    max_message_size=10 * 1024 * 1024,  # Optional: Set max message size (default 10MB)
-    batch_size=20  # Optional: Max instruments per subscription batch (default 20)
+    log_level="info",         # Options: "error", "info", "debug"
+    max_message_size=10 * 1024 * 1024,  # Optional: default 10MB
+    batch_size=20             # Optional: default 20 instruments per batch
 )
 
 # Method 2: Using environment variables
-# (Requires WZ__QUOTES_BASE_URL and WZ__TOKEN to be set)
+# (Requires WZ__QUOTES_BASE_URL and WZ__TOKEN set)
 client = QuotesClient(log_level="info")
 
-# Method 3: Mixed approach (some params direct, some from env vars)
+# Method 3: Mixed approach
 client = QuotesClient(
-    base_url="wss://custom-websocket-url/quotes",
-    log_level="debug"
-    # token will be taken from WZ__TOKEN environment variable
+    base_url="wss://custom-url/quotes",
+    log_level="debug"         # token from WZ__TOKEN env var
 )
 ```
 
 ### Connection Methods
 
-The `QuotesClient` offers two ways to connect:
-
 #### Blocking Connection
 
-This approach is similar to Zerodha's KiteTicker and is recommended for simple scripts:
+Blocks your main thread, similar to Zerodha’s KiteTicker:
 
 ```python
-# This will block and run until stopped
 client.connect()
 ```
 
-#### Non-Blocking Connection
+#### Non‑Blocking Connection
 
-Use this for more complex applications where you need to perform other tasks:
+Run alongside your own `asyncio` code:
 
 ```python
-# Start the connection in the background
 client.connect_async()
-
-# Later, when you want to stop:
+# … do other work …
 client.stop()
 ```
 
 ### Callbacks
 
-Set up callbacks to handle different events:
+All callbacks are **plain `def`** functions.  Inside them you can call `subscribe(...)`, which under the hood schedules the actual async work—so you never `await` in your callbacks.
 
 ```python
 def on_tick(ws, tick):
-    """Called when a tick is received"""
-    print(f"Received tick: {tick}")
+    print("Tick:", tick)
 
 def on_connect(ws):
-    """Called when the connection is established"""
-    print("Connected to the quotes server")
-    # Subscribe to instruments
-    ws.subscribe(["NSE:SBIN:3045"])
+    print("Connected!")
+    # fire‑and‑forget subscribe—no await needed
+    ws.subscribe([
+        "NSE:SBIN:3045",
+        "NSE:RELIANCE:2885"
+    ])
 
 def on_close(ws, code, reason):
-    """Called when the connection is closed"""
-    print(f"Connection closed with code {code}: {reason}")
-    # Optional: Stop the client (if you want to exit)
-    # ws.stop()
+    print(f"Connection closed [{code}]: {reason}")
+    ws.stop()   # to prevent auto‑reconnect
 
 def on_error(ws, error):
-    """Called when an error occurs"""
-    print(f"Error: {error}")
+    print("Error:", error)
 
-# Set the callbacks
-client.on_tick = on_tick
+client.on_tick    = on_tick
 client.on_connect = on_connect
-client.on_close = on_close
-client.on_error = on_error
+client.on_close   = on_close
+client.on_error   = on_error
 ```
 
 ### Subscribing to Instruments
 
-Subscribe to receive market data for specific instruments:
+Call `ws.subscribe([...])` directly; the SDK will batch large lists and send them over the socket:
 
 ```python
-# Inside an on_connect callback:
 def on_connect(ws):
-    # Subscribe to a single instrument
-    ws.subscribe(["NSE:SBIN:3045"])
-    
-    # Or subscribe to multiple instruments at once
+    # subscribe without await
     ws.subscribe([
         "NSE:SBIN:3045",
         "NSE:ICICIBANK:4963",
-        "NSE:RELIANCE:2885"
+        "NSE:RELIANCE:2885",
     ])
 ```
 
-For large lists of instruments, the client will automatically batch them to avoid message size issues.
-
 ### Unsubscribing from Instruments
 
-To stop receiving data for specific instruments:
+Similarly, plain call to `unsubscribe`:
 
 ```python
-# Unsubscribe from specific instruments
 ws.unsubscribe(["NSE:SBIN:3045", "NSE:ICICIBANK:4963"])
 ```
 
-### Handling WebSocket Connection
-
-The WebSocket connection automatically attempts to reconnect with exponential backoff if disconnected. You don't need to handle this manually.
-
-To explicitly close the connection:
-
-```python
-# In a blocking context:
-client.stop()
-
-# In an async context:
-await client.close()
-```
-
-### Quotes Client Examples
+### Complete Examples
 
-#### Complete Blocking Example
+#### Blocking Example
 
 ```python
 import logging
 from wiz_trader import QuotesClient
 
-# Configure logging
-logging.basicConfig(level=logging.DEBUG)
+logging.basicConfig(level=logging.INFO)
 
-# Initialize the client
 client = QuotesClient(
     base_url="wss://websocket-url/quotes",
     token="your-jwt-token"
 )
 
 def on_tick(ws, tick):
-    """Process incoming market data"""
-    logging.debug("Received tick: %s", tick)
+    logging.debug("Tick: %s", tick)
 
 def on_connect(ws):
-    """Handle successful connection"""
-    logging.info("Connected to quotes server")
-    # Subscribe to instruments
-    ws.subscribe(["NSE:SBIN:3045", "NSE:RELIANCE:2885"])
+    logging.info("Connected.")
+    ws.subscribe(["NSE:SBIN:3045", "NSE:RELIANCE:2885"])  # no await
 
 def on_close(ws, code, reason):
-    """Handle connection closure"""
-    logging.info("Connection closed: %s", reason)
+    logging.warning("Closed: %s", reason)
+    ws.stop()
 
 def on_error(ws, error):
-    """Handle errors"""
-    logging.error("Error occurred: %s", error)
+    logging.error("Error: %s", error)
 
-# Set callbacks
-client.on_tick = on_tick
+client.on_tick    = on_tick
 client.on_connect = on_connect
-client.on_close = on_close
-client.on_error = on_error
+client.on_close   = on_close
+client.on_error   = on_error
 
-# Connect and run (blocking call)
 try:
     client.connect()
 except KeyboardInterrupt:
-    print("Interrupted by user, shutting down...")
     client.stop()
 ```
 
-#### Non-Blocking Example with Other Operations
+#### Non‑Blocking Example
 
 ```python
 import asyncio
 import logging
-from wiz_trader import QuotesClient, WizzerClient
+from wiz_trader import QuotesClient
 
 async def main():
-    # Configure logging
     logging.basicConfig(level=logging.INFO)
-    
-    # Initialize the quotes client
-    quotes_client = QuotesClient(
+    client = QuotesClient(
         base_url="wss://websocket-url/quotes",
         token="your-jwt-token"
     )
-    
-    # Initialize the REST API client
-    wizzer_client = WizzerClient(
-        base_url="https://api-url.in",
-        token="your-jwt-token"
-    )
-    
-    # Set up quotes callbacks
-    quotes_client.on_tick = lambda ws, tick: logging.info(f"Tick: {tick}")
-    quotes_client.on_connect = lambda ws: ws.subscribe(["NSE:SBIN:3045"])
-    
-    # Connect in non-blocking mode
-    quotes_client.connect_async()
-    
-    # Perform other operations
-    indices = await asyncio.to_thread(wizzer_client.get_indices, exchange="NSE")
-    logging.info(f"Available indices: {[idx['name'] for idx in indices[:5]]}")
-    
-    # Wait for some time
+    client.on_tick    = lambda ws, tick: logging.info(tick)
+    client.on_connect = lambda ws: ws.subscribe(["NSE:SBIN:3045"])
+    client.connect_async()
+
+    # Your other async work here...
     await asyncio.sleep(60)
-    
-    # Stop the quotes client
-    quotes_client.stop()
+    client.stop()
 
-if __name__ == "__main__":
-    asyncio.run(main())
+asyncio.run(main())
 ```
 
 ## Wizzer Client

{wiz_trader-0.10.0 → wiz_trader-0.11.0}/README.md

@@ -105,7 +105,7 @@ quotes_client = QuotesClient(log_level="debug")  # Only override log level
 
 ## Quotes Client
 
-The `QuotesClient` enables you to connect to Wizzer's WebSocket server for real-time market data.
+The `QuotesClient` enables you to connect to Wizzer's WebSocket server for real‑time market data using **plain synchronous** callbacks—no `async def` required.
 
 ### Quotes Client Initialization
 
@@ -118,214 +118,155 @@ from wiz_trader import QuotesClient
 client = QuotesClient(
     base_url="wss://websocket-url/quotes",
     token="your-jwt-token",
-    log_level="info",  # Options: "error", "info", "debug"
-    max_message_size=10 * 1024 * 1024,  # Optional: Set max message size (default 10MB)
-    batch_size=20  # Optional: Max instruments per subscription batch (default 20)
+    log_level="info",         # Options: "error", "info", "debug"
+    max_message_size=10 * 1024 * 1024,  # Optional: default 10MB
+    batch_size=20             # Optional: default 20 instruments per batch
 )
 
 # Method 2: Using environment variables
-# (Requires WZ__QUOTES_BASE_URL and WZ__TOKEN to be set)
+# (Requires WZ__QUOTES_BASE_URL and WZ__TOKEN set)
 client = QuotesClient(log_level="info")
 
-# Method 3: Mixed approach (some params direct, some from env vars)
+# Method 3: Mixed approach
 client = QuotesClient(
-    base_url="wss://custom-websocket-url/quotes",
-    log_level="debug"
-    # token will be taken from WZ__TOKEN environment variable
+    base_url="wss://custom-url/quotes",
+    log_level="debug"         # token from WZ__TOKEN env var
 )
 ```
 
 ### Connection Methods
 
-The `QuotesClient` offers two ways to connect:
-
 #### Blocking Connection
 
-This approach is similar to Zerodha's KiteTicker and is recommended for simple scripts:
+Blocks your main thread, similar to Zerodha’s KiteTicker:
 
 ```python
-# This will block and run until stopped
 client.connect()
 ```
 
-#### Non-Blocking Connection
+#### Non‑Blocking Connection
 
-Use this for more complex applications where you need to perform other tasks:
+Run alongside your own `asyncio` code:
 
 ```python
-# Start the connection in the background
 client.connect_async()
-
-# Later, when you want to stop:
+# … do other work …
 client.stop()
 ```
 
 ### Callbacks
 
-Set up callbacks to handle different events:
+All callbacks are **plain `def`** functions.  Inside them you can call `subscribe(...)`, which under the hood schedules the actual async work—so you never `await` in your callbacks.
 
 ```python
 def on_tick(ws, tick):
-    """Called when a tick is received"""
-    print(f"Received tick: {tick}")
+    print("Tick:", tick)
 
 def on_connect(ws):
-    """Called when the connection is established"""
-    print("Connected to the quotes server")
-    # Subscribe to instruments
-    ws.subscribe(["NSE:SBIN:3045"])
+    print("Connected!")
+    # fire‑and‑forget subscribe—no await needed
+    ws.subscribe([
+        "NSE:SBIN:3045",
+        "NSE:RELIANCE:2885"
+    ])
 
 def on_close(ws, code, reason):
-    """Called when the connection is closed"""
-    print(f"Connection closed with code {code}: {reason}")
-    # Optional: Stop the client (if you want to exit)
-    # ws.stop()
+    print(f"Connection closed [{code}]: {reason}")
+    ws.stop()   # to prevent auto‑reconnect
 
 def on_error(ws, error):
-    """Called when an error occurs"""
-    print(f"Error: {error}")
+    print("Error:", error)
 
-# Set the callbacks
-client.on_tick = on_tick
+client.on_tick    = on_tick
 client.on_connect = on_connect
-client.on_close = on_close
-client.on_error = on_error
+client.on_close   = on_close
+client.on_error   = on_error
 ```
 
 ### Subscribing to Instruments
 
-Subscribe to receive market data for specific instruments:
+Call `ws.subscribe([...])` directly; the SDK will batch large lists and send them over the socket:
 
 ```python
-# Inside an on_connect callback:
 def on_connect(ws):
-    # Subscribe to a single instrument
-    ws.subscribe(["NSE:SBIN:3045"])
-    
-    # Or subscribe to multiple instruments at once
+    # subscribe without await
     ws.subscribe([
         "NSE:SBIN:3045",
         "NSE:ICICIBANK:4963",
-        "NSE:RELIANCE:2885"
+        "NSE:RELIANCE:2885",
     ])
 ```
 
-For large lists of instruments, the client will automatically batch them to avoid message size issues.
-
 ### Unsubscribing from Instruments
 
-To stop receiving data for specific instruments:
+Similarly, plain call to `unsubscribe`:
 
 ```python
-# Unsubscribe from specific instruments
 ws.unsubscribe(["NSE:SBIN:3045", "NSE:ICICIBANK:4963"])
 ```
 
-### Handling WebSocket Connection
-
-The WebSocket connection automatically attempts to reconnect with exponential backoff if disconnected. You don't need to handle this manually.
-
-To explicitly close the connection:
-
-```python
-# In a blocking context:
-client.stop()
-
-# In an async context:
-await client.close()
-```
-
-### Quotes Client Examples
+### Complete Examples
 
-#### Complete Blocking Example
+#### Blocking Example
 
 ```python
 import logging
 from wiz_trader import QuotesClient
 
-# Configure logging
-logging.basicConfig(level=logging.DEBUG)
+logging.basicConfig(level=logging.INFO)
 
-# Initialize the client
 client = QuotesClient(
     base_url="wss://websocket-url/quotes",
     token="your-jwt-token"
 )
 
 def on_tick(ws, tick):
-    """Process incoming market data"""
-    logging.debug("Received tick: %s", tick)
+    logging.debug("Tick: %s", tick)
 
 def on_connect(ws):
-    """Handle successful connection"""
-    logging.info("Connected to quotes server")
-    # Subscribe to instruments
-    ws.subscribe(["NSE:SBIN:3045", "NSE:RELIANCE:2885"])
+    logging.info("Connected.")
+    ws.subscribe(["NSE:SBIN:3045", "NSE:RELIANCE:2885"])  # no await
 
 def on_close(ws, code, reason):
-    """Handle connection closure"""
-    logging.info("Connection closed: %s", reason)
+    logging.warning("Closed: %s", reason)
+    ws.stop()
 
 def on_error(ws, error):
-    """Handle errors"""
-    logging.error("Error occurred: %s", error)
+    logging.error("Error: %s", error)
 
-# Set callbacks
-client.on_tick = on_tick
+client.on_tick    = on_tick
 client.on_connect = on_connect
-client.on_close = on_close
-client.on_error = on_error
+client.on_close   = on_close
+client.on_error   = on_error
 
-# Connect and run (blocking call)
 try:
     client.connect()
 except KeyboardInterrupt:
-    print("Interrupted by user, shutting down...")
     client.stop()
 ```
 
-#### Non-Blocking Example with Other Operations
+#### Non‑Blocking Example
 
 ```python
 import asyncio
 import logging
-from wiz_trader import QuotesClient, WizzerClient
+from wiz_trader import QuotesClient
 
 async def main():
-    # Configure logging
     logging.basicConfig(level=logging.INFO)
-    
-    # Initialize the quotes client
-    quotes_client = QuotesClient(
+    client = QuotesClient(
         base_url="wss://websocket-url/quotes",
         token="your-jwt-token"
     )
-    
-    # Initialize the REST API client
-    wizzer_client = WizzerClient(
-        base_url="https://api-url.in",
-        token="your-jwt-token"
-    )
-    
-    # Set up quotes callbacks
-    quotes_client.on_tick = lambda ws, tick: logging.info(f"Tick: {tick}")
-    quotes_client.on_connect = lambda ws: ws.subscribe(["NSE:SBIN:3045"])
-    
-    # Connect in non-blocking mode
-    quotes_client.connect_async()
-    
-    # Perform other operations
-    indices = await asyncio.to_thread(wizzer_client.get_indices, exchange="NSE")
-    logging.info(f"Available indices: {[idx['name'] for idx in indices[:5]]}")
-    
-    # Wait for some time
+    client.on_tick    = lambda ws, tick: logging.info(tick)
+    client.on_connect = lambda ws: ws.subscribe(["NSE:SBIN:3045"])
+    client.connect_async()
+
+    # Your other async work here...
     await asyncio.sleep(60)
-    
-    # Stop the quotes client
-    quotes_client.stop()
+    client.stop()
 
-if __name__ == "__main__":
-    asyncio.run(main())
+asyncio.run(main())
 ```
 
 ## Wizzer Client

{wiz_trader-0.10.0 → wiz_trader-0.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wiz_trader"
-version = "0.10.0"
+version = "0.11.0"
 description = "A Python SDK for connecting to the Wizzer."
 readme = "README.md"
 authors = [

{wiz_trader-0.10.0 → wiz_trader-0.11.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
   name='wiz_trader',
-  version='0.10.0',
+  version='0.11.0',
   description='A Python SDK for connecting to the Wizzer.',
   long_description=open('README.md').read() if open('README.md') else "",
   long_description_content_type='text/markdown',

{wiz_trader-0.10.0 → wiz_trader-0.11.0}/src/wiz_trader/__init__.py

@@ -3,6 +3,6 @@
 from .quotes import QuotesClient
 from .apis import WizzerClient
 
-__version__ = "0.10.0"
+__version__ = "0.11.0"
 
 __all__ = ["QuotesClient", "WizzerClient"]