Skip to content

Commit 9f79af7

Browse files
Release v0.1.1: Anonymous users get latest 100 observations
- Fixed backend API to return most recent data for anonymous users - Updated README to clarify anonymous mode behavior - Added CHANGELOG entry - Built and published to TestPyPI
1 parent 590372d commit 9f79af7

4 files changed

Lines changed: 33 additions & 24 deletions

File tree

CHANGELOG.md

Lines changed: 27 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,31 +2,38 @@
22

33
All notable changes to this project will be documented in this file.
44

5-
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6-
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
5+
## [0.1.1] - 2025-12-17
6+
7+
### Fixed
8+
- **Anonymous users now receive latest 100 observations** instead of oldest 100
9+
- Backend API updated to fetch most recent data for non-authenticated requests
10+
- Updated documentation to clarify anonymous mode returns latest data only
11+
12+
### Changed
13+
- Improved README to explain anonymous vs authenticated data access patterns
714

815
## [0.1.0] - 2025-12-17
916

1017
### Added
11-
- Initial public release
12-
- `get()` function for fetching time series data
18+
- Initial release of DataSetIQ Python client
19+
- Core `get()` function for fetching time series data
1320
- `search()` function for dataset discovery
14-
- `configure()` for client configuration
15-
- `set_api_key()` helper function
16-
- Disk-based caching with TTL
21+
- Intelligent disk-based caching with TTL
1722
- Automatic retry logic with exponential backoff
18-
- Typed exceptions with marketing messages
19-
- Support for authenticated (CSV) and anonymous (paginated JSON) modes
20-
- Date filtering with `start` and `end` parameters
21-
- NaN handling with `dropna` parameter
22-
- Comprehensive test suite
23-
- Documentation and examples
23+
- Support for authenticated (CSV) and anonymous (JSON) modes
24+
- Comprehensive error handling with marketing-embedded messages
25+
- Date filtering support (start/end parameters)
26+
- Configuration management via `configure()` and `set_api_key()`
27+
- Cache management: `clear_cache()` and `get_cache_size()`
28+
- Full pandas DataFrame integration with date index
29+
- Example scripts (basic and advanced)
30+
- Complete documentation and guides
2431

2532
### Features
26-
- TCP connection reuse via `requests.Session`
27-
- Respects `Retry-After` headers
28-
- Pagination safety valve (max 200 pages for anonymous)
29-
- SHA256-based cache keying
30-
- Type-safe error handling
31-
32-
[0.1.0]: https://github.com/DataSetIQ/datasetiq-python/releases/tag/v0.1.0
33+
- 40M+ economic time series from FRED, BLS, Census, World Bank, and more
34+
- Free tier: 25 requests/minute + 25 AI insights/month
35+
- Smart NaN detection and handling
36+
- Connection pooling for performance
37+
- `Retry-After` header support
38+
- Metadata-only dataset detection
39+
- Cross-platform cache directory management

README.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -205,13 +205,15 @@ df = iq.get("fred-cpi") # Full dataset
205205
### Anonymous Mode
206206

207207
**Without API Key:**
208-
- ⚠️ Paginated JSON (max 100 obs/page, 200 pages = 20K obs)
208+
- ⚠️ Returns **latest 100 observations** only (most recent data)
209209
- ⚠️ Lower rate limits (5 RPM)
210210
- ⚠️ Metadata-only for some datasets
211+
- ⚠️ No date filtering support
211212

212213
```python
213214
# No API key set
214-
df = iq.get("fred-cpi") # Limited to 20K observations
215+
df = iq.get("fred-cpi") # Latest 100 observations only
216+
print(df.tail()) # Most recent data points
215217
```
216218

217219
---

datasetiq/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
- Pricing: https://www.datasetiq.com/pricing
2222
"""
2323

24-
__version__ = "0.1.0"
24+
__version__ = "0.1.1"
2525

2626
# Public API exports
2727
from .client import get, search

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
44

55
[project]
66
name = "datasetiq"
7-
version = "0.1.0"
7+
version = "0.1.1"
88
description = "Official Python client for DataSetIQ — The Modern Economic Data Platform"
99
readme = "README.md"
1010
requires-python = ">=3.9"

0 commit comments

Comments
 (0)