chisel

Chisel is a lightweight Python WSGI application framework built for creating well-documented, schema-validated JSON web APIs.

JSON APIs

Chisel provides the action decorator for easily implementing schema-validated JSON APIs.

import chisel

@chisel.action(spec='''
# Sum a list of numbers
action sum_numbers
    urls
        GET

    query
        # The list of numbers
        float[len > 0] numbers

    output
        # The sum of the numbers
        float sum
''')
def sum_numbers(ctx, req):
    return {'sum': sum(req['numbers'])}

application = chisel.Application()
application.add_request(sum_numbers)
application.request('GET', '/sum_numbers', query_string='numbers.0=1&numbers.1=2&numbers.2=4')

('200 OK', [('Content-Type', 'application/json')], b'{"sum":7.0}')

Each action defines an action definition using Schema Markdown. The action callback is passed two arguments, a request Context and the schema-validated request input dictionary. The input request dictionary is created by combining the request's URL path parameters, query string parameters, and input JSON content parameters.

If there is a schema validation error the appropriate error code is automatically returned.

status, _, content_bytes = application.request('GET', '/sum_numbers')

'400 Bad Request'
b'{"error":"InvalidInput","message":"Required member \\"numbers\\" missing (query string)"}'

A chisel.Application is a standard WSGI application object - host it with any WSGI server. For example:

gunicorn module:application

API Documentation

You can add API documentation to your application by adding the Chisel documentation application requests from create_doc_requests.

application = chisel.Application()
application.add_requests(chisel.create_doc_requests())

By default the documentation application is hosted at "/doc/". An example of Chisel's documentation output is available.

Development

This package is developed using python-build. It was started using python-template as follows:

template-specialize python-template/template/ chisel/ -k package chisel -k name 'Craig A. Hobbs' -k email 'craigahobbs@gmail.com' -k github 'craigahobbs' -k nomain 1

Metadata

Release files for chisel 2.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chisel 2.5.1
File	Size	Uploaded	Provenance
chisel-2.5.1.tar.gz	289.3 kB	Oct 9, 2026	Without provenance	Details

Release files / chisel-2.5.1.tar.gz

Download URL	chisel-2.5.1.tar.gz
Size	289.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`cd62bd090dc3e2ee4de82e50033ae5112c6103e675689db583393bfd8105c0c4`
BLAKE2b-256 checksum How to use checksums	`d2c8fe0dad694619d817bfc8df55c2f8a67309d77fd173690c052498b9d1e9a3`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.8`

Security for chisel 2.5.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.