Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nedpals/vex
Easy-to-use, modular web framework built for V
https://github.com/nedpals/vex
http-server v vlang web-framework
Last synced: 3 days ago
JSON representation
Easy-to-use, modular web framework built for V
- Host: GitHub
- URL: https://github.com/nedpals/vex
- Owner: nedpals
- License: mit
- Created: 2019-11-13T14:55:21.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-02-03T11:00:27.000Z (9 months ago)
- Last Synced: 2024-05-01T14:54:16.026Z (6 months ago)
- Topics: http-server, v, vlang, web-framework
- Language: V
- Homepage: https://nedpals.github.io/vex
- Size: 712 KB
- Stars: 333
- Watchers: 16
- Forks: 28
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-pinoy-made - GitHub
- awesome-v - vex - Web framework written on V inspired by Express and Sinatra. (Libraries / Web)
README
### Easy-to-use, modular web framework for [V](https://vlang.io).
```v
module main
import nedpals.vex.router
import nedpals.vex.server
import nedpals.vex.ctx
fn print_req_info(mut req ctx.Req, mut res ctx.Resp) {
println('${req.method} ${req.path}')
}
fn do_stuff(mut req ctx.Req, mut res ctx.Resp) {
println('incoming request!')
}
fn main() {
mut app := router.new()
app.use(do_stuff, print_req_info)
app.route(.get, '/', fn (req &ctx.Req, mut res ctx.Resp) {
res.send_file('index.html', 200)
})
app.route(.get, '/public/*path', fn (req &ctx.Req, mut res ctx.Resp) {
res.send_file('public/' + req.params['path'], 200)
})
app.route(.get, '/path/:name', fn (req &ctx.Req, mut res ctx.Resp) {
println('path is ${req.params["name"]}')
}, fn (req &ctx.Req, mut res ctx.Resp) {
res.send('path: ' + req.params['name'], 200)
})
app.route(.get, '/complex/:name/*path', fn (req &ctx.Req, mut res ctx.Resp) {
res.send('username: ' + req.params['name'] + '\npath: ' + req.params['path'], 200)
})
server.serve(app, 6789)
}
```
## Installation & Getting Started
Learn how to setup and use VEX by reading the [Wiki](https://github.com/nedpals/vex/wiki/Installation).
## Roadmap
- [X] Support for `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, and `OPTION` HTTP methods.
- [x] HTTP Router (Wildcards are now supported)
- [x] Route groups (non-reusable for now)
- [x] ~~Static file server~~
- [x] Params and query parsing
- [x] Middleware support
- [x] Cookie parsing (basic support)
- [x] Cookie manipulation / Session support
- [ ] Websocket Server
- [x] Body parsing
- [x] `application/x-www-form-urlencoded` support
- [x] `application/json` support
- [x] `multipart/form-data` support
## Contributing
1. Fork it ()
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
## Examples
Examples can be found at the [`/examples`](/examples) directory.
## License
[MIT](LICENSE)
## Contributors
- [Ned Palacios](https://github.com/nedpals) - creator and maintainer