pyeve/eve

Eve

.. image:: https://img.shields.io/pypi/v/eve.svg?style=flat-square :target: https://pypi.org/project/eve

.. image:: https://github.com/pyeve/eve/workflows/CI/badge.svg :target: https://github.com/pyeve/eve/actions?query=workflow%3ACI

.. image:: https://img.shields.io/pypi/pyversions/eve.svg?style=flat-square :target: https://pypi.org/project/eve

.. image:: https://img.shields.io/badge/license-BSD-blue.svg?style=flat-square :target: https://en.wikipedia.org/wiki/BSD_License

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/ambv/black

Eve is an open source Python REST API framework designed for human beings. It allows to effortlessly build and deploy highly customizable, fully featured RESTful Web Services. Eve offers native support for MongoDB, and SQL backends via community extensions.

Eve is Simple

.. code-block:: python

from eve import Eve

app = Eve()
app.run()

The API is now live, ready to be consumed:

.. code-block:: console

$ curl -i http://example.com/people
HTTP/1.1 200 OK

All you need to bring your API online is a database, a configuration file (defaults to settings.py) and a launch script. Overall, you will find that configuring and fine-tuning your API is a very simple process.

Check out the Eve Website <http://python-eve.org/>_

Features

• Emphasis on REST
• Full range of CRUD operations
• Customizable resource endpoints
• Customizable, multiple item endpoints
• Filtering and Sorting
• Pagination
• HATEOAS
• JSON and XML Rendering
• Conditional Requests
• Data Integrity and Concurrency Control
• Bulk Inserts
• Data Validation
• Extensible Data Validation
• Resource-level Cache Control
• API Versioning
• Document Versioning
• Authentication
• CORS Cross-Origin Resource Sharing
• JSONP
• Read-only by default
• Default Values
• Predefined Database Filters
• Projections
• Embedded Resource Serialization
• Event Hooks
• Rate Limiting
• Custom ID Fields
• File Storage
• GeoJSON
• Internal Resources
• Enhanced Logging
• Operations Log
• MongoDB Aggregation Framework
• MongoDB and SQL Support
• Powered by Flask

License

Eve is a Nicola Iarocci_ open source project, distributed under the BSD license <https://github.com/pyeve/eve/blob/master/LICENSE>_.

Funding

Eve REST framework is a open source, collaboratively funded project. If you run a business and are using Eve in a revenue-generating product, it would make business sense to sponsor Eve development: it ensures the project that your product relies on stays healthy and actively maintained. Individual users are also welcome to make a recurring pledge or a one time donation if Eve has helped you in your work or personal projects.

Every single sign-up makes a significant impact towards making Eve possible. To learn more, check out our funding page_.

Sponsored by

.. image:: https://raw.githubusercontent.com/pyeve/eve/refs/heads/master/docs/_static/invoicetronic.svg :target: https://invoicetronic.com/en/ :width: 50 % :alt: Invoicetronic is the leading API for electronic invoicing in Italy

.. _Nicola Iarocci: http://nicolaiarocci.com .. _funding page: http://python-eve.org/funding.html