terndata.ecoplots 0.0.3b0__tar.gz → 0.0.4b0__tar.gz

{terndata_ecoplots-0.0.3b0 → terndata_ecoplots-0.0.4b0}/LICENSE

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2025  TERN Data Services and Analytics (TDSA)
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{terndata_ecoplots-0.0.3b0 → terndata_ecoplots-0.0.4b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: terndata.ecoplots
-Version: 0.0.3b0
+Version: 0.0.4b0
 Summary: TERN ecoplots data access library
 Author-email: Avinash Chandra <avinash.chandra@uq.edu.au>
 Maintainer-email: "TERN Data Services and Analytics (TDSA)" <esupport@tern.org.au>
@@ -26,9 +26,9 @@ Requires-Dist: numpy
 Requires-Dist: pandas
 Requires-Dist: geopandas
 Requires-Dist: requests
+Requires-Dist: aiohttp<4.0.0,>=3.11.12
 Requires-Dist: python-dateutil
 Requires-Dist: pytz
-Requires-Dist: httpx<1.0.0,>=0.28.1
 Requires-Dist: rapidfuzz<4.0.0,>=3.13.0
 Requires-Dist: orjson<4.0.0,>=3.10.15
 Requires-Dist: diskcache<6.0.0,>=5.6.3
@@ -77,25 +77,35 @@ Supported Python: 3.10+
 
 ## Quick start
 
-    from terndata.ecoplots import EcoPlots
+```python
+from terndata.ecoplots import EcoPlots
 
-    ec = EcoPlots()
-    ec.select(site_id="TCFTNS0002")    # add validated filters
-    preview = ec.preview().head()      # quick look (first page)
-    gdf = ec.get_data()                # full pull (GeoDataFrame)
+ec = EcoPlots()
+ec.select(site_id="TCFTNS0002")    # add validated filters
+preview = ec.preview().head()      # quick look (first page)
+gdf = ec.get_data()                # full pull (GeoDataFrame)
+```
 
 ### Async
 
-    import asyncio
-    from terndata.ecoplots import AsyncEcoPlots
+```python
+import asyncio
+from terndata.ecoplots import AsyncEcoPlots
 
-    async def main():
-        ec = AsyncEcoPlots()
-        ec.select(site_id="TCFTNS0002")
-        gdf = await ec.get_data()
-        return gdf
+async def main():
+    ec = AsyncEcoPlots()
+    ec.select(site_id="TCFTNS0002")
+    gdf = await ec.get_data()
+    return gdf
 
-    # asyncio.run(main())
+# asyncio.run(main())
+```
+
+---
+
+## Demo
+
+For example usage, please refer to the [demo notebook](examples/demo.ipynb).
 
 ---
 

{terndata_ecoplots-0.0.3b0 → terndata_ecoplots-0.0.4b0}/README.md

@@ -36,25 +36,35 @@ Supported Python: 3.10+
 
 ## Quick start
 
-    from terndata.ecoplots import EcoPlots
+```python
+from terndata.ecoplots import EcoPlots
 
-    ec = EcoPlots()
-    ec.select(site_id="TCFTNS0002")    # add validated filters
-    preview = ec.preview().head()      # quick look (first page)
-    gdf = ec.get_data()                # full pull (GeoDataFrame)
+ec = EcoPlots()
+ec.select(site_id="TCFTNS0002")    # add validated filters
+preview = ec.preview().head()      # quick look (first page)
+gdf = ec.get_data()                # full pull (GeoDataFrame)
+```
 
 ### Async
 
-    import asyncio
-    from terndata.ecoplots import AsyncEcoPlots
+```python
+import asyncio
+from terndata.ecoplots import AsyncEcoPlots
 
-    async def main():
-        ec = AsyncEcoPlots()
-        ec.select(site_id="TCFTNS0002")
-        gdf = await ec.get_data()
-        return gdf
+async def main():
+    ec = AsyncEcoPlots()
+    ec.select(site_id="TCFTNS0002")
+    gdf = await ec.get_data()
+    return gdf
 
-    # asyncio.run(main())
+# asyncio.run(main())
+```
+
+---
+
+## Demo
+
+For example usage, please refer to the [demo notebook](examples/demo.ipynb).
 
 ---
 

{terndata_ecoplots-0.0.3b0 → terndata_ecoplots-0.0.4b0}/docs/conf.py

@@ -8,6 +8,18 @@ SRC = ROOT / "src"
 if str(SRC) not in sys.path:
     sys.path.insert(0, str(SRC))
 
+# Debug: Print Python path for troubleshooting
+print(f"[DEBUG] Python path: {sys.path[:3]}")
+print(f"[DEBUG] ROOT: {ROOT}")
+print(f"[DEBUG] SRC: {SRC}")
+
+# Test import to catch errors early
+try:
+    import terndata.ecoplots
+    print(f"[DEBUG] Successfully imported terndata.ecoplots from {terndata.ecoplots.__file__}")
+except ImportError as e:
+    print(f"[ERROR] Failed to import terndata.ecoplots: {e}")
+
 project = "terndata.ecoplots"
 author = "Avinash Chandra"
 
@@ -15,7 +27,7 @@ START_YEAR = 2025
 YEAR = datetime.now(timezone.utc).year
 years = f"{START_YEAR}-{YEAR}" if YEAR > START_YEAR else f"{YEAR}"
 copyright = f"{years}, TDSA (TERN Data Services and Analytics)"  # noqa: A001
-release = "0.1.0"
+release = "0.0.4-beta"
 
 extensions = [
     "sphinx.ext.autodoc",
@@ -89,8 +101,6 @@ autodoc_mock_imports = [
     "fiona",
     "pyproj",
     "rtree",
-    "numpy",
-    "pandas",
 ]
 
 exclude_patterns = ["api/modules.rst"]

{terndata_ecoplots-0.0.3b0 → terndata_ecoplots-0.0.4b0}/docs/index.rst

@@ -32,16 +32,16 @@
      </div>
    </div>
 
-What is EcoPlots?
-==================
+About EcoPlots
+==============
 TERN EcoPlots is a platform designed for searching, discovering, and accessing ecological observations—both from systematic site-based surveys and opportunistic surveys—as well as specimen samples collected during field surveys from various data sources. With TERN EcoPlots, users can search for observation data and specimen samples from systematic surveys across Australia. The platform allows users to integrate data from multiple sources and access it as a comprehensive, ready-to-use data package. Additionally, users can search for specimen samples and request access to these samples for further research.
 
 TERN EcoPlots is developed based on a semantic data integration approach. Datasets are generally received from custodians in various forms, including PostgreSQL databases and CSV file formats. In the data ingestion process, each source dataset is mapped to a `TERN Plot ontology <https://linkeddata.tern.org.au/information-models/tern-ontology>`_ including the identification and mapping of domain feature types, parameters, and categorical values to controlled vocabularies, as well as the performance of data validation routines and the resolution of taxonomic names. All data are organised in Resource Description Framework (RDF) and stored in a triple store.
 
 See also: `EcoPlots Portal <https://ecoplots.tern.org.au>`_.
 
-What is the EcoPlots Python library?
-====================================
+EcoPlots Python library
+=======================
 The EcoPlots Python library provides a small, Pythonic client for the EcoPlots REST API, so you can programmatically discover datasets, apply validated filters, preview results, and retrieve analysis-ready data.
 
 Key capabilities:
@@ -63,6 +63,7 @@ Installation
 
 Next steps
 ==========
+- `Demo Notebook <https://github.com/ternaustralia/terndata.ecoplots/blob/main/examples/demo.ipynb>`_ - Interactive examples and usage patterns
 - :doc:`Package overview <api/overview>`
 - :doc:`EcoPlots Client <api/ecoplots_class>`
 - :doc:`Async EcoPlots client <api/async_ecoplots_class>`

terndata_ecoplots-0.0.4b0/docs/requirements.txt

@@ -0,0 +1,13 @@
+sphinx>=7.0
+myst-parser
+furo
+sphinx-autobuild
+
+# Core dependencies needed for autodoc to import the package
+aiohttp
+orjson
+requests
+diskcache
+pandas
+numpy
+rapidfuzz