nber-cli 0.3.1__tar.gz → 0.4.0__tar.gz

{nber_cli-0.3.1 → nber_cli-0.4.0}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.0] - 2026-06-04
+
+### Added
+- `nber-cli info --refresh` skips the local `info_cache` and re-fetches the paper from NBER. The new data is written back to the cache when the cache is enabled.
+- `nber-cli info cache --turn-on` / `--turn-off` toggle the `info_cache` lookup globally and persist the state to `~/.nber-cli/config.json`.
+- `nber-cli info cache --set-refresh <N>` sets the cache refresh interval in days. The value is persisted to `~/.nber-cli/config.json` and used as the TTL for every subsequent `info` call. Defaults to `30` days.
+- `nber-cli info cache clear` with `--days`, `--all`, `--start-date`, or `--end-date` mirrors the `feed clean` parameter set, using `last_fetched_at` from the `info_cache` table. `nber-cli info cache clean` is a convenience alias for `clear --all`.
+- `nber-cli info cache` (no sub-action) prints the current cache state, TTL, and cached row count.
+- New `nber_cli.config_store` module: centralised read and write of `~/.nber-cli/config.json` plus the `InfoCacheSettings` dataclass and helpers (`get_info_cache_settings`, `set_info_cache_enabled`, `set_info_cache_ttl_days`).
+- New `nber_cli.info_cache.get_paper_with_info_cache_result` async helper that returns an `InfoCacheLookupResult` carrying the `NBER` paper and a `from_cache` flag, so callers (CLI and MCP) can surface a "loaded from cache" hint.
+- Public Python API exports: `InfoCacheSettings`, `InfoCacheLookupResult`, `clear_info_cache`, `count_info_cache`, `get_info_cache_settings`, `get_info_cache_ttl_days`, `is_info_cache_enabled`, `is_info_cache_expired`, `set_info_cache_enabled`, `set_info_cache_ttl_days`, `NBERInfoCacheClearResult`.
+
+### Changed
+- `~/.nber-cli/config.json` now carries an `info` section: `info.cache_enabled` (default `true`) and `info.cache_ttl_days` (default `30`). Missing or malformed fields fall back to defaults.
+- `info` now prints a one-line stderr hint when the paper was served from the local cache, pointing to `nber-cli info <id> --refresh` for a fresh fetch.
+
 ## [0.3.1] - 2026-06-03
 
 ### Added

