pylookyloo 1.28.0__py3-none-any.whl → 1.29.0__py3-none-any.whl

pylookyloo/api.py

@@ -60,8 +60,10 @@ class CaptureSettings(TypedDict, total=False):
     device_name: str | None
     user_agent: str | None
     proxy: str | dict[str, str] | None
+    remote_lacus_name: str | None
     general_timeout_in_sec: int | None
     cookies: list[dict[str, Any]] | None
+    storage: str | dict[str, Any] | None
     headers: str | dict[str, str] | None
     http_credentials: dict[str, int] | None
     geolocation: dict[str, float] | None
@@ -127,6 +129,11 @@ class Lookyloo():
         r = self.session.get(urljoin(self.root_url, str(PurePosixPath('json', tree_uuid, 'status'))))
         return r.json()
 
+    def get_remote_lacuses(self) -> list[dict[str, Any]]:
+        '''Get the list of Lacus instances configured on the Lookyloo instance'''
+        r = self.session.get(urljoin(self.root_url, str(PurePosixPath('json', 'remote_lacuses'))))
+        return r.json()
+
     def get_capture_stats(self, tree_uuid: str) -> dict[str, Any]:
         '''Get statistics of the capture'''
         r = self.session.get(urljoin(self.root_url, str(PurePosixPath('json', tree_uuid, 'stats'))))
@@ -169,8 +176,10 @@ class Lookyloo():
                browser: str | None=None, device_name: str | None=None,
                user_agent: str | None=None,
                proxy: str | dict[str, str] | None=None,
+               remote_lacus_name: str | None=None,
                general_timeout_in_sec: int | None=None,
                cookies: list[dict[str, Any]] | None=None,
+               storage: str | dict[str, Any] | None=None,
                headers: str | dict[str, str] | None=None,
                http_credentials: dict[str, int] | None=None,
                geolocation: dict[str, float] | None=None,
@@ -193,8 +202,10 @@ class Lookyloo():
                browser: str | None=None, device_name: str | None=None,
                user_agent: str | None=None,
                proxy: str | dict[str, str] | None=None,
+               remote_lacus_name: str | None=None,
                general_timeout_in_sec: int | None=None,
                cookies: list[dict[str, Any]] | None=None,
+               storage: str | dict[str, Any] | None=None,
                headers: str | dict[str, str] | None=None,
                http_credentials: dict[str, int] | None=None,
                geolocation: dict[str, float] | None=None,
@@ -220,7 +231,8 @@ class Lookyloo():
         :param browser: The browser to use for the capture, must be something Playwright knows
         :param device_name: The name of the device, must be something Playwright knows
         :param user_agent: The user agent the browser will use for the capture
-        :param proxy: SOCKS5 proxy to use for capturing
+        :param proxy: Capture via a proxy. It can either be the full URL to a SOCKS5 proxy, or the name of a specific proxy configured on a remote lacus instance.
+        :param remote_lacus_name: The name of the remote Lacus instance to use for the capture (only if lookyloo is configured this way)
         :param general_timeout_in_sec: The capture will raise a timeout it it takes more than that time
         :param cookies: A list of cookies
         :param headers: The headers to pass to the capture
@@ -270,6 +282,8 @@ class Lookyloo():
                 to_send['general_timeout_in_sec'] = general_timeout_in_sec
             if cookies:
                 to_send['cookies'] = cookies
+            if storage:
+                to_send['storage'] = storage
             if headers:
                 to_send['headers'] = headers
             if http_credentials:
@@ -425,6 +439,14 @@ class Lookyloo():
         r = self.session.get(urljoin(self.root_url, str(PurePosixPath('json', capture_uuid, 'cookies'))))
         return r.json()
 
+    def get_storage(self, capture_uuid: str) -> dict[str, Any]:
+        '''Returns the complete storage state.
+
+        :param capture_uuid: UUID of the capture
+        '''
+        r = self.session.get(urljoin(self.root_url, str(PurePosixPath('json', capture_uuid, 'storage'))))
+        return r.json()
+
     def get_html(self, capture_uuid: str) -> StringIO:
         '''Returns the rendered HTML as it would be in the browser after the page loaded.
 

{pylookyloo-1.28.0.dist-info → pylookyloo-1.29.0.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.3
 Name: pylookyloo
-Version: 1.28.0
+Version: 1.29.0
 Summary: Python CLI and module for Lookyloo
-License: BSD-3-Clause
+License: GPL-2.0-or-later
 Author: Raphaël Vinot
 Author-email: raphael.vinot@circl.lu
 Requires-Python: >=3.9
@@ -11,7 +11,7 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Telecommunications Industry
-Classifier: License :: OSI Approved :: BSD License
+Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
@@ -23,8 +23,8 @@ Classifier: Topic :: Internet
 Classifier: Topic :: Security
 Provides-Extra: docs
 Provides-Extra: examples
-Requires-Dist: Sphinx (>=8.1.3) ; (python_version >= "3.10") and (extra == "docs")
-Requires-Dist: pylacus (>=1.12.1) ; extra == "examples"
+Requires-Dist: Sphinx (>=8.2.3) ; (python_version >= "3.11") and (extra == "docs")
+Requires-Dist: pylacus (>=1.14.0) ; extra == "examples"
 Requires-Dist: requests (>=2.32.3)
 Project-URL: Documentation, https://pylookyloo.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/lookyloo/PyLookyloo

pylookyloo-1.29.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pylookyloo/__init__.py,sha256=_JYXwXHL7ShZkeruvGd8qDTpxNRfuDjvV65SOMMU6yc,1922
+pylookyloo/api.py,sha256=Udgl9O8R1IPzNCXfpP3zad7Y6Q0n2neVEWpAJQ58yHM,31907
+pylookyloo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pylookyloo-1.29.0.dist-info/LICENSE,sha256=4C4hLYrIkUD96Ggk-y_Go1Qf7PBZrEm9PSeTGe2nd4s,1516
+pylookyloo-1.29.0.dist-info/METADATA,sha256=69lw0CSTxdx9wv1H4Ltby-m52jSxjzm_ktD6Ysr7gsw,2387
+pylookyloo-1.29.0.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+pylookyloo-1.29.0.dist-info/entry_points.txt,sha256=y2c0Ujg8co6Xyf7MoxStVU-fLQMZBSGAg-KFidmsha4,44
+pylookyloo-1.29.0.dist-info/RECORD,,

{pylookyloo-1.28.0.dist-info → pylookyloo-1.29.0.dist-info}/WHEEL

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

pylookyloo-1.28.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-pylookyloo/__init__.py,sha256=_JYXwXHL7ShZkeruvGd8qDTpxNRfuDjvV65SOMMU6yc,1922
-pylookyloo/api.py,sha256=h6v4hf4HtxUD-pf4uEKSurMw_QYnpcgYUBk3dv7v1Nc,30733
-pylookyloo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pylookyloo-1.28.0.dist-info/LICENSE,sha256=4C4hLYrIkUD96Ggk-y_Go1Qf7PBZrEm9PSeTGe2nd4s,1516
-pylookyloo-1.28.0.dist-info/METADATA,sha256=mG1xvmCC10QP-yBYZ4PkfI8NVLiZe9f8HOAHLeydKrY,2347
-pylookyloo-1.28.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-pylookyloo-1.28.0.dist-info/entry_points.txt,sha256=y2c0Ujg8co6Xyf7MoxStVU-fLQMZBSGAg-KFidmsha4,44
-pylookyloo-1.28.0.dist-info/RECORD,,