PyCQA / pydocstyle
docstring style checker
PyCQA/pydocstyle tiene un índice de salud de 19 sobre 100, lo que lo sitúa en la banda Crítico. Su puntuación más alta es Engineering Quality (84/100) y la más baja, Security (1/100). El repositorio está archivado, por lo que no cabe esperar más mantenimiento.
Í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.
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 48 se calibra a 47 en la escala publicada del índice (calibración del registro 2026-08-02).
Titularidad
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 |
|---|---|---|---|---|---|
| PyPI | pydocstyle | 6.3.0 | - | 22 | hace 1276 días |
Métricas por categoría
Vitalidad
¿Está vivo el proyecto: se escribe código y se publican versiones?
Actividad de desarrollo
Ha llegado trabajo y nadie se ha ocupado de él
El silencio por sí solo nunca es el hallazgo: una biblioteca pequeña y terminada puede no necesitar commits durante años. Esta alerta exige ambas cosas: mucho tiempo sin un commit humano y obligaciones que el proyecto visiblemente no atiende. Los commits automatizados no cuentan como mantenimiento.
Cómo se evalúa el abandonoCómo se puntúa
| 0/36 | Recencia de push — último push hace 986 días |
| 0/36 | Cadencia de commits — 0/52 semanas con commits |
| 0/18 | Volumen de commits — 0 commits en el último año |
| 0/10 | OpenSSF Scorecard: Maintained — sin datos |
Datos de entrada utilizados
| commits_last_year | 0 |
| human_commit_share | — |
| days_since_last_push | 986 |
| active_weeks_last_year | 0 |
Disciplina de publicación
Cómo se puntúa
| 27/27 | Publica versiones — 17 versiones publicadas |
| 0/36 | Recencia de las versiones — última versión hace 1276 días |
| 19.8/27 | Cadencia de publicación — una versión cada ~97,6 días |
| 0/10 | OpenSSF Scorecard: Signed-Releases — sin datos |
Datos de entrada utilizados
| releases_count | 17 |
| latest_release_tag | 6.3.0 |
| releases_from_tags | no |
| days_since_latest_release | 1276 |
| mean_days_between_releases | 97,6 |
Comunidad y Adopción
¿Tiene el proyecto usuarios, descargas, atención y unas condiciones acogedoras para quienes contribuyen?
Popularidad y adopción
Cómo se puntúa
| 49.4/60 | Estrellas — 1117 estrellas |
| 19/25 | Forks — 190 forks |
| 0/15 | Observadores — 2 observadores |
Datos de entrada utilizados
| forks | 190 |
| stars | 1117 |
| watchers | 2 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Salud de la comunidad
Cómo se puntúa
| 22.5/22.5 | README |
| 22.5/22.5 | Licencia — licencia reconocida (MIT) |
| 0/18 | Guía CONTRIBUTING |
| 0/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 | — |
| has_contributing | no |
| has_issue_template | no |
| has_code_of_conduct | no |
| readme_badge_services | — |
| has_pull_request_template | sí |
Sostenibilidad y Gobernanza
¿Sobrevivirá el proyecto a sus personas: factor bus, capacidad de respuesta, quién lo respalda y mantenimiento del paquete?
Cómo se puntúa
| 9/54 | Factor bus — la mitad de los commits recae en 1 contribuyente(s) |
| 10.9/22.5 | Distribución de commits — el principal contribuyente firma el 52% de los commits |
| 13.5/13.5 | Amplitud de contribuyentes — 85 contribuyentes |
| 0/10 | OpenSSF Scorecard: Contributors — sin datos |
Datos de entrada utilizados
| bus_factor | 1 |
| contributors_sampled | 85 |
| top_contributor_share | 0,515 |
Cómo se puntúa
| 28/42 | Resolución de issues — 67% de issues cerradas |
| 22.7/30 | Aceptación de PR — 235/310 PR decididos fusionados |
| 0/13 | Newcomer PR acceptance — ningún PR de un contribuyente primerizo decidido en 30 d |
| 0/15 | OpenSSF Scorecard: Code-Review — sin datos |
Datos de entrada utilizados
| merged_prs | 235 |
| open_issues | 113 |
| closed_issues | 225 |
| prs_merged_7d | — |
| prs_decided_7d | — |
| prs_merged_30d | — |
| prs_decided_30d | — |
| issue_closed_ratio | 0,666 |
| closed_unmerged_prs | 75 |
| first_time_authors_30d | — |
| first_time_prs_merged_30d | — |
| first_time_prs_decided_30d | — |
Propiedad y custodia
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 |
| 21.6/25 | Alcance del propietario — 1013 seguidores de PyCQA |
| 22.8/25 | Trayectoria — 29 repos públicos, cuenta de ~11 años |
Datos de entrada utilizados
| followers | 1013 |
| owner_type | Organization |
| is_verified | — |
| owner_login | PyCQA |
| public_repos | 29 |
| account_age_days | 4325 |
Mantenimiento de paquetes
Cómo se puntúa
| 25/25 | Publicado y resoluble — 1 paquete(s) en pypi |
| 4/35 | Recencia de publicación — última publicación hace 1276 días |
| 20/20 | Historial de versiones — 22 versiones en el registro |
| 20/20 | No obsoleto — activo, ni obsoleto ni retirado |
Datos de entrada utilizados
| packages | pydocstyle |
| ecosystems | pypi |
| any_deprecated | no |
| min_days_since_publish | 1276 |
Calidad de Ingeniería
¿Existen unas prácticas mínimas de ingeniería y documentación?
Prácticas de ingeniería
Cómo se puntúa
| 24/24 | Flujos de trabajo de CI — 3 flujo(s) de trabajo |
| 24/24 | Pruebas presentes |
| 16/16 | Configuración de linter — tox.ini |
| 0/9.6 | Hooks de pre-commit |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard: CI-Tests — sin datos |
Datos de entrada utilizados
| has_ci | sí |
| has_tests | sí |
| has_editorconfig | no |
| has_linter_config | sí |
| has_precommit_config | no |
Documentación
Cómo se puntúa
| 30/30 | README |
| 25/25 | Directorio de documentación |
| 15/15 | Sitio de documentación / página del proyecto — http://pydocstyle.org |
| 10/10 | Descripción del repositorio |
| 10/10 | Topics — 3 topics |
| 0/10 | Wiki |
Datos de entrada utilizados
| topics | python, linter, docstrings |
| has_wiki | no |
| homepage | http://pydocstyle.org |
| docs_site | http://pydocstyle.org |
| has_readme | sí |
| has_docs_dir | sí |
| 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?
Postura de seguridad
Cómo se puntúa
| 0/30 | Política de seguridad (SECURITY.md) |
| 0/25 | Configuración de Dependabot |
| 0/25 | Lockfiles de dependencias — biblioteca publicada — los lockfiles son cosa de las aplicaciones, no se esperan aquí |
| 0/20 | Flujo de trabajo de CodeQL |
Datos de entrada utilizados
| source | file_signals |
| lockfiles | poetry.lock |
| manifests | pyproject.toml, requirements.txt |
| has_codeql_workflow | no |
| has_security_policy | no |
| has_dependabot_config | no |
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.
Contexto y guía para agentes
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) |
| 0/40 | Historial de commits legible — sin datos |
Datos de entrada utilizados
| has_llms_txt | no |
| llms_txt_url | — |
| legible_history_share | — |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
Cómo se puntúa
| 18/18 | Arranque con un solo comando — Makefile, docs/Makefile |
| 22/22 | Pruebas automatizadas |
| 11/11 | Configuración de lint / formato — tox.ini |
| 0/11 | Verificación estática de tipos |
| 10/10 | Entorno reproducible — lockfile |
| 0/10 | Práctica demostrada con agentes — sin datos |
| 0/8 | Mantenimiento automatizado — sin datos |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — sin datos |
Datos de entrada utilizados
| has_nix | no |
| has_tests | sí |
| lockfiles | poetry.lock |
| has_dockerfile | no |
| typed_language | no |
| bootstrap_files | Makefile, docs/Makefile |
| has_devcontainer | no |
| has_linter_config | sí |
| typecheck_configs | — |
| agent_commit_share | — |
| toolchain_manifests | — |
| dependency_bot_commit_share | — |
Legibilidad del código para modelos
Cómo se puntúa
| 0/45 | Código verificable por tipos — Python sin configuración de verificación de tipos |
| 55/55 | Tamaños de archivo manejables — 0/38 archivos fuente de más de 60 KB |
Datos de entrada utilizados
| primary_language | Python |
| largest_source_bytes | 47.225 |
| source_files_sampled | 38 |
| oversized_source_files | 0 |
Datos clave
Advertencias de recopilación de datos
- OpenSSF Scorecard timed out after 240s; skipping Scorecard checks
Más detalle
Dependencias directas 3
| Registro | Paquete | Restricción de versión | Manifiesto |
|---|---|---|---|
| PyPI | snowballstemmer | >=2.2.0 | pyproject.toml |
| PyPI | tomli | >=1.2.3 | pyproject.toml |
| PyPI | importlib-metadata | >=2.0.0,<5.0.0 | pyproject.toml |
Todas las dependencias 18
Conjunto completo de dependencias resueltas según el grafo de dependencias de GitHub: 6 paquetes directos y 12 indirectos (transitivos). El cierre transitivo es completo cuando el repositorio incluye un lockfile.
| Registro | Paquete | Versión | Relación |
|---|---|---|---|
| PyPI | importlib-metadata | — | directa |
| PyPI | importlib-metadata | 4.8.3 | directa |
| PyPI | snowballstemmer | — | directa |
| PyPI | snowballstemmer | 2.2.0 | directa |
| PyPI | tomli | — | directa |
| PyPI | tomli | 1.2.3 | directa |
| PyPI | - | — | indirecta |
| PyPI | black | 22.3 | indirecta |
| PyPI | isort | 5.4.2 | indirecta |
| PyPI | jinja2 | — | indirecta |
| PyPI | mypy | 0.930 | indirecta |
| PyPI | pytest | 6.2.5 | indirecta |
| PyPI | sphinx | — | indirecta |
| PyPI | sphinx-rtd-theme | — | indirecta |
| PyPI | tox | — | indirecta |
| PyPI | types-setuptools | — | indirecta |
| PyPI | typing-extensions | 4.1.1 | indirecta |
| PyPI | zipp | 3.6.0 | indirecta |
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.11.0 — metodología completa · wiki de métricas.
Cómo se sitúa un resultado dentro del registro general: estadísticas agregadas — PyPI.