{nber_cli-0.3.1 → nber_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nber-cli
-Version: 0.3.1
+Version: 0.4.0
 Summary: A command line interface for reaching the National Bureau of Economic Research (NBER) paper without brower.
 Project-URL: Homepage, https://github.com/sepinetam/nber-cli
 Project-URL: Repository, https://github.com/sepinetam/nber-cli

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/en/changelog.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented here.
 
+## 0.4.0 - 2026-06-04
+
+### Added
+
+- Added `nber-cli info --refresh` to bypass the local `info_cache` and re-fetch paper metadata from NBER. The fresh data is written back to the cache when the cache is enabled.
+- Added `nber-cli info cache --turn-on` and `--turn-off` to toggle the `info_cache` lookup globally. The setting is persisted to `~/.nber-cli/config.json`.
+- Added `nber-cli info cache --set-refresh <N>` to set the cache refresh interval in days. The value is persisted to `~/.nber-cli/config.json` and applied as the TTL for every subsequent `info` call. Defaults to `30` days.
+- Added `nber-cli info cache clear` with the same parameter set as `feed clean`: `--days`, `--all`, `--start-date`, and `--end-date`. Filtering uses `last_fetched_at` from the `info_cache` table. `nber-cli info cache clean` is a convenience alias for `clear --all`.
+- Added `nber-cli info cache` (no sub-action) to print the current cache state, TTL, and cached row count.
+- Added `nber_cli.config_store` module with `InfoCacheSettings` and helpers (`get_info_cache_settings`, `set_info_cache_enabled`, `set_info_cache_ttl_days`) for reading and writing `~/.nber-cli/config.json`.
+- Added `nber_cli.info_cache.get_paper_with_info_cache_result` async helper that returns an `InfoCacheLookupResult` carrying the `NBER` paper and a `from_cache` flag.
+- Added public Python API exports for the new info cache helpers and `NBERInfoCacheClearResult` model.
+
+### Changed
+
+- `~/.nber-cli/config.json` now stores an `info` section: `info.cache_enabled` (default `true`) and `info.cache_ttl_days` (default `30`). Missing or malformed fields fall back to defaults.
+- `info` now prints a one-line stderr hint when the paper was served from the local cache, pointing to `nber-cli info <id> --refresh` for a fresh fetch.
+
 ## 0.3.1 - 2026-06-03
 
 ### Added

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/en/cli.md

@@ -100,6 +100,85 @@ nber-cli info w25000 -f json
 | `paper_id` | Required paper ID, with or without the `w` prefix. |
 | `--all`, `-a` | Include related fields and published-version information when available. |
 | `--format`, `-f` | Output format: `list` or `json`. Defaults to `list`. |
+| `--refresh` | Bypass the local `info_cache` and re-fetch from NBER. The new data is written back to the cache when the cache is enabled. |
+
+When the cache is enabled and the cached entry has not yet passed the configured TTL, repeated `info` calls are served from the local database. The first `info` call after a TTL expiry, or any call with `--refresh`, performs a live fetch.
+
+The MCP `get_paper_info` tool follows the same cache behavior, including the `--refresh` flag.
+
+## info cache
+
+Manage the `info_cache` lookup behavior and clear cached records.
+
+Show the current cache state, TTL, and row count:
+
+```bash
+nber-cli info cache
+```
+
+Toggle the cache globally:
+
+```bash
+nber-cli info cache --turn-on
+nber-cli info cache --turn-off
+```
+
+Set the cache refresh interval in days:
+
+```bash
+nber-cli info cache --set-refresh 7
+nber-cli info cache --set-refresh 30
+```
+
+`--set-refresh` requires a positive integer. The new value is written to `~/.nber-cli/config.json` and used as the TTL for every subsequent `info` call.
+
+Clean cached records not refreshed in the last 30 days:
+
+```bash
+nber-cli info cache clear
+nber-cli info cache clear --days 30
+```
+
+Clean all cached records:
+
+```bash
+nber-cli info cache clear --all
+nber-cli info cache clean
+```
+
+`info cache clean` is a convenience alias for `info cache clear --all`.
+
+Clean cached records by `last_fetched_at` date:
+
+```bash
+nber-cli info cache clear --end-date 2026-06-01
+nber-cli info cache clear --start-date 2026-05-01 --end-date 2026-06-01
+```
+
+`--end-date` without `--start-date` cleans from the earliest cached record through the end date. `--start-date` and `--end-date` are inclusive. Passing only `--start-date` is invalid.
+
+Before deleting anything, `info cache clear` prints how many cached records match and asks for confirmation:
+
+```text
+This operation is irreversible.
+Deleted info cache records may be fetched again from NBER.
+Continue? [y/N]:
+```
+
+Only `y` or `Y` continues. Any other response aborts without deleting records.
+
+### info cache Options
+
+| Subcommand | Option | Description |
+| --- | --- | --- |
+| (none) | `--turn-on` | Enable the info cache globally. |
+| (none) | `--turn-off` | Disable the info cache globally. |
+| (none) | `--set-refresh` | Set the info cache refresh interval in days. Must be a positive integer. |
+| `clear` | `--days` | Clean cached records not refreshed for this many days. Defaults to `30`. |
+| `clear` | `--all` | Clean all cached records. |
+| `clear` | `--start-date` | Clean cached records refreshed on or after this date, formatted `YYYY-MM-DD`. |
+| `clear` | `--end-date` | Clean cached records refreshed on or before this date, formatted `YYYY-MM-DD`. |
+| `clean` | — | Alias for `clear --all`. |
 
 ## search
 

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/en/configuration.md

@@ -30,6 +30,10 @@ Current schema:
   "schema_version": 2,
   "feed": {
     "db-path": "/Users/name/.nber-cli/nber.db"
+  },
+  "info": {
+    "cache_enabled": true,
+    "cache_ttl_days": 30
   }
 }
 ```
@@ -38,6 +42,12 @@ Current schema:
 
 `schema_version` records the current database schema version. NBER-CLI updates it after `db init` or schema upgrades.
 
+`info.cache_enabled` controls the `info_cache` lookup globally. Set to `false` to force every `info` call (and the MCP `get_paper_info` tool) to go straight to NBER. Defaults to `true`.
+
+`info.cache_ttl_days` sets the refresh interval in days. Cached entries older than this threshold are treated as cache misses and re-fetched on the next `info` call. Must be a positive integer. Defaults to `30`.
+
+Both `info` keys are managed by `nber-cli info cache --turn-on/--off/--set-refresh <N>`. Missing or malformed fields fall back to defaults and never cause NBER-CLI to fail.
+
 ## Local Database
 
 Default database path:
@@ -69,7 +79,7 @@ If you upgraded from 0.3.0 and still have `~/.nber-cli/feed.db`, NBER-CLI will k
 The database holds:
 
 - `feed_items` and `feed_fetches`: RSS cache used by `feed fetch` and `feed clean`.
-- `info_cache`: paper metadata cache used by `info` and the MCP `get_paper_info` tool.
+- `info_cache`: paper metadata cache used by `info` and the MCP `get_paper_info` tool. Cache reads are gated by `info.cache_enabled` and respect the `info.cache_ttl_days` TTL.
 - `query_log`, `download_log`, `info_log`: behavior logs for search keywords, download outcomes, and info lookups.
 
 ## Output Paths

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/en/python-api.md

@@ -161,6 +161,70 @@ if paper is None:
 print(paper.title)
 ```
 
