📦 NEW: Python Release System

Author: arre-ankit

.releaserc.json

@@ -0,0 +1,64 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "releaseRules": [
+          {"type": "📦 NEW", "release": "major"},
+          {"type": "👌 IMPROVE", "release": "patch"},
+          {"type": "🐛 FIX", "release": "patch"},
+          {"type": "🚀 RELEASE", "release": "patch"},
+          {"type": "📖 DOC", "release": false},
+          {"type": "🤖 TEST", "release": false},
+          {"type": "‼️ BREAKING", "release": "major"}
+        ],
+        "parserOpts": {
+          "pattern": "^(📦 NEW|👌 IMPROVE|🐛 FIX|🚀 RELEASE|📖 DOC|🤖 TEST|‼️ BREAKING): (.*)$",
+          "groupCorrespondence": ["type", "subject"]
+        }
+      }
+    ],
+    [
+      "@semantic-release/release-notes-generator",
+      {
+        "parserOpts": {
+          "pattern": "^(📦 NEW|👌 IMPROVE|🐛 FIX|🚀 RELEASE|📖 DOC|🤖 TEST|‼️ BREAKING): (.*)$",
+          "groupCorrespondence": ["type", "subject"]
+        },
+        "writerOpts": {
+          "transform": {
+            "hash": false,
+            "committerDate": false,
+            "authorDate": false,
+            "authorName": false,
+            "authorEmail": false,
+            "committerName": false,
+            "committerEmail": false
+          },
+          "groupBy": "type",
+          "commitGroupsSort": ["📦 NEW", "👌 IMPROVE", "🐛 FIX", "‼️ BREAKING", "📖 DOC", "🤖 TEST"],
+          "commitsSort": ["subject"],
+          "noteGroupsSort": "title"
+        }
+      }
+    ],
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md"
+      }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "CHANGELOG.md",
+          "pyproject.toml",
+          "langbase/__init__.py"
+        ],
+        "message": "🚀 RELEASE: ${nextRelease.version}\n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+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.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial Python SDK for Langbase API
+- Support for Pipes, Memories, Threads, Tools, and Workflows
+- Comprehensive type definitions and error handling
+- Streaming support for real-time responses
+- Memory and RAG functionality
+- Agent and workflow orchestration
+
+## [0.1.0] - 2024-01-01
+
+### Added
+- Initial release of the Langbase Python SDK

langbase/__init__.py

@@ -64,6 +64,9 @@
 from .workflow import TimeoutError, Workflow
 
 __version__ = "0.1.0"
+__author__ = "LangbaseInc"
+__description__ = "Python SDK for the Langbase API"
+
 __all__ = [
     # Errors
     "APIConnectionError",

pyproject.toml

@@ -3,7 +3,7 @@ name = "langbase"
 version = "0.1.0"
 description = "Python SDK for the Langbase API"
 readme = "README.md"
-license = {text = "MIT"}
+license = {text = "Apache-2.0"}
 authors = [
     { name = "Saqib", email = "[email protected]" },
     { name = "Ankit", email = "[email protected]" },
@@ -13,20 +13,29 @@ keywords = ["ai", "langbase", "agent", "memory", "rag", "mcp", "pipes", "workflo
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "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",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
     "requests>=2.25.0",
     "typing-extensions>=4.0.0",
 ]
 
+[project.optional-dependencies]
+release = [
+    "python-semantic-release>=8.0.0",
+]
+
 [project.urls]
 Documentation = "https://docs.langbase.com"
 Homepage = "https://langbase.com"
@@ -102,3 +111,19 @@ precision = 2
 
 [tool.coverage.html]
 directory = "htmlcov"
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+version_variables = [
+    "langbase/__init__.py:__version__",
+]
+branch = "main"
+upload_to_PyPI = false
+upload_to_release = false
+build_command = "pip install build && python -m build"
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = ["📦 NEW", "👌 IMPROVE", "🐛 FIX", "🚀 RELEASE", "📖 DOC", "🤖 TEST", "‼️ BREAKING"]
+minor_tags = ["📦 NEW"]
+patch_tags = ["👌 IMPROVE", "🐛 FIX", "🚀 RELEASE"]
+major_tags = ["‼️ BREAKING"]

release.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python3
+"""
+Simple release script for Langbase Python SDK.
+Usage: python release.py
+"""
+
+import os
+import subprocess
+import sys
+
+# Fix Windows encoding issues with emojis
+os.environ["PYTHONUTF8"] = "1"
+os.environ["PYTHONIOENCODING"] = "utf-8"
+
+
+def run_command(cmd, description):
+    """Run a command and handle errors."""
+    print(f"🔄 {description}...")
+    print(f"   Running: {cmd}")
+    try:
+        result = subprocess.run(
+            cmd,
+            shell=True,
+            check=True,
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
+        )
+        # Show both stdout and stderr
+        if result.stdout.strip():
+            print("📤 Output:")
+            print(result.stdout)
+        if result.stderr.strip():
+            print("⚠️  Warnings:")
+            print(result.stderr)
+        if not result.stdout.strip() and not result.stderr.strip():
+            print("✅ Command completed (no output)")
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"❌ Error: {e}")
+        print(f"❌ Command that failed: {cmd}")
+        if e.stdout:
+            print(f"📤 Output: {e.stdout}")
+        if e.stderr:
+            print(f"📤 Error details: {e.stderr}")
+        return False
+
+
+def main():
+    """Run the complete release process."""
+    print("🚀 Starting Langbase SDK release process...\n")
+
+    # Step 1: Confirm release
+    try:
+        confirm = input("\n❓ Proceed with release? (y/N): ").lower().strip()
+        if confirm != "y" and confirm != "yes":
+            print("❌ Release cancelled")
+            return
+    except KeyboardInterrupt:
+        print("\n❌ Release cancelled")
+        return
+
+    # Step 2: Create version
+    print("\n📦 Creating new version...")
+    if not run_command("semantic-release version", "Creating version"):
+        print("❌ Failed to create version")
+        sys.exit(1)
+
+    # Step 3: Configure git to push tags automatically (one-time setup)
+    run_command(
+        "git config push.followTags true", "Configuring git to push tags automatically"
+    )
+
+    # Step 4: Push everything to origin
+    print("\n⬆️  Pushing to origin...")
+    if not run_command("git push origin main", "Pushing commits and tags"):
+        print("❌ Failed to push to origin")
+        sys.exit(1)
+
+    print("\n✅ Release completed successfully!")
+    print("🎯 Next steps (optional):")
+    print("   • python -m build          # Build packages")
+    print("   • twine upload dist/*      # Upload to PyPI")
+
+
+if __name__ == "__main__":
+    main()

requirements-dev.txt

@@ -21,3 +21,6 @@ twine>=4.0.0
 # Development utilities
 ipdb>=0.13.0
 python-dotenv>=0.19.0
+
+# release
+python-semantic-release>=8.0.0