Informe de salud del softwareesquema 0.31.0 · métricas 2.10.0 · 2026-08-11 07:27 UTC

smithy-lang / smithy-python

Smithy code generators and core modules for Python (in development)

Python · JavaApache-2.0★ 83 estrellas⑂ 31 forksdesde feb 2021Ver en GitHub ↗

TipoBibliotecaComplementocómo se determina

smithy-lang/smithy-python tiene un índice de salud de 80 sobre 100, lo que lo sitúa en la banda Excelente. Su puntuación más alta es Security (82/100) y la más baja, Engineering Quality (57/100). Se actualizó por última vez hoy. Una sola persona concentra la mayor parte del trabajo reciente.

global / 100

Excelente

Índice de salud del software

Las métricas se agrupan en categorías ponderadas sobre una escala estandarizada de 1 a 100. El resultado global parte de su media ponderada, calibrada contra la distribución del registro público para que las bandas tengan significado percentil; cuando la evidencia pública activa la Política de Jurisdicciones de Alto Riesgo, la calificación se ajusta y recibe un límite «En riesgo» de 34.

Excepcional93-100El nivel más alto del registro (≈ el 5% superior); cumple prácticamente todos los criterios evaluados

Excelente80-92Sólido en todos los frentes; carencias menores

Bueno65-79Saludable; carencias limitadas y manejables

Moderado50-64Aceptable con carencias notables; se recomienda revisión

Débil35-49Debilidades sustanciales en varias áreas

En riesgo20-34Debilidades significativas; su adopción exige cautela

Crítico1-19Problemas graves (proyecto abandonado, un solo mantenedor, sin higiene)

Perfil de puntuación

Cada eje es una categoría. La forma importa más que la media: un proyecto sano llena toda la figura, mientras que un perfil de picos y cráteres indica que la fortaleza en una dimensión enmascara el riesgo en otra.

El resultado global ponderado 68 se calibra a 80 en la escala publicada del índice (calibración del registro 2026-08-02).

Titularidad

smithy-langOrganización

111 seguidores23 repositorios públicosdesde may 2023

Este repositorio está respaldado por una organización: una custodia compartida y responsable que puede sobrevivir a cualquier mantenedor individual.

Ecosistemas de paquetes

Registro	Paquete	Versión	Descargas / mes	Versiones	Última publicación	Etiquetas
PyPI	smithy-xml	0.1.0	-	1	hace 125 días	sdk smithy xml
PyPI	smithy-core	0.7.0	486.496	10	hace 10 días	sdk smithy
PyPI	smithy-http	0.4.3	474.916	10	hace 10 días	http sdk smithy
PyPI	smithy-json	0.2.3	474.267	6	hace 49 días	json sdk smithy
PyPI	aws-sdk-signers	0.3.0	449.305	6	hace 97 días	amazon aws http sdk signing sigv4
PyPI	smithy-aws-core	0.8.0	-	12	hace 10 días	amazon aws sdk smithy
PyPI	smithy-aws-event-stream	0.3.0	441.154	6	hace 97 días	amazon aws eventstream sdk smithy

Métricas por categoría

Vitalidad

¿Está vivo el proyecto: se escribe código y se publican versiones?

60Moderado · 21% del índice global

Actividad de desarrollo

99Excepcional

Cómo se puntúa

36/36	Recencia de push — último push hace 0 días
35.3/36	Cadencia de commits — 51/52 semanas con commits
18/18	Volumen de commits — 226 commits en el último año
10/10	OpenSSF Scorecard: Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10

Datos de entrada utilizados

commits_last_year	226
human_commit_share	0,6
days_since_last_push	0
active_weeks_last_year	51

Disciplina de publicación

1Crítico

Cómo se puntúa

0/27	Publica versiones — sin versiones publicadas
0/36	Recencia de las versiones — sin versiones
0/27	Cadencia de publicación — sin versiones
0/10	OpenSSF Scorecard: Signed-Releases — sin datos

Datos de entrada utilizados

releases_count

