fastagsdata 0.1.0__tar.gz

fastagsdata-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FastAgsData
+
+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.

fastagsdata-0.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: fastagsdata
+Version: 0.1.0
+Summary: Python client for FastAgsData — single source for cleaned alternative ags data
+Author-email: FastAgsData <support@fastagsdata.com>
+License-Expression: MIT
+Project-URL: Homepage, https://fastagsdata.com
+Project-URL: Documentation, https://fastagsdata.com/docs
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pyarrow
+Requires-Dist: pandas
+Dynamic: license-file
+
+# fastagsdata
+
+Single source for cleaned alternative ags data.
+
+Python client for the [FastAgsData](https://fastagsdata.com) API — cleaned USDA agricultural fundamentals delivered as pandas DataFrames.
+
+## Install
+
+```bash
+pip install fastagsdata
+```
+
+## Quick start
+
+```python
+import fastagsdata
+
+fastagsdata.set_key('your-api-key')
+
+# Get WASDE corn ending stocks
+df = fastagsdata.get('wasde', comdty='c', param='stx')
+
+# Get NASS yields for Illinois
+df = fastagsdata.get('nass', comdty='c', param='yld', shape_id='us.il')
+
+# Multiple commodities and years
+df = fastagsdata.get('wasde', comdty=['c', 's', 'w'], year=[2023, 2024])
+
+# Wildcard params
+df = fastagsdata.get('nass', comdty='c', param='prg%')
+```
+
+## API key
+
+Set your key in one of three ways:
+
+```python
+# 1. Set globally
+fastagsdata.set_key('your-api-key')
+
+# 2. Environment variable
+export FASTAGSDATA_API_KEY=your-api-key
+
+# 3. Per-request
+df = fastagsdata.get('wasde', api_key='your-api-key')
+```
+
+Get your API key at [fastagsdata.com](https://fastagsdata.com).
+
+## Parameters
+
+| Parameter  | Description | Example |
+|------------|-------------|---------|
+| `source`   | Data source | `wasde`, `nass`, `nass_txt`, `export_sales`, `inspections`, `flashsales` |
+| `comdty`   | Commodity   | `c`, `s`, `w`, `w.win`, `w.spr`, `b`, `sg`, `fs`, `mx`, `o`, `ry`, `sf` |
+| `param`    | Parameter   | `yld`, `ap`, `stx`, `prg%` (supports `%` wildcards) |
+| `shape_id` | Geography   | `us`, `us.il`, `us.ia` |
+| `shape_lvl`| Administrative level | `0` (national), `1` (state), `2` (county) |
+| `year`     | Matches source, generally marketing year | `2024`, `[2023, 2024]` |
+
+All parameters support comma-separated strings or Python lists.
+
+## Sources
+
+| Source | Description | Link | Parameters |
+|--------|-------------|------|------------|
+| `wasde` | World Agricultural Supply and Demand Estimates. Monthly balance sheet projections for major crops. | [USDA WASDE](https://www.usda.gov/oce/commodity/wasde) | `stx` (ending stocks), `prd` (production), `yld` (yield), `ap` (area planted), `ah` (area harvested), and more |
+| `nass` | Final values from NASS QuickStats. No revision history — always reflects the latest number. Updated day after each text release. | [USDA QuickStats](https://quickstats.nass.usda.gov/) | `yld`, `ap`, `ah`, `prd`, `stx`, `prg%` (crop progress) |
+| `nass_txt` | Parsed directly from NASS text releases (Stocks, Acreage, Crop Progress & Conditions, Crush, Grind). Available on release day and preserves revision history across subsequent releases. | [USDA NASS](https://www.nass.usda.gov/) | Same as `nass` |
+| `export_sales` | Weekly export sales and shipments by commodity and destination. | [USDA FAS](https://apps.fas.usda.gov/esrquery/) | `net_sales`, `exports`, `outstanding` |
+| `inspections` | Weekly grain inspections for export by port and commodity. | [USDA AMS](https://www.ams.usda.gov/) | `inspections` |
+| `flashsales` | Large single-day export sales reported under daily reporting requirements. | [USDA FAS](https://apps.fas.usda.gov/esrquery/) | `flash_sales` |
+
+> **Note:** Not all commodity/param combinations from QuickStats are currently saved. If you need a combination that isn't available, reach out to support@fastagsdata.com and it will be added within 24 hours.
+
+> **Note:** Not all NASS text reports are currently being parsed. To request additional reports, reach out to support@fastagsdata.com.
+
+## Response
+
+Returns a pandas DataFrame with columns: `date_ref`, `date_release`, `source`, `comdty`, `shape_id`, `param`, `value`, `year`. Date columns are `datetime64` type.

fastagsdata-0.1.0/README.md

@@ -0,0 +1,80 @@
+# fastagsdata
+
+Single source for cleaned alternative ags data.
+
+Python client for the [FastAgsData](https://fastagsdata.com) API — cleaned USDA agricultural fundamentals delivered as pandas DataFrames.
+
+## Install
+
+```bash
+pip install fastagsdata
+```
+
+## Quick start
+
+```python
+import fastagsdata
+
+fastagsdata.set_key('your-api-key')
+
+# Get WASDE corn ending stocks
+df = fastagsdata.get('wasde', comdty='c', param='stx')
+
+# Get NASS yields for Illinois
+df = fastagsdata.get('nass', comdty='c', param='yld', shape_id='us.il')
+
+# Multiple commodities and years
+df = fastagsdata.get('wasde', comdty=['c', 's', 'w'], year=[2023, 2024])
+
+# Wildcard params
+df = fastagsdata.get('nass', comdty='c', param='prg%')
+```
+
+## API key
+
+Set your key in one of three ways:
+
+```python
+# 1. Set globally
+fastagsdata.set_key('your-api-key')
+
+# 2. Environment variable
+export FASTAGSDATA_API_KEY=your-api-key
+
+# 3. Per-request
+df = fastagsdata.get('wasde', api_key='your-api-key')
+```
+
+Get your API key at [fastagsdata.com](https://fastagsdata.com).
+
+## Parameters
+
+| Parameter  | Description | Example |
+|------------|-------------|---------|
+| `source`   | Data source | `wasde`, `nass`, `nass_txt`, `export_sales`, `inspections`, `flashsales` |
+| `comdty`   | Commodity   | `c`, `s`, `w`, `w.win`, `w.spr`, `b`, `sg`, `fs`, `mx`, `o`, `ry`, `sf` |
+| `param`    | Parameter   | `yld`, `ap`, `stx`, `prg%` (supports `%` wildcards) |
+| `shape_id` | Geography   | `us`, `us.il`, `us.ia` |
+| `shape_lvl`| Administrative level | `0` (national), `1` (state), `2` (county) |
+| `year`     | Matches source, generally marketing year | `2024`, `[2023, 2024]` |
+
+All parameters support comma-separated strings or Python lists.
+
+## Sources
+
+| Source | Description | Link | Parameters |
+|--------|-------------|------|------------|
+| `wasde` | World Agricultural Supply and Demand Estimates. Monthly balance sheet projections for major crops. | [USDA WASDE](https://www.usda.gov/oce/commodity/wasde) | `stx` (ending stocks), `prd` (production), `yld` (yield), `ap` (area planted), `ah` (area harvested), and more |
+| `nass` | Final values from NASS QuickStats. No revision history — always reflects the latest number. Updated day after each text release. | [USDA QuickStats](https://quickstats.nass.usda.gov/) | `yld`, `ap`, `ah`, `prd`, `stx`, `prg%` (crop progress) |
+| `nass_txt` | Parsed directly from NASS text releases (Stocks, Acreage, Crop Progress & Conditions, Crush, Grind). Available on release day and preserves revision history across subsequent releases. | [USDA NASS](https://www.nass.usda.gov/) | Same as `nass` |
+| `export_sales` | Weekly export sales and shipments by commodity and destination. | [USDA FAS](https://apps.fas.usda.gov/esrquery/) | `net_sales`, `exports`, `outstanding` |
+| `inspections` | Weekly grain inspections for export by port and commodity. | [USDA AMS](https://www.ams.usda.gov/) | `inspections` |
+| `flashsales` | Large single-day export sales reported under daily reporting requirements. | [USDA FAS](https://apps.fas.usda.gov/esrquery/) | `flash_sales` |
+
+> **Note:** Not all commodity/param combinations from QuickStats are currently saved. If you need a combination that isn't available, reach out to support@fastagsdata.com and it will be added within 24 hours.
+
+> **Note:** Not all NASS text reports are currently being parsed. To request additional reports, reach out to support@fastagsdata.com.
+
+## Response
+
+Returns a pandas DataFrame with columns: `date_ref`, `date_release`, `source`, `comdty`, `shape_id`, `param`, `value`, `year`. Date columns are `datetime64` type.

fastagsdata-0.1.0/fastagsdata/__init__.py

@@ -0,0 +1,69 @@
+"""FastAgsData - Single Source for Cleaned Alternative Ags Data."""
+
+import base64, gzip, os, requests, pyarrow as pa, pandas as pd
+from io import BytesIO
+
+URL = 'https://api.fastagsdata.com/fundamentals'
+_api_key = os.environ.get('FASTAGSDATA_API_KEY', '')
+
+
+def set_key(key):
+    global _api_key
+    _api_key = key
+
+
+def get(source=None, comdty=None, param=None, shape_id=None, shape_lvl=None, year=None,
+        api_key=None):
+    """Query USDA agricultural fundamentals. Returns a pandas DataFrame.
+
+    Args:
+        source:         Data source (nass, wasde, basis, export_sales, inspections, flashsales)
+        comdty:         Commodity code (c, s, w, w.win, w.spr, b, sg, fs, mx, o, ry, sf)
+        param:          Parameter code (e.g. yld, ap, stx, prg%). Use % for wildcards.
+        shape_id:       Geography ID (e.g. us, us.il, us.ia)
+        shape_lvl:      Administrative level (0=national, 1=state, 2=county)
+        year:           Matches source, generally marketing year (e.g. 2024)
+        api_key:        Override the global API key for this request
+
+    All params support comma-separated lists or Python lists:
+        comdty='c,s,w'  or  comdty=['c', 's', 'w']
+        year='2023,2024' or  year=[2023, 2024]
+
+    Use % for wildcards: param='prg%'
+
+    Examples:
+        df = fastagsdata.get('wasde')
+        df = fastagsdata.get('wasde', comdty='c', year=2025)
+        df = fastagsdata.get('nass', comdty='c', param='cnd%', shape_lvl=1)
+        df = fastagsdata.get('nass', comdty=['c','s'], year=[2023,2024])
+    """
+    key = api_key or _api_key
+    if not key:
+        raise ValueError("Set API key: fastagsdata.set_key('...'), export FASTAGSDATA_API_KEY, or pass api_key=")
+
+    _fmt = lambda v: ','.join(str(x) for x in v) if isinstance(v, (list, tuple)) else str(v)
+    params = {}
+    if source: params['source'] = _fmt(source)
+    if comdty: params['comdty'] = _fmt(comdty)
+    if param: params['param'] = _fmt(param)
+    if shape_id: params['shape_id'] = _fmt(shape_id)
+    if shape_lvl is not None: params['shape_lvl'] = _fmt(shape_lvl)
+    if year: params['year'] = _fmt(year)
+
+    headers = {'X-API-Key': key, 'Accept': 'application/vnd.apache.arrow.stream'}
+    dfs, cursor = [], None
+    while True:
+        p = {**params, **({'cursor': cursor} if cursor else {})}
+        r = requests.get(URL, headers=headers, params=p)
+        if r.status_code != 200:
+            raise RuntimeError(f"API error {r.status_code}: {r.text[:200]}")
+        raw = gzip.decompress(base64.b64decode(r.content))
+        dfs.append(pa.ipc.open_stream(BytesIO(raw)).read_all().to_pandas())
+        if r.headers.get('X-Has-More') != 'true':
+            break
+        cursor = r.headers.get('X-Next-Cursor')
+    df = pd.concat(dfs, ignore_index=True) if dfs else pd.DataFrame()
+    for col in ('date_ref', 'date_release'):
+        if col in df.columns:
+            df[col] = pd.to_datetime(df[col])
+    return df

fastagsdata-0.1.0/fastagsdata.egg-info/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: fastagsdata
+Version: 0.1.0
+Summary: Python client for FastAgsData — single source for cleaned alternative ags data
+Author-email: FastAgsData <support@fastagsdata.com>
+License-Expression: MIT
+Project-URL: Homepage, https://fastagsdata.com
+Project-URL: Documentation, https://fastagsdata.com/docs
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pyarrow
+Requires-Dist: pandas
+Dynamic: license-file
+
+# fastagsdata
+
+Single source for cleaned alternative ags data.
+
+Python client for the [FastAgsData](https://fastagsdata.com) API — cleaned USDA agricultural fundamentals delivered as pandas DataFrames.
+
+## Install
+
+```bash
+pip install fastagsdata
+```
+
+## Quick start
+
+```python
+import fastagsdata
+
+fastagsdata.set_key('your-api-key')
+
+# Get WASDE corn ending stocks
+df = fastagsdata.get('wasde', comdty='c', param='stx')
+
+# Get NASS yields for Illinois
+df = fastagsdata.get('nass', comdty='c', param='yld', shape_id='us.il')
+
+# Multiple commodities and years
+df = fastagsdata.get('wasde', comdty=['c', 's', 'w'], year=[2023, 2024])
+
+# Wildcard params
+df = fastagsdata.get('nass', comdty='c', param='prg%')
+```
+
+## API key
+
+Set your key in one of three ways:
+
+```python
+# 1. Set globally
+fastagsdata.set_key('your-api-key')
+
+# 2. Environment variable
+export FASTAGSDATA_API_KEY=your-api-key
+
+# 3. Per-request
+df = fastagsdata.get('wasde', api_key='your-api-key')
+```
+
+Get your API key at [fastagsdata.com](https://fastagsdata.com).
+
+## Parameters
+
+| Parameter  | Description | Example |
+|------------|-------------|---------|
+| `source`   | Data source | `wasde`, `nass`, `nass_txt`, `export_sales`, `inspections`, `flashsales` |
+| `comdty`   | Commodity   | `c`, `s`, `w`, `w.win`, `w.spr`, `b`, `sg`, `fs`, `mx`, `o`, `ry`, `sf` |
+| `param`    | Parameter   | `yld`, `ap`, `stx`, `prg%` (supports `%` wildcards) |
+| `shape_id` | Geography   | `us`, `us.il`, `us.ia` |
+| `shape_lvl`| Administrative level | `0` (national), `1` (state), `2` (county) |
+| `year`     | Matches source, generally marketing year | `2024`, `[2023, 2024]` |
+
+All parameters support comma-separated strings or Python lists.
+
+## Sources
+
+| Source | Description | Link | Parameters |
+|--------|-------------|------|------------|
+| `wasde` | World Agricultural Supply and Demand Estimates. Monthly balance sheet projections for major crops. | [USDA WASDE](https://www.usda.gov/oce/commodity/wasde) | `stx` (ending stocks), `prd` (production), `yld` (yield), `ap` (area planted), `ah` (area harvested), and more |
+| `nass` | Final values from NASS QuickStats. No revision history — always reflects the latest number. Updated day after each text release. | [USDA QuickStats](https://quickstats.nass.usda.gov/) | `yld`, `ap`, `ah`, `prd`, `stx`, `prg%` (crop progress) |
+| `nass_txt` | Parsed directly from NASS text releases (Stocks, Acreage, Crop Progress & Conditions, Crush, Grind). Available on release day and preserves revision history across subsequent releases. | [USDA NASS](https://www.nass.usda.gov/) | Same as `nass` |
+| `export_sales` | Weekly export sales and shipments by commodity and destination. | [USDA FAS](https://apps.fas.usda.gov/esrquery/) | `net_sales`, `exports`, `outstanding` |
+| `inspections` | Weekly grain inspections for export by port and commodity. | [USDA AMS](https://www.ams.usda.gov/) | `inspections` |
+| `flashsales` | Large single-day export sales reported under daily reporting requirements. | [USDA FAS](https://apps.fas.usda.gov/esrquery/) | `flash_sales` |
+
+> **Note:** Not all commodity/param combinations from QuickStats are currently saved. If you need a combination that isn't available, reach out to support@fastagsdata.com and it will be added within 24 hours.
+
+> **Note:** Not all NASS text reports are currently being parsed. To request additional reports, reach out to support@fastagsdata.com.
+
+## Response
+
+Returns a pandas DataFrame with columns: `date_ref`, `date_release`, `source`, `comdty`, `shape_id`, `param`, `value`, `year`. Date columns are `datetime64` type.

fastagsdata-0.1.0/fastagsdata.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+fastagsdata/__init__.py
+fastagsdata.egg-info/PKG-INFO
+fastagsdata.egg-info/SOURCES.txt
+fastagsdata.egg-info/dependency_links.txt
+fastagsdata.egg-info/requires.txt
+fastagsdata.egg-info/top_level.txt

fastagsdata-0.1.0/fastagsdata.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fastagsdata-0.1.0/fastagsdata.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests
+pyarrow
+pandas

fastagsdata-0.1.0/fastagsdata.egg-info/top_level.txt

@@ -0,0 +1 @@
+fastagsdata

fastagsdata-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fastagsdata"
+version = "0.1.0"
+description = "Python client for FastAgsData — single source for cleaned alternative ags data"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "FastAgsData", email = "support@fastagsdata.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Intended Audience :: Science/Research",
+"Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "requests",
+    "pyarrow",
+    "pandas",
+]
+
+[project.urls]
+Homepage = "https://fastagsdata.com"
+Documentation = "https://fastagsdata.com/docs"

fastagsdata-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+