STatic ANalyzer (stan)

Analizador de código estático

Note

En la siguiente sintaxis,

<_> significa que un campo es obligatorio

[_] siginifca que un campo es opcional

Sintaxis de datasets

Depende de argendata_datasets

Obtención de datasets

Datasets.<CODIGO>.get(version=<VERSION>)
Datasets.<CODIGO>.get(version=<VERSION>, to=<path>)

Donde:

• CODIGO es el codigo de la fuente (alfanumérico y guiones bajos)
• VERSION es latest o un hash de la forma <metodo>:<hexdigest>. Por ejemplo sha1:86f7e437faa5a7fce15d1ddcb9eaeaea377667b8

Declaración de output de datasets

<var> = Datasets.<CODIGO>.register(filename=<path>[, **extra])
...
<var>.save([*])

Donde:

• var es algún nombre de variable válido
• **extra son keyword-arguments opcionales.

Por ejemplo: x = Datasets.MI_CODIGO.register(filename='output.csv', url='example.com', foo='bar')

• * es cualquier expresión válida.

Por ejemplo: x.save(df.write_csv('output.csv')

Sintaxis de flags

Una parte del analizador estático soporta el parsing de flags en el código.

Descrito en argendata_stan.common.flags

Flags soportadas

Note

DEPENDENCIA puede ser un nombre, opcionalmente precedido por los operadores unitarios + o -

flag	sintaxis	descripcion	source
Dependencia pip	#' <DEPENDENCIA>[, <DEPENDENCIA>]	Importa dependencias desde pypi.org	argendata_stan.static_analyzer.dependencies.dependencies
Dependencia externa	#@ git+<metodo>://<URI>	Importa una dependencia de una URI externa.	argendata_stan.static_analyzer.dependencies.github

Ejemplo minimal

import dotenv #' python-dotenv
import polars # +pyarrow, +fastexcel
import my_package #@ git+https://github.com/octocat/mylib

En este ejemplo, se importan los modulos:

• dotenv del paquete en pypi.org/project/python-dotenv
• polars desde pypi.org/project/polars, junto con fastexcel y pyarrow - también desde PyPi.
• my_package desde el repositorio (ficticio) en GitHub octocat/mylib

Flags experimentales

Warning

Estas flags existen, pero su comportamiento no está completamente soportado

flag	sintaxis	descripcion	source
Entorno	#^ <path>	Usa el entorno especificado	argendata_stan.static_analyzer.dependencies.dependencies
Configuración in-file	#% <flag>[, <flag>]	Sobreescribe las flags del analizador estático	argendata_stan.common.config_flags