Registro público
Informe de salud del softwareesquema 0.12.0 · métricas 2.10.0 · 2026-07-18 13:49 UTC

mitmproxy / pdoc

API Documentation for Python Projects

Python · JinjaMIT-0★ 2513 estrellas⑂ 228 forksdesde ago 2013Ver en GitHub ↗
TipoBibliotecacómo se determina
#documentation#python#docstrings#docs#pdoc#api-documentation#python3#api#docstring#documentation-tool#documentation-generator

mitmproxy/pdoc tiene un índice de salud de 81 sobre 100, lo que lo sitúa en la banda Excelente. Su puntuación más alta es Community & Adoption (84/100) y la más baja, AI Readiness (52/100). Se actualizó por última vez hace 17 días. Una sola persona concentra la mayor parte del trabajo reciente.

81
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.

81
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)
VitalidadComunidad yAdopciónSostenibilidady GobernanzaCalidad deIngenieríaSeguridadPreparaciónpara IA

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 69 se calibra a 81 en la escala publicada del índice (calibración del registro 2026-08-02).

Titularidad

mitmproxyOrganización
639 seguidores20 repositorios públicosdesde jun 2013

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

Ecosistemas de paquetes

RegistroPaqueteVersiónDescargas / mesVersionesÚltima publicación
PyPIpdoc16.0.0-114hace 263 días

Métricas por categoría

Vitalidad

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

53Moderado · 21% del índice global

Actividad de desarrollo

49Débil
Cómo se puntúa
28.8/36Recencia de push — último push hace 17 días
6.9/36Cadencia de commits — 10/52 semanas con commits
12.9/18Volumen de commits — 26 commits en el último año
0/10OpenSSF Scorecard: Maintained — 0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
Datos de entrada utilizados
commits_last_year26
human_commit_share—
days_since_last_push17
active_weeks_last_year10

Disciplina de publicación

58Moderado
Cómo se puntúa
16.2/27Publica versiones — 93 etiquetas de versión (sin releases de GitHub)
16.2/36Recencia de las versiones — última versión hace 263 días
19.8/27Cadencia de publicación — una versión cada ~54,3 días
0/10OpenSSF Scorecard: Signed-Releases — sin datos
Datos de entrada utilizados
releases_count93
latest_release_tagv16.0.0
releases_from_tagssí
days_since_latest_release263
mean_days_between_releases54,3
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?

84Excelente · 17% del índice global

Popularidad y adopción

83Excelente
Cómo se puntúa
55.2/60Estrellas — 2513 estrellas
19.6/25Forks — 228 forks
8.3/15Observadores — 32 observadores
Datos de entrada utilizados
forks228
stars2513
watchers32
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

Salud de la comunidad

85Excelente
Cómo se puntúa
22.5/22.5README
22.5/22.5Licencia — licencia reconocida (MIT-0)
18/18Guía CONTRIBUTING
13.5/13.5Código de conducta
0/7.2Plantilla de issues
0/6.3Plantilla de PR
Datos de entrada utilizados
has_readmesí
has_licensesí
readme_badges—
has_contributingsí
has_issue_templateno
has_code_of_conductsí
readme_badge_services—
has_pull_request_templateno

Sostenibilidad y Gobernanza

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

73Bueno · 23% del índice global

Resiliencia de mantenedores (factor bus)

41Débil
Cómo se puntúa
9/54Factor bus — la mitad de los commits recae en 1 contribuyente(s)
8.8/22.5Distribución de commits — el principal contribuyente firma el 61% de los commits
13.5/13.5Amplitud de contribuyentes — 62 contribuyentes
10/10OpenSSF Scorecard: Contributors — project has 32 contributing companies or organizations
Datos de entrada utilizados
bus_factor1
contributors_sampled62
top_contributor_share0,607

Capacidad de respuesta a issues y PR

79Bueno
Cómo se puntúa
37.5/42Resolución de issues — 89% de issues cerradas
24.9/30Aceptación de PR — 331/399 PR decididos fusionados
0/13Newcomer PR acceptance — ningún PR de un contribuyente primerizo decidido en 30 d
6/15OpenSSF Scorecard: Code-Review — Found 9/19 approved changesets -- score normalized to 4
Datos de entrada utilizados
merged_prs331
open_issues50
closed_issues417
prs_merged_7d—
prs_decided_7d—
prs_merged_30d—
prs_decided_30d—
issue_closed_ratio0,893
closed_unmerged_prs68
first_time_authors_30d—
first_time_prs_merged_30d—
first_time_prs_decided_30d—
Excluidos de la puntuación (sin datos o no aplicable): Newcomer PR acceptance. Los pesos restantes se han renormalizado.

Propiedad y custodia

