Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/simonjwright/ews
The Embedded Web Server is designed for use in embedded systems with limited resources (eg, no disk). It supports both static (converted from a standard web tree, including graphics and Java class files) and dynamic pages. It is written in GCC Ada.
https://github.com/simonjwright/ews
Last synced: about 2 months ago
JSON representation
The Embedded Web Server is designed for use in embedded systems with limited resources (eg, no disk). It supports both static (converted from a standard web tree, including graphics and Java class files) and dynamic pages. It is written in GCC Ada.
- Host: GitHub
- URL: https://github.com/simonjwright/ews
- Owner: simonjwright
- License: gpl-3.0
- Created: 2022-03-12T19:48:56.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2022-08-19T13:46:51.000Z (over 2 years ago)
- Last Synced: 2024-07-31T20:35:16.998Z (5 months ago)
- Language: Ada
- Homepage:
- Size: 892 KB
- Stars: 12
- Watchers: 3
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: COPYING.RUNTIME
Awesome Lists containing this project
- awesome-ada - ews - Embedded Web Server is a web server construction kit, designed for embedded applications using the GNAT Ada compiler. (Frameworks / Web)
README
# Embedded Web Server #
## Introduction ##
EWS is a web server construction kit, designed for embedded applications using the GNAT Ada compiler.
The project is hosted on [Github](https://github.com/simonjwright/ews).
## Building with Alire ##
See the [Alire documentation](https://alire.ada.dev/docs/#introduction).
After you've installed Alire, start a small test program by saying
```
alr init --bin ews_test
cd ews_test
alr with ews
```
This generates a project (GPR) file at the top level and a source file `src/ews_test.adb`.
Create a directory `html` and in it `index.html` containing (for example)
```
Hello world!
```
The contents of `html/` need to be converted to Ada source code in `src/`, which will form the static content of the pages served by `ews_test`. This can be done as part of the Alire build process; to do this, edit `alire.toml` to add the lines
```
[[actions]]
type = "pre-build"
command = ["ews_generator", "--input-dir", "html", "--output-dir", "src"]
```
Edit the contents of `src/ews_test.adb` to contain
```
with EWS_Htdocs;
with EWS.Server;
procedure EWS_Test is
begin
EWS.Server.Serve (Using_Port => 8088,
Tracing => True);
end EWS_Test;
```
and build and run with
```
alr run
```
Now, in your browser, open `localhost:8088` (possibly, `127.0.0.1:8088`) to see your exciting web page!
To see a worked example of dynamic content, check out the document [ews.pdf](https://github.com/simonjwright/ews/blob/master/demonstrator/ews.pdf).
## Building outside Alire ##
EWS requires GNAT and XML/Ada, and uses Ada 2012 features.
In the top-level directory, `make` will build the library, and `make demo` will create a server `doc/ews_demo`, which when executed will listen on port 8080 and respond with the web in the `doc/` directory.
The package can be installed with the compiler by `make install` (more likely, `sudo make install`). You can install in an alternative place by setting `prefix`, for example
$ make install prefix=~/local/ews
## Dynamic web ##
The facilities available in EWS, and the code for a demonstration, are described in `demonstrator/ews.pdf`, which is derived from `demonstrator/ews.w`. As well as being the document source, `ews.w` also acts as the source code using the [Literate Programming](http://www.literateprogramming.com/) facilities of [nuweb.py](https://github.com/simonjwright/nuweb.py).
### Demonstration ###
If you're seeing this page via the demonstration (`ews_demo`), you can view a page with [AJAX](https://en.wikipedia.org/wiki/Ajax_\(programming\)) content [here](ajax.html).