faenz VS SQLite

Two years back, I created a little web analytics tool for my side projects and I called Faenz. It's open source and self-hostable, available on GitHub at https://github.com/a-chris/faenz.

I've recently given it an update and came up with the idea of creating a demo version that's accessible to everyone.

How does it work?

You can add your own website, blog or e-commerce site and keep track of the visits it receives. Your website stats will be visible to others, and you'll get to check out everyone else's stats too. You won't be allowed to edit/delete a website, you should reach out to me for that.

I find it to be a fun experiment to see how people handle SEO or just to discover some cool new websites :)

The demo is available here https://faenz.acmecorp.dev/

Here is the project I'm working on: Faenz Analytics

I've built several personal projects to be honest; background jobs, tasks automation, telegram bots to find a house to rent or buy, most of them are kept provate.

The two I'm most proud of are a web analytics that, coincidentally, I've made public today after a few weeks of work:

https://github.com/a-chris/faenz

I developed it for collect data for my personal website and it is working well so far, really happy of it.

The other one is a Google Chrome extension to manage bookmark because I think the default one is a mess and very unpratical to use. I haven't worked on it for a while:

https://github.com/a-chris/peffect-bookmarks-manager

If you are into alternative storage engines for SQLite, there is also an LSM (Log-Structured Merge-tree) extension in the main repository that is not announced nor documented but seems to work. It’s based on the SQLite 4 project.

https://github.com/sqlite/sqlite/tree/master/ext/lsm1

https://www.charlesleifer.com/blog/lsm-key-value-storage-in-...

The sqlite code base is really well done. Lots of documentation.

https://github.com/sqlite/sqlite

Especially the VM part: https://github.com/spandanb/learndb-py/blob/master/learndb/v...

Compare it with this: https://github.com/sqlite/sqlite/blob/master/src/vdbe.c

That's said, I'm curious how complete this LearnDB is. SQLite is hard to read not only it's old but also it covers a lot of SQL and following SQL spec makes hings complicated. SQLite has great test suite so it's nice if you run the suit against this implementation.

Correct, see the github mirror[1]. I don't know how well supported that feature is compared to main branch. If it was completely stable, then it would have already landed in the main stable branch. Clarity about the roadmap of that branch would be nice.

1. https://github.com/sqlite/sqlite/tree/begin-concurrent

Including comprehensive comments, documentation and tests in a codebase takes time and effort.

Failing to do so creates code that is very difficult to maintain or for someone new to the codebase to understand.

However, time and effort may not be what the organization wants to pay for, and individuals may view their own incomprehensible code as something like job security, as they can't be replaced by someone else easily.

As an example of complicated code that's still well-documented, the open-source sqlite code is a good example, about 1/4 of the B-tree file is comments, every time a variable is defined there's a short note explaining what it's used for, every function has a comment header that's comprehensive, such that someone new to the codebase could construct a map of how it all works fairly quickly. It's a good model for how to avoid the problem:

https://github.com/sqlite/sqlite/blob/master/src/btree.c