isaac-data 0.1.3__tar.gz

isaac_data-0.1.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Board of Trustees of the University of Illinois
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

isaac_data-0.1.3/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: isaac-data
+Version: 0.1.3
+Summary: Python loader for the ISAAC Reddit corpus (Illinois Social Attitudes Aggregate Corpus) direct-download endpoint.
+Author-email: Babak Hemmatian <babak.hemmatian@gmail.com>
+Maintainer: ISAAC / Social Cognition Lab, University of Illinois Urbana-Champaign
+License-Expression: MIT
+Project-URL: Homepage, https://isaac.psychology.illinois.edu/
+Project-URL: Documentation, https://isaac.psychology.illinois.edu/direct-download/
+Project-URL: Source, https://github.com/BabakHemmatian/Illinois_Social_Attitudes/tree/main/isaac-data-loader
+Project-URL: Issues, https://github.com/BabakHemmatian/Illinois_Social_Attitudes/issues
+Project-URL: Citation, https://github.com/BabakHemmatian/Illinois_Social_Attitudes/blob/main/CITATION.cff
+Keywords: ISAAC,reddit,corpus,dataset,nlp,social-attitudes
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Sociology
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Requires-Dist: pandas>=1.3
+Requires-Dist: pyarrow>=10
+Requires-Dist: fsspec>=2023.1.0
+Requires-Dist: aiohttp>=3.8
+Requires-Dist: platformdirs>=3
+Provides-Extra: polars
+Requires-Dist: polars>=0.20; extra == "polars"
+Provides-Extra: docs
+Requires-Dist: pdoc>=14; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pdoc>=14; extra == "dev"
+Dynamic: license-file
+
+# isaac-data
+
+A thin Python loader for the **ISAAC** Reddit corpus (Illinois Social Attitudes
+Aggregate Corpus). It reads the public
+[Direct Download catalog](https://isaac.psychology.illinois.edu/direct-download/),
+using the published `manifest.json` as the catalog, with the data files served
+directly from the project's public Globus collection on NCSA Taiga, so you don't
+have to hand-build URLs or stitch months together.
+
+- **Catalog-driven**: enumerate what exists; never hard-code filenames.
+- **Parquet column pushdown**: ask for a few columns and only those bytes are
+  transferred over HTTP (via pyarrow + fsspec).
+- **Resumable, cached downloads** for bulk/offline work.
+- **pandas** out of the box.
+
+## Install
+
+```bash
+pip install isaac-data
+# or, from source:
+pip install git+https://github.com/BabakHemmatian/Illinois_Social_Attitudes.git#subdirectory=isaac-data-loader
+```
+
+### Data Use Agreement
+
+The first time you **access data** (`load`, `download`, or a remote `read_parquet`),
+the package shows the ISAAC
+[Data Use Agreement](https://github.com/BabakHemmatian/Illinois_Social_Attitudes/blob/main/Data_Use_Agreement.md)
+and asks you to accept, then asks for your email address. Browsing the catalog
+(`catalog`, `files`) needs no acceptance.
+
+**What is recorded.** Acceptance is saved on your machine (in your OS config dir)
+and sent to the ISAAC server: your email, the timestamp, and the version
+identifiers of the agreement text you were shown. An email address is required
+to accept.
+
+> We ask for your email so we can notify you of changes to the Data Use
+> Agreement and of corrections or errata affecting the corpus, and to keep a
+> record of your acceptance. We do not share it, and we don't use it for
+> anything else.
+
+Sending the record is best-effort: if the server is unreachable, acceptance is
+still recorded locally and data access proceeds.
+
+**If the agreement changes.** The package identifies the agreement by a SHA-256
+of its exact text and re-checks at most once a day. If the text has changed since
+you accepted, you are shown the new version and asked to accept it again. If you
+are offline, your existing acceptance stands.
+
+For non-interactive use (CI, headless notebooks), accept ahead of time:
+
+```bash
+isaac-data accept-agreement                        # interactive review + accept
+isaac-data accept-agreement --yes --email you@x.edu # accept non-interactively
+isaac-data accept-agreement --status               # show / --withdraw to revoke
+```
+…or set `ISAAC_ACCEPT_AGREEMENT=1` **together with** `ISAAC_AGREEMENT_EMAIL`:
+there is no prompt to fall back on in a non-interactive session, so opting in
+without an address raises `AgreementNotAccepted` rather than recording an
+anonymous acceptance.
+
+> **Renamed in 0.1.2.** This document was previously the "Terms of Use". The old
+> names still work: `isaac-data accept-terms`, `ISAAC_ACCEPT_TERMS`,
+> `TermsNotAccepted`, `isaac_data.accept_terms`, and `import isaac_data.terms`.
+> Existing local acceptance records remain valid; no need to re-accept.
+
+## Quick start
+
+```python
+import isaac_data as isaac
+
+# 1) What's available?
+cat = isaac.catalog()                       # full manifest as a DataFrame
+race = isaac.files("race", "2018-01", "2018-12")   # filter by category + months
+
+# 2) Load a slice: only the columns you need (pushed down over HTTP)
+df = isaac.load("race", "2018-03", "2018-03", columns=["text", "score"])
+
+# 3) Stratified sample: 1000 rows TOTAL, spread equally across the 12 months
+#    (uniform within each month, reproducible). Pass columns= when sampling.
+sample = isaac.load("age", "2015-01", "2015-12", columns=["text"], n=1000, seed=0)
+
+# 4) Bulk download for offline use (resumable, cached)
+paths = isaac.download("weight", "2020-01", "2020-12", dest="./weight2020")
+```
+
+Categories: `ability, age, race, sexuality, skin_tone, weight`
+(monthly, 2007-01 → 2023-12). Both `parquet` (default, recommended) and `csv`.
+
+## How it works
+
+The package is three layers: **discover → read/fetch → configure**:
+
+1. **Discover.** `catalog()` downloads the published `manifest.json` (the
+   authoritative list of every file) and returns it as a DataFrame, cached for
+   24h. `files(...)` filters that catalog by category, month range, and format.
+   Neither transfers any corpus data, so you can inspect sizes and row-counts
+   before pulling anything.
+2. **Read or fetch.**
+   - `load(...)` is the main entry point. It selects files, then for **parquet**
+     streams *only the columns you ask for* over HTTP: it reads the file footer,
+     then just those column chunks, so `columns=["text","score"]` from a 285 MB
+     file moves a few MB, not 285. `n=` draws a **stratified total**, spread
+     equally across the selected months, uniform within each (matching the web
+     app), reading only the selected columns of the row groups that contain
+     sampled rows. Each row is tagged with `_category`/`_month`; a `max_bytes`
+     guard prevents accidental hundred-GB full loads.
+   - `read_parquet(url, columns=...)` is the single-file primitive `load` uses.
+   - `download(...)` fetches whole files to disk (resumable, skips complete ones)
+     without loading them into memory, for offline work or other tools
+     (DuckDB, Spark).
+3. **Configure.** Reads and downloads are cached under an OS-native directory
+   (`cache_dir()` / `set_cache_dir()` / `$ISAAC_DATA_CACHE`), and the first data
+   access prompts for Data-Use-Agreement acceptance (recorded locally, and on
+   the ISAAC server when you provide an email).
+
+In short: *catalog tells you what exists → files narrows it → load streams just
+the columns you need (or download grabs whole files) → the cache avoids repeat
+transfers.*
+
+> Full per-argument reference lives in the function docstrings (`help(isaac.load)`,
+> IDE tooltips) and the generated [API docs](#documentation); the table below is
+> a summary.
+
+## API
+
+| Function | Purpose |
+|---|---|
+| `catalog(refresh=False)` | Full manifest as a DataFrame (cached 24h). |
+| `files(category, start, end, fmt="parquet")` | Filtered file list. |
+| `load(..., columns=None, n=None, seed=None, combine=True, cache=False)` | Read into pandas; column pushdown for parquet; `n` samples rows per file. |
+| `read_parquet(url, columns=None)` | Read one parquet file (local or http) into pandas. |
+| `download(..., dest=None)` | Resumable, cached bulk download; returns local paths. |
+| `set_cache_dir(path)` / `cache_dir()` | Manage the local cache (default `~/.cache/isaac-data`, or `$ISAAC_DATA_CACHE`). |
+
+`load()` has a safety guardrail (`max_bytes`, default 5 GB): it refuses very
+large selections unless you pass `columns=`, set `n=`, raise `max_bytes=`, or use
+`download()`.
+
+## CLI
+
+```bash
+isaac-data info
+isaac-data ls --category race --start 2018-01 --end 2018-12
+isaac-data download --category age --start 2015-01 --end 2015-12 --dest ./age2015
+```
+
+## Documentation
+
+The full per-argument API reference is generated from the docstrings with
+[pdoc](https://pdoc.dev):
+
+```bash
+pip install "isaac-data[docs]"
+pdoc -d google isaac_data -o docs/api    # static HTML into docs/api/
+pdoc -d google isaac_data                # or a live preview server
+```
+
+(`docs/api/` is git-ignored; publish it to GitHub Pages if you want a hosted reference.)
+
+## Requirements & platform notes
+
+- **Python 3.9+**, on **Windows, macOS (Intel & Apple Silicon), and Linux**. All
+  dependencies ship prebuilt wheels for these platforms.
+- **Install footprint**: `pyarrow` is a large dependency (~100 MB installed) and
+  `aiohttp` is a compiled extension. Fine on a laptop; size-conscious in slim
+  CI/container images.
+- **Cache location** is OS-native (via `platformdirs`): `~/Library/Caches/isaac-data`
+  (macOS), `%LOCALAPPDATA%\isaac-data\Cache` (Windows), `~/.cache/isaac-data`
+  (Linux). Override with `isaac.set_cache_dir(...)` or `$ISAAC_DATA_CACHE`.
+
+## Citation
+
+Please cite the ISAAC paper. **One citation covers the whole project**: the
+corpus, the pipeline, the models, and this package. Please do not cite the
+package separately.
+
+```bibtex
+@article{hemmatian2026isaac,
+  author = {Hemmatian, Babak and Hadjarab, Sarah and Chen, Jessica and Kurdi, Benedek},
+  title  = {The {Illinois} Social Attitudes Aggregate Corpus ({ISAAC}): An Open Tool and Reproducible Pipeline for Analyzing Social Group Discourse at Scale},
+  year   = {2026},
+  note   = {Manuscript submitted for publication}
+}
+```
+
+## License
+
+This package is released under the [MIT License](./LICENSE). The ISAAC corpus it
+downloads is governed separately by the
+[Data Use Agreement](https://github.com/BabakHemmatian/Illinois_Social_Attitudes/blob/main/Data_Use_Agreement.md),
+which the package presents for acceptance before any data access.
+
+## Notes
+
+- **Parquet is recommended** for scripting (column projection, smaller transfers).
+  The final labeled ISAAC release will add many per-post fields (moralization,
+  sentiment, generalization, emotion, location), and column pushdown makes those
+  cheap to query.
+- For SQL-style predicate pushdown without Python, query the parquet directly
+  with DuckDB (reads only the columns/row groups your query needs):
+  ```sql
+  SELECT author, score FROM
+  read_parquet('https://isaac.psychology.illinois.edu/data/race/RC_2018-03.parquet')
+  WHERE score > 100;
+  ```
+  HTTP has no directory listing, so wildcard globs don't work; for multiple
+  months pass an explicit URL list, e.g. from the loader:
+  `duckdb.sql("... read_parquet($u) ...", params={"u": isaac.files("race","2018-01","2018-12").url.tolist()})`.

isaac_data-0.1.3/README.md

@@ -0,0 +1,209 @@
+# isaac-data
+
+A thin Python loader for the **ISAAC** Reddit corpus (Illinois Social Attitudes
+Aggregate Corpus). It reads the public
+[Direct Download catalog](https://isaac.psychology.illinois.edu/direct-download/),
+using the published `manifest.json` as the catalog, with the data files served
+directly from the project's public Globus collection on NCSA Taiga, so you don't
+have to hand-build URLs or stitch months together.
+
+- **Catalog-driven**: enumerate what exists; never hard-code filenames.
+- **Parquet column pushdown**: ask for a few columns and only those bytes are
+  transferred over HTTP (via pyarrow + fsspec).
+- **Resumable, cached downloads** for bulk/offline work.
+- **pandas** out of the box.
+
+## Install
+
+```bash
+pip install isaac-data
+# or, from source:
+pip install git+https://github.com/BabakHemmatian/Illinois_Social_Attitudes.git#subdirectory=isaac-data-loader
+```
+
+### Data Use Agreement
+
+The first time you **access data** (`load`, `download`, or a remote `read_parquet`),
+the package shows the ISAAC
+[Data Use Agreement](https://github.com/BabakHemmatian/Illinois_Social_Attitudes/blob/main/Data_Use_Agreement.md)
+and asks you to accept, then asks for your email address. Browsing the catalog
+(`catalog`, `files`) needs no acceptance.
+
+**What is recorded.** Acceptance is saved on your machine (in your OS config dir)
+and sent to the ISAAC server: your email, the timestamp, and the version
+identifiers of the agreement text you were shown. An email address is required
+to accept.
+
+> We ask for your email so we can notify you of changes to the Data Use
+> Agreement and of corrections or errata affecting the corpus, and to keep a
+> record of your acceptance. We do not share it, and we don't use it for
+> anything else.
+
+Sending the record is best-effort: if the server is unreachable, acceptance is
+still recorded locally and data access proceeds.
+
+**If the agreement changes.** The package identifies the agreement by a SHA-256
+of its exact text and re-checks at most once a day. If the text has changed since
+you accepted, you are shown the new version and asked to accept it again. If you
+are offline, your existing acceptance stands.
+
+For non-interactive use (CI, headless notebooks), accept ahead of time:
+
+```bash
+isaac-data accept-agreement                        # interactive review + accept
+isaac-data accept-agreement --yes --email you@x.edu # accept non-interactively
+isaac-data accept-agreement --status               # show / --withdraw to revoke
+```
+…or set `ISAAC_ACCEPT_AGREEMENT=1` **together with** `ISAAC_AGREEMENT_EMAIL`:
+there is no prompt to fall back on in a non-interactive session, so opting in
+without an address raises `AgreementNotAccepted` rather than recording an
+anonymous acceptance.
+
+> **Renamed in 0.1.2.** This document was previously the "Terms of Use". The old
+> names still work: `isaac-data accept-terms`, `ISAAC_ACCEPT_TERMS`,
+> `TermsNotAccepted`, `isaac_data.accept_terms`, and `import isaac_data.terms`.
+> Existing local acceptance records remain valid; no need to re-accept.
+
+## Quick start
+
+```python
+import isaac_data as isaac
+
+# 1) What's available?
+cat = isaac.catalog()                       # full manifest as a DataFrame
+race = isaac.files("race", "2018-01", "2018-12")   # filter by category + months
+
+# 2) Load a slice: only the columns you need (pushed down over HTTP)
+df = isaac.load("race", "2018-03", "2018-03", columns=["text", "score"])
+
+# 3) Stratified sample: 1000 rows TOTAL, spread equally across the 12 months
+#    (uniform within each month, reproducible). Pass columns= when sampling.
+sample = isaac.load("age", "2015-01", "2015-12", columns=["text"], n=1000, seed=0)
+
+# 4) Bulk download for offline use (resumable, cached)
+paths = isaac.download("weight", "2020-01", "2020-12", dest="./weight2020")
+```
+
+Categories: `ability, age, race, sexuality, skin_tone, weight`
+(monthly, 2007-01 → 2023-12). Both `parquet` (default, recommended) and `csv`.
+
+## How it works
+
+The package is three layers: **discover → read/fetch → configure**:
+
+1. **Discover.** `catalog()` downloads the published `manifest.json` (the
+   authoritative list of every file) and returns it as a DataFrame, cached for
+   24h. `files(...)` filters that catalog by category, month range, and format.
+   Neither transfers any corpus data, so you can inspect sizes and row-counts
+   before pulling anything.
+2. **Read or fetch.**
+   - `load(...)` is the main entry point. It selects files, then for **parquet**
+     streams *only the columns you ask for* over HTTP: it reads the file footer,
+     then just those column chunks, so `columns=["text","score"]` from a 285 MB
+     file moves a few MB, not 285. `n=` draws a **stratified total**, spread
+     equally across the selected months, uniform within each (matching the web
+     app), reading only the selected columns of the row groups that contain
+     sampled rows. Each row is tagged with `_category`/`_month`; a `max_bytes`
+     guard prevents accidental hundred-GB full loads.
+   - `read_parquet(url, columns=...)` is the single-file primitive `load` uses.
+   - `download(...)` fetches whole files to disk (resumable, skips complete ones)
+     without loading them into memory, for offline work or other tools
+     (DuckDB, Spark).
+3. **Configure.** Reads and downloads are cached under an OS-native directory
+   (`cache_dir()` / `set_cache_dir()` / `$ISAAC_DATA_CACHE`), and the first data
+   access prompts for Data-Use-Agreement acceptance (recorded locally, and on
+   the ISAAC server when you provide an email).
+
+In short: *catalog tells you what exists → files narrows it → load streams just
+the columns you need (or download grabs whole files) → the cache avoids repeat
+transfers.*
+
+> Full per-argument reference lives in the function docstrings (`help(isaac.load)`,
+> IDE tooltips) and the generated [API docs](#documentation); the table below is
+> a summary.
+
+## API
+
+| Function | Purpose |
+|---|---|
+| `catalog(refresh=False)` | Full manifest as a DataFrame (cached 24h). |
+| `files(category, start, end, fmt="parquet")` | Filtered file list. |
+| `load(..., columns=None, n=None, seed=None, combine=True, cache=False)` | Read into pandas; column pushdown for parquet; `n` samples rows per file. |
+| `read_parquet(url, columns=None)` | Read one parquet file (local or http) into pandas. |
+| `download(..., dest=None)` | Resumable, cached bulk download; returns local paths. |
+| `set_cache_dir(path)` / `cache_dir()` | Manage the local cache (default `~/.cache/isaac-data`, or `$ISAAC_DATA_CACHE`). |
+
+`load()` has a safety guardrail (`max_bytes`, default 5 GB): it refuses very
+large selections unless you pass `columns=`, set `n=`, raise `max_bytes=`, or use
+`download()`.
+
+## CLI
+
+```bash
+isaac-data info
+isaac-data ls --category race --start 2018-01 --end 2018-12
+isaac-data download --category age --start 2015-01 --end 2015-12 --dest ./age2015
+```
+
+## Documentation
+
+The full per-argument API reference is generated from the docstrings with
+[pdoc](https://pdoc.dev):
+
+```bash
+pip install "isaac-data[docs]"
+pdoc -d google isaac_data -o docs/api    # static HTML into docs/api/
+pdoc -d google isaac_data                # or a live preview server
+```
+
+(`docs/api/` is git-ignored; publish it to GitHub Pages if you want a hosted reference.)
+
+## Requirements & platform notes
+
+- **Python 3.9+**, on **Windows, macOS (Intel & Apple Silicon), and Linux**. All
+  dependencies ship prebuilt wheels for these platforms.
+- **Install footprint**: `pyarrow` is a large dependency (~100 MB installed) and
+  `aiohttp` is a compiled extension. Fine on a laptop; size-conscious in slim
+  CI/container images.
+- **Cache location** is OS-native (via `platformdirs`): `~/Library/Caches/isaac-data`
+  (macOS), `%LOCALAPPDATA%\isaac-data\Cache` (Windows), `~/.cache/isaac-data`
+  (Linux). Override with `isaac.set_cache_dir(...)` or `$ISAAC_DATA_CACHE`.
+
+## Citation
+
+Please cite the ISAAC paper. **One citation covers the whole project**: the
+corpus, the pipeline, the models, and this package. Please do not cite the
+package separately.
+
+```bibtex
+@article{hemmatian2026isaac,
+  author = {Hemmatian, Babak and Hadjarab, Sarah and Chen, Jessica and Kurdi, Benedek},
+  title  = {The {Illinois} Social Attitudes Aggregate Corpus ({ISAAC}): An Open Tool and Reproducible Pipeline for Analyzing Social Group Discourse at Scale},
+  year   = {2026},
+  note   = {Manuscript submitted for publication}
+}
+```
+
+## License
+
+This package is released under the [MIT License](./LICENSE). The ISAAC corpus it
+downloads is governed separately by the
+[Data Use Agreement](https://github.com/BabakHemmatian/Illinois_Social_Attitudes/blob/main/Data_Use_Agreement.md),
+which the package presents for acceptance before any data access.
+
+## Notes
+
+- **Parquet is recommended** for scripting (column projection, smaller transfers).
+  The final labeled ISAAC release will add many per-post fields (moralization,
+  sentiment, generalization, emotion, location), and column pushdown makes those
+  cheap to query.
+- For SQL-style predicate pushdown without Python, query the parquet directly
+  with DuckDB (reads only the columns/row groups your query needs):
+  ```sql
+  SELECT author, score FROM
+  read_parquet('https://isaac.psychology.illinois.edu/data/race/RC_2018-03.parquet')
+  WHERE score > 100;
+  ```
+  HTTP has no directory listing, so wildcard globs don't work; for multiple
+  months pass an explicit URL list, e.g. from the loader:
+  `duckdb.sql("... read_parquet($u) ...", params={"u": isaac.files("race","2018-01","2018-12").url.tolist()})`.

isaac_data-0.1.3/isaac_data/__init__.py

@@ -0,0 +1,54 @@
+"""isaac-data: a thin Python loader for the ISAAC Reddit corpus.
+
+Reads the ISAAC Direct Download endpoint
+(https://isaac.psychology.illinois.edu/direct-download/) using the published
+manifest as a catalog. Parquet reads support column pushdown over HTTP.
+
+Quick start
+-----------
+>>> import isaac_data as isaac
+>>> isaac.files("race", "2018-01", "2018-12")          # what's available
+>>> df = isaac.load("race", "2018-03", "2018-03",       # one month, two columns
+...                 columns=["text", "score"])
+>>> isaac.download("age", "2015-01", "2015-12", dest="./age2015")  # bulk fetch
+"""
+from .core import (
+    BASE_URL,
+    CATEGORIES,
+    DATA_BASE,
+    MANIFEST_URL,
+    DataHostUnavailable,
+    cache_dir,
+    catalog,
+    download,
+    files,
+    load,
+    read_parquet,
+    set_cache_dir,
+)
+from .agreement import (
+    AgreementNotAccepted,
+    accept_agreement,
+    is_accepted,
+    status as agreement_status,
+    withdraw as withdraw_agreement,
+)
+
+# Pre-2026-07-25 names ("Terms of Use" era), kept importable for compatibility.
+TermsNotAccepted = AgreementNotAccepted
+accept_terms = accept_agreement
+terms_status = agreement_status
+withdraw_terms = withdraw_agreement
+
+__version__ = "0.1.3"
+
+__all__ = [
+    "__version__",
+    "BASE_URL", "DATA_BASE", "MANIFEST_URL", "CATEGORIES",
+    "cache_dir", "set_cache_dir", "catalog", "files",
+    "download", "read_parquet", "load", "DataHostUnavailable",
+    "accept_agreement", "is_accepted", "agreement_status", "withdraw_agreement",
+    "AgreementNotAccepted",
+    # deprecated aliases
+    "accept_terms", "terms_status", "withdraw_terms", "TermsNotAccepted",
+]