perplexity-webui-scraper 0.3.2__py3-none-any.whl → 0.3.3__py3-none-any.whl

perplexity_webui_scraper/__init__.py

@@ -1,4 +1,4 @@
-"""Unofficial Python client for Perplexity AI."""
+"""Extract AI responses from Perplexity's web interface."""
 
 from importlib.metadata import version
 
@@ -17,30 +17,23 @@ from .types import Coordinates, Response, SearchResultItem
 
 
 __version__: str = version("perplexity-webui-scraper")
-
 __all__: list[str] = [
-    # Main client
-    "Perplexity",
+    "AuthenticationError",
+    "CitationMode",
+    "ClientConfig",
     "Conversation",
-    # Configuration
     "ConversationConfig",
-    "ClientConfig",
     "Coordinates",
-    # Enums
-    "CitationMode",
-    "SearchFocus",
-    "SourceFocus",
-    "TimeRange",
-    # Models
-    "Model",
-    "Models",
-    # Response types
-    "Response",
-    "SearchResultItem",
-    # Exceptions
-    "AuthenticationError",
     "FileUploadError",
     "FileValidationError",
+    "Model",
+    "Models",
+    "Perplexity",
     "PerplexityError",
     "RateLimitError",
+    "Response",
+    "SearchFocus",
+    "SearchResultItem",
+    "SourceFocus",
+    "TimeRange",
 ]

perplexity_webui_scraper/config.py

@@ -6,11 +6,11 @@ from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
 from .enums import CitationMode, SearchFocus, SourceFocus, TimeRange
-from .types import Coordinates
 
 
 if TYPE_CHECKING:
     from .models import Model
+    from .types import Coordinates
 
 
 @dataclass(slots=True)

perplexity_webui_scraper/core.py

@@ -2,16 +2,19 @@
 
 from __future__ import annotations
 
-from collections.abc import Generator
 from mimetypes import guess_type
 from os import PathLike
 from pathlib import Path
-from re import Match
-from typing import Any
+from typing import TYPE_CHECKING, Any
 from uuid import uuid4
 
 from orjson import loads
 
+
+if TYPE_CHECKING:
+    from collections.abc import Generator
+    from re import Match
+
 from .config import ClientConfig, ConversationConfig
 from .constants import (
     API_VERSION,
@@ -31,11 +34,21 @@ from .types import Response, SearchResultItem, _FileInfo
 
 
 class Perplexity:
-    """Perplexity AI client."""
+    """Web scraper for Perplexity AI conversations."""
 
     __slots__ = ("_http",)
 
     def __init__(self, session_token: str, config: ClientConfig | None = None) -> None:
+        """Initialize web scraper with session token.
+
+        Args:
+            session_token: Perplexity session cookie (__Secure-next-auth.session-token).
+            config: Optional HTTP client configuration.
+
+        Raises:
+            ValueError: If session_token is empty or whitespace.
+        """
+
         if not session_token or not session_token.strip():
             raise ValueError("session_token cannot be empty")
 
@@ -58,20 +71,20 @@ class Perplexity:
 
 
 class Conversation:
-    """A conversation with Perplexity AI."""
+    """Manage a Perplexity conversation with query and follow-up support."""
 
     __slots__ = (
-        "_http",
-        "_config",
-        "_citation_mode",
-        "_backend_uuid",
-        "_read_write_token",
-        "_title",
         "_answer",
+        "_backend_uuid",
         "_chunks",
-        "_search_results",
+        "_citation_mode",
+        "_config",
+        "_http",
         "_raw_data",
+        "_read_write_token",
+        "_search_results",
         "_stream_generator",
+        "_title",
     )
 
     def __init__(self, http: HTTPClient, config: ConversationConfig) -> None:
@@ -120,7 +133,7 @@ class Conversation:
         citation_mode: CitationMode | None = None,
         stream: bool = False,
     ) -> Conversation:
-        """Send a message. Returns self for chaining or streaming."""
+        """Ask a question. Returns self for method chaining or streaming iteration."""
         effective_model = model or self._config.model or Models.BEST
         effective_citation = citation_mode if citation_mode is not None else self._config.citation_mode
         self._citation_mode = effective_citation
@@ -255,7 +268,9 @@ class Conversation:
     ) -> dict[str, Any]:
         cfg = self._config
 
-        sources = [s.value for s in cfg.source_focus] if isinstance(cfg.source_focus, list) else [cfg.source_focus.value]
+        sources = (
+            [s.value for s in cfg.source_focus] if isinstance(cfg.source_focus, list) else [cfg.source_focus.value]
+        )
 
         client_coordinates = None
         if cfg.coordinates is not None:

perplexity_webui_scraper/http.py

@@ -2,10 +2,14 @@
 
 from __future__ import annotations
 
