add instance about page and some stopwatches

config.maple

···
 
 	default_theme = 'https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.classless.min.css'
 	allow_changing_theme = true
+
+	// instance version
+	version = '2025.01'
+
+	// set this to '' if your instance is closed source (twt)
+	source = 'https://github.com/emmathemartian/beep'
 }
 
 http = {

src/main.v

···
 import os
 import webapp { App, Context, StringValidator }
 import beep_sql
+import util
 
-fn main() {
-	config := webapp.load_config_from(os.args[1])
+pub const version = '25.01.0'
 
-	println('-> connecting to db...')
-	mut db := pg.connect(pg.Config{
-		host:     config.postgres.host
-		dbname:   config.postgres.db
-		user:     config.postgres.user
-		password: config.postgres.password
-		port:     config.postgres.port
-	})!
-	println('<- connected')
-
-	defer {
-		db.close()
+@[inline]
+fn connect(mut app App) {
+	println('-> connecting to database...')
+	app.db = pg.connect(pg.Config{
+		host:     app.config.postgres.host
+		dbname:   app.config.postgres.db
+		user:     app.config.postgres.user
+		password: app.config.postgres.password
+		port:     app.config.postgres.port
+	}) or {
+		panic('failed to connect to database: ${err}')
 	}
+}
 
-	beep_sql.load(mut db)
-
-	mut app := &App{
-		config: config
-		db:     db
-		auth:   auth.new(db)
-	}
-
-	// vfmt off
-	app.validators.username = StringValidator.new(config.user.username_min_len, config.user.username_max_len, config.user.username_pattern)
-	app.validators.password = StringValidator.new(config.user.username_min_len, config.user.username_max_len, config.user.username_pattern)
-	app.validators.nickname = StringValidator.new(config.user.nickname_min_len, config.user.nickname_max_len, config.user.nickname_pattern)
-	app.validators.user_bio = StringValidator.new(config.user.bio_min_len, config.user.bio_max_len, config.user.bio_pattern)
-	app.validators.pronouns = StringValidator.new(config.user.pronouns_min_len, config.user.pronouns_max_len, config.user.pronouns_pattern)
-	app.validators.post_title = StringValidator.new(config.post.title_min_len, config.post.title_max_len, config.post.title_pattern)
-	app.validators.post_body = StringValidator.new(config.post.body_min_len, config.post.body_max_len, config.post.body_pattern)
-	// vfmt on
-
-	app.mount_static_folder_at(app.config.static_path, '/static')!
-
-	println('-> initializing database...')
-	sql db {
+@[inline]
+fn init_db(mut app App) {
+	println('-> initializing database')
+	sql app.db {
 		create table entity.Site
 		create table entity.User
 		create table entity.Post
···
 		create table entity.LikeCache
 		create table entity.Notification
 		create table entity.SavedPost
-	}!
-	println('<- done')
+	} or {
+		panic('failed to initialize database: ${err}')
+	}
+}
+
+@[inline]
+fn load_validators(mut app App) {
+	app.validators.username = StringValidator.new(app.config.user.username_min_len, app.config.user.username_max_len, app.config.user.username_pattern)
+	app.validators.password = StringValidator.new(app.config.user.username_min_len, app.config.user.username_max_len, app.config.user.username_pattern)
+	app.validators.nickname = StringValidator.new(app.config.user.nickname_min_len, app.config.user.nickname_max_len, app.config.user.nickname_pattern)
+	app.validators.user_bio = StringValidator.new(app.config.user.bio_min_len, app.config.user.bio_max_len, app.config.user.bio_pattern)
+	app.validators.pronouns = StringValidator.new(app.config.user.pronouns_min_len, app.config.user.pronouns_max_len, app.config.user.pronouns_pattern)
+	app.validators.post_title = StringValidator.new(app.config.post.title_min_len, app.config.post.title_max_len, app.config.post.title_pattern)
+	app.validators.post_body = StringValidator.new(app.config.post.body_min_len, app.config.post.body_max_len, app.config.post.body_pattern)
+}
+
+fn main() {
+	mut stopwatch := util.Stopwatch.new()
+
+	config := webapp.load_config_from(os.args[1])
+	mut app := &App{ config: config }
+
+	// connect to database
+	util.time_it(
+		it: fn [mut app] () {
+			connect(mut app)
+		}
+		name: 'connect to db'
+		log: true
+	)
+
+	defer { app.db.close() }
+
+	// add authenticator
+	app.auth = auth.new(app.db)
+
+	// load sql files kept in beep_sql/
+	util.time_it(
+		it: fn [mut app] () {
+			beep_sql.load(mut app.db)
+		}
+		name: 'load beep_sql'
+		log: true
+	)
+
+	// load validators
+	load_validators(mut app)
+
+	// mount static things
+	app.mount_static_folder_at(app.config.static_path, '/static')!
+
+	// initialize database
+	util.time_it(it: fn [mut app] () {
+		init_db(mut app)
+	}, name: 'init db', log: true)
 
 	// make the website config, if it does not exist
 	app.get_or_create_site_config()
···
 	if config.dev_mode {
 		println('\033[1;31mNOTE: YOU ARE IN DEV MODE\033[0m')
 	}
+
+	stop := stopwatch.stop()
+	println('-> took ${stop} to start app')
 
 	veb.run[App, Context](mut app, app.config.http.port)
 }

src/templates/about.html

···
+@include 'partial/header.html'
+
+<h1>about this instance</h1>
+
+<div>
+	<p>name: @{app.config.instance.name}</p>
+	<p>version: @{app.config.instance.version} (commit: @{app.commit})</p>
+	<p>built at @{app.built_at} (<span id="built_at">date n/a</span>)</p>
+	<p>built using @{app.v_hash}</p>
+
+	@if app.config.instance.source != ''
+	<p>source: <a href="@{app.config.instance.source}">@{app.config.instance.source}</a></p>
+	@end
+</div>
+
+<script>
+	document.getElementById('built_at').innerText = new Date(@{app.built_at} * 1000).toLocaleString()
+</script>
+
+@include 'partial/footer.html'

src/templates/partial/footer.html

···
 	</main>
 
 	<footer>
-		@if ctx.is_logged_in()
 		<p>
+			@if ctx.is_logged_in()
 			<a href="/settings">settings</a>
 			@if user.admin
 			-
···
 			@end
 			-
 			<a href="/logout">log out</a>
+			-
+			@end
+			<a href="/about">about</a>
 		</p>
-		@end
 
 		<p>powered by <a href="https://github.com/emmathemartian/beep">beep</a></p>
 	</footer>

src/util/stopwatch.v

···
+module util
+
+import time
+
+@[noinit]
+pub struct Stopwatch {
+pub:
+	start time.Time = time.now()
+pub mut:
+	stop time.Time
+	took ?time.Duration
+}
+
+@[inline]
+pub fn Stopwatch.new() Stopwatch {
+	return Stopwatch{}
+}
+
+@[inline]
+pub fn (mut stopwatch Stopwatch) stop() time.Duration {
+	stopwatch.stop = time.now()
+	duration := stopwatch.stop - stopwatch.start
+	stopwatch.took = duration
+	return duration
+}
+
+@[params]
+pub struct TimeItParams {
+pub:
+	it   fn () @[required]
+	name string
+	log  bool
+}
+
+@[inline]
+pub fn time_it(params TimeItParams) Stopwatch {
+	mut stopwatch := Stopwatch.new()
+	params.it()
+	took := stopwatch.stop()
+	if params.log {
+		println('-> (time_it) ${params.name} took ${took}')
+	}
+	return stopwatch
+}

src/webapp/app.v

···
 	veb.StaticHandler
 	DatabaseAccess
 pub:
-	config Config
+	config   Config
+	commit   string = @VMODHASH
+	built_at string = @BUILD_TIMESTAMP
+	v_hash   string = @VHASH
 pub mut:
 	auth       auth.Auth[pg.DB]
 	validators struct {

src/webapp/config.v

···
 		welcome              string
 		default_theme        string
 		allow_changing_theme bool
+		version              string
+		source               string
 	}
 	http        struct {
 	pub mut:
···
 	config.instance.welcome = loaded_instance.get('welcome').to_str()
 	config.instance.default_theme = loaded_instance.get('default_theme').to_str()
 	config.instance.allow_changing_theme = loaded_instance.get('allow_changing_theme').to_bool()
+	config.instance.version = loaded_instance.get('version').to_str()
+	config.instance.source = loaded_instance.get('source').to_str()
 
 	loaded_http := loaded.get('http')
 	config.http.port = loaded_http.get('port').to_int()

src/webapp/pages.v

···
 	ctx.title = '${app.config.instance.name} - search'
 	return $veb.html('../templates/search.html')
 }
+
+@['/about']
+fn (mut app App) about(mut ctx Context) veb.Result {
+	user := app.whoami(mut ctx) or { User{} }
+	ctx.title = '${app.config.instance.name} - about'
+	return $veb.html('../templates/about.html')
+}