+Read the paper metadata cache through the high-level helper, which respects the user-config TTL and the global cache toggle:
+
+```python
+import asyncio
+
+from nber_cli import get_paper_with_info_cache_result
+
+
+async def main() -> None:
+    result = await get_paper_with_info_cache_result(25000)
+    if result.from_cache:
+        print("Served from local info cache")
+    print(result.paper.title)
+
+
+asyncio.run(main())
+```
+
+`refresh=True` skips the cache lookup and re-fetches from NBER before optionally writing back:
+
+```python
+import asyncio
+
+from nber_cli import get_paper_with_info_cache_result
+
+
+async def main() -> None:
+    result = await get_paper_with_info_cache_result(25000, refresh=True)
+    print(result.paper.title)
+
+
+asyncio.run(main())
+```
+
+Manage the user config (`~/.nber-cli/config.json`):
+
+```python
+from nber_cli import (
+    get_info_cache_settings,
+    set_info_cache_enabled,
+    set_info_cache_ttl_days,
+)
+
+print(get_info_cache_settings())
+set_info_cache_enabled(False)
+set_info_cache_ttl_days(7)
+```
+
+Clean cached paper metadata:
+
+```python
+from nber_cli import clear_info_cache, count_info_cache
+
+print(f"Cached rows: {count_info_cache()}")
+
+preview = clear_info_cache(days=30, dry_run=True)
+print(f"Matched: {preview.matched_count}")
+
+result = clear_info_cache(days=30)
+print(f"Deleted: {result.deleted_count}")
+```
+
+The same `clear_info_cache` function also supports `delete_all=True` and `start_date` / `end_date` filters that mirror `clean_feed_cache`.
+
 ## Data Models
 
 ### NBER
@@ -226,6 +290,33 @@ print(paper.title)
 | `end_date` | `str` or `None` | Inclusive end date for `date-range` mode. |
 | `dry_run` | `bool` | Whether the operation only counted matching records. |
 
+### NBERInfoCacheClearResult
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `database_path` | `Path` | SQLite cache database path. |
+| `matched_count` | `int` | Number of cache records matching the clean criteria. |
+| `deleted_count` | `int` | Number of cache records deleted. |
+| `mode` | `str` | Clean mode: `days`, `all`, or `date-range`. |
+| `days` | `int` or `None` | Day threshold for `days` mode. |
+| `start_date` | `str` or `None` | Inclusive start date for `date-range` mode. |
+| `end_date` | `str` or `None` | Inclusive end date for `date-range` mode. |
+| `dry_run` | `bool` | Whether the operation only counted matching records. |
+
+### InfoCacheSettings
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `cache_enabled` | `bool` | Global toggle for the `info_cache` lookup. |
+| `cache_ttl_days` | `int` | Cache refresh interval in days. |
+
+### InfoCacheLookupResult
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `paper` | `NBER` | The paper returned by the lookup. |
+| `from_cache` | `bool` | `True` when the paper was served from the local `info_cache`. |
+
 ### DownloadFailure
 
 | Field | Type | Description |

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/zh/changelog.md

@@ -2,6 +2,24 @@
 
 这里记录项目的重要变更。
 