-from collections.abc import Generator
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 from curl_cffi.requests import Response as CurlResponse
+
+
+if TYPE_CHECKING:
+    from collections.abc import Generator
+
 from curl_cffi.requests import Session
 
 from .constants import (
@@ -72,9 +76,9 @@ class HTTPClient:
         elif status_code == 429:
             raise RateLimitError() from error
         elif status_code is not None:
-            raise PerplexityError(f"{context}HTTP {status_code}: {str(error)}", status_code=status_code) from error
+            raise PerplexityError(f"{context}HTTP {status_code}: {error!s}", status_code=status_code) from error
         else:
-            raise PerplexityError(f"{context}{str(error)}") from error
+            raise PerplexityError(f"{context}{error!s}") from error
 
     def get(self, endpoint: str, params: dict[str, Any] | None = None) -> CurlResponse:
         """Make a GET request.

{perplexity_webui_scraper-0.3.2.dist-info → perplexity_webui_scraper-0.3.3.dist-info}/METADATA

@@ -1,20 +1,40 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: perplexity-webui-scraper
-Version: 0.3.2
-Summary: An unofficial Python client library for interacting with Perplexity AI through its web interface.
+Version: 0.3.3
+Summary: Python scraper to extract AI responses from Perplexity's web interface.
+Keywords: perplexity,ai,scraper,webui,api,client
 Author: henrique-coder
 Author-email: henrique-coder <henriquemoreira10fk@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
 Requires-Dist: curl-cffi>=0.13.0
 Requires-Dist: orjson>=3.11.5
 Requires-Dist: pydantic>=2.12.5
 Requires-Python: >=3.10
+Project-URL: Changelog, https://github.com/henrique-coder/perplexity-webui-scraper/releases
+Project-URL: Documentation, https://github.com/henrique-coder/perplexity-webui-scraper#readme
+Project-URL: Homepage, https://github.com/henrique-coder/perplexity-webui-scraper
+Project-URL: Issues, https://github.com/henrique-coder/perplexity-webui-scraper/issues
+Project-URL: Repository, https://github.com/henrique-coder/perplexity-webui-scraper.git
 Description-Content-Type: text/markdown
 
 <div align="center">
 
 # Perplexity WebUI Scraper
 
-Unofficial Python client for [Perplexity AI](https://www.perplexity.ai).
+Python scraper to extract AI responses from [Perplexity's](https://www.perplexity.ai) web interface.
 
 [![PyPI](https://img.shields.io/pypi/v/perplexity-webui-scraper?color=blue)](https://pypi.org/project/perplexity-webui-scraper)
 [![Python](https://img.shields.io/pypi/pyversions/perplexity-webui-scraper)](https://pypi.org/project/perplexity-webui-scraper)

{perplexity_webui_scraper-0.3.2.dist-info → perplexity_webui_scraper-0.3.3.dist-info}/RECORD

@@ -1,14 +1,14 @@
-perplexity_webui_scraper/__init__.py,sha256=pOj45Fk5ZspW7SniWrakjNpBEUNh3Zw0510h-R01p_U,1040
-perplexity_webui_scraper/config.py,sha256=Tslz5p1Ig4oooRiRIZkgnxBNH4k7VmEswkogmEcDd1U,940
+perplexity_webui_scraper/__init__.py,sha256=ytFPohwQGMEEI51-fp6-_4WBWotPMcm2gNGqT3Pz9VA,948
+perplexity_webui_scraper/config.py,sha256=YrQgapklVDLMdM-FGLqfUcp1IOMeKlXqz1bNKpOloZY,944
 perplexity_webui_scraper/constants.py,sha256=ycXV8SCcP_vUCkmznVhE9oykZccaxuDNWmgrdJLGLyM,2943
-perplexity_webui_scraper/core.py,sha256=wrlVhRWMyhlIzXeJD6TMzuTAcMDw6jpIimIajLgDV-k,13586
+perplexity_webui_scraper/core.py,sha256=QxkTs3jJCA_eE4HpI8sUKcdU_WU2JVAgyKlmqNmcBng,14034
 perplexity_webui_scraper/enums.py,sha256=Xo7RmtWFxhSQU2Zma5sFmMyitOqlqjAb4XwRC0KJON0,2124
 perplexity_webui_scraper/exceptions.py,sha256=0oOWe_A0B0wBsFeogt323BGJY3oBzaFK9PItXs77J70,1629
-perplexity_webui_scraper/http.py,sha256=cKxqW1_dJwP9TZbqM_BrJcft3sBmRZxO1owewZKYE7A,5578
+perplexity_webui_scraper/http.py,sha256=xOC4ppfsennESNj8uC5zuNxAxAjy9Qya9moUwEzcg9o,5612
 perplexity_webui_scraper/limits.py,sha256=qFKTO-qCy3f_XE2RWFGIgZXeAEaTTvEqLjuIX8cBUN8,561
 perplexity_webui_scraper/models.py,sha256=HufYUW0aM8MHvU0L4i8muGi6_Rmi7sNZC9JpY_BINY0,1892
 perplexity_webui_scraper/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 perplexity_webui_scraper/types.py,sha256=VlnzvNilIHrDXM2YOGjJa1y2VY0tfR-F0zaPjQHoPKs,1028
-perplexity_webui_scraper-0.3.2.dist-info/WHEEL,sha256=93kfTGt3a0Dykt_T-gsjtyS5_p8F_d6CE1NwmBOirzo,79
-perplexity_webui_scraper-0.3.2.dist-info/METADATA,sha256=EmEo2CBTL6rckxyYYc3pq3s07cNopGK8axeEfoA44_w,4775
-perplexity_webui_scraper-0.3.2.dist-info/RECORD,,
+perplexity_webui_scraper-0.3.3.dist-info/WHEEL,sha256=xDCZ-UyfvkGuEHPeI7BcJzYKIZzdqN8A8o1M5Om8IyA,79
+perplexity_webui_scraper-0.3.3.dist-info/METADATA,sha256=J3qKWSevwp-iDJVsfgwRee6HunMFDe-fhsyznANgHlo,5924
+perplexity_webui_scraper-0.3.3.dist-info/RECORD,,

{perplexity_webui_scraper-0.3.2.dist-info → perplexity_webui_scraper-0.3.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.16
+Generator: uv 0.9.17
 Root-Is-Purelib: true
 Tag: py3-none-any