Excluidos de la puntuación (sin datos o no aplicable): OpenSSF Scorecard: Signed-Releases. Los pesos restantes se han renormalizado.

Comunidad y Adopción

¿Tiene el proyecto usuarios, descargas, atención y unas condiciones acogedoras para quienes contribuyen?

76Bueno · 17% del índice global

Popularidad y adopción

47Débil

Cómo se puntúa

31/60	Estrellas — 83 estrellas
12.3/25	Forks — 31 forks
3.3/15	Observadores — 5 observadores

Datos de entrada utilizados

forks	31
stars	83
watchers	5
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

Salud de la comunidad

92Excelente

Cómo se puntúa

22.5/22.5	README
22.5/22.5	Licencia — licencia reconocida (Apache-2.0)
18/18	Guía CONTRIBUTING
13.5/13.5	Código de conducta
0/7.2	Plantilla de issues
6.3/6.3	Plantilla de PR

Datos de entrada utilizados

has_readme	sí
has_license	sí
readme_badges	0
has_contributing	sí
has_issue_template	no
has_code_of_conduct	sí
readme_badge_services	—
has_pull_request_template	sí

Adopción en el ecosistema (descargas)

100Excepcional

Cómo se puntúa

80/80	Descargas mensuales — 2.326.138 descargas/mes en pypi
0/20	Dependientes en el registro — no lo informa este ecosistema

Datos de entrada utilizados

packages	smithy-xml, smithy-core, smithy-http, smithy-json, aws-sdk-signers, smithy-aws-core, smithy-aws-event-stream
dependents	—
ecosystems	pypi
total_downloads	—
monthly_downloads	2.326.138
unverified_packages_excluded	—

Excluidos de la puntuación (sin datos o no aplicable): Dependientes en el registro. Los pesos restantes se han renormalizado.

Sostenibilidad y Gobernanza

¿Sobrevivirá el proyecto a sus personas: factor bus, capacidad de respuesta, quién lo respalda y mantenimiento del paquete?

68Bueno · 23% del índice global

Resiliencia de mantenedores (factor bus)

42Débil

Cómo se puntúa

9/54	Factor bus — la mitad de los commits recae en 1 contribuyente(s)
9/22.5	Distribución de commits — el principal contribuyente firma el 60% de los commits
13.5/13.5	Amplitud de contribuyentes — 20 contribuyentes
10/10	OpenSSF Scorecard: Contributors — project has 9 contributing companies or organizations

Datos de entrada utilizados

bus_factor	1
contributors_sampled	20
top_contributor_share	0,599

Capacidad de respuesta a issues y PR

67Bueno

Cómo se puntúa

18.5/42	Resolución de issues — 44% de issues cerradas
28/30	Aceptación de PR — 674/722 PR decididos fusionados
0/13	Newcomer PR acceptance — ningún PR de un contribuyente primerizo decidido en 30 d
12/15	OpenSSF Scorecard: Code-Review — Found 15/18 approved changesets -- score normalized to 8

Datos de entrada utilizados

merged_prs	674
open_issues	14
closed_issues	11
prs_merged_7d	1
prs_decided_7d	2
prs_merged_30d	3
prs_decided_30d	5
issue_closed_ratio	0,44
closed_unmerged_prs	48
first_time_authors_30d	0
first_time_prs_merged_30d	0
first_time_prs_decided_30d	0

Excluidos de la puntuación (sin datos o no aplicable): Newcomer PR acceptance. Los pesos restantes se han renormalizado.

Propiedad y custodia

76Bueno

Cómo se puntúa

30/30	Respaldo de la propiedad — propiedad de una organización
0/20	Dominio verificado — el estado de dominio verificado no se leyó para esta organización
14.7/25	Alcance del propietario — 111 seguidores de smithy-lang
16.5/25	Trayectoria — 23 repos públicos, cuenta de ~3 años

Datos de entrada utilizados

followers	111
owner_type	Organization
is_verified	—
owner_login	smithy-lang
public_repos	23
account_age_days	1182

Excluidos de la puntuación (sin datos o no aplicable): Dominio verificado. Los pesos restantes se han renormalizado.

