Registro público
Informe de salud del softwareesquema 0.34.0 · métricas 2.10.0 · 2026-09-16 10:09 UTC

samuelcolvin / watchfiles

Simple, modern and fast file watching and code reload for Python, written in Rust

Python · RustMIT★ 2533 estrellas⑂ 146 forksdesde oct 2017Ver en GitHub ↗
TipoBibliotecaHerramienta de línea de comandosAplicación de escritoriocómo se determina

samuelcolvin/watchfiles tiene un índice de salud de 78 sobre 100, lo que lo sitúa en la banda Bueno. Su puntuación más alta es Engineering Quality (84/100) y la más baja, Security (56/100). Se actualizó por última vez hace 12 días. Una sola persona concentra la mayor parte del trabajo reciente.

78
global / 100
Bueno

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

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

Titularidad

Samuel ColvinCuenta personal
6653 seguidores311 repositorios públicosdesde abr 2013@pydantic

Este repositorio pertenece a una cuenta personal. Un proyecto con un único propietario conlleva más riesgo de continuidad que uno respaldado por una organización.

Ecosistemas de paquetes

RegistroPaqueteVersiónDescargas / mesVersionesÚltima publicación
PyPIwatchfiles1.2.0311.935.08929hace 121 días

Métricas por categoría

Vitalidad

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

57Moderado · 21% del índice global
Cómo se puntúa
28.8/36Recencia de push — último push hace 12 días
2.8/36Cadencia de commits — 4/52 semanas con commits
9.4/18Volumen de commits — 10 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_year10
human_commit_share0,88
days_since_last_push12
active_weeks_last_year4
Cómo se puntúa
27/27Publica versiones — 43 versiones publicadas
27/36Recencia de las versiones — última versión hace 121 días
19.8/27Cadencia de publicación — una versión cada ~69,7 días
0/10OpenSSF Scorecard: Signed-Releases — sin datos
Datos de entrada utilizados
releases_count43
latest_release_tagv1.2.0
releases_from_tagsno
days_since_latest_release121
mean_days_between_releases69,7
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?

74Bueno · 17% del índice global
Cómo se puntúa
55.2/60Estrellas — 2533 estrellas
18/25Forks — 146 forks
6.4/15Observadores — 15 observadores
Datos de entrada utilizados
forks146
stars2533
watchers15
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Cómo se puntúa
22.5/22.5README
22.5/22.5Licencia — licencia reconocida (MIT)
0/18Guía CONTRIBUTING
0/13.5Código de conducta
0/7.2Plantilla de issues
0/6.3Plantilla de PR
Datos de entrada utilizados
has_readmesí
has_licensesí
readme_badges5
has_contributingno
has_issue_templateno
has_code_of_conductno
readme_badge_servicescodecov.io, github.com, shields.io
has_pull_request_templateno
Cómo se puntúa
80/80Descargas mensuales — 311.935.089 descargas/mes en pypi
0/20Dependientes en el registro — no lo informa este ecosistema
Datos de entrada utilizados
packageswatchfiles
dependents—
ecosystemspypi
total_downloads—
monthly_downloads311.935.089
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?