90Excelente
Cómo se puntúa
30/30Respaldo de la propiedad — propiedad de una organización
0/20Dominio verificado — el estado de dominio verificado no se leyó para esta organización
20.2/25Alcance del propietario — 639 seguidores de mitmproxy
21.6/25Trayectoria — 20 repos públicos, cuenta de ~13 años
Datos de entrada utilizados
followers639
owner_typeOrganization
is_verified—
owner_loginmitmproxy
public_repos20
account_age_days4787
Excluidos de la puntuación (sin datos o no aplicable): Dominio verificado. Los pesos restantes se han renormalizado.

Mantenimiento de paquetes

91Excelente
Cómo se puntúa
25/25Publicado y resoluble — 1 paquete(s) en pypi
26/35Recencia de publicación — última publicación hace 263 días
20/20Historial de versiones — 114 versiones en el registro
20/20No obsoleto — activo, ni obsoleto ni retirado
Datos de entrada utilizados
packagespdoc
ecosystemspypi
any_deprecatedno
min_days_since_publish263

Calidad de Ingeniería

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

76Bueno · 19% del índice global

Prácticas de ingeniería

66Bueno
Cómo se puntúa
24/24Flujos de trabajo de CI — 4 flujo(s) de trabajo
24/24Pruebas presentes
0/16Configuración de linter
0/9.6Hooks de pre-commit
0/6.4.editorconfig
18/20OpenSSF Scorecard: CI-Tests — 26 out of 27 merged PRs checked by a CI test -- score normalized to 9
Datos de entrada utilizados
has_cisí
has_testssí
has_editorconfigno
has_linter_configno
has_precommit_configno

Documentación

90Excelente
Cómo se puntúa
30/30README
25/25Directorio de documentación
15/15Sitio de documentación / página del proyecto — https://pdoc.dev
10/10Descripción del repositorio
10/10Topics — 11 topics
0/10Wiki
Datos de entrada utilizados
topicsdocumentation, python, docstrings, docs, pdoc, api-documentation, python3, api, docstring, documentation-tool, documentation-generator
has_wikino
homepagehttps://pdoc.dev
docs_sitehttps://pdoc.dev
has_readmesí
has_docs_dirsí
has_descriptionsí

Seguridad

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

67Bueno · 16% del índice global

Postura de seguridad

67Bueno
Cómo se puntúa
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — sin datos
2.2/2.5CI-Tests — 26 out of 27 merged PRs checked by a CI test -- score normalized to 9
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
3/7.5Code-Review — Found 9/19 approved changesets -- score normalized to 4
2.5/2.5Contributors — project has 32 contributing companies or organizations
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5Licencia — license file detected
0/7.5Maintained — 0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
0/5Packaging — sin datos
4/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 8
2/5SAST — SAST tool is not run on all commits -- score normalized to 4
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — sin datos
7.5/7.5Token-Permissions — GitHub workflow tokens follow principle of least privilege
3/7.5Vulnerabilities — 6 existing vulnerabilities detected
Datos de entrada utilizados
sourceopenssf_scorecard
checks_evaluated15
scorecard_versionv5.5.0
checks_inconclusive3
scorecard_aggregate6,7
Excluidos de la puntuación (sin datos o no aplicable): Branch-Protection, Packaging, Signed-Releases. Los pesos restantes se han renormalizado.

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.

52Moderado · 4% del índice global

Contexto y guía para agentes

1Crítico
Cómo se puntúa
0/45Instrucciones para agentes — sin CLAUDE.md / AGENTS.md / reglas de editor
0/15Documentación legible por máquinas (llms.txt)
0/40Historial de commits legible — sin datos
Datos de entrada utilizados
has_llms_txtno
llms_txt_url—
legible_history_share—
agent_instruction_files—
agent_instruction_max_bytes—
Excluidos de la puntuación (sin datos o no aplicable): Historial de commits legible. Los pesos restantes se han renormalizado.

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

62Moderado
Cómo se puntúa
0/18Arranque con un solo comando
22/22Pruebas automatizadas
0/11Configuración de lint / formato
11/11Verificación estática de tipos — pdoc/py.typed
10/10Entorno reproducible — lockfile
0/10Práctica demostrada con agentes — sin datos
5/8Mantenimiento automatizado — automatización de dependencias configurada, no observada en los commits muestreados
8/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 8
Datos de entrada utilizados
has_nixno
has_testssí
lockfilesuv.lock
has_dockerfileno
typed_languageno
bootstrap_files—
has_devcontainerno
has_linter_configno
typecheck_configspdoc/py.typed
agent_commit_share—
toolchain_manifests—
dependency_bot_commit_share0
Excluidos de la puntuación (sin datos o no aplicable): Práctica demostrada con agentes. Los pesos restantes se han renormalizado.

Legibilidad del código para modelos

82Excelente
Cómo se puntúa
27/45Código verificable por tipos — Python con configuración de verificación de tipos (pdoc/py.typed)
55/55Tamaños de archivo manejables — 0/87 archivos fuente de más de 60 KB
Datos de entrada utilizados
primary_languagePython
largest_source_bytes50.382
source_files_sampled87
oversized_source_files0