Mantenimiento de paquetes

100Excepcional

Cómo se puntúa

25/25	Publicado y resoluble — 7 paquete(s) en pypi
35/35	Recencia de publicación — última publicación hace 10 días
20/20	Historial de versiones — 12 versiones en el registro
20/20	No obsoleto — activo, ni obsoleto ni retirado

Datos de entrada utilizados

packages	smithy-xml, smithy-core, smithy-http, smithy-json, aws-sdk-signers, smithy-aws-core, smithy-aws-event-stream
ecosystems	pypi
any_deprecated	no
min_days_since_publish	10

Calidad de Ingeniería

¿Existen unas prácticas mínimas de ingeniería y documentación?

57Moderado · 19% del índice global

Prácticas de ingeniería

68Bueno

Cómo se puntúa

24/24	Flujos de trabajo de CI — 4 flujo(s) de trabajo
24/24	Pruebas presentes
0/16	Configuración de linter
0/9.6	Hooks de pre-commit
0/6.4	.editorconfig
20/20	OpenSSF Scorecard: CI-Tests — 27 out of 27 merged PRs checked by a CI test -- score normalized to 10

Datos de entrada utilizados

has_ci	sí
has_tests	sí
has_editorconfig	no
has_linter_config	no
has_precommit_config	no

Documentación

40Débil

Cómo se puntúa

30/30	README
0/25	Directorio de documentación
0/15	Sitio de documentación / página del proyecto
10/10	Descripción del repositorio
0/10	Topics
0/10	Wiki

Datos de entrada utilizados

topics	—
has_wiki	no
homepage	—
docs_site	—
has_readme	sí
has_docs_dir	no
has_description	sí

Seguridad

¿Son sólidas las prácticas visibles de seguridad y de cadena de suministro, sin exposición jurisdiccional de alto riesgo sin resolver?

82Excelente · 16% del índice global

Postura de seguridad

78Bueno

Cómo se puntúa

6.8/7.5	Binary-Artifacts — binaries present in source code
4.5/7.5	Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5	CI-Tests — 27 out of 27 merged PRs checked by a CI test -- score normalized to 10
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
6/7.5	Code-Review — Found 15/18 approved changesets -- score normalized to 8
2.5/2.5	Contributors — project has 9 contributing companies or organizations
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5	Dependency-Update-Tool — update tool detected
0/5	Fuzzing — project is not fuzzed
2.5/2.5	Licencia — license file detected
7.5/7.5	Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
0/5	Packaging — sin datos
5/5	Pinned-Dependencies — all dependencies are pinned
5/5	SAST — SAST tool is run on all commits
5/5	Security-Policy — security policy file detected
0/7.5	Signed-Releases — sin datos
7.5/7.5	Token-Permissions — GitHub workflow tokens follow principle of least privilege
0/7.5	Vulnerabilities — 12 existing vulnerabilities detected

Datos de entrada utilizados

source	openssf_scorecard
checks_evaluated	16
scorecard_version	v5.5.0
checks_inconclusive	2
scorecard_aggregate	7,8

Excluidos de la puntuación (sin datos o no aplicable): Packaging, Signed-Releases. Los pesos restantes se han renormalizado.

Avisos de dependencias

100Excepcional

Cómo se puntúa

35/35	Dependencias directas libres de avisos conocidos — ninguna dependencia directa tiene un aviso conocido
25/25	Dependencias indirectas libres de avisos conocidos — ninguna dependencia indirecta tiene un aviso conocido
0/40	Sin avisos pendientes — ningún aviso tiene fecha de publicación

Datos de entrada utilizados

source	osv
advisories	0
affected_packages	0
assessed_packages	1
unassessed_packages	0
affected_by_severity	none
direct_affected_packages	0

Excluidos de la puntuación (sin datos o no aplicable): Sin avisos pendientes. Los pesos restantes se han renormalizado. Se cotejó el cierre de dependencias en tiempo de ejecución de pypi:smithy-xml@0.1.0 —lo que arrastra la instalación del paquete publicado—: 1 paquetes. No se analiza la alcanzabilidad.

