Release v1.0.3

Author: sborsje

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,31 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest
+
+      - name: Run tests
+        run: pytest -v

.github/workflows/test.yml

@@ -5,7 +5,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.1] - 2025-11-27
+## [1.0.3] - 2025-12-10
 
-- Initial release
+- Update SDK endpoints for improved consistency
+
+- Audit and modernize SDK for better reliability
 

CHANGELOG.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Klime
+
+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.
+

LICENSE.md

@@ -1,11 +1,11 @@
-# klime-analytics
+# klime
 
-Klime Analytics SDK for Python.
+Klime SDK for Python.
 
 ## Installation
 
 ```bash
-pip install klime-analytics
+pip install klime
 ```
 
 ## Quick Start
@@ -17,24 +17,27 @@ client = KlimeClient(
     write_key='your-write-key'
 )
 
-# Track an event
-client.track('Button Clicked', {
-    'button_name': 'Sign up',
-    'plan': 'pro'
-})
-
 # Identify a user
 client.identify('user_123', {
     'email': '[email protected]',
     'name': 'Stefan'
 })
 
-# Group a user with an organization
+# Track an event
+client.track('Button Clicked', {
+    'button_name': 'Sign up',
+    'plan': 'pro'
+}, user_id='user_123')
+
+# Associate user with a group and set group traits
 client.group('org_456', {
     'name': 'Acme Inc',
     'plan': 'enterprise'
 }, user_id='user_123')
 
