v/vlib/vweb
Alexander Medvednikov 5bb8416baf
update vweb readme
2019-07-29 19:46:26 +02:00
..
tmpl generics, vweb, comptime codegen, etc 2019-07-29 18:24:48 +02:00
README.md update vweb readme 2019-07-29 19:46:26 +02:00
vweb.v generics, vweb, comptime codegen, etc 2019-07-29 18:24:48 +02:00

README.md

This is pre-alpha software.

Lots of things are broken and not implemented yet in V and vweb.

There's no documentation yet, have a look at https://github.com/vlang/vtalk for an example of a simple vweb app.

vtalk.v contains all GET and POST actions.

pub fn (app mut App) index() {
	posts := app.find_all_posts()
	$vweb.html()
}

// TODO ['/post/:id/:title'] 
// TODO `fn (app App) post(id int)` 
pub fn (app App) post() {
	id := app.get_post_id() 
	post := app.retrieve_post(id) or {
		app.vweb.redirect('/') 
		return 
	}
	comments := app.find_comments(id)
	show_form := true 
	$vweb.html()
}

index.html is an example of the V template language:

@for post in posts 
	<div class=post>
		<a class=topic href="@post.url">@post.title</a> 
		<img class=comment-img> 
		<span class=nr-comments>@post.nr_comments</span> 
		<span class=time>@post.time</span>
	</div>
@end

$vweb.html() compiles an HTML template into V during compilation, and embeds the resulting code in current action.

That means that the template automatically has access to that action's entire environemnt.

Deploying vweb apps

Everything, including HTML templates, is in one binary file. That's all you need to deploy.