DOI-USGS / DOI-USGS/dataretrieval-python

Publish a horizon for Samples keyword aliases

未关闭
#409 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
ready-for-agent
主要语言
Python
星标
266
派生
63
平均合并
1 天 20 小时
30 天内合并 PR
19

描述

## What to build

Give the deprecated Samples camelCase keyword aliases one published removal horizon through the package's shared deprecation mechanism. The aliases were introduced on 2026-08-07; use 2027-08-07, matching the repository's one-year horizon convention.

Both Samples getters must read that date from the central removal table and continue accepting and translating every legacy keyword exactly as they do now. This ticket schedules the aliases; it does not remove them or change their wire spellings.

## Acceptance criteria

- [ ] The central removal table contains one Samples-scoped horizon of 2027-08-07.
- [ ] Both Samples legacy-keyword shims emit advisories that name the usable replacement and print that horizon.
- [ ] No Samples deprecation still says only "in a future release."
- [ ] Tests obtain the expected horizon from the central table rather than duplicating the date literal.
- [ ] Every camelCase alias remains accepted and produces the same request as its snake_case replacement.
- [ ] Public signatures, parameter mappings, and Samples wire names are unchanged.
- [ ] The full offline suite and coverage gate pass.

## Blocked by

None — can start immediately.

贡献指南

打开贡献指南

调研方向

首先定位共享的中央移除表和 Samples 的两个 legacy-keyword getter,然后检查它们现有的 deprecation 测试以及 request-mapping 行为。添加唯一的 2027-08-07 时间节点,并验证 advisories、未更改的 alias 翻译、完整的 offline suite 和 coverage gate。

由索引模型根据 Issue 内容生成。

评估

技术栈
python
领域
api
Issue 类型
功能
难度
3/5
预计耗时
1-2 天
活跃度
活跃
描述清晰度
基本清楚
新手友好度
68/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。