项目状态标记¶

注意

此规范最初定义于 PEP 792。

注意

PEP 792 包含了对 HTML 和 JSON 索引 API 的更改。这些更改记录在简单仓库 API 中的 HTML - 项目详情和 JSON - 项目详情下。

规范¶

一个项目总是只有一个状态。如果没有明确指出状态，则该项目被认为是 active 状态。

索引可以根据其需求实现任何指定状态标记的子集。

本标准不规定哪些主体（即项目维护者、索引管理员等）被允许设置和取消设置哪些状态。

`active`¶

描述：项目处于活跃状态。这是项目的默认状态。

索引语义

托管该项目的索引必须允许向该项目上传新的分发包。
索引必须提供该项目现有的分发包供下载。

安装器语义：无。

`archived`¶

描述：项目预计未来不会再更新。

索引语义

托管该项目的索引不得允许向该项目上传新的分发包。
索引必须提供该项目现有的分发包供下载。

安装器语义

安装器可以对项目的归档状态发出警告。

`quarantined`¶

描述：项目被认为普遍不安全，例如由于恶意软件。

索引语义

托管该项目的索引不得允许向该项目上传新的分发包。
索引不得提供该项目的任何分发包供下载。

安装器语义

安装器可以对项目的隔离状态发出警告，尽管这样做实际上是毫无意义的（因为索引不会提供任何分发包进行安装）。

`deprecated`¶

描述：项目被认为已过时，并且可能已被其他项目取代。

索引语义

此状态与 active 具有相同的语义。

安装器语义

安装器可以对项目的弃用状态发出警告。