fixes

Author: idanasulin2706

DEVELOPMENT.md

@@ -0,0 +1,89 @@
+# Development Guide
+
+This document explains how to set up the superclient library for local development.
+
+## Local Installation
+
+### Step 1: Clone the Repository
+
+```bash
+git clone https://github.com/superstreamlabs/superclient-python.git
+cd superclient-python
+```
+
+### Step 2: Create a Virtual Environment (Recommended)
+
+```bash
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+```
+
+### Step 3: Install in Development Mode
+
+```bash
+pip install -e .
+```
+
+This installs the package in "editable" mode, which means:
+- Changes to the source code are immediately reflected without reinstalling
+- The package is installed in your Python environment
+- You can import and use the package normally
+
+### Step 4: Enable Automatic Loading
+
+To test the automatic loading functionality:
+
+```bash
+python -m superclient install_pth
+```
+
+This installs the `.pth` file that enables automatic loading when Python starts.
+
+## Development Workflow
+
+### Making Changes
+
+1. Edit the source code in the `superclient/` directory
+2. Changes are immediately available (no reinstallation needed)
+3. Test your changes by running examples or your own code
+
+### Running Examples
+
+```bash
+# Run a kafka-python example
+python examples/kafkapy/apache.py
+
+# Run an aiokafka example  
+python examples/aiokafka/apache.py
+
+# Run a confluent-kafka example
+python examples/confluent_kafka/apache.py
+```
+
+## Uninstallation
+
+### Step 1: Remove the .pth File (if installed)
+
+```bash
+# Find and remove the .pth file
+find /path/to/your/venv/lib/python*/site-packages -name "superclient-init.pth" -delete
+```
+
+Or manually remove it from your site-packages directory.
+
+### Step 2: Uninstall the Package
+
+```bash
+pip uninstall superclient
+```
+
+### Step 3: Clean Up Build Artifacts
+
+```bash
+# Remove build directories
+rm -rf build/ dist/ superclient.egg-info/
+
+# Remove any cached Python files
+find . -name "*.pyc" -delete
+find . -name "__pycache__" -type d -exec rm -rf {} +
+```

superclient/agent/tracker.py

@@ -82,7 +82,7 @@ class Heartbeat(threading.Thread):
 
     def __init__(self):
         super().__init__(name="superstream-heartbeat", daemon=True)
-        self._stop = threading.Event()
+        self._stop_event = threading.Event()
 
     @classmethod
     def ensure(cls):
@@ -107,7 +107,7 @@ def unregister_tracker(cls, tracker_id: str):
 
     def run(self):
         """Main heartbeat loop."""
-        while not self._stop.is_set():
+        while not self._stop_event.is_set():
             now = time.time()
             with self._track_lock:
                 trackers = list(self._trackers.values())