Skip to main content

A very simple python REST server

Project description

Kaa REST Server

A very simple python server framework for REST applications.

Install

pip install kaa-rest-server

Configuration - kaa.json

kaa.json: Specifies server handling.

{
  "name": "My Server",
  "version": "1.0.0",
  "server": "server.MyServer",
  "debug": false,
  "enableCors": false,
  "developmentPolling": {
    "enabled": true,
    "intervalSeconds": 1,
    "include": [".", "src", "*.py"],
    "exclude": [
      "docs",
      "tests",
      "__pycache__",
      "*.md"
    ]
  }
}

See Configuration.

Definitions (deprecated)

See Legacy Documentation

Main classes

server.py

Initializes Kaa for each http request:

from kaa import KaaServer


class MyServer(KaaServer):

    def register_resources(self):
        self.kaa.register_resources("resources", "AppResources")

resources.py

This class define your resources (or routes):

from kaa import GET, PATH, Resources, Response, Status


class AppResources(Resources):

    @GET
    @PATH("/")
    def basic_resource(self, **params):
        return Response(Status.OK).json({
            "message": "your response"
        })

Starting server

Static mode (serve): Starts Kaa server in static mode. Every code change needs restart server manually.

kaa serve

Development mode (dev): Start server that auto restarts on every code change.

kaa dev

Custom host and port

By default host is localhost and port is 5321.

You can change them adding host and port on kaa.json file:

{
  // ...
  "host": "localhost",
  "port": 5111,
  // ...
}

Or in command line:

kaa serve host:port

More

For more information, view Documentation.

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

kaa_rest_server-0.3.3.tar.gz (14.1 kB view hashes)

Uploaded Source

Built Distribution

kaa_rest_server-0.3.3-py3-none-any.whl (16.9 kB view hashes)

Uploaded Python 3

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