Preparación para IA

¿Hasta qué punto está el repositorio preparado para desarrollarse y mantenerse con agentes de codificación de IA? Tiene un peso deliberadamente pequeño (4%): las herramientas para agentes son una señal real de mantenimiento, pero un repositorio sin ninguna puede alcanzar igualmente 100/100.

69Bueno · 4% del índice global

Contexto y guía para agentes

33En riesgo

Cómo se puntúa

0/45	Instrucciones para agentes — sin CLAUDE.md / AGENTS.md / reglas de editor
0/15	Documentación legible por máquinas (llms.txt)
32.9/40	Historial de commits legible — 37 de 60 commits humanos declaran su intención (asunto estructurado o cuerpo explicativo)

Datos de entrada utilizados

has_llms_txt	no
llms_txt_url	—
legible_history_share	0,617
agent_instruction_files	—
agent_instruction_max_bytes	—

Bucle de verificación (compilación / pruebas / verificación de tipos)

79Bueno

Cómo se puntúa

18/18	Arranque con un solo comando — Makefile
22/22	Pruebas automatizadas
0/11	Configuración de lint / formato
11/11	Verificación estática de tipos — packages/aws-sdk-signers/src/aws_sdk_signers/py.typed, packages/smithy-aws-core/src/smithy_aws_core/py.typed, packages/smithy-aws-event-stream/src/smithy_aws_event_stream/py.typed, packages/smithy-aws-event-stream/tests/py.typed, packages/smithy-core/src/smithy_core/py.typed, packages/smithy-core/tests/py.typed, packages/smithy-http/src/smithy_http/py.typed, packages/smithy-http/tests/py.typed, packages/smithy-json/src/smithy_json/py.typed, packages/smithy-xml/src/smithy_xml/py.typed
10/10	Entorno reproducible — lockfile
0/10	Práctica demostrada con agentes — ningún commit con autoría de agente entre los últimos 100
8/8	Mantenimiento automatizado — 40 de los últimos 100 commits son actualizaciones automáticas de dependencias
10/10	OpenSSF Scorecard: Pinned-Dependencies — all dependencies are pinned

Datos de entrada utilizados

has_nix	no
has_tests	sí
lockfiles	uv.lock
has_dockerfile	no
typed_language	no
bootstrap_files	Makefile
has_devcontainer	no
has_linter_config	no
typecheck_configs	packages/aws-sdk-signers/src/aws_sdk_signers/py.typed, packages/smithy-aws-core/src/smithy_aws_core/py.typed, packages/smithy-aws-event-stream/src/smithy_aws_event_stream/py.typed, packages/smithy-aws-event-stream/tests/py.typed, packages/smithy-core/src/smithy_core/py.typed, packages/smithy-core/tests/py.typed, packages/smithy-http/src/smithy_http/py.typed, packages/smithy-http/tests/py.typed, packages/smithy-json/src/smithy_json/py.typed, packages/smithy-xml/src/smithy_xml/py.typed
agent_commit_share	0
toolchain_manifests	codegen/aws/core/build.gradle.kts, codegen/build.gradle.kts, codegen/buildSrc/build.gradle.kts, codegen/core/build.gradle.kts, codegen/plugins/build.gradle.kts, codegen/plugins/types/build.gradle.kts, codegen/protocol-test/build.gradle.kts
dependency_bot_commit_share	0,4

Legibilidad del código para modelos

82Excelente

Cómo se puntúa

27/45

Código verificable por tipos — Python con configuración de verificación de tipos (packages/aws-sdk-signers/src/aws_sdk_signers/py.typed, packages/smithy-aws-core/src/smithy_aws_core/py.typed, packages/smithy-aws-event-stream/src/smithy_aws_event_stream/py.typed, packages/smithy-aws-event-stream/tests/py.typed, packages/smithy-core/src/smithy_core/py.typed, packages/smithy-core/tests/py.typed, packages/smithy-http/src/smithy_http/py.typed, packages/smithy-http/tests/py.typed, packages/smithy-json/src/smithy_json/py.typed, packages/smithy-xml/src/smithy_xml/py.typed)

