@graphql-codegen/python-common

中文文档
0.1.0发布于 2026/11/11MITTypeScriptESM + CJS构建来源已验证近 30 天下载 5459

Shared Python-specific helpers (reserved keywords, scalar mapping, identifier naming) for @graphql-codegen/python and @graphql-codegen/python-operations.

原始使用文档

@graphql-codegen/python-common

Shared Python-specific helpers for the @graphql-codegen/python plugin family (python, python-operations): the naming knowledge those plugins must agree on so their generated classes line up exactly, kept in one place.

Modeled on @graphql-codegen/c-sharp-common / @graphql-codegen/java-common, which play the same role for their respective language families.

What's here

  • PYTHON_KEYWORDS / PY_IDENT_RE / isValidClassAttr — the CPython reserved-word set (incl. the soft keywords match/case) and identifier validation used to decide when a GraphQL name needs escaping.
  • PYTHON_SCALARS — the default GraphQL scalar → Python type mapping (custom scalars fall back to Any).
  • pythonFieldName / isReservedField — convert a GraphQL name to snake_case for use as a Python identifier, escaping reserved keywords with a trailing _.
  • pascalCase / constantCase — the class-name and document-constant casing helpers, re-exported from change-case-all.

This package is the single place in the family that depends on change-case-all: pythonFieldName, pascalCase, and constantCase all route through it, so every plugin gets the same acronym-splitting behavior (GetHTTPStatus → GetHttpStatus / get_http_status) and no consumer imports change-case-all or hand-rolls the rules itself. python and python-operations get PascalCase names from BaseVisitor.convertName (which uses change-case-all); a plugin that doesn't extend the base visitor can use the pascalCase / constantCase exported here to produce byte-identical names.

版本与发布记录

@graphql-codegen/python-common 共发布 29 个版本,首次发布于 2026/10/28;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.0latest2026/11/115 天前
0.1.0-alpha-20261111095912-96ab889adc0f15f8a38d9950fef222ef73c46126alpha2026/11/115 天前
0.1.0-alpha-20261111092512-1367cf9075eac4fe42ec8e1d72610d15f541aa1d2026/11/115 天前
0.1.0-alpha-20261111092317-6bc0e0e15089cd3f43bfeb2b653a5086f48d05452026/11/115 天前
0.1.0-alpha-20261110215755-5ad8c7676642f8eaeee75d66042c7e8be214da642026/11/116 天前
0.1.0-alpha-20261110130114-66e7e67a38e78ab7516629f6d800b650e2fba9422026/11/106 天前

关于 @graphql-codegen/python-common 的常见问题

@graphql-codegen/python-common 是什么?

Shared Python-specific helpers (reserved keywords, scalar mapping, identifier naming) for @graphql-codegen/python and @graphql-codegen/python-operations.

如何安装 @graphql-codegen/python-common?

在项目目录运行 npm install @graphql-codegen/python-common,或使用 pnpm add / yarn add / bun add。

@graphql-codegen/python-common 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@graphql-codegen/python-common 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@graphql-codegen/python-common 需要什么版本的 Node.js?

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

@graphql-codegen/python-common 可以商用吗?

@graphql-codegen/python-common 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@graphql-codegen/python-common 的下载量有多少?

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

@graphql-codegen/python-common 还在维护吗?

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