# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-voluptuous
VERSION=		0.15.2
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		Python data validation library (3.12)
SDESC[v13]=		Python data validation library (3.13)
HOMEPAGE=		https://github.com/alecthomas/voluptuous
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/db/a8/8f9cc6749331186e6a513bfe3745454f81d25f6e34c6024f88f80c71ed28
DISTFILE[1]=		voluptuous-0.15.2-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		voluptuous-0.15.2.dist-info

GENERATED=		yes

[PY312].USES_ON=			python:v12,wheel

[PY313].USES_ON=			python:v13,wheel

[FILE:2653:descriptions/desc.single]

# CONTRIBUTIONS ONLY

**What does this mean?** I do not have time to fix issues myself. The only
way fixes or new features will be added is by people submitting PRs.

**Current status:** Voluptuous is largely feature stable. There hasn't been
a need to add new features in a while, but there are some bugs that should
be fixed.

**Why?** I no longer use Voluptuous personally (in fact I no longer
regularly write Python code). Rather than leave the project in a limbo of
people filing issues and wondering why they're not being worked on, I
believe this notice will more clearly set expectations.

# Voluptuous is a Python data validation library

[image]
[image]
[image]
[Test status]
[Coverage status]
[Gitter chat]

Voluptuous, *despite* the name, is a Python data validation library. It
is primarily intended for validating data coming into Python as JSON,
YAML, etc.

It has three goals:

1. Simplicity.
2. Support for complex data structures.
3. Provide useful error messages.

## Contact

Voluptuous now has a mailing list! Send a mail to
[<voluptuous@librelist.com>] to subscribe. Instructions
will follow.

You can also contact me directly via [email] or
[Twitter].

To file a bug, create a [new issue] on GitHub with a short example of how
to replicate the issue.

## Documentation

The documentation is provided [here].

## Contribution to Documentation

Documentation is built using `Sphinx`. You can install it by

    pip install -r requirements.txt

For building `sphinx-apidoc` from scratch you need to set PYTHONPATH to
`voluptuous/voluptuous` repository.

The documentation is provided [here.]

## Changelog

See [CHANGELOG.md].

## Why use Voluptuous over another validation library?

**Validators are simple callables:**
No need to subclass anything, just use a function.

**Errors are simple exceptions:**
A validator can just `raise Invalid(msg)` and expect the user to get
useful messages.

**Schemas are basic Python data structures:**
Should your data be a dictionary of integer keys to strings?
`{int: str}` does what you expect. List of integers, floats or
strings? `[int, float, str]`.

**Designed from the ground up for validating more than just forms:**
Nested data structures are treated in the same way as any other
type. Need a list of dictionaries? `[{}]`

**Consistency:**
Types in the schema are checked as types. Values are compared as
values. Callables are called to validate. Simple.

## Show me an example

Twitter's [user search API] accepts
query URLs like:

```bash
$ curl
'https://api.twitter.com/1.1/users/search.json?q=python&per_page=20&page=1'
```

To validate this we might use a schema like:

```pycon


[FILE:124:distinfo]
016348bc7788a9af9520b1764ebd4de0df41fe2138ebe9e06fa036bf86a65566        31349 python-src/voluptuous-0.15.2-py3-none-any.whl