perplexity-webui-scraper 0.3.2__tar.gz → 0.3.3__tar.gz

{perplexity_webui_scraper-0.3.2 → perplexity_webui_scraper-0.3.3}/PKG-INFO

@@ -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 → perplexity_webui_scraper-0.3.3}/README.md

@@ -2,7 +2,7 @@
 
 # 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.3/pyproject.toml

@@ -0,0 +1,103 @@
+[project]
+name = "perplexity-webui-scraper"
+version = "0.3.3"
+description = "Python scraper to extract AI responses from Perplexity's web interface."
+authors = [{ name = "henrique-coder", email = "henriquemoreira10fk@gmail.com" }]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["perplexity", "ai", "scraper", "webui", "api", "client"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "curl-cffi>=0.13.0",
+    "orjson>=3.11.5",
+    "pydantic>=2.12.5",
+]
+
+[dependency-groups]
+dev = [
+    "python-dotenv>=1.2.1",
+    "rich>=14.2.0",
+]
+lint = [
+    "ruff>=0.14.8",
+]
+tests = [
+    "pytest>=9.0.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/henrique-coder/perplexity-webui-scraper"
+Documentation = "https://github.com/henrique-coder/perplexity-webui-scraper#readme"
+Repository = "https://github.com/henrique-coder/perplexity-webui-scraper.git"
+Issues = "https://github.com/henrique-coder/perplexity-webui-scraper/issues"
+Changelog = "https://github.com/henrique-coder/perplexity-webui-scraper/releases"
+
+[tool.ruff]
+line-length = 120
+indent-width = 4
+
+[tool.ruff.lint]
+select = [
+    "F",      # Pyflakes: unused imports/variables, undefined names
+    "E",      # pycodestyle errors: basic PEP 8 style violations
+    "W",      # pycodestyle warnings: whitespace issues, blank lines
+    "I",      # isort: import sorting and organization
+    "UP",     # pyupgrade: upgrade syntax for newer Python versions
+    "B",      # flake8-bugbear: common bugs and design problems
+    "SIM",    # flake8-simplify: simplify complex code patterns
+    "C4",     # flake8-comprehensions: better list/dict/set comprehensions
+    "PIE",    # flake8-pie: misc. lints (unnecessary pass, duplicate keys)
+    "RUF",    # Ruff-specific: modern Python best practices
+    "PERF",   # Perflint: performance anti-patterns
+    "FURB",   # refurb: modernize legacy Python idioms
+    "PTH",    # flake8-use-pathlib: prefer pathlib over os.path
+    "T20",    # flake8-print: detect leftover print() statements
+    "TCH",    # flake8-type-checking: optimize TYPE_CHECKING imports
+    "PL",     # Pylint: broad set of code quality checks
+    "D205",   # 1 blank line required between docstring and code
+]
+ignore = [
+    "PLR0912",   # Too many branches (complex validation logic is acceptable)
+    "PLR0913",   # Too many arguments in function definition (common in APIs)
+    "PLR2004",   # Magic value used in comparison (too strict for general use)
+]
+fixable = ["ALL"]            # Allow auto-fix for all enabled rules
+dummy-variable-rgx = "^_$"   # Only underscore is considered a dummy variable
+
+[tool.ruff.lint.isort]
+known-first-party = ["perplexity_webui_scraper"]
+lines-after-imports = 2             # PEP 8: two blank lines after imports
+force-sort-within-sections = true   # Alphabetical order within each section
+split-on-trailing-comma = true      # Trailing comma triggers multi-line format
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"   # Google-style docstrings (Args, Returns, Raises)
+
+[tool.ruff.lint.flake8-quotes]
+docstring-quotes = "double"   # Docstrings must use triple double quotes
+
+[tool.ruff.format]
+quote-style = "double"              # Strings use double quotes (PEP 8 preference)
+indent-style = "space"              # Spaces over tabs (PEP 8)
+line-ending = "lf"                  # Unix-style line endings
+docstring-code-format = true        # Format code examples inside docstrings
+skip-magic-trailing-comma = false   # Preserve trailing commas as formatting hints
+
+[build-system]
+requires = ["uv_build"]
+build-backend = "uv_build"

{perplexity_webui_scraper-0.3.2 → perplexity_webui_scraper-0.3.3}/src/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-0.3.2 → perplexity_webui_scraper-0.3.3}/src/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-0.3.2 → perplexity_webui_scraper-0.3.3}/src/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-0.3.2 → perplexity_webui_scraper-0.3.3}/src/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/pyproject.toml

@@ -1,27 +0,0 @@
-[project]
-name = "perplexity-webui-scraper"
-version = "0.3.2"
-description = "An unofficial Python client library for interacting with Perplexity AI through its web interface."
-readme = "README.md"
-authors = [
-    { name = "henrique-coder", email = "henriquemoreira10fk@gmail.com" }
-]
-requires-python = ">=3.10"
-dependencies = [
-    "curl-cffi>=0.13.0",
-    "orjson>=3.11.5",
-    "pydantic>=2.12.5",
-]
-
-[dependency-groups]
-dev = [
-    "python-dotenv>=1.2.1",
-    "rich>=14.2.0",
-]
-lint = [
-    "ruff>=0.14.8",
-]
-
-[build-system]
-requires = ["uv_build"]
-build-backend = "uv_build"