Skip to main content

cvgruplac-json

CI PyPI Python

Une los JSON de cvlac-json (el CvLAC de una persona) y de gruplac-json (el GrupLAC de un grupo) de Minciencias: cada producto de los dos recibe un id y una lista scrapping_ids con sus ids en una y otra fuente, así que un producto del grupo apunta al mismo producto en el CV de cada integrante que lo firmó, y al revés.

No descarga nada ni llama a ninguna API: lee los JSON que ya escribieron los dos paquetes y escribe copias unidas, sin tocar los originales. Solo usa la biblioteca estándar.

Instalación

pip install cvgruplac-json

Uso

cvgruplac-json --cvlac cvlac/ --gruplac gruplac/ --out unidos/
cvgruplac-json --cvlac cvlac_udea/ cvlac_colombia/json/ --gruplac gruplac/json/ --out unidos/ --workers 4
cvgruplac-json --gruplac gruplac_COL0008423.json --cvlac cvlac_0000707619.json --out unidos/
cvgruplac-json --gruplac gruplac/ --out unidos/        # sin CvLAC: ids de CvLAC sin verificar
  • --cvlac y --gruplac reciben archivos o carpetas (cvlac_*.json[.gz], gruplac_*.json[.gz]). Si un COD_RH o un grupo está en más de una entrada, gana la primera.
  • Escribe unidos/gruplac/ y unidos/cvlac/ con el mismo nombre y compresión de cada entrada, y unidos/cvgruplac_summary.json con los conteos y los archivos que no pudo leer. --only gruplac escribe solo los GrupLAC.
  • Hace tres pasadas: lee los hashes de los CvLAC, une los GrupLAC y luego los CvLAC.

En Python:

from cvgruplac_json import link, link_gruplac, link_cvlac, id_hash

index = link(gruplacs, cvlacs)  # listas de dicts de gruplac-json y cvlac-json, unidos en su lugar

Los identificadores

Cada producto (obras, proyectos, eventos, patentes y cada ítem de other_products) empieza con dos claves:

"id": "efc8d0bb2fa50a617767aa814a57a7a40c1c956f",
"scrapping_ids": [
  {"id": "efc8d0bb2fa50a617767aa814a57a7a40c1c956f", "source": "cvlac"},
  {"id": "efc8d0bb2fa50a617767aa814a57a7a40c1c956f", "source": "gruplac"}
]

En un GrupLAC

  • source: "cvlac": una por integrante autor con product_hash, en el orden de los autores. Es el id del producto en el CvLAC de ese integrante (el product_hash que cvlac-json pone en la entrada del dueño). Si el CvLAC del integrante está entre las entradas, se pone solo si el producto está en él; si no está, se pone con "verified": false. No hay ninguna en las secciones que solo tiene el GrupLAC (data/sections.json), ni en proyectos y eventos, que el GrupLAC lista sin autores.
  • source: "gruplac", siempre la última: el primer id de CvLAC si lo hay, así que un producto que está en los dos tiene el mismo id. Si no, el SHA-1 de título|código COL|tipo|año (abajo).
  • id es el de source: "gruplac".

En un CvLAC

  • source: "cvlac": el product_hash del dueño. Los productos sin él (los eventos) usan el SHA-1 de título|COD_RH|event|año.
  • source: "gruplac", con group (código COL): una por cada producto de un GrupLAC que lo lista como id de CvLAC verificado. Un artículo del CV que está en dos grupos tiene dos.
  • id es el de source: "cvlac" y reemplaza el id por posición de cvlac-json (cvlac:COD_RH:n).

El hash. id_hash(título, dueño, tipo, año, n) es la receta del product_hash con el dueño que corresponda: el SHA-1 de

<título>|<dueño>|<tipo>|<año>
  • título en minúsculas, sin tildes y solo con letras y dígitos; un ítem sin título usa su nombre (eventos) o su texto;
  • dueño: el código COL del grupo (el número GrupLAC de 14 dígitos si no tiene), o el COD_RH con 10 dígitos (con un COD_RH y los tipos work, project, patent y other da exactamente el product_hash);
  • tipo: work, project, event, patent u other;
  • año: year_published, year, el año de start o el de date.

Si varios productos del mismo JSON dan la misma clave, el n-ésimo, en el orden de la página, lleva |n al final; y un candidato ya usado en ese JSON pasa al siguiente n. Por eso id es único dentro de cada GrupLAC y de cada CvLAC. Ejemplo de clave de un evento: juevesdelaciencia|COL0008423|event|2023.

product_hash.py es una copia sin cambios del de cvlac-json y gruplac-json; tests/product_hash_vectors.json fija su resultado en los tres paquetes.

Desarrollo

python -m pip install -e ".[dev]"
python -m pytest
ruff check . && ruff format --check .

Las versiones se publican en PyPI desde GitHub Actions al subir una etiqueta v*; ver PUBLISHING.md y CHANGELOG.md.

Metadata

Release files for cvgruplac-json 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cvgruplac-json 0.1.0
File Size Uploaded Provenance Actions
cvgruplac_json-0.1.0.tar.gz 16.7 kB With provenance Details for cvgruplac_json-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cvgruplac-json 0.1.0
File Interpreter ABI Platform Actions
cvgruplac_json-0.1.0-py3-none-any.whl Python 3 none any Details for cvgruplac_json-0.1.0-py3-none-any.whl

Total release size: 31.3 kB

Release files / cvgruplac_json-0.1.0.tar.gz

Download URL cvgruplac_json-0.1.0.tar.gz
Size 16.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0c9dca014ec0c63494affec99544dbcb444f940cf6ad89dbe22d8903c4b597d8
BLAKE2b-256 checksum
How to use checksums
15674d918d3cd7e9e2fa4313049e641274859d57958e5452a85e3883c07cdf3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / cvgruplac_json-0.1.0-py3-none-any.whl

Download URL cvgruplac_json-0.1.0-py3-none-any.whl
Size 14.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
56b73311d09beee18be9f7bacc573b3a764aae686360e60d0a5e5003ccfe14b2
BLAKE2b-256 checksum
How to use checksums
b587bb13e63d5c0a9c1bf6aea2155159074ef2770b6b2c2f76bbb04c47c83907
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for cvgruplac-json 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cvgruplac_json-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page