Skip to main content

Efesto

Pypi Travis build Codacy grade Codacy grade

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 quickstart

Create an admin:

efesto create_user tofu --superuser

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

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

Efesto should now be running, let's make sure it is. Create a jwt with the secret you have configured. Efesto comes with an helper for that:

efesto token tofu 1000

Send a request with the token:

curl http://localhost:8000/users -H "Authorization: Bearer token"

Success! Efesto is running fine. Read the complete documentation <http://efesto.readthedocs.io>_ to find out more

Performance

Efesto performs at about 200 requests/second on a small 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.

That said, Efesto's did not reach its maximum and a lot can be done to improve its performance.

Notes from the author

  • Efesto is not meant to be the solution to all problems. It can be quite good as a prototyping and early stage backend, less so on the long term (see below)

  • Efesto lacks some strategic features and I can only put a limited amount of time into Efesto. If you want some features done and can't contribute yourself, I can be hired.

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.0.3.tar.gz (12.0 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

efesto-2.0.3-py3.6.egg (45.1 kB view details)

Uploaded Egg

efesto-2.0.3-py3-none-any.whl (31.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: efesto-2.0.3.tar.gz
  • Upload date:
  • Size: 12.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.8

File hashes

Hashes for efesto-2.0.3.tar.gz
Algorithm Hash digest
SHA256 c6f9a750af6a7f9738a382e87527f3a9ce0f0261158ce9f9124bdd00da070065
MD5 74187e6cec84192a3c6889362719a2ac
BLAKE2b-256 da0686308931259b0b955dcf350f21e3b8556509c51920bad5307f9222a1fb05

See more details on using hashes here.

File details

Details for the file efesto-2.0.3-py3.6.egg.

File metadata

  • Download URL: efesto-2.0.3-py3.6.egg
  • Upload date:
  • Size: 45.1 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.8

File hashes

Hashes for efesto-2.0.3-py3.6.egg
Algorithm Hash digest
SHA256 76ac399626d11948eacd47b8db1bf79196ddb9ec201f241addabbe094f190112
MD5 5f5b8d9d1063f0ac4b293db333ae2570
BLAKE2b-256 bc95c267d655b3715a851cd9c6f10ea2f24f04b4d188079af880e2bb60b4dbc3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: efesto-2.0.3-py3-none-any.whl
  • Upload date:
  • Size: 31.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.8

File hashes

Hashes for efesto-2.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 26b8e4c97d182ad541f5c4d1d33b0e5a12b6b18812a0498b49da1caca428102e
MD5 ddf730ee12d3a8906838b74ff0d86d1b
BLAKE2b-256 de6344cc0b8661712b6ead006552c40ec698905eae95ac0cf56cafb1e72136d5

See more details on using hashes here.

Supported by

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