egutierrez
988e901066
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
2.2 KiB
2.2 KiB
name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
| name | kind | lang | domain | version | purity | signature | description | tags | uses_functions | uses_types | returns | returns_optional | error_type | imports | params | output | tested | tests | test_file_path | file_path | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ops_to_rdf_triples | function | py | datascience | 1.0.0 | pure | def ops_to_rdf_triples(db_path: str, namespace: str = 'http://osint.local/') -> list[tuple[str, str, str]] | Convierte entities y relations de operations.db a triples RDF (subject, predicate, object). Prefija IDs con namespace para formar URIs. Solo stdlib. |
|
false |
|
|
lista de tuplas (subject, predicate, object) en formato RDF. Subjects y objetos son URIs con namespace, predicados son literales. | false | python/functions/datascience/ops_to_rdf_triples.py |
Ejemplo
from datascience.ops_to_rdf_triples import ops_to_rdf_triples
triples = ops_to_rdf_triples("apps/my_analysis/operations.db")
for s, p, o in triples[:5]:
print(f"{s} -- {p} --> {o}")
# Con namespace personalizado
triples_ns = ops_to_rdf_triples(
"apps/my_analysis/operations.db",
namespace="http://mi-empresa.com/osint/"
)
Notas
Funcion pura — solo abre la DB en lectura, no escribe nada.
Triples generados por entidad:
(ns+id, rdf:type, type_ref)— si type_ref no es None(ns+id, name, literal)— si name no es None(ns+id, status, literal)— si status no es None(ns+id, domain, literal)— si domain no es None(ns+id, key, str(value))— por cada clave en el JSON de metadata
Triples generados por relacion:
(ns+from_entity, relation_name, ns+to_entity)
Los subjects de relaciones tipo URI reciben el prefijo de namespace. Los predicados literales (name, status, etc.) no llevan prefijo. Esta separacion sigue la convencion RDF de distinguir recursos de literales sin introducir dependencias externas (rdflib u otras).
Para exportar a Turtle (.ttl) o N-Triples, el notebook puede iterar la lista y formatear segun necesite.