Skip to content

Latest commit

 

History

History
107 lines (71 loc) · 4.92 KB

README.md

File metadata and controls

107 lines (71 loc) · 4.92 KB
Raw

Eiffel Web Framework

Build Status

Overview

The Eiffel Web Framework (EWF) provides Eiffel users with a layer to build anything on top of the http protocol such as websites, web API/services.

This layer is multi-platform: it can be set on Windows, Linux operating systems, and in addition it can run on top of any httpd servers such as Apache2, IIS, nginx, lighttpd. EWF includes as well a standalone httpd web server component, written in Eiffel, which enables users to run easily a web server on their machine, or even embed this component in any application written with Eiffel.

Currently EWF offers a collection of Eiffel libraries designed to be integrated with each others, and among other functionalities, it give simple access to the request data, to handle content negotiation, url dispatcher, integrate with openid system, and so on.

There is a growing ecosystem around EWF, that provides useful components:

  • OpenID and OAuth consumer library
  • Various hypermedia format such as HAL, Collection+json, ...
  • Websocket server and client
  • Template engine
  • API Auto-documentation with swagger
  • A simple experimental CMS.
  • ...

So if you want to build a website, a web api, RESTful service, ... or even if you want to consume other web api, EWF is a solution.

EWF brings with it all the advantages of the Eiffel technology and tools with its powerful features such as Design by Contract, debugging, testing tools which enable to build efficient systems expected to be repeatedly refined, extended, and improved in a predictable and controllable way so as to become with time bugfree systems. Enjoy the full power of debugging your web server application from the IDE.

Project

Official project site for Eiffel Web Framework:

For more information please have a look at the related wiki:

For download, check

Tasks and issues are managed with github issue system

Requirements

  • Compiling from EiffelStudio 16.05 to 17.05 and more recent version of the compiler.
  • Currently being developped using EiffelStudio 17.01 (on Windows, Linux)
  • Tested using EiffelStudio 17.01 with "jenkins" CI server.
  • The code have to allow void-safe compilation and non void-safe system (see more about void-safety

How to get the source code?

Using git

  • git clone https://github.com/EiffelWebFramework/EWF.git

  • And to build the required and related Clibs

    • cd contrib/ise_library/cURL
    • geant compile

Libraries under 'library'

server

  • ewsgi: Eiffel Web Server Gateway Interface read more
    • connectors: various web server connectors for EWSGI
  • libfcgi: Wrapper for libfcgi SDK
  • wsf: Web Server Framework read more
    • router: URL dispatching/routing based on uri, uri_template, or custom read more

protocol

  • http: HTTP related classes, constants for status code, content types, ... read more
  • uri_template: URI Template library (parsing and expander) read more
  • CONNEG: Content negotiation library (Content-type Negociation) read more

client

  • http_client: simple HTTP client based on cURL read more

text

  • encoder: Various simpler encoders: base64, url-encoder, xml entities, html entities read more

Others

  • error: very simple/basic library to handle error

Draft folder = call for contribution

Examples

..

Contributing to this project

Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.

Community

Keep track of development and community news.

For more information please have a look at the related workbook documentation