66Bueno · 23% del índice global
Cómo se puntúa
9/54Factor bus — la mitad de los commits recae en 1 contribuyente(s)
7.4/22.5Distribución de commits — el principal contribuyente firma el 67% de los commits
13.5/13.5Amplitud de contribuyentes — 52 contribuyentes
10/10OpenSSF Scorecard: Contributors — project has 18 contributing companies or organizations
Datos de entrada utilizados
bus_factor1
contributors_sampled52
top_contributor_share0,67
Cómo se puntúa
31.4/42Resolución de issues — 75% de issues cerradas
23.7/30Aceptación de PR — 172/218 PR decididos fusionados
0/13Newcomer PR acceptance — 0/1 PR de contribuyentes primerizos fusionados en 30 d
4.5/15OpenSSF Scorecard: Code-Review — Found 9/26 approved changesets -- score normalized to 3
Datos de entrada utilizados
merged_prs172
open_issues41
closed_issues121
prs_merged_7d0
prs_decided_7d0
prs_merged_30d0
prs_decided_30d1
issue_closed_ratio0,747
closed_unmerged_prs46
first_time_authors_30d1
first_time_prs_merged_30d0
first_time_prs_decided_30d1
Cómo se puntúa
10/30Respaldo de la propiedad — cuenta personal (usuario)
0/20Dominio verificado — no aplicable a cuentas de usuario
25/25Alcance del propietario — 6653 seguidores de samuelcolvin
25/25Trayectoria — 311 repos públicos, cuenta de ~13 años
Datos de entrada utilizados
followers6653
owner_typeUser
is_verified—
owner_loginsamuelcolvin
public_repos311
account_age_days4914
Excluidos de la puntuación (sin datos o no aplicable): Dominio verificado. Los pesos restantes se han renormalizado.
Cómo se puntúa
25/25Publicado y resoluble — 1 paquete(s) en pypi
35/35Recencia de publicación — última publicación hace 121 días
20/20Historial de versiones — 29 versiones en el registro
20/20No obsoleto — activo, ni obsoleto ni retirado
Datos de entrada utilizados
packageswatchfiles
ecosystemspypi
any_deprecatedno
min_days_since_publish121

Calidad de Ingeniería

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

84Excelente · 19% del índice global
Cómo se puntúa
24/24Flujos de trabajo de CI — 2 flujo(s) de trabajo
24/24Pruebas presentes
16/16Configuración de linter — .rustfmt.toml, pyproject.toml ([tool.ruff])
9.6/9.6Hooks de pre-commit
0/6.4.editorconfig
6/20OpenSSF Scorecard: CI-Tests — 10 out of 26 merged PRs checked by a CI test -- score normalized to 3
Datos de entrada utilizados
has_cisí
has_testssí
has_editorconfigno
has_linter_configsí
has_precommit_configsí

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://watchfiles.helpmanual.io
10/10Descripción del repositorio
10/10Topics — 8 topics
0/10Wiki
Datos de entrada utilizados
topicspython, asyncio, filesystem, notify, inotify, inotifywatch, uvicorn, rust
has_wikino
homepagehttps://watchfiles.helpmanual.io
docs_sitehttps://watchfiles.helpmanual.io
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?

56Moderado · 16% del índice global
Cómo se puntúa
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — sin datos
0.8/2.5CI-Tests — 10 out of 26 merged PRs checked by a CI test -- score normalized to 3
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
2.2/7.5Code-Review — Found 9/26 approved changesets -- score normalized to 3
2.5/2.5Contributors — project has 18 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
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — sin datos
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
5.2/7.5Vulnerabilities — 3 existing vulnerabilities detected
Datos de entrada utilizados
sourceopenssf_scorecard
checks_evaluated15
scorecard_versionv5.5.0
checks_inconclusive3
scorecard_aggregate4,5
Excluidos de la puntuación (sin datos o no aplicable): Branch-Protection, Packaging, Signed-Releases. Los pesos restantes se han renormalizado.
Cómo se puntúa
35/35Dependencias directas libres de avisos conocidos — ninguna dependencia directa tiene un aviso conocido
25/25Dependencias indirectas libres de avisos conocidos — ninguna dependencia indirecta tiene un aviso conocido
0/40Sin avisos pendientes — ningún aviso tiene fecha de publicación
Datos de entrada utilizados
sourceosv
advisories0
affected_packages0
assessed_packages3
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
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:watchfiles@1.2.0 —lo que arrastra la instalación del paquete publicado—: 3 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.

