Skip to main content

RESTful (micro)server that can generate an API in minutes.

Project description

Efesto

Pypi Travis build Codacy grade Codacy coverage Docs

A micro REST API meant to be used almost out of the box with other microservices.

It kickstarts you by providing a simple way to build a backend and expose it. Efesto uses PostgreSQL and JWTs for authentication.

Efesto follows the UNIX principle of doing one thing and well, leaving you the freedom of choice about other components (authentication, caching, rate-limiting, load balancer).

Installing

Install efesto, possibly in a virtual environment:

pip install efesto

Create a postgresql database and export the database url:

export DB_URL=postgres://postgres:postgres@localhost:5432/efesto

Export the jwt secret:

export JWT_SECRET=secret

Populate the db:

efesto install

Create an admin:

efesto create users tofu --superuser

Now you can start efesto, with either uwsgi or gunicorn:

gunicorn "efesto.App:App.run()"

Efesto should now be running:

curl http://localhost:8000/version

Read the complete documentation to find out more.

Docker

Docker images are available in the hub:

  • strangemachines/efesto:latest
  • strangemachines/efesto:latest-meinheld
  • strangemachines/efesto:2.3
  • strangemachines/efesto:2.3-meinheld
  • strangemachines/efesto:2.2
  • strangemachines/efesto:2.1

Performance

Efesto performs at about 300 requests/second on the smallest digital ocean droplet, for requests that include JWT authentication, fetching data and printing out JSON.

You have seen 100k requests benchmarks, but don't be fooled: most benchmarks from authors are made so that their package comes to the top and do not reflect real conditions.

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

efesto-2.3.4.tar.gz (37.7 kB view details)

Uploaded Source

Built Distribution

efesto-2.3.4-py3-none-any.whl (58.6 kB view details)

Uploaded Python 3

File details

Details for the file efesto-2.3.4.tar.gz.

File metadata

  • Download URL: efesto-2.3.4.tar.gz
  • Upload date:
  • Size: 37.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.17 CPython/3.7.3 Linux/5.3.0-20-generic

File hashes

Hashes for efesto-2.3.4.tar.gz
Algorithm Hash digest
SHA256 f319e64910d8dd33b51d40fedd5f07d984406517dc44a55ad9fa1e9e215ccde7
MD5 91211c6ddd68ccf8950b16e679653958
BLAKE2b-256 cb65298933897f5c2b8a68d61c41b4b598f309716a8466066292ee8dc37a104d

See more details on using hashes here.

File details

Details for the file efesto-2.3.4-py3-none-any.whl.

File metadata

  • Download URL: efesto-2.3.4-py3-none-any.whl
  • Upload date:
  • Size: 58.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.17 CPython/3.7.3 Linux/5.3.0-20-generic

File hashes

Hashes for efesto-2.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 c7c172eace6043cc5f95be48f2a7ff3c8b24d582f929cc53f94010bbb8a6c3d2
MD5 368134dad90922347ae933fdc3b0a197
BLAKE2b-256 58daa18246e8601acc079c622f0d0b3979d802ef620bcb2ffbcc3372483b3677

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page