feat: allow creation of replane client without connection options

Author: tilyupo

README.md

@@ -74,12 +74,20 @@ async with AsyncReplane(
 ```python
 from replane import Replane
 
+# Option 1: Provide credentials in constructor
 replane = Replane(
     base_url="https://cloud.replane.dev",
     sdk_key="rp_...",
 )
 replane.connect()
 
+# Option 2: Provide credentials in connect()
+replane = Replane()
+replane.connect(
+    base_url="https://cloud.replane.dev",
+    sdk_key="rp_...",
+)
+
 # Use configs
 rate_limit = replane.configs["rate-limit"]
 user_client = replane.with_context({"user_id": "123"})

docs/source/configuration.md

@@ -10,7 +10,7 @@ Both `Replane` and `AsyncReplane` accept the same configuration options:
 from replane import Replane
 
 replane = Replane(
-    # Required
+    # Can be provided here or in connect()
     base_url="https://replane.example.com",
     sdk_key="rp_...",
 
@@ -26,30 +26,38 @@ replane = Replane(
 )
 ```
 
-### Required Options
+### Connection Options
 
 #### `base_url`
 
 - **Type:** `str`
-- **Required:** Yes
+- **Required:** Yes (in constructor or `connect()`)
 
-The base URL of your Replane server.
+The base URL of your Replane server. Can be provided in the constructor or in `connect()`.
 
 ```python
-base_url="https://replane.example.com"
-base_url="http://localhost:3000"  # Local development
+# In constructor
+replane = Replane(base_url="https://replane.example.com", sdk_key="...")
+
+# Or in connect()
+replane = Replane(sdk_key="...")
+replane.connect(base_url="https://replane.example.com")
 ```
 
 #### `sdk_key`
 
 - **Type:** `str`
-- **Required:** Yes
+- **Required:** Yes (in constructor or `connect()`)
 
-Your SDK key from the Replane dashboard. SDK keys are scoped to a specific project and environment.
+Your SDK key from the Replane dashboard. Can be provided in the constructor or in `connect()`.
 
 ```python
-sdk_key="rp_abc123..."  # Production
-sdk_key="rp_test_xyz789..."  # Testing/staging
+# In constructor
+replane = Replane(base_url="...", sdk_key="rp_abc123...")
+
+# Or in connect()
+replane = Replane(base_url="...")
+replane.connect(sdk_key="rp_abc123...")
 ```
 
 ### Optional Options

docs/source/index.md

@@ -32,9 +32,14 @@ with Replane(
 Or without context manager:
 
 ```python
+# Credentials in constructor
 replane = Replane(base_url="...", sdk_key="...")
 replane.connect()
 
+# Or in connect()
+replane = Replane()
+replane.connect(base_url="...", sdk_key="...")
+
 rate_limit = replane.configs["rate-limit"]
 
 replane.close()

docs/source/quickstart.md

@@ -71,12 +71,20 @@ If you prefer manual lifecycle management:
 ```python
 from replane import Replane
 
+# Option 1: Provide credentials in constructor
 replane = Replane(
     base_url="https://replane.example.com",
     sdk_key="rp_...",
 )
 replane.connect()
 
+# Option 2: Provide credentials in connect()
+replane = Replane()
+replane.connect(
+    base_url="https://replane.example.com",
+    sdk_key="rp_...",
+)
+
 try:
     rate_limit = replane.configs["rate-limit"]
     user_client = replane.with_context({"user_id": "123"})

replane/_async.py

@@ -309,8 +309,8 @@ class AsyncReplane(Generic[ConfigsT]):
 
     def __init__(
         self,
-        base_url: str,
-        sdk_key: str,
+        base_url: str | None = None,
+        sdk_key: str | None = None,
         *,
         context: dict[str, ContextValue] | None = None,
         defaults: dict[str, Any] | None = None,
@@ -325,8 +325,8 @@ def __init__(
         """Initialize the async Replane client.
 
         Args:
-            base_url: Base URL of the Replane server.
-            sdk_key: SDK key for authentication.
+            base_url: Base URL of the Replane server. Can also be provided in connect().
+            sdk_key: SDK key for authentication. Can also be provided in connect().
             context: Default context for override evaluation.
             defaults: Default values for configs if not loaded from server.
             required: List of config names that must be present on init.
@@ -364,7 +364,7 @@ def __init__(
             if required:
                 logger.debug("Required configs: %s", required)
 
-        self._base_url = base_url.rstrip("/")
+        self._base_url = base_url.rstrip("/") if base_url else None
         self._sdk_key = sdk_key
         # Generate replaneClientId and set it as base context.
         # User-provided context values take precedence (merged on top).
@@ -399,20 +399,41 @@ def __init__(
         self._stream_task: asyncio.Task[None] | None = None
         self._http_client: httpx.AsyncClient | None = None
 
-    async def connect(self, *, wait: bool = True) -> None:
+    async def connect(
+        self,
+        base_url: str | None = None,
+        sdk_key: str | None = None,
+        *,
+        wait: bool = True,
+    ) -> None:
         """Connect to the Replane server and start receiving updates.
 
         This starts a background task that maintains the SSE connection.
 
         Args:
+            base_url: Base URL of the Replane server. Overrides constructor value.
+            sdk_key: SDK key for authentication. Overrides constructor value.
             wait: If True, wait until initial configs are loaded.
 
         Raises:
+            ValueError: If base_url or sdk_key is not provided here or in constructor.
             ReplaneError: If connection fails or required configs are missing.
         """
         if self._closed:
             raise ClientClosedError()
 
+        # Apply overrides from connect() if provided
+        if base_url is not None:
+            self._base_url = base_url.rstrip("/")
+        if sdk_key is not None:
+            self._sdk_key = sdk_key
+
+        # Validate required parameters
+        if not self._base_url:
+            raise ValueError("base_url is required - provide it in constructor or connect()")
+        if not self._sdk_key:
+            raise ValueError("sdk_key is required - provide it in constructor or connect()")
+
         logger.debug("connect() called, wait=%s", wait)
 
         # Use request_timeout for the handshake (server should respond quickly).

replane/_sync.py

@@ -311,8 +311,8 @@ class Replane(Generic[ConfigsT]):
 
     def __init__(
         self,
-        base_url: str,
-        sdk_key: str,
+        base_url: str | None = None,
+        sdk_key: str | None = None,
         *,
         context: dict[str, ContextValue] | None = None,
         defaults: dict[str, Any] | None = None,
@@ -327,8 +327,8 @@ def __init__(
         """Initialize the Replane client.
 
         Args:
-            base_url: Base URL of the Replane server.
-            sdk_key: SDK key for authentication.
+            base_url: Base URL of the Replane server. Can also be provided in connect().
+            sdk_key: SDK key for authentication. Can also be provided in connect().
             context: Default context for override evaluation.
             defaults: Default values for configs if not loaded from server.
             required: List of config names that must be present on init.
@@ -359,7 +359,7 @@ def __init__(
                 logger.debug("Default configs: %s", list(defaults.keys()))
             if required:
                 logger.debug("Required configs: %s", required)
-        self._base_url = base_url.rstrip("/")
+        self._base_url = base_url.rstrip("/") if base_url else None
         self._sdk_key = sdk_key
         # Generate replaneClientId and set it as base context.
         # User-provided context values take precedence (merged on top).
@@ -394,20 +394,41 @@ def __init__(
         self._stream_thread: threading.Thread | None = None
         self._stop_event = threading.Event()
 
-    def connect(self, *, wait: bool = True) -> None:
+    def connect(
+        self,
+        base_url: str | None = None,
+        sdk_key: str | None = None,
+        *,
+        wait: bool = True,
+    ) -> None:
         """Connect to the Replane server and start receiving updates.
 
         This starts a background thread that maintains the SSE connection.
 
         Args:
+            base_url: Base URL of the Replane server. Overrides constructor value.
+            sdk_key: SDK key for authentication. Overrides constructor value.
             wait: If True, block until initial configs are loaded.
 
         Raises:
+            ValueError: If base_url or sdk_key is not provided here or in constructor.
             ReplaneError: If connection fails or required configs are missing.
         """
         if self._closed:
             raise ClientClosedError()
 
+        # Apply overrides from connect() if provided
+        if base_url is not None:
+            self._base_url = base_url.rstrip("/")
+        if sdk_key is not None:
+            self._sdk_key = sdk_key
+
+        # Validate required parameters
+        if not self._base_url:
+            raise ValueError("base_url is required - provide it in constructor or connect()")
+        if not self._sdk_key:
+            raise ValueError("sdk_key is required - provide it in constructor or connect()")
+
         logger.debug("connect() called, wait=%s", wait)
 
         self._stream_thread = threading.Thread(