Skip to main content

Working with YAML format

Project description

Coverage Status CodeQL

vutils-yaml: Working with YAML Format

This package provides tools for loading data from and saving data to the YAML format. Features:

  • It annotates data while loading them from the YAML format. Every object returned by vutils.yaml.load.load_yaml has information about its origin. This is useful when reporting errors.

Limitations:

  • Due to the annotating data, this packages is not suitable for loading YAML formatted data containing thousands and hundreds of thousands items. For such amounts of data use PyYAML or other YAML parser since it is supposed that large data sets are usually machine-generated and consistent so further verification is not required.
  • When used for the first time, vutils.yaml.utils.keyloc function builds a mapping between dict keys and their locations. This can be a bottle-neck for large dictionaries.

Due to the limitations, this package is suitable for parsing human-written configurations in YAML format containing at most hundreds of items.

Installation

pip install vutils-yaml

How to Use

Topic covered in this short guide is:

  • loading annotated YAML data
  • API reference

Loading Annotated YAML Data

To load YAML data with annotations, use the load_yaml function from vutils.yaml.load. Example:

from vutils.yaml.load import load_yaml
from vutils.yaml.utils import is_null, keyloc

stream = """
---
food:
  fruit:
    - apple
    - banana
    - orange
  vegetable:
    - potato
    - tomato
    - carrot
  meat: null
"""

data = load_yaml(stream)
food = data["food"]
# `if food["meat"] is None` will not work, `null` is converted to `NullType`
# object to be annotated
if is_null(food["meat"]):
    # `keyloc` retrieves the annotated key object from `food` and return its
    # location
    print(f"{keyloc(food, 'meat')}: At least one kind of meat is required.")

Observe the testing if the value is null and the retrieving the meat key location to inform a user where the problem with his/her data is.

API Reference

Module vutils.yaml.load provide these functions:

  • load_yaml(stream) loads YAML data from stream and annotates them. stream can be str, bytes, or a file-like object supporting read.

Module vutils.yaml.utils provide these functions:

  • getloc(obj) retrieves the location of obj
  • keyloc(obj, kobj) retrieves the location of kobj, which is a key of dict-like object obj.
  • is_null(obj) tests whether obj is null.
  • is_bool(obj) tests whether obj is of the Boolean type.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vutils-yaml-0.1.4.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

vutils_yaml-0.1.4-py2.py3-none-any.whl (9.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file vutils-yaml-0.1.4.tar.gz.

File metadata

  • Download URL: vutils-yaml-0.1.4.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.3

File hashes

Hashes for vutils-yaml-0.1.4.tar.gz
Algorithm Hash digest
SHA256 268a8d87682529873c627efe3f5f44e0fc60fa12c23f53ced289fd764c44a5c8
MD5 9c7ae5627e3f57f9d9a2162a0d084729
BLAKE2b-256 9ddf2c574d916937c59df66cc5314ef467bb5763242fee1c9641c59275e389ab

See more details on using hashes here.

File details

Details for the file vutils_yaml-0.1.4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for vutils_yaml-0.1.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 39cdf59bffbc0e636c88e834ad429144fe99c5b41ff2a714b4c36926fc78f331
MD5 c52db17e5e76e55ec8d2dd26004da506
BLAKE2b-256 fcd85a40ea31cb33f407f1dd9251ad5781c13f9b408328ab1049fb555d53c10f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page