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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.3.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Vesuvium from gravatar.com Vesuvium

Credits

Author: Jacopo Cascioli

License

GNU General Public License v3 (GPLv3) (GPL3)

Classifiers

Report project as malware

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.0.tar.gz (11.9 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.0-py3.6.egg (45.0 kB view details)

Uploaded Egg

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: efesto-2.0.0.tar.gz
  • Upload date:
  • Size: 11.9 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.0.tar.gz
Algorithm Hash digest
SHA256 8efe68f20aab20b6aeb51c7cbf296dd592b70d46a9aa7b700ace80b653aeba5f
MD5 d26db36d9d797923728762c9f7ec6454
BLAKE2b-256 e50fc6a34f1c9fd5869317e97009e70d526dd987a2818cf3055f928d48abef08

See more details on using hashes here.

File details

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

File metadata

  • Download URL: efesto-2.0.0-py3.6.egg
  • Upload date:
  • Size: 45.0 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.0-py3.6.egg
Algorithm Hash digest
SHA256 3cc07470990fc6128a350012d04c98edaa74c14398a7ac2a8272ecb3efbc17db
MD5 f4d9d63b49ba03727b800f70c8488222
BLAKE2b-256 80017f885d648e25707a61a76ac9dba7993806a684d3d61e466cb072fb072c32

See more details on using hashes here.

File details

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

File metadata

  • Download URL: efesto-2.0.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b1f3e48be56c12d920e5b32d00beaffb876b48eaadf3ea8e2941a4bf8133201f
MD5 08f5b715401521aec3db529a52c08275
BLAKE2b-256 e08eddec5fb68e123c5d1e965bf10aec35a1ef27267dd8e6faaf0a66e9c0014b

See more details on using hashes here.

Release history Release notifications | RSS feed

2.3.4

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.0

2 files

2.1.0

2 files

2.0.3

3 files

2.0.2

3 files

2.0.1

3 files

This release

2.0.0 This release

3 files

1.2.0

3 files

1.1.8

2 files

1.1.7

2 files

1.1.6

3 files

1.1.5

1 file

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

3 files

1.0.0

3 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

0.11.4

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.1

2 files

0.8.0

2 files

0.7.5

1 file

0.7.4

1 file

0.7.3

1 file

0.7.2

1 file

0.7.1

1 file

0.7

3 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page