+## 0.4.0 - 2026-06-04
+
+### Added
+
+- 新增 `nber-cli info --refresh`，跳过本地 `info_cache` 并直接从 NBER 重新拉取论文元数据。缓存开启时，新数据会写回缓存。
+- 新增 `nber-cli info cache --turn-on` 和 `--turn-off`，全局开关 `info_cache` 读取行为，状态会持久化到 `~/.nber-cli/config.json`。
+- 新增 `nber-cli info cache --set-refresh <N>`，设置缓存刷新间隔（天）。该值会持久化到 `~/.nber-cli/config.json`，并在后续每次 `info` 调用中作为 TTL 生效，默认 `30` 天。
+- 新增 `nber-cli info cache clear`，参数集与 `feed clean` 一致：`--days`、`--all`、`--start-date`、`--end-date`，使用 `info_cache` 表的 `last_fetched_at` 字段过滤。`nber-cli info cache clean` 是 `clear --all` 的便利别名。
+- 新增 `nber-cli info cache`（不带子动作），用于打印当前缓存状态、TTL 和已缓存行数。
+- 新增 `nber_cli.config_store` 模块，集中处理 `~/.nber-cli/config.json` 的读写，包含 `InfoCacheSettings` 数据类及 `get_info_cache_settings`、`set_info_cache_enabled`、`set_info_cache_ttl_days` 等辅助函数。
+- 新增 `nber_cli.info_cache.get_paper_with_info_cache_result` 异步辅助函数，返回包含 `NBER` 论文对象和 `from_cache` 标志的 `InfoCacheLookupResult`。
+- 新增 info cache 相关辅助函数和 `NBERInfoCacheClearResult` 数据模型的 Python API 导出。
+
+### Changed
+
+- `~/.nber-cli/config.json` 现在携带 `info` 段：`info.cache_enabled`（默认 `true`）和 `info.cache_ttl_days`（默认 `30`）。字段缺失或类型错误时回退到默认值。
+- `info` 命令在从本地缓存命中时，会通过 stderr 打印一行提示，并指向 `nber-cli info <id> --refresh` 用于强制刷新。
+
 ## 0.3.1 - 2026-06-03
 
 ### Added

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/zh/cli.md

@@ -100,6 +100,85 @@ nber-cli info w25000 -f json
 | `paper_id` | 必填论文编号，可以带 `w` 前缀，也可以不带。 |
 | `--all`, `-a` | 如果可用，包含相关字段和 published-version 信息。 |
 | `--format`, `-f` | 输出格式：`list` 或 `json`，默认是 `list`。 |
+| `--refresh` | 跳过本地 `info_cache` 并直接从 NBER 重新拉取。缓存开启时，新数据会写回缓存。 |
+
+当缓存开启且缓存条目尚未超过配置的 TTL 时，重复执行 `info` 会从本地数据库返回。TTL 到期后的第一次 `info` 调用，或任何携带 `--refresh` 的调用，都会执行实时网络拉取。
+
+MCP 的 `get_paper_info` 工具遵循相同的缓存行为，也支持 `--refresh`。
+
+## info cache
+
+管理 `info_cache` 的读取行为并清理缓存记录。
+
+显示当前缓存状态、TTL 和已缓存行数：
+
+```bash
+nber-cli info cache
+```
+
+全局开关缓存：
+
+```bash
+nber-cli info cache --turn-on
+nber-cli info cache --turn-off
+```
+
+设置缓存刷新间隔（天）：
+
+```bash
+nber-cli info cache --set-refresh 7
+nber-cli info cache --set-refresh 30
+```
+
+`--set-refresh` 必须是正整数。新值会写入 `~/.nber-cli/config.json`，并在后续每次 `info` 调用中作为 TTL 生效。
+
+清理 30 天内没有刷新的缓存记录：
+
+```bash
+nber-cli info cache clear
+nber-cli info cache clear --days 30
+```
+
+清理全部缓存记录：
+
+```bash
+nber-cli info cache clear --all
+nber-cli info cache clean
+```
+
+`info cache clean` 是 `info cache clear --all` 的便利别名。
+
+按 `last_fetched_at` 日期清理缓存记录：
+
+```bash
+nber-cli info cache clear --end-date 2026-06-01
+nber-cli info cache clear --start-date 2026-05-01 --end-date 2026-06-01
+```
+
+只提供 `--end-date` 时，会从最早的缓存记录清理到该结束日期。`--start-date` 和 `--end-date` 都是前后包含的。只提供 `--start-date` 是无效的。
+
+删除前，`info cache clear` 会先打印匹配到的缓存记录数量，并要求确认：
+
+```text
+This operation is irreversible.
+Deleted info cache records may be fetched again from NBER.
+Continue? [y/N]:
+```
+
+只有输入 `y` 或 `Y` 才会继续。其他输入都会中止，不删除记录。
+
+### info cache 选项
+
+| 子命令 | 选项 | 说明 |
+| --- | --- | --- |
+| (无) | `--turn-on` | 全局启用 info cache。 |
+| (无) | `--turn-off` | 全局禁用 info cache。 |
+| (无) | `--set-refresh` | 设置 info cache 刷新间隔（天），必须是正整数。 |
+| `clear` | `--days` | 清理这么多天没有刷新的缓存记录，默认是 `30`。 |
+| `clear` | `--all` | 清理全部 info cache 记录。 |
+| `clear` | `--start-date` | 清理 `last_fetched_at` 在该日期及之后的缓存记录，格式为 `YYYY-MM-DD`。 |
+| `clear` | `--end-date` | 清理 `last_fetched_at` 在该日期及之前的缓存记录，格式为 `YYYY-MM-DD`。 |
+| `clean` | — | `clear --all` 的别名。 |
 
 ## search
 

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/zh/configuration.md

