pyfunda 3.1.0__tar.gz → 3.1.1__tar.gz

{pyfunda-3.1.0 → pyfunda-3.1.1}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: pyfunda
-Version: 3.1.0
-Summary: Python API for Funda.nl real estate listings
+Version: 3.1.1
+Summary: Python API wrapper for Funda.nl, the Dutch real estate platform. Reverse-engineered mobile API client, no scraping, no Selenium, no CAPTCHA.
 Project-URL: Homepage, https://github.com/0xMH/pyfunda
 Project-URL: Repository, https://github.com/0xMH/pyfunda
 Project-URL: Issues, https://github.com/0xMH/pyfunda/issues
 Author: 0xMH
 License-Expression: AGPL-3.0-or-later
 License-File: LICENSE
-Keywords: api,funda,housing,netherlands,real-estate,scraper
+Keywords: api,api-wrapper,client,dutch,funda,funda-api,funda-nl,funda-scraper,housing,housing-api,mobile-api,netherlands,real-estate,real-estate-api,rest-api,reverse-engineering,scraper,sdk
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
@@ -29,9 +29,17 @@ Description-Content-Type: text/markdown
 [![Python versions](https://img.shields.io/pypi/pyversions/pyfunda)](https://pypi.org/project/pyfunda/)
 [![License](https://img.shields.io/pypi/l/pyfunda)](https://github.com/0xMH/pyfunda/blob/main/LICENSE)
 
-The only working real Python API for Funda ([funda.nl](https://www.funda.nl)) -- the Netherlands' largest real estate platform.
+**pyfunda** is a Python API wrapper for [Funda.nl](https://www.funda.nl), the Netherlands' largest Dutch real estate platform. It talks to Funda's reverse engineered mobile JSON API, so you get clean typed objects for listings, prices, media, brokers, and price history without HTML scraping, Selenium, a headless browser, or CAPTCHA solving.
 
-> If you find this useful, consider giving it a star -- it helps others discover the project.
+Funda has no public developer API. pyfunda is the only working opensource Python client that hits Funda's app facing `*.funda.io` endpoints directly, the same ones the official Android app uses.
+
+```bash
+pip install pyfunda
+```
+
+Use pyfunda as a Funda API client or Funda Python SDK to fetch Dutch property listings, run search queries by city and price, pull listing detail and media, get broker info and reviews, read price history, and stream new listings. If you have been looking for a working fundascraper alternative or a Netherlands housing API, this is the only Python wrapper hitting the same `*.funda.io` endpoints the Funda Android app uses.
+
+> If you find this useful, consider giving it a star, it helps others discover the project.
 
 [![Star History Chart](https://api.star-history.com/svg?repos=0xMH/pyfunda&type=Date)](https://star-history.com/#0xMH/pyfunda&Date)
 

{pyfunda-3.1.0 → pyfunda-3.1.1}/README.md

@@ -4,9 +4,17 @@
 [![Python versions](https://img.shields.io/pypi/pyversions/pyfunda)](https://pypi.org/project/pyfunda/)
 [![License](https://img.shields.io/pypi/l/pyfunda)](https://github.com/0xMH/pyfunda/blob/main/LICENSE)
 
-The only working real Python API for Funda ([funda.nl](https://www.funda.nl)) -- the Netherlands' largest real estate platform.
+**pyfunda** is a Python API wrapper for [Funda.nl](https://www.funda.nl), the Netherlands' largest Dutch real estate platform. It talks to Funda's reverse engineered mobile JSON API, so you get clean typed objects for listings, prices, media, brokers, and price history without HTML scraping, Selenium, a headless browser, or CAPTCHA solving.
 
-> If you find this useful, consider giving it a star -- it helps others discover the project.
+Funda has no public developer API. pyfunda is the only working opensource Python client that hits Funda's app facing `*.funda.io` endpoints directly, the same ones the official Android app uses.
+
+```bash
+pip install pyfunda
+```
+
+Use pyfunda as a Funda API client or Funda Python SDK to fetch Dutch property listings, run search queries by city and price, pull listing detail and media, get broker info and reviews, read price history, and stream new listings. If you have been looking for a working fundascraper alternative or a Netherlands housing API, this is the only Python wrapper hitting the same `*.funda.io` endpoints the Funda Android app uses.
+
+> If you find this useful, consider giving it a star, it helps others discover the project.
 
 [![Star History Chart](https://api.star-history.com/svg?repos=0xMH/pyfunda&type=Date)](https://star-history.com/#0xMH/pyfunda&Date)
 

pyfunda-3.1.0/funda/autocomplete.py → pyfunda-3.1.1/funda/_autocomplete.py

@@ -1,4 +1,4 @@
-"""Autocomplete payload construction."""
+"""Internal autocomplete payload construction."""
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from funda.models import JsonDict
 
 
 @dataclass(frozen=True, slots=True)
-class _LocationAutocomplete:
+class LocationAutocomplete:
     value: str
     timeout: str = "3s"
     size: int = 10

{pyfunda-3.1.0 → pyfunda-3.1.1}/funda/funda.py

@@ -28,7 +28,7 @@ from funda.constants import (
     PAGE_SIZE,
 )
 from funda.exceptions import FundaRequestError, ListingNotFound, PriceHistoryError, SearchError
-from funda.autocomplete import _LocationAutocomplete
+from funda._autocomplete import LocationAutocomplete
 from funda.listing import Listing, LocationSuggestion, PriceHistory
 from funda.models import JsonDict
 from funda.parsing import (
@@ -84,7 +84,7 @@ class Funda:
     def __enter__(self) -> "Funda":
         return self
 
-    def __exit__(self, *args) -> None:
+    def __exit__(self, *_) -> None:
         self.close()
 
     def listing(self, listing_id: int | str) -> Listing:
@@ -130,7 +130,7 @@ class Funda:
         sort: Sequence[Any] | None = None,
     ) -> list[LocationSuggestion]:
         """Suggest Funda location identifiers for search-box text."""
-        autocomplete = _LocationAutocomplete(
+        autocomplete = LocationAutocomplete(
             value=value,
             size=size,
             timeout=timeout,
@@ -434,7 +434,7 @@ class Funda:
 
         raise SearchError("Search failed without a response")
 
-    def _autocomplete(self, autocomplete: _LocationAutocomplete) -> JsonDict:
+    def _autocomplete(self, autocomplete: LocationAutocomplete) -> JsonDict:
         payload = autocomplete.to_payload()
         for attempt in range(3):
             response = self._transport.post(

{pyfunda-3.1.0 → pyfunda-3.1.1}/pyproject.toml

@@ -4,15 +4,34 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyfunda"
-version = "3.1.0"
-description = "Python API for Funda.nl real estate listings"
+version = "3.1.1"
+description = "Python API wrapper for Funda.nl, the Dutch real estate platform. Reverse-engineered mobile API client, no scraping, no Selenium, no CAPTCHA."
 readme = "README.md"
 license = "AGPL-3.0-or-later"
 requires-python = ">=3.10"
 authors = [
     { name = "0xMH" }
 ]
-keywords = ["funda", "real-estate", "netherlands", "housing", "api", "scraper"]
+keywords = [
+    "funda",
+    "funda-api",
+    "funda-nl",
+    "funda-scraper",
+    "real-estate",
+    "real-estate-api",
+    "netherlands",
+    "dutch",
+    "housing",
+    "housing-api",
+    "api",
+    "api-wrapper",
+    "rest-api",
+    "client",
+    "sdk",
+    "mobile-api",
+    "reverse-engineering",
+    "scraper",
+]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",

{pyfunda-3.1.0 → pyfunda-3.1.1}/tests/test_autocomplete.py

@@ -1,6 +1,6 @@
 import unittest
 
-from funda.autocomplete import _LocationAutocomplete
+from funda._autocomplete import LocationAutocomplete
 from funda.constants import (
     LOCATION_AUTOCOMPLETE_AREA_TYPES,
     LOCATION_AUTOCOMPLETE_TEMPLATE_ID,
@@ -45,7 +45,7 @@ AUTOCOMPLETE_RESPONSE = {
 
 class AutocompleteTests(unittest.TestCase):
     def test_payload_matches_funda_searchbox_template(self) -> None:
-        payload = _LocationAutocomplete("almere poor").to_payload()
+        payload = LocationAutocomplete("almere poor").to_payload()
 
         self.assertEqual(payload["id"], LOCATION_AUTOCOMPLETE_TEMPLATE_ID)
         self.assertEqual(payload["params"]["value"], "almere poor")
@@ -60,7 +60,7 @@ class AutocompleteTests(unittest.TestCase):
         )
 
     def test_payload_can_limit_area_types_for_vague_area_searches(self) -> None:
-        payload = _LocationAutocomplete(
+        payload = LocationAutocomplete(
             "amsterdam west",
             area_types=("city", "municipality", "neighborhood", "wijk"),
             size=5,
@@ -74,9 +74,9 @@ class AutocompleteTests(unittest.TestCase):
 
     def test_invalid_payload_values_fail_before_network(self) -> None:
         with self.assertRaises(ValueError):
-            _LocationAutocomplete("").to_payload()
+            LocationAutocomplete("").to_payload()
         with self.assertRaises(ValueError):
-            _LocationAutocomplete("amsterdam", size=0).to_payload()
+            LocationAutocomplete("amsterdam", size=0).to_payload()
 
     def test_parse_location_suggestions_maps_geo_hits(self) -> None:
         suggestions = parse_location_suggestions(AUTOCOMPLETE_RESPONSE)