54.8/55

Tamaños de archivo manejables — 1/290 archivos fuente de más de 60 KB

Datos de entrada utilizados

primary_language	Python
largest_source_bytes	70.827
source_files_sampled	290
oversized_source_files	1

Interfaces legibles por máquina

100Excepcional

Cómo se puntúa

0/40	Esquema de API (OpenAPI/GraphQL/proto) — no aplicable a este tipo de software
0/20	Servidor MCP — no aplicable a este tipo de software
40/40	Ejemplos ejecutables — examples

Datos de entrada utilizados

example_dirs	examples
has_mcp_signal	no
api_schema_files	—
interfaces_expected_of	—

Excluidos de la puntuación (sin datos o no aplicable): Esquema de API (OpenAPI/GraphQL/proto), Servidor MCP. Los pesos restantes se han renormalizado.

Datos clave

83estrellas de GitHub

20contribuidores

226commits en los últimos 12 meses

0días desde el último push

0versiones publicadas

1factor bus

14issues abiertas

Maven, PyPIecosistemas de paquetes

Advertencias de recopilación de datos

Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
Could not fetch pypi package 'smithy-python' from its registry

Más detalle

Historial de estrellas y forks 0 ★ / 31 ⇿

0Estrellas

31Forks

Cuándo se añadió cada estrella y fork, recopilado de GitHub y agrupado por día. El crecimiento acumulado se sitúa justo encima de las adiciones diarias que lo componen, de modo que ambos se leen en conjunto: la acumulación orgánica sostenida no se parece en nada a un pico abrupto y efímero. Cuando esa diferencia es medible, se informa como autenticidad del crecimiento.

Cada punto abarca 3 días.

OpenSSF Scorecard 7.8 / 10

7.8agregado

Evaluación de seguridad independiente y agnóstica en cuanto a herramientas, procedente del proyecto de código abierto OpenSSF Scorecard. Cada comprobación premia una práctica de seguridad, no la herramienta de un proveedor concreto. Las comprobaciones que Scorecard no pudo determinar se marcan como n/d y se excluyen de la puntuación de seguridad (nunca se cuentan como cero).Scorecard v5.5.0 · 2026-08-11 07:27 UTC

9	Binary-Artifacts	binaries present in source code
6	Branch-Protection	branch protection is not maximal on development and all release branches
10	CI-Tests	27 out of 27 merged PRs checked by a CI test -- score normalized to 10
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
8	Code-Review	Found 15/18 approved changesets -- score normalized to 8
10	Contributors	project has 9 contributing companies or organizations
10	Dangerous-Workflow	no dangerous workflow patterns detected
10	Dependency-Update-Tool	update tool detected
0	Fuzzing	project is not fuzzed
10	License	license file detected
10	Maintained	30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
n/d	Packaging	packaging workflow not detected
10	Pinned-Dependencies	all dependencies are pinned
10	SAST	SAST tool is run on all commits
10	Security-Policy	security policy file detected
n/d	Signed-Releases	no releases found
10	Token-Permissions	GitHub workflow tokens follow principle of least privilege
0	Vulnerabilities	12 existing vulnerabilities detected

Dependencias directas 8

Registro	Paquete	Restricción de versión	Manifiesto
PyPI	smithy-core	`~=0.7.0`	packages/smithy-aws-core/pyproject.toml
PyPI	smithy-http	`~=0.4.0`	packages/smithy-aws-core/pyproject.toml
PyPI	aws-sdk-signers	`~=0.3.0`	packages/smithy-aws-core/pyproject.toml
PyPI	smithy-core	`—`	packages/smithy-aws-event-stream/pyproject.toml
PyPI	smithy-core	`—`	packages/smithy-http/pyproject.toml
PyPI	ijson	`>=3.3.0`	packages/smithy-json/pyproject.toml
PyPI	smithy-core	`—`	packages/smithy-json/pyproject.toml
PyPI	smithy-core	`—`	packages/smithy-xml/pyproject.toml