67Bueno · 4% del índice global
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)
40/40Historial de commits legible — 74 de 88 commits humanos declaran su intención (asunto estructurado o cuerpo explicativo)
Datos de entrada utilizados
has_llms_txtno
llms_txt_url—
legible_history_share0,841
agent_instruction_files—
agent_instruction_max_bytes—
Cómo se puntúa
18/18Arranque con un solo comando — Makefile
22/22Pruebas automatizadas
11/11Configuración de lint / formato — .rustfmt.toml, pyproject.toml ([tool.ruff])
11/11Verificación estática de tipos — watchfiles/py.typed
10/10Entorno reproducible — lockfile
2/10Práctica demostrada con agentes — 1 de los últimos 100 commits con autoría o crédito de agente
8/8Mantenimiento automatizado — 12 de los últimos 100 commits son actualizaciones automáticas de dependencias
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Datos de entrada utilizados
has_nixno
has_testssí
lockfilesCargo.lock, uv.lock
has_dockerfileno
typed_languageno
bootstrap_filesMakefile
has_devcontainerno
has_linter_configsí
typecheck_configswatchfiles/py.typed
agent_commit_share0,01
toolchain_manifestsCargo.toml
dependency_bot_commit_share0,12
Cómo se puntúa
27/45Código verificable por tipos — Python con configuración de verificación de tipos (watchfiles/py.typed)
55/55Tamaños de archivo manejables — 0/18 archivos fuente de más de 60 KB
Datos de entrada utilizados
primary_languagePython
largest_source_bytes15.244
source_files_sampled18
oversized_source_files0

Datos clave

2533estrellas de GitHub
52contribuidores
10commits en los últimos 12 meses
12días desde el último push
43versiones publicadas
1factor bus
41issues abiertas
crates.io, 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 crates package 'watchfiles_rust_notify' from its registry

Más detalle

Historial de estrellas y forks 0 ★ / 146 ⇿
0Estrellas
146Forks
40Versiones

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.

025507510012515014332018-012022-052026-08
Mayor 1Menor 12Parche 12

Cada punto abarca 8 días.

OpenSSF Scorecard 4.5 / 10
4.5agregado

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-09-16 10:09 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
3CI-Tests10 out of 26 merged PRs checked by a CI test -- score normalized to 3
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
3Code-ReviewFound 9/26 approved changesets -- score normalized to 3
10Contributorsproject has 18 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
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
n/dSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
7Vulnerabilities3 existing vulnerabilities detected
Dependencias directas 4
RegistroPaqueteRestricción de versiónManifiesto
crates.iocrossbeam-channel0.5.15Cargo.toml
crates.ionotify8.0.0Cargo.toml
crates.iopyo30.29.0Cargo.toml
PyPIanyio>=3.0.0pyproject.toml
Todas las dependencias 111

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

