WSME

What it is and what it does

WSME is a REST API framework that removes boilerplate by letting you define web service methods with Python type annotations instead of manually parsing requests and serializing responses. You decorate functions with `@expose()` to declare parameter and return types, then WSME automatically handles protocol conversion, validation, and documentation. It works standalone as a WSGI application or integrates into existing frameworks like Flask or Pecan, supporting multiple protocols (REST+JSON, REST+XML) and generating Sphinx documentation from your type definitions.

The package is lightweight—just four runtime dependencies—and framework-agnostic, so you can use it with your preferred routing layer while delegating type handling and serialization to WSME. It's particularly useful when you want clean, self-documenting APIs without writing separate request/response parsing code.

Use it for

• Build a REST API with automatic JSON and XML endpoint variants from a single typed method definition.
• Generate Sphinx documentation for your REST API directly from your WSME type annotations and docstrings.
• Add type validation and multi-protocol support to an existing WSGI or Flask application without rewriting routing.
• Create a microservice that exposes the same business logic over REST+JSON and REST+XML simultaneously.
• Prototype a REST API quickly by focusing on business logic while WSME handles serialization and validation.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

wsme on PyPI

Before you install

Low install friction: pure Python wheel with only four runtime dependencies (WebOb, simplegeneric, netaddr, importlib_metadata). Actively maintained as of 32 days ago and marked active.

Requires Python 3.8 or later; designed for WSGI-compatible web frameworks.

License in practice

MIT license (permissive) — you can use, modify, and distribute WSME freely in commercial and private projects with minimal restrictions.

Quickstart

pip install WSME

from wsme import WSRoot, expose

class MyService(WSRoot):
    @expose(unicode, unicode)
    def hello(self, who=u'World'):
        return u"Hello {0} !".format(who)

ws = MyService(protocols=['restjson', 'restxml'])
application = ws.wsgiapp()

Package facts

Evidence: wsme-0.13.0-py3-none-any.whl

Tags

More Python Modules packages

See also Flask · microversion-parse · oslo.versionedobjects · asyauth · oslo.service · spyne · oslo.middleware · pyramid · msrest · WTForms-Components