Índices das LIBS

O arquivo de índices das LIBS (geralmente indices.csv, com nome definido pelo registro FA do dadger) associa cada identificador de card das LIBS ao arquivo que contém os seus registros. Suas informações são armazenadas na classe:

class Indices(data: Any = Ellipsis)[código-fonte]

Armazena os dados do arquivo de índices das LIBS (indices.csv, nome definido pelo registro FA do dadger), que associa cada identificador de card das LIBS ao arquivo que contém os seus registros.

Regras de leitura e escrita:

  • toda linha que contém ; e não começa com & (após os espaços iniciais) é um registro RegistroIndice, no formato IDENTIFICADOR;DESCRICAO;ARQUIVO;

  • as linhas iniciadas por & são comentários, mesmo quando contêm ;, e são reescritas sem alterações;

  • os espaços em torno dos valores são removidos e os identificadores não são convertidos para maiúsculas;

  • um campo vazio é lido como "", e um campo que falta no fim da linha, como None;

  • identificadores repetidos são mantidos como registros separados, na ordem do arquivo, sem gerar erro;

  • na escrita, os registros são reescritos como IDENTIFICADOR;DESCRICAO;ARQUIVO.

indices(identificador: str | None = None, arquivo: str | None = None, *, df: Literal[True]) → DataFrame[código-fonte]
indices(identificador: str | None = None, arquivo: str | None = None, df: Literal[False] = False) → RegistroIndice | list[RegistroIndice] | None
indices(identificador: str | None = None, arquivo: str | None = None, df: bool = False) → RegistroIndice | list[RegistroIndice] | DataFrame | None

Obtém registros que associam os identificadores dos cards das LIBS aos arquivos que contêm os seus registros. Opcionalmente, o retorno pode ser transformado em um DataFrame, com as colunas arquivo, descricao e identificador.

Parâmetros:
  • identificador (str | None) – o identificador do card das LIBS

  • arquivo (str | None) – o arquivo que contém os registros do card

  • df (bool) – ignorar os filtros e retornar todos os dados de registros como um DataFrame

Retorna:

Os registros, se existirem.

Tipo de retorno:

RegistroIndice | list[RegistroIndice] | pd.DataFrame | None

Cada linha do arquivo é armazenada no modelo:

class RegistroIndice(previous: Any | None = None, next: Any | None = None, data: Any | None = None)[código-fonte]

Registro do arquivo de índices das LIBS, que associa o identificador de um card das LIBS ao arquivo que contém os seus registros, no formato IDENTIFICADOR;DESCRICAO;ARQUIVO.

O registro não possui um identificador fixo: o primeiro campo da linha é o próprio identificador do card indexado.

property arquivo: str | None

O arquivo que contém os registros do card das LIBS.

Retorna:

O nome do arquivo

Tipo de retorno:

str | None

property descricao: str | None

A descrição do card das LIBS.

Retorna:

A descrição

Tipo de retorno:

str | None

property identificador: str | None

O identificador do card das LIBS.

Retorna:

O identificador

Tipo de retorno:

str | None

classmethod matches(line: str | bytes, storage: str | StorageType = '') → bool[código-fonte]

Casa as linhas que contêm ; e que não são comentários, isto é, que não começam com & após os espaços iniciais.