pstructutils 1.0

Library for working with structured data

Structutils

Structutils is a Python library for working with structured data.

It supports Python 3.14 and later.

Installation

Structutils is available on PyPI under the name pstructutils.

Types

Inferring a type form from a value

import structutils

structutils.infer_type([1, 2, 3]) # => list[int]

Formatting a type form

import structutils

structutils.format_type(list[int]) # => 'list[int]'

Configuration

Creating and validating a schema

import structutils

@dataclass
class User:
  age: int
  name: str

type Users = list[User]

try:
  structutils.check(Users)
except structutils.SchemaError as e:
  print(f"Invalid schema: {e}")

Generating a JSON schema from a schema

import structutils

with Path('schema.json').open('w') as file:
  json.dump(structutils.generate(Users), file)

Instantiating data using a schema

import structutils

with Path('data.json').open() as file:
  raw_data = json.load(file)

try:
  data = structutils.instantiate(Users, raw_data)
except structutils.InstantiationError as e:
  print(f"Invalid data: {e}")

Miscellaneous

Loading an object from a string specifier

import structutils

pathlib = structutils.load('pathlib', allow_modules=True)
Iterable = structutils.load('collections.abc:Iterable')