Interfaces legibles por máquina

100Excepcional
Cómo se puntúa
0/40Esquema de API (OpenAPI/GraphQL/proto) — no aplicable a este tipo de software
0/20Servidor MCP — no aplicable a este tipo de software
40/40Ejemplos ejecutables — examples
Datos de entrada utilizados
example_dirsexamples
has_mcp_signalno
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

2513estrellas de GitHub
62contribuidores
26commits en los últimos 12 meses
17días desde el último push
93versiones publicadas
1factor bus
50issues abiertas
PyPIecosistemas de paquetes

Más detalle

OpenSSF Scorecard 6.7 / 10
6.7agregado

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-07-18 13:48 UTC

10Binary-Artifactsno binaries found in the repo
n/dBranch-Protectioninternal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
9CI-Tests26 out of 27 merged PRs checked by a CI test -- score normalized to 9
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
4Code-ReviewFound 9/19 approved changesets -- score normalized to 4
10Contributorsproject has 32 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
0Maintained0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
n/dPackagingpackaging workflow not detected
8Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 8
4SASTSAST tool is not run on all commits -- score normalized to 4
10Security-Policysecurity policy file detected
n/dSigned-Releasesno releases found
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
4Vulnerabilities6 existing vulnerabilities detected
Dependencias directas 4
RegistroPaqueteRestricción de versiónManifiesto
PyPIJinja2>= 2.11.0pyproject.toml
PyPIpygments>= 2.12.0pyproject.toml
PyPIMarkupSafe>= 1.1.1pyproject.toml
PyPImarkdown2>= 2.5.4pyproject.toml
Todas las dependencias 39

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

RegistroPaqueteVersiónRelación
PyPIjinja23.1.6directa
PyPImarkdown22.5.4directa
PyPImarkupsafe3.0.3directa
PyPIpygments2.20.0directa
PyPIannotated-types0.7.0indirecta
PyPIattrs25.4.0indirecta
PyPIcachetools6.2.1indirecta
PyPIchardet5.2.0indirecta
PyPIcolorama0.4.6indirecta
PyPIcoverage7.11.0indirecta
PyPIdistlib0.4.0indirecta
PyPIexceptiongroup1.3.0indirecta
PyPIfilelock3.20.0indirecta
PyPIhypothesis6.142.4indirecta
PyPIiniconfig2.3.0indirecta
PyPImypy1.18.2indirecta
PyPImypy-extensions1.1.0indirecta
PyPIpackaging25.0indirecta
PyPIpathspec0.12.1indirecta
PyPIpdoc-pyo3-sample-library1.0.11indirecta
PyPIplatformdirs4.5.0indirecta
PyPIpluggy1.6.0indirecta
PyPIpydantic2.12.3indirecta
PyPIpydantic-core2.41.4indirecta
PyPIpyproject-api1.10.0indirecta
PyPIpytest8.4.2indirecta
PyPIpytest-cov7.0.0indirecta
PyPIpytest-timeout2.4.0indirecta
PyPIruff0.14.2indirecta
PyPIsortedcontainers2.4.0indirecta
PyPItomli2.3.0indirecta
PyPItox4.32.0indirecta
PyPItox-uv1.29.0indirecta
PyPItypes-docutils0.22.2.20251006indirecta
PyPItypes-pygments2.19.0.20250809indirecta
PyPItyping-extensions4.15.0indirecta
PyPItyping-inspection0.4.2indirecta
PyPIuv0.9.6indirecta
PyPIvirtualenv20.35.3indirecta
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.

El mensaje se conserva durante el inicio de sesión.

Registros relacionados

Repositorios inspeccionados que comparten etiquetas de catálogo o ecosistemas con mitmproxy/pdoc. Leer en paralelo →

99scalar/scalarScalar is an open-source API platform:　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　🌐 Modern REST API Client　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　📖 Beautiful API References　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　✨ 1st-Class OpenAPI/Swagger SupportExcepcional98fastapi/fastapiFastAPI framework, high performance, easy to learn, fast to code, ready for productionExcepcional99astral-sh/ruffAn extremely fast Python linter and code formatter, written in Rust.Excepcional99IBM/mcp-context-forgeAn AI Gateway, registry, and proxy that sits in front of any MCP, A2A, or REST/gRPC APIs, exposing a unified endpoint with centralized discovery, guardrails and management. Optimizes Agent & Tool calling, and supports plugins.Excepcional99litestar-org/litestarLight, flexible and extensible ASGI framework | Built to scaleExcepcional99quantumlib/CirqPython framework for creating, editing, and running Noisy Intermediate-Scale Quantum (NISQ) circuits.Excepcional

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.12.0 — metodología completa · wiki de métricas.

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