pylookyloo 1.25.0__tar.gz → 1.26.1__tar.gz

{pylookyloo-1.25.0 → pylookyloo-1.26.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pylookyloo
-Version: 1.25.0
+Version: 1.26.1
 Summary: Python CLI and module for Lookyloo
 Home-page: https://github.com/lookyloo/PyLookyloo
 License: BSD-3-Clause
@@ -24,7 +24,8 @@ Classifier: Topic :: Internet
 Classifier: Topic :: Security
 Provides-Extra: docs
 Requires-Dist: Sphinx (<7.2) ; (python_version < "3.9") and (extra == "docs")
-Requires-Dist: Sphinx (>=7.2,<8.0) ; (python_version >= "3.9") and (extra == "docs")
+Requires-Dist: Sphinx (>=7.2,<8.0) ; (python_version >= "3.9" and python_version < "3.10") and (extra == "docs")
+Requires-Dist: Sphinx (>=8,<9) ; (python_version >= "3.10") and (extra == "docs")
 Requires-Dist: requests (>=2.32.3,<3.0.0)
 Project-URL: Documentation, https://pylookyloo.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/lookyloo/PyLookyloo

{pylookyloo-1.25.0 → pylookyloo-1.26.1}/pylookyloo/api.py

@@ -42,6 +42,7 @@ class CaptureSettings(TypedDict, total=False):
     timezone_id: str | None
     locale: str | None
     color_scheme: str | None
+    java_script_enabled: bool
     viewport: dict[str, int] | None
     referer: str | None
 
@@ -147,6 +148,7 @@ class Lookyloo():
                timezone_id: str | None=None,
                locale: str | None=None,
                color_scheme: str | None=None,
+               java_script_enabled: bool=True,
                viewport: dict[str, int] | None=None,
                referer: str | None=None,
                listing: bool | None=None,
@@ -169,6 +171,7 @@ class Lookyloo():
                timezone_id: str | None=None,
                locale: str | None=None,
                color_scheme: str | None=None,
+               java_script_enabled: bool | None=None,
                viewport: dict[str, int] | None=None,
                referer: str | None=None,
                listing: bool | None=None,
@@ -195,6 +198,7 @@ class Lookyloo():
         :param timezone_id: The timezone, warning, it m ust be a valid timezone (continent/city)
         :param locale: The locale of the browser
         :param color_scheme: The prefered color scheme of the browser (light or dark)
+        :param java_script_enabled: If False, no JS will run during the capture.
         :param viewport: The viewport of the browser used for capturing
         :param referer: The referer URL for the capture
         :param listing: If False, the capture will be not be on the publicly accessible index page of lookyloo
@@ -246,6 +250,8 @@ class Lookyloo():
                 to_send['locale'] = locale
             if color_scheme:
                 to_send['color_scheme'] = color_scheme
+            if java_script_enabled is not None:
+                to_send['java_script_enabled'] = java_script_enabled
             if viewport:
                 to_send['viewport'] = viewport
             if referer:
@@ -330,6 +336,13 @@ class Lookyloo():
         r = self.session.post(urljoin(self.root_url, str(PurePosixPath('admin', tree_uuid, 'hide'))))
         return r.json()
 
+    def remove_capture(self, tree_uuid: str) -> dict[str, str]:
+        '''Remove a capture, it will be impossible to get it by UUID (requires an authenticated user, use init_apikey first)'''
+        if not self.apikey:
+            raise AuthError('You need to initialize the apikey to use this method (see init_apikey)')
+        r = self.session.post(urljoin(self.root_url, str(PurePosixPath('admin', tree_uuid, 'remove'))))
+        return r.json()
+
     def get_redirects(self, capture_uuid: str) -> dict[str, Any]:
         '''Returns the initial redirects.
 
@@ -498,14 +511,26 @@ class Lookyloo():
     def get_recent_captures(self, timestamp: str | datetime | float | None=None) -> list[str]:
         '''Gets the uuids of the most recent captures
 
-        :param timestamp: Timestamp of the capture
+        :param timestamp: Oldest timestamp to consider
         '''
-        if not timestamp:
-            url = urljoin(self.root_url, str(PurePosixPath('json', 'recent_captures')))
-        else:
+        if timestamp:
             if isinstance(timestamp, datetime):
                 timestamp = timestamp.timestamp()
             url = urljoin(self.root_url, str(PurePosixPath('json', 'recent_captures', str(timestamp))))
+        else:
+            url = urljoin(self.root_url, str(PurePosixPath('json', 'recent_captures')))
+        r = self.session.get(url)
+        return r.json()
+
+    def get_categories_captures(self, category: str | None=None) -> list[str] | dict[str, list[str]] | None:
+        '''Get uuids for a specific category or all categorized uuids if category is None
+
+        :param category: The category according to which the uuids are to be returned
+        '''
+        if category:
+            url = urljoin(self.root_url, str(PurePosixPath('json', 'categories', category)))
+        else:
+            url = urljoin(self.root_url, str(PurePosixPath('json', 'categories')))
         r = self.session.get(url)
         return r.json()
 

{pylookyloo-1.25.0 → pylookyloo-1.26.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pylookyloo"
-version = "1.25.0"
+version = "1.26.1"
 description = "Python CLI and module for Lookyloo"
 authors = ["Raphaël Vinot <raphael.vinot@circl.lu>"]
 license = "BSD-3-Clause"
@@ -34,18 +34,19 @@ python = "^3.8"
 requests = "^2.32.3"
 Sphinx = [
     {version = "<7.2", python = "<3.9", optional = true},
-    {version = "^7.2", python = ">=3.9", optional = true}
+    {version = "^7.2", python = ">=3.9,<3.10", optional = true},
+    {version = "^8", python = ">=3.10", optional = true}
 ]
 
 [tool.poetry.group.dev.dependencies]
-mypy = "^1.10.1"
-types-requests = "^2.32.0.20240622"
+mypy = "^1.11.2"
+types-requests = "^2.32.0.20240914"
 ipython = [
     {version = "<8.13.0", python = "<3.9"},
     {version = "^8.18.0", python = ">=3.9"},
     {version = "^8.19.0", python = ">=3.10"}
 ]
-pytest = "^8.2.2"
+pytest = "^8.3.3"
 
 [tool.poetry.extras]
 docs = ["Sphinx"]