+# Or just link the user to a group (if traits are already set)
+client.group('org_456', user_id='user_123')
+
 # Shutdown gracefully
 client.shutdown()
 ```
@@ -46,7 +49,7 @@ client.shutdown()
 ```python
 KlimeClient(
     write_key: str,                    # Required: Your Klime write key
-    endpoint: Optional[str] = None,    # Optional: API endpoint (default: https://ingest.klime.com)
+    endpoint: Optional[str] = None,    # Optional: API endpoint (default: https://i.klime.com)
     flush_interval: Optional[int] = None,      # Optional: Milliseconds between flushes (default: 2000)
     max_batch_size: Optional[int] = None,     # Optional: Max events per batch (default: 20, max: 100)
     max_queue_size: Optional[int] = None,      # Optional: Max queued events (default: 1000)
@@ -60,22 +63,23 @@ KlimeClient(
 
 #### `track(event: str, properties: Optional[Dict] = None, user_id: Optional[str] = None, group_id: Optional[str] = None, ip: Optional[str] = None) -> None`
 
-Track a user event.
+Track a user event. A `user_id` is required for events to be useful in Klime.
 
 ```python
-# Simple usage
 client.track('Button Clicked', {
     'button_name': 'Sign up',
     'plan': 'pro'
-})
+}, user_id='user_123')
 
-# With user context and IP
+# With IP address (for geolocation)
 client.track('Button Clicked', {
     'button_name': 'Sign up',
     'plan': 'pro'
-}, user_id='user_123', group_id='org_456', ip='192.168.1.1')
+}, user_id='user_123', ip='192.168.1.1')
 ```
 
+> **Advanced**: The `group_id` parameter is available for multi-tenant scenarios where a user belongs to multiple organizations and you need to specify which organization context the event occurred in.
+
 #### `identify(user_id: str, traits: Optional[Dict] = None, ip: Optional[str] = None) -> None`
 
 Identify a user with traits.
@@ -89,20 +93,23 @@ client.identify('user_123', {
 
 #### `group(group_id: str, traits: Optional[Dict] = None, user_id: Optional[str] = None, ip: Optional[str] = None) -> None`
 
-Associate a user with a group and set group traits.
+Associate a user with a group and/or set group traits.
 
 ```python
-# Simple usage
+# Associate user with a group and set group traits (most common)
 client.group('org_456', {
     'name': 'Acme Inc',
     'plan': 'enterprise'
-})
+}, user_id='user_123')
+
+# Just link a user to a group (traits already set or not needed)
+client.group('org_456', user_id='user_123')
 
-# With user ID and IP
+# Just update group traits (e.g., from a webhook or background job)
 client.group('org_456', {
-    'name': 'Acme Inc',
-    'plan': 'enterprise'
-}, user_id='user_123', ip='192.168.1.1')
+    'plan': 'enterprise',
+    'employee_count': 50
+})
 ```
 
 #### `flush() -> None`
@@ -170,7 +177,7 @@ def button_clicked():
     client.track('Button Clicked', {
         'button_name': request.json.get('buttonName')
     }, user_id=request.json.get('userId'), ip=request.remote_addr)
-    
+
     return {'success': True}
 
 # Graceful shutdown
@@ -192,16 +199,15 @@ class ButtonClickView(View):
         client.track('Button Clicked', {
             'button_name': request.POST.get('buttonName')
         }, user_id=str(request.user.id), ip=request.META.get('REMOTE_ADDR'))
-        
+
         return JsonResponse({'success': True})
 ```
 
 ## Requirements
 
-- Python 3.7 or higher
+- Python 3.9 or higher
 - No external dependencies (uses only standard library)
 
 ## License
 
 MIT
-

README.md

@@ -1,5 +1,5 @@
 from .client import KlimeClient
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"
 __all__ = ["KlimeClient"]
 

klime/__init__.py

@@ -19,7 +19,7 @@
     ValidationError,
 )
 
-DEFAULT_ENDPOINT = "https://ingest.klime.com"
+DEFAULT_ENDPOINT = "https://i.klime.com"
 DEFAULT_FLUSH_INTERVAL = 2000  # milliseconds
 DEFAULT_MAX_BATCH_SIZE = 20
 DEFAULT_MAX_QUEUE_SIZE = 1000
@@ -28,7 +28,7 @@
 MAX_BATCH_SIZE = 100
 MAX_EVENT_SIZE_BYTES = 200 * 1024  # 200KB
 MAX_BATCH_SIZE_BYTES = 10 * 1024 * 1024  # 10MB
-SDK_VERSION = "1.0.0"
+SDK_VERSION = "1.0.2"
 
 
 class KlimeClient:
@@ -161,7 +161,8 @@ def shutdown(self) -> None:
             self._flush_timer.cancel()
             self._flush_timer = None
 
-        self.flush()
+        # Force flush remaining events (bypass normal flush which checks _is_shutdown)
+        self._flush_remaining()
 
     def _enqueue(self, event: Event) -> None:
         # Check event size
@@ -192,16 +193,20 @@ def _do_flush(self) -> None:
             self._flush_timer = None
 
         # Process batches
+        self._flush_remaining()
+
+        # Schedule next flush
+        if not self._is_shutdown:
+            self._schedule_flush()
+
+    def _flush_remaining(self) -> None:
+        """Flush all queued events without scheduling (used by shutdown)."""
         while True:
             batch = self._extract_batch()
             if not batch:
                 break
-
             self._send_batch(batch)
 
-        # Schedule next flush
-        self._schedule_flush()
-
     def _extract_batch(self) -> List[Event]:
         batch: List[Event] = []
         batch_size = 0
@@ -350,7 +355,7 @@ def _generate_uuid(self) -> str:
         return str(uuid.uuid4())
 
     def _generate_timestamp(self) -> str:
-        return datetime.now(timezone.utc).isoformat()
+        return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] + "Z"
 
     def _get_context(self, ip: Optional[str] = None) -> EventContext:
         context = EventContext(

klime/client.py

@@ -3,32 +3,31 @@ requires = ["setuptools>=61.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "klime-analytics"
-version = "1.0.1"
-description = "Klime Analytics SDK for Python"
+name = "klime"
+version = "1.0.3"
+description = "Klime SDK for Python"
 readme = "README.md"
-requires-python = ">=3.7"
+requires-python = ">=3.9"
 license = {text = "MIT"}
 authors = [
     {name = "Klime"}
 ]
 keywords = ["analytics", "klime", "tracking", "events"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.7",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
 ]
 
 [project.urls]
-Homepage = "https://github.com/klime/analytics-python"
-Documentation = "https://github.com/klime/analytics-python"
-Repository = "https://github.com/klime/analytics-python"
+Homepage = "https://github.com/klimeapp/klime-python"
+Documentation = "https://github.com/klimeapp/klime-python"
+Repository = "https://github.com/klimeapp/klime-python"
 
 [tool.setuptools]
 packages = ["klime"]