@@ -30,6 +30,10 @@ NBER-CLI 的大多数运行时行为使用内置默认值。本地数据库还
   "schema_version": 2,
   "feed": {
     "db-path": "/Users/name/.nber-cli/nber.db"
+  },
+  "info": {
+    "cache_enabled": true,
+    "cache_ttl_days": 30
   }
 }
 ```
@@ -38,6 +42,12 @@ NBER-CLI 的大多数运行时行为使用内置默认值。本地数据库还
 
 `schema_version` 记录当前数据库 schema 的版本。NBER-CLI 在 `db init` 或 schema 升级后更新该字段。
 
+`info.cache_enabled` 全局控制 `info_cache` 的读取行为。设为 `false` 时，每次 `info` 调用（以及 MCP `get_paper_info` 工具）都会直接访问 NBER。默认是 `true`。
+
+`info.cache_ttl_days` 设置刷新间隔（天）。超过该阈值的缓存条目会被视为未命中，并在下一次 `info` 调用时重新拉取。必须是正整数。默认是 `30`。
+
+两个 `info` 字段由 `nber-cli info cache --turn-on/--off/--set-refresh <N>` 维护。字段缺失或类型错误时一律回退到默认值，不会导致 NBER-CLI 失败。
+
 ## 本地数据库
 
 默认数据库路径：
@@ -69,7 +79,7 @@ nber-cli db migrate ~/data/nber.db
 数据库包含以下内容：
 
 - `feed_items` 和 `feed_fetches`：`feed fetch` 和 `feed clean` 使用的 RSS 缓存。
-- `info_cache`：`info` 和 MCP `get_paper_info` 工具使用的论文元数据缓存。
+- `info_cache`：`info` 和 MCP `get_paper_info` 工具使用的论文元数据缓存。读取行为受 `info.cache_enabled` 控制，并受 `info.cache_ttl_days` 的 TTL 约束。
 - `query_log`、`download_log`、`info_log`：搜索关键词、下载结果和 info 查询的行为日志。
 
 ## 输出路径

{nber_cli-0.3.1 → nber_cli-0.4.0}/docs/zh/python-api.md

@@ -161,6 +161,70 @@ if paper is None:
 print(paper.title)
 ```
 
+通过高层辅助函数读取论文元数据缓存，该函数会遵守用户配置中的 TTL 和全局缓存开关：
+
+```python
+import asyncio
+
+from nber_cli import get_paper_with_info_cache_result
+
+
+async def main() -> None:
+    result = await get_paper_with_info_cache_result(25000)
+    if result.from_cache:
+        print("Served from local info cache")
+    print(result.paper.title)
+
+
+asyncio.run(main())
+```
+
+`refresh=True` 跳过缓存读取，重新从 NBER 拉取，并在缓存开启时写回：
+
+```python
+import asyncio
+
+from nber_cli import get_paper_with_info_cache_result
+
+
+async def main() -> None:
+    result = await get_paper_with_info_cache_result(25000, refresh=True)
+    print(result.paper.title)
+
+
+asyncio.run(main())
+```
+
+管理用户配置（`~/.nber-cli/config.json`）：
+
+```python
+from nber_cli import (
+    get_info_cache_settings,
+    set_info_cache_enabled,
+    set_info_cache_ttl_days,
+)
+
+print(get_info_cache_settings())
+set_info_cache_enabled(False)
+set_info_cache_ttl_days(7)
+```
+
+清理论文元数据缓存：
+
+```python
+from nber_cli import clear_info_cache, count_info_cache
+
+print(f"Cached rows: {count_info_cache()}")
+
+preview = clear_info_cache(days=30, dry_run=True)
+print(f"Matched: {preview.matched_count}")
+
+result = clear_info_cache(days=30)
+print(f"Deleted: {result.deleted_count}")
+```
+
+`clear_info_cache` 同时支持 `delete_all=True` 以及 `start_date` / `end_date` 过滤，与 `clean_feed_cache` 的语义一致。
+
 ## 数据模型
 
 ### NBER
