pylookyloo 1.33.0__py3-none-any.whl → 1.36.2__py3-none-any.whl

pylookyloo/api.py

@@ -76,6 +76,7 @@ class CaptureSettings(TypedDict, total=False):
     headless: bool
     viewport: dict[str, int] | None
     referer: str | None
+    categories: list[str] | None
 
     listing: bool | None
     auto_report: bool | dict[str, str] | None
@@ -195,7 +196,8 @@ class Lookyloo():
                viewport: dict[str, int] | None=None,
                referer: str | None=None,
                listing: bool | None=None,
-               auto_report: bool | dict[str, str] | None=None
+               auto_report: bool | dict[str, str] | None=None,
+               categories: list[str] | None=None
                ) -> str:
         ...
 
@@ -222,7 +224,8 @@ class Lookyloo():
                viewport: dict[str, int] | None=None,
                referer: str | None=None,
                listing: bool | None=None,
-               auto_report: bool | dict[str, str] | None=None
+               auto_report: bool | dict[str, str] | None=None,
+               categories: list[str] | None=None
                ) -> str:
         '''Submit a URL to a lookyloo instance.
 
@@ -256,6 +259,7 @@ class Lookyloo():
                             Pass True if you want to autoreport without any setting, or a dictionary with two keys:
                                 * email (required): the email of the submitter, so the analyst to get in touch
                                 * comment (optional): a comment about the capture to help the analyst
+        :param categories: (v1.37.0+) A list of categories to assign to the capture
         '''
         to_send: CaptureSettings
         if capture_settings:
@@ -316,6 +320,8 @@ class Lookyloo():
                 to_send['listing'] = listing
             if auto_report:
                 to_send['auto_report'] = auto_report
+            if categories:
+                to_send['categories'] = categories
 
         response = self.session.post(urljoin(self.root_url, 'submit'), json=to_send)
         response.raise_for_status()
@@ -672,7 +678,8 @@ class Lookyloo():
                        har: Path | BytesIO | str | None = None,
                        html: Path | BytesIO | str | None = None,
                        last_redirected_url: str | None = None,
-                       screenshot: Path | BytesIO | str | None = None) -> str:
+                       screenshot: Path | BytesIO | str | None = None,
+                       categories: list[str] | None=None) -> str:
         ...
 
     @overload
@@ -682,7 +689,8 @@ class Lookyloo():
                        har: Path | BytesIO | str | None = None,
                        html: Path | BytesIO | str | None = None,
                        last_redirected_url: str | None = None,
-                       screenshot: Path | BytesIO | str | None = None) -> tuple[str, dict[str, str]]:
+                       screenshot: Path | BytesIO | str | None = None,
+                       categories: list[str] | None=None) -> tuple[str, dict[str, str]]:
         ...
 
     def upload_capture(self, *, quiet: bool = False,
@@ -691,7 +699,8 @@ class Lookyloo():
                        har: Path | BytesIO | str | None = None,
                        html: Path | BytesIO | str | None = None,
                        last_redirected_url: str | None = None,
-                       screenshot: Path | BytesIO | str | None = None) -> str | tuple[str, dict[str, str]]:
+                       screenshot: Path | BytesIO | str | None = None,
+                       categories: list[str] | None=None) -> str | tuple[str, dict[str, str]]:
         '''Upload a capture via har-file and others
 
         :param quiet: Returns the UUID only, instead of the the UUID and the potential error / warning messages
@@ -701,6 +710,7 @@ class Lookyloo():
         :param html: rendered HTML of the capture
         :param last_redirected_url: The landing page of the capture
         :param screenshot: Screenshot of the capture
+        :param categories: The categories assigned to the capture
         '''
         def encode_document(document: Path | BytesIO | str) -> str:
             if isinstance(document, str):
@@ -713,6 +723,8 @@ class Lookyloo():
             return base64.b64encode(document.getvalue()).decode()
 
         to_send: dict[str, Any] = {'listing': listing}
+        if categories:
+            to_send['categories'] = categories
 
         if full_capture:
             b64_full_capture = encode_document(full_capture)
