https://github.com/lazy-eggplant/vs.http
An HTTP server based on vs.templ
https://github.com/lazy-eggplant/vs.http
http-server mongoose ssg vs-templ
Last synced: 3 months ago
JSON representation
An HTTP server based on vs.templ
- Host: GitHub
- URL: https://github.com/lazy-eggplant/vs.http
- Owner: lazy-eggplant
- License: gpl-2.0
- Created: 2025-01-05T19:12:41.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2025-02-04T10:57:45.000Z (4 months ago)
- Last Synced: 2025-02-04T11:32:57.117Z (4 months ago)
- Topics: http-server, mongoose, ssg, vs-templ
- Language: C++
- Homepage:
- Size: 22.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
`vs.http` is an HTTP server based on [mongoose](https://github.com/cesanta/mongoose) and [vs.templ](https://github.com/lazy-eggplant/vs.templ).
It serves as demo project for _vs.templ_, but it works and might have some practical value.
It has a quite small memory footprint, mostly thanks to _mongoose_ and _pugixml_ which are decently optimized.
If you are targetting embedded devices, you might want to configure some flags in _pugixml_ to further reduce its memory usage.
## Building
> [!IMPORTANT]
> You will not be able to build it with normal meson for an [unrelated issue](https://github.com/mesonbuild/meson/pull/14073) whose PR is in waiting list.
> ~~For now, you will need to patch meson manually if you really want to build this example.~~
> Patch has been added to meson 1.7.
The current build is explicitly using static deps for portability.
```bash
meson setup build
meson install --skip-subprojects -C build
```
## Usage
After building it, run this to see the default example.
```bash
cd example
../build/vs.http
```
It has an internal default profile for the folder layout.
Still, a custom profile can be passed as the first and only argument.
## Not in scope
But PRs are accepted:
- File streaming
- Cache HTTP headers to avoid reloads
- A configurable cache of pre-generated files
PRs will not be accepted:
- Support for methods other than GET. There is no way to support actions able to mutate the state, or externally get data without introducing other scripting capabilities or dynamic library loading.
## Licence
It is forced to GPL-2.0 by _mongoose_.
Clearly this does not cover your own files and configuration, only the engine itself.