@defra/lis-species-cattle

中文文档
0.10.7发布于 2026/11/10OGL-UK-3.0ES Module零依赖构建来源已验证近 30 天下载 5658

牲畜分类流动共享套餐.

中文使用文档
文档目录19 节
  1. 安装
  2. 使用量
  3. species
  4. breeds
  5. getBreedName(code)
  6. getBreedCode(name)
  7. 先决条件
  8. 设置
  9. 发展
  10. 测试
  11. 正在发展中
  12. 正在测试
  13. 管道
  14. 本地运行建筑
  15. 本地测试 GitHub 动作工作流程
  16. 分支政策
  17. 协助这一项目
  18. 许可证
  19. 关于许可证

丽斯-物种-牲畜

畜牧信息服务(LIS)的一部分,它允许牲畜饲养者、所有者、代理商和牲畜饲养者使用 代表们记录和管理他们的动物.

@defra/lis-species-cattle 是一个共享 npm 包, 持有牛种定义 牛的微站点:物种特征和牛的品种和品种代码列表.

这是一个物种包。 分类学套件( E)lis-taxonomy-*例如家、搬家、搬家 (d) 说明旅行的作用。 这个包裹说它是为了哪个物种 一头牛 微站点将两者结合起来,例如从 taxonomy.id 财务报告和审定财务报表 species.id编辑 软件包不导入任何分类软件包。 哥哥们 丽丝-羊 套件对绵羊遵循相同的模式.

用于:

安装

npm install @defra/lis-species-cattle

软件包没有对等依赖性 .

使用量

包裹有一个入口, @defra/lis-species-cattle它输出四样东西.

species

该物种的特征: { id: 'cattle', label: 'Cattle', summary: '...' }启用 species.id 改为 构建微站路径.

import { species } from '@defra/lis-species-cattle'

export const ROOT_PATH = buildMicrositePath(taxonomy.id, species.id)

breeds

牛品种犬目列表 以大案品种代码为关键对象. 举个例子 breeds.AA 实值 'Aberdeen Angus'. 十字军有自己的代码,例如: AAX 实值 'Aberdeen Angus Cross'。 。 。 .

import { breeds } from '@defra/lis-species-cattle'

const items = Object.entries(breeds).map(([value, text]) => ({ value, text }))

getBreedName(code)

返回品种代码的品种名称 。 代码是忽略大小写。 回返 undefined 用于 未知代码 .

import { getBreedName } from '@defra/lis-species-cattle'

getBreedName('aa') // 'Aberdeen Angus'
getBreedName('nope') // undefined

getBreedCode(name)

返回品种名称的品种代码。 名字是小写小写和小写, 卷曲或缺失)被忽略. 回返 undefined 一个未知的名字.

import { getBreedCode } from '@defra/lis-species-cattle'

getBreedCode('aberdeen angus') // 'AA'
getBreedCode("Blonde D'Aquitaine") // 'BA'

先决条件

  • 节点.js 24(见 .nvmrc,使用时 nvm use(中文(简体) )
  • 对照一个消费的应用程序检查更改: 净值 一次性设置完成

设置

发展

nvm use
npm install

测试

无法安装工具 npm install测试 维特。 。 。 .

正在发展中

这是一个库,所以它没有自己的服务器. 尝试改变一个消费应用 没有 发布, 将本地副本链接到 lis- dev 堆栈 :

cd lis-dev
.bin/sideload link species/cattle       # every installed copy now points at this repo
.bin/sideload up cattle-home            # optional: run a consumer locally with hot reload
.bin/sideload unlink species/cattle     # when done

正在测试

npm test                 # unit tests
npm run test:coverage    # with coverage
npm run lint             # ESLint
npm run format:check     # Prettier

在释放出一个变化之前,还要对连接包进行每个消耗回波的测试.

管道

GitHub 动作中运行的构建、版本和出版(.github/workflows)使用蛋糕脚本(*.cake:

  • 将请求拉到 main: 校验(格式、林特、测试),声纳分析,版本检查
  • 推到一个 feature/ 或者说 hotfix/ 分支: 预发版本和标签
  • 合并到 main: 释放标签,然后发布到 无

版本来自git标签 (SemVer). 合并后, 等待出版工作完成后, 才将套件撞入消耗回购中 .

本地运行建筑

蛋糕是建造引擎并管弦乐节点包生命周期. 运行默认构建 (安装、审计、格式、插图、测试和包)当地:

dotnet cake ./build.cake --target=Default --package_version=0.1.0

本地测试 GitHub 动作工作流程

安装 act (例如 brew install act),然后运行:

act -W .github/workflows/prerelease.yml

分支政策

Repo采用干线开发. 分行从 main 并命名分支:

  • feature/LREG-<ticket>-<short-kebab-description>
  • hotfix/LREG-<ticket>-<short-kebab-description>

LREG 必须是大写,因为 GitHub 规则拒绝其他分支名称。 重置为 main 而不是合并 main 进去.

协助这一项目

  • 跟着 Defra软件开发标准。 。 。 .
  • npm install 设置一个承诺前钩子(Husky),运行安全审计,格式检查和lint.
  • 打开拉动请求 main 使用 PR 模板。 CI必须通过而声纳质量门在合并前必须是绿色.

许可证

本资料系根据下列公开政府规定公布:

http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3 互联网档案馆的存檔,存档日期2013-12-21

在使用此信息时, 您的产品和应用程序中引用以下的归属声明 MUST .

载有根据开放政府许可证颁发的公共部门信息v3

关于许可证

开放政府许可证(OGL)由陛下文具办公室(HMSO)的主计长制定,使公共部门的信息提供者能够根据共同开放许可证许可其信息的使用和再使用.

它旨在鼓励自由和灵活地使用和再使用信息,仅附带一些条件.

版本与发布记录

@defra/lis-species-cattle 共发布 35 个版本,首次发布于 2026/08/06;过去 12 个月发布了 35 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.7latest2026/11/101 天前
0.10.62026/11/092 天前
0.10.52026/11/092 天前
0.10.42026/11/092 天前
0.10.32026/11/092 天前
0.10.22026/11/092 天前

其他发布通道:alpha → 0.10.0-lreg-814.alpha.3。

关于 @defra/lis-species-cattle 的常见问题

@defra/lis-species-cattle 是什么?

牲畜分类流动共享套餐.

如何安装 @defra/lis-species-cattle?

在项目目录运行 npm install @defra/lis-species-cattle,或使用 pnpm add / yarn add / bun add。

@defra/lis-species-cattle 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/defra__lis-species-cattle 是否存在。

@defra/lis-species-cattle 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@defra/lis-species-cattle 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@defra/lis-species-cattle 可以商用吗?

@defra/lis-species-cattle 使用 OGL-UK-3.0 许可。声明的许可为 OGL-UK-3.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@defra/lis-species-cattle 的下载量有多少?

根据 npm 官方下载统计,@defra/lis-species-cattle 在 2026/10/12 – 2026/11/10 这 30 天内被下载 5,658 次,日均约 189 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@defra/lis-species-cattle 还在维护吗?

最新版本 0.10.7 发布于 2026/11/10(1 天前);至今共发布 35 个版本,其中过去 12 个月发布了 35 个;首次发布于 2026/08/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。