@@ -734,9 +746,13 @@ class Lookyloo():
         else:
             raise PyLookylooError("Full capture or at least har-file are required")
 
-        r = self.session.post(urljoin(self.root_url, str(PurePosixPath('json', 'upload'))), json=to_send)
-        r.raise_for_status()
-        json_response = r.json()
+        try:
+            r = self.session.post(urljoin(self.root_url, str(PurePosixPath('json', 'upload'))), json=to_send)
+            r.raise_for_status()
+            json_response = r.json()
+        except Exception as e:
+            raise PyLookylooError(f'Unable to upload capture: {e}.')
+
         uuid = json_response['uuid']
         messages = json_response['messages']
 

{pylookyloo-1.33.0.dist-info → pylookyloo-1.36.2.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pylookyloo
-Version: 1.33.0
+Version: 1.36.2
 Summary: Python CLI and module for Lookyloo
 License-Expression: GPL-2.0-or-later
 License-File: LICENSE
 Author: Raphaël Vinot
 Author-email: raphael.vinot@circl.lu
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Information Technology
@@ -14,7 +14,6 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Telecommunications Industry
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -24,8 +23,8 @@ Classifier: Topic :: Internet
 Classifier: Topic :: Security
 Provides-Extra: docs
 Provides-Extra: examples
-Requires-Dist: Sphinx (>=8.2.3) ; (python_version >= "3.11") and (extra == "docs")
-Requires-Dist: pylacus (>=1.18.0) ; extra == "examples"
+Requires-Dist: Sphinx (>=9.1.0) ; (python_version >= "3.12") and (extra == "docs")
+Requires-Dist: pylacus (>=1.21.0) ; extra == "examples"
 Requires-Dist: requests (>=2.32.5)
 Project-URL: Documentation, https://pylookyloo.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/lookyloo/PyLookyloo

pylookyloo-1.36.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+pylookyloo/__init__.py,sha256=_JYXwXHL7ShZkeruvGd8qDTpxNRfuDjvV65SOMMU6yc,1922
+pylookyloo/api.py,sha256=9NFPMcr1WAlesY0dWJSRx8-Nug1OErrYTLp8IZynDLU,37047
+pylookyloo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pylookyloo-1.36.2.dist-info/METADATA,sha256=9xHsTcp6S2yyQf7bgFs-w21JG68GQvHy3v4eMzho0s4,2335
+pylookyloo-1.36.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+pylookyloo-1.36.2.dist-info/entry_points.txt,sha256=y2c0Ujg8co6Xyf7MoxStVU-fLQMZBSGAg-KFidmsha4,44
+pylookyloo-1.36.2.dist-info/licenses/LICENSE,sha256=4C4hLYrIkUD96Ggk-y_Go1Qf7PBZrEm9PSeTGe2nd4s,1516
+pylookyloo-1.36.2.dist-info/RECORD,,

{pylookyloo-1.33.0.dist-info → pylookyloo-1.36.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.2.0
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any

pylookyloo-1.33.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-pylookyloo/__init__.py,sha256=_JYXwXHL7ShZkeruvGd8qDTpxNRfuDjvV65SOMMU6yc,1922
-pylookyloo/api.py,sha256=ehPOX_BWePTRWQu5cAW6Du7y-FY0ViGYMPjFOiN3CvA,36316
-pylookyloo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pylookyloo-1.33.0.dist-info/METADATA,sha256=a1tQ0SFfe22VC0E9dPPqnqFdI9QH5B9rAitYuHssnCk,2384
-pylookyloo-1.33.0.dist-info/WHEEL,sha256=M5asmiAlL6HEcOq52Yi5mmk9KmTVjY2RDPtO4p9DMrc,88
-pylookyloo-1.33.0.dist-info/entry_points.txt,sha256=y2c0Ujg8co6Xyf7MoxStVU-fLQMZBSGAg-KFidmsha4,44
-pylookyloo-1.33.0.dist-info/licenses/LICENSE,sha256=4C4hLYrIkUD96Ggk-y_Go1Qf7PBZrEm9PSeTGe2nd4s,1516
-pylookyloo-1.33.0.dist-info/RECORD,,