RegistroPaqueteVersiónRelación
crates.iocrossbeam-channel0.5.15directa
crates.ionotify8.0.0directa
crates.iopyo30.29.0directa
PyPIanyio4.13.0directa
crates.iobitflags1.3.2indirecta
crates.iobitflags2.7.0indirecta
crates.iocfg-if1.0.0indirecta
crates.iocrossbeam-utils0.8.19indirecta
crates.iofiletime0.2.24indirecta
crates.iofsevent-sys4.1.0indirecta
crates.ioheck0.5.0indirecta
crates.ioinotify0.11.0indirecta
crates.ioinotify-sys0.1.5indirecta
crates.iokqueue1.0.8indirecta
crates.iokqueue-sys1.0.4indirecta
crates.iolibc0.2.169indirecta
crates.iolibredox0.1.3indirecta
crates.iolog0.4.22indirecta
crates.iomio1.0.3indirecta
crates.ionotify-types2.0.0indirecta
crates.ioonce_cell1.21.3indirecta
crates.ioportable-atomic1.6.0indirecta
crates.ioproc-macro21.0.81indirecta
crates.iopyo3-build-config0.29.0indirecta
crates.iopyo3-ffi0.29.0indirecta
crates.iopyo3-macros0.29.0indirecta
crates.iopyo3-macros-backend0.29.0indirecta
crates.ioquote1.0.45indirecta
crates.ioredox_syscall0.5.3indirecta
crates.iosame-file1.0.6indirecta
crates.iosyn2.0.60indirecta
crates.iotarget-lexicon0.13.5indirecta
crates.iounicode-ident1.0.12indirecta
crates.iowalkdir2.5.0indirecta
crates.iowasi0.11.0+wasi-snapshot-preview1indirecta
crates.iowinapi-util0.1.9indirecta
crates.iowindows-sys0.52.0indirecta
crates.iowindows-sys0.59.0indirecta
crates.iowindows-targets0.52.6indirecta
crates.iowindows_aarch64_gnullvm0.52.6indirecta
crates.iowindows_aarch64_msvc0.52.6indirecta
crates.iowindows_i686_gnu0.52.6indirecta
crates.iowindows_i686_gnullvm0.52.6indirecta
crates.iowindows_i686_msvc0.52.6indirecta
crates.iowindows_x86_64_gnu0.52.6indirecta
crates.iowindows_x86_64_gnullvm0.52.6indirecta
crates.iowindows_x86_64_msvc0.52.6indirecta
PyPIast-serialize0.5.0indirecta
PyPIattrs26.1.0indirecta
PyPIbabel2.18.0indirecta
PyPIbackrefs7.0indirecta
PyPIcertifi2026.4.22indirecta
PyPIcffi2.0.0indirecta
PyPIcharset-normalizer3.4.7indirecta
PyPIclick8.4.0indirecta
PyPIcolorama0.4.6indirecta
PyPIcoverage7.14.0indirecta
PyPIcyclic1.0.0indirecta
PyPIdirty-equals0.11indirecta
PyPIexceptiongroup1.3.1indirecta
PyPIghp-import2.1.0indirecta
PyPIgriffelib2.0.2indirecta
PyPIidna3.15indirecta
PyPIiniconfig2.3.0indirecta
PyPIjinja23.1.6indirecta
PyPIlibrt0.11.0indirecta
PyPImarkdown3.10.2indirecta
PyPImarkdown-it-py4.2.0indirecta
PyPImarkupsafe3.0.3indirecta
PyPImaturin1.13.3indirecta
PyPImdurl0.1.2indirecta
PyPImdx-include1.4.2indirecta
PyPImergedeep1.3.4indirecta
PyPImkdocs1.6.1indirecta
PyPImkdocs-autorefs1.4.4indirecta
PyPImkdocs-get-deps0.2.2indirecta
PyPImkdocs-material9.7.6indirecta
PyPImkdocs-material-extensions1.3.1indirecta
PyPImkdocstrings—indirecta
PyPImkdocstrings1.0.4indirecta
PyPImkdocstrings-python2.0.3indirecta
PyPImypy2.1.0indirecta
PyPImypy-extensions1.1.0indirecta
PyPIoutcome1.3.0.post0indirecta
PyPIpackaging26.2indirecta
PyPIpaginate0.5.7indirecta
PyPIpathspec1.1.1indirecta
PyPIplatformdirs4.9.6indirecta
PyPIpluggy1.6.0indirecta
PyPIpycparser3.0indirecta
PyPIpygments2.20.0indirecta
PyPIpymdown-extensions10.21.3indirecta
PyPIpytest9.0.3indirecta
PyPIpytest-mock3.15.1indirecta
PyPIpytest-pretty1.3.0indirecta
PyPIpytest-timeout2.4.0indirecta
PyPIpython-dateutil2.9.0.post0indirecta
PyPIpyyaml6.0.3indirecta
PyPIpyyaml-env-tag1.1indirecta
PyPIrcslice1.1.0indirecta
PyPIrequests2.34.2indirecta
PyPIrich15.0.0indirecta
PyPIruff0.15.13indirecta
PyPIsix1.17.0indirecta
PyPIsniffio1.3.1indirecta
PyPIsortedcontainers2.4.0indirecta
PyPItomli2.4.1indirecta
PyPItrio0.33.0indirecta
PyPItyping-extensions4.15.0indirecta
PyPIurllib32.7.0indirecta
PyPIwatchdog6.0.0indirecta
Avisos de dependencias 0

Instalar pypi:watchfiles@1.2.0 arrastra 3 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.

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

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

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