python-picnic-api2 1.3.3__tar.gz → 1.3.4__tar.gz

{python_picnic_api2-1.3.3 → python_picnic_api2-1.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-picnic-api2
-Version: 1.3.3
+Version: 1.3.4
 Project-URL: homepage, https://github.com/codesalatdev/python-picnic-api
 Project-URL: repository, https://github.com/codesalatdev/python-picnic-api
 Author-email: Mike Brink <mjh.brink@icloud.com>, CodeSalat <pypi@codesalat.dev>

{python_picnic_api2-1.3.3 → python_picnic_api2-1.3.4}/README.md

@@ -32,6 +32,27 @@ picnic = PicnicAPI(username='username', password='password', country_code="NL")
 
 The country_code parameter defaults to `NL`, but you have to change it if you live in a different country than the Netherlands (ISO 3166-1 Alpha-2). This obviously only works for countries that picnic services.
 
+### Two-factor authentication (2FA)
+
+For new logins, Picnic may require two-factor authentication. When 2FA is required, logging in raises a `Picnic2FARequired` exception. You then need to request a code and verify it:
+
+```python
+from python_picnic_api2 import PicnicAPI, Picnic2FARequired, Picnic2FAError
+
+picnic = PicnicAPI(country_code="NL")
+
+try:
+    picnic.login(username='username', password='password')
+except Picnic2FARequired:
+    # Request a code via SMS or EMAIL
+    picnic.generate_2fa_code(channel="SMS")
+
+    code = input("Enter the code you received: ")
+    picnic.verify_2fa_code(code)
+```
+
+After successful verification, the session is authenticated and you can use the API normally. If the code is invalid, `Picnic2FAError` is raised.
+
 ## Searching for an article
 
 ```python

{python_picnic_api2-1.3.3 → python_picnic_api2-1.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-picnic-api2"
-version = "1.3.3"
+version = "1.3.4"
 description = ""
 readme = "README.rst"
 license = {text = "Apache-2.0"}

{python_picnic_api2-1.3.3 → python_picnic_api2-1.3.4}/src/python_picnic_api2/client.py

@@ -94,8 +94,8 @@ class PicnicAPI:
         if not isinstance(response, dict):
             return False
 
-        error_code = response.get("error", {}).get("code")
-        return error_code == "TWO_FACTOR_AUTHENTICATION_REQUIRED"
+        return "second_factor_authentication_required" in response \
+        and response["second_factor_authentication_required"] is True
 
     def login(self, username: str, password: str):
         path = "/user/login"

{python_picnic_api2-1.3.3 → python_picnic_api2-1.3.4}/tests/test_client.py

@@ -343,11 +343,10 @@ class TestClient(unittest.TestCase):
 
     def test_login_requires_2fa(self):
         response = {
-            "error": {
-                "code": "TWO_FACTOR_AUTHENTICATION_REQUIRED",
-                "message": "User must verify their second factor",
-                "details": {},
-            }
+            "user_id": "123-456-7890",
+            "second_factor_authentication_required": True,
+            "show_second_factor_authentication_intro": False,
+            "error": {},
         }
         self.session_mock().post.return_value = self.MockResponse(response, 200)
 
@@ -355,7 +354,7 @@ class TestClient(unittest.TestCase):
         with self.assertRaises(Picnic2FARequired) as ctx:
             client.login("test-user", "test-password")
         self.assertEqual(
-            str(ctx.exception), "User must verify their second factor"
+            str(ctx.exception), "Two-factor authentication required"
         )
         self.assertEqual(ctx.exception.response, response)
 

{python_picnic_api2-1.3.3 → python_picnic_api2-1.3.4}/uv.lock

@@ -146,7 +146,7 @@ wheels = [
 
 [[package]]
 name = "python-picnic-api2"
-version = "1.3.3"
+version = "1.3.4"
 source = { editable = "." }
 dependencies = [
     { name = "requests" },