python-chargepoint 2.0.0__tar.gz → 2.0.1__tar.gz

{python_chargepoint-2.0.0 → python_chargepoint-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-chargepoint
-Version: 2.0.0
+Version: 2.0.1
 Summary: A simple, Pythonic wrapper for the ChargePoint API.
 License: MIT
 License-File: LICENSE
@@ -77,6 +77,28 @@ await client.login_with_sso_session("<sso jwt>")
 
 ---
 
+### Obtaining Tokens Manually
+
+Password-based login may be blocked by bot-protection (Datadome). When that happens,
+you can capture a token directly from your browser and pass it to the client.
+
+1. Open [https://driver.chargepoint.com](https://driver.chargepoint.com) in your browser and log in normally.
+2. Open Developer Tools and navigate to **Application > Cookies > https://driver.chargepoint.com**.
+3. Copy the value of one of the following cookies:
+
+| Cookie | Use as |
+|---|---|
+| `coulomb_sess` | `coulomb_token=` (recommended — long-lived) |
+| `auth-session` | `login_with_sso_session()` (shorter-lived JWT) |
+
+> **Note:** The `coulomb_sess` value contains `#` and `?` characters. The library handles both raw and URL-encoded (`%23`, `%3F`) forms automatically. When setting it as a shell environment variable, always wrap the value in **double quotes** to prevent the shell from interpreting `#` as a comment:
+>
+> ```bash
+> export CP_COULOMB_TOKEN="Ab3dEf...token...#D???????#RNA-US"
+> ```
+
+---
+
 ### Account
 
 ```python

{python_chargepoint-2.0.0 → python_chargepoint-2.0.1}/README.md

@@ -56,6 +56,28 @@ await client.login_with_sso_session("<sso jwt>")
 
 ---
 
+### Obtaining Tokens Manually
+
+Password-based login may be blocked by bot-protection (Datadome). When that happens,
+you can capture a token directly from your browser and pass it to the client.
+
+1. Open [https://driver.chargepoint.com](https://driver.chargepoint.com) in your browser and log in normally.
+2. Open Developer Tools and navigate to **Application > Cookies > https://driver.chargepoint.com**.
+3. Copy the value of one of the following cookies:
+
+| Cookie | Use as |
+|---|---|
+| `coulomb_sess` | `coulomb_token=` (recommended — long-lived) |
+| `auth-session` | `login_with_sso_session()` (shorter-lived JWT) |
+
+> **Note:** The `coulomb_sess` value contains `#` and `?` characters. The library handles both raw and URL-encoded (`%23`, `%3F`) forms automatically. When setting it as a shell environment variable, always wrap the value in **double quotes** to prevent the shell from interpreting `#` as a comment:
+>
+> ```bash
+> export CP_COULOMB_TOKEN="Ab3dEf...token...#D???????#RNA-US"
+> ```
+
+---
+
 ### Account
 
 ```python

{python_chargepoint-2.0.0 → python_chargepoint-2.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-chargepoint"
-version = "2.0.0"
+version = "2.0.1"
 description = "A simple, Pythonic wrapper for the ChargePoint API."
 authors = ["Marc Billow <mbillow@users.noreply.github.compoetry>"]
 license = "MIT"

{python_chargepoint-2.0.0 → python_chargepoint-2.0.1}/python_chargepoint/client.py

@@ -189,6 +189,18 @@ class ChargePoint:
                 await self._init_account_parameters()
                 return
 
+            if login.status == 403:
+                try:
+                    body = await login.json(content_type=None)
+                    if "url" in body:
+                        raise DatadomeCaptcha(
+                            body["url"], "Login blocked by Datadome captcha."
+                        )
+                except DatadomeCaptcha:
+                    raise
+                except Exception:
+                    pass
+
             _LOGGER.error(
                 "Failed to get auth token! status_code=%s err=%s",
                 login.status,