Todas las dependencias 40

Conjunto completo de dependencias resueltas según el grafo de dependencias de GitHub: 5 paquetes directos y 35 indirectos (transitivos). El cierre transitivo es completo cuando el repositorio incluye un lockfile.

Registro	Paquete	Versión	Relación
PyPI	aws-sdk-signers	`—`	directa
PyPI	ijson	`—`	directa
PyPI	ijson	`3.3.0`	directa
PyPI	smithy-core	`—`	directa
PyPI	smithy-http	`—`	directa
PyPI	aiohappyeyeballs	`2.6.1`	indirecta
PyPI	aiohttp	`—`	indirecta
PyPI	aiohttp	`3.14.0`	indirecta
PyPI	aiosignal	`1.4.0`	indirecta
PyPI	attrs	`25.3.0`	indirecta
PyPI	awscrt	`—`	indirecta
PyPI	awscrt	`0.32.0`	indirecta
PyPI	colorama	`0.4.6`	indirecta
PyPI	coverage	`7.12.0`	indirecta
PyPI	freezegun	`1.5.5`	indirecta
PyPI	frozenlist	`1.6.0`	indirecta
PyPI	idna	`3.15`	indirecta
PyPI	iniconfig	`2.1.0`	indirecta
PyPI	jinja2	`3.1.6`	indirecta
PyPI	markupsafe	`3.0.2`	indirecta
PyPI	multidict	`6.4.3`	indirecta
PyPI	nodeenv	`1.9.1`	indirecta
PyPI	packaging	`25.0`	indirecta
PyPI	pluggy	`1.5.0`	indirecta
PyPI	propcache	`0.3.1`	indirecta
PyPI	pygments	`2.19.2`	indirecta
PyPI	pyright	`1.1.406`	indirecta
PyPI	pytest	`9.0.3`	indirecta
PyPI	pytest-asyncio	`1.3.0`	indirecta
PyPI	pytest-cov	`7.0.0`	indirecta
PyPI	python-dateutil	`2.9.0.post0`	indirecta
PyPI	ruff	`0.15.22`	indirecta
PyPI	six	`1.17.0`	indirecta
PyPI	smithy-aws-event-stream	`—`	indirecta
PyPI	smithy-json	`—`	indirecta
PyPI	smithy-python	`0.1.0`	indirecta
PyPI	smithy-xml	`—`	indirecta
PyPI	typing-extensions	`—`	indirecta
PyPI	typing-extensions	`4.13.2`	indirecta
PyPI	yarl	`1.20.0`	indirecta

Avisos de dependencias 0

Instalar pypi:smithy-xml@0.1.0 arrastra 1 paquetes, directos y transitivos: 0 tienen avisos conocidos, de los cuales 0 son dependencias directas.

Ningún aviso conocido afecta a las dependencias evaluadas.

Un aviso significa que la versión registrada en el grafo de dependencias cae dentro del rango afectado de un aviso. No se analiza la alcanzabilidad, y el grafo incluye fijaciones de desarrollo y prueba: un hallazgo puede referirse al utillaje y no al software distribuido.

Informe JSON sin procesar legible por máquina

Comentarios

¿Algo no cuadra en este informe, o hay ideas que compartir? Mediciones erróneas, herramientas no detectadas, ideas, preguntas: todo es bienvenido. Cada mensaje se lee y recibe respuesta.

Las puntuaciones son señales, no garantías. Reflejan prácticas públicamente visibles en GitHub; no son una auditoría de código ni una garantía de seguridad.

Los datos ausentes se excluyen y los pesos se renormalizan; nunca se puntúan como cero. La metodología es versionada y abierta: métricas v2.10.0, esquema v0.31.0 — metodología completa · wiki de métricas.

Cómo se sitúa un resultado dentro del registro general: estadísticas agregadas — PyPI.

Índice de salud del software

Perfil de puntuación

Titularidad

Ecosistemas de paquetes

Métricas por categoría

Datos clave

Advertencias de recopilación de datos

Más detalle

Comentarios

Registros relacionados