@@ -226,6 +290,33 @@ print(paper.title)
 | `end_date` | `str` 或 `None` | `date-range` 模式下前后包含的结束日期。 |
 | `dry_run` | `bool` | 是否只统计匹配记录而不删除。 |
 
+### NBERInfoCacheClearResult
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `database_path` | `Path` | SQLite 缓存数据库路径。 |
+| `matched_count` | `int` | 符合清理条件的缓存记录数量。 |
+| `deleted_count` | `int` | 已删除的缓存记录数量。 |
+| `mode` | `str` | 清理模式：`days`、`all` 或 `date-range`。 |
+| `days` | `int` 或 `None` | `days` 模式下的天数阈值。 |
+| `start_date` | `str` 或 `None` | `date-range` 模式下前后包含的开始日期。 |
+| `end_date` | `str` 或 `None` | `date-range` 模式下前后包含的结束日期。 |
+| `dry_run` | `bool` | 是否只统计匹配记录而不删除。 |
+
+### InfoCacheSettings
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `cache_enabled` | `bool` | `info_cache` 读取的全局开关。 |
+| `cache_ttl_days` | `int` | 缓存刷新间隔（天）。 |
+
+### InfoCacheLookupResult
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `paper` | `NBER` | 查询返回的论文对象。 |
+| `from_cache` | `bool` | 当论文来自本地 `info_cache` 时为 `True`。 |
+
 ### DownloadFailure
 
 | 字段 | 类型 | 说明 |

{nber_cli-0.3.1 → nber_cli-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nber-cli"
-version = "0.3.1"
+version = "0.4.0"
 description = "A command line interface for reaching the National Bureau of Economic Research (NBER) paper without brower."
 readme = "README.md"
 requires-python = ">=3.11"

{nber_cli-0.3.1 → nber_cli-0.4.0}/src/nber_cli/__init__.py

@@ -4,6 +4,12 @@ from __future__ import annotations
 
 from .cli import main
 from .config import NBER_CLI_CONFIG, NBERCLIConfig
+from .config_store import (
+    InfoCacheSettings,
+    get_info_cache_settings,
+    set_info_cache_enabled,
+    set_info_cache_ttl_days,
+)
 from .core.models import (
     DownloadBatchResult,
     DownloadFailure,
@@ -11,12 +17,18 @@ from .core.models import (
     NBERFeedCleanResult,
     NBERFeedFetchResult,
     NBERFeedItem,
+    NBERInfoCacheClearResult,
     NBERSearchResults,
 )
 from .db import (
+    clear_info_cache,
+    count_info_cache,
     get_database_path,
+    get_info_cache_ttl_days,
     get_schema_version,
     init_database,
+    is_info_cache_enabled,
+    is_info_cache_expired,
     migrate_database,
     read_info_cache,
     record_download,
@@ -39,25 +51,33 @@ from .formatters import feed_results, info, related, search_results
 __all__ = [
     "DownloadBatchResult",
     "DownloadFailure",
+    "InfoCacheSettings",
     "NBER",
     "NBERCLIConfig",
     "NBER_CLI_CONFIG",
     "NBERFeedCleanResult",
     "NBERFeedFetchResult",
     "NBERFeedItem",
+    "NBERInfoCacheClearResult",
     "NBERSearchResults",
+    "clear_info_cache",
     "clean_feed_cache",
+    "count_info_cache",
     "download_multiple_papers",
     "download_paper",
     "download_paper_to_file",
     "feed_results",
     "fetch_feed",
     "get_database_path",
+    "get_info_cache_settings",
+    "get_info_cache_ttl_days",
     "get_nber",
     "get_schema_version",
     "init_database",
     "init_feed_database",
     "info",
+    "is_info_cache_enabled",
+    "is_info_cache_expired",
     "main",
     "migrate_database",
     "migrate_feed_database",
@@ -69,6 +89,8 @@ __all__ = [
     "related",
     "search_nber",
     "search_results",
+    "set_info_cache_enabled",
+    "set_info_cache_ttl_days",
     "touch_info_cache",
     "write_info_cache",
 ]