WIP

[jhvst]

🚧 WIP 🚧

✅ Done:

• Search @c1bbae93fb4ecef44470faf8f9fe21631408c9c0
• Editing of posts
• Site-wide settings @f083a8294ef7fbc404bfa8d7ad319f2e9cb5fd44
• Password reminder @07d3dde2713b3199c1e9973824f5cfbfaed68333
• Analytics middleware (kind of)
• Documentation on useful functions
• Homepage which lists posts from all users
• Migrate RethinkDB to embedded database (sqlite?) @bbcba13bc1abb6d2e1c0667f125859854642b1cf
• T-te-tests?! (I was very skeptical to add these in the first place, but I'm very glad I did)
• Import databases as drivers
• get rid of martini and replace it with idiomatic HTTP server

🚧 Backlog:

• CSRF protection
• make packages like email testable without running the HTTP server (aka improve code coverage)
• unique post slugs (slug + 5 character UUID)
• paging (https://00f.net/2011/02/25/pagination-and-http-caching/)
• P2P sharing, reading and discovering of posts? (this should be done in like version v2.0) (https://github.com/ipfs/go-ipfs?)

🚫 Won't be implemented:

• RethinkDB DAL
• tagging? (aka hashtags, tags, or whatnot)
• Embed .tmpl and other static files into the binary
• Menus?
• A WYSIWYG editor such as Quill would be nice

[jhvst]

Let's leave WYSIWYQ out of the main package. Quill seemed to inject iframes and other black magic on to the page, which really kills the whole simplicity thing.

Homepage and complete CRUD options are now available on posts.

[jhvst]

Added search.

Now that I'm only menus short of some sort of milestone, I have decided to look into adding native analytics middleware to this program.

[jhvst]

Very simple analytics have now been added as well as documentation on all functions.

[jhvst]

Added RSS and Atom support even though it was not in roadmap...

Adding email sending and lost password etc to roadmap.

[jhvst]

Also, DB could be migrated from RethinkDB to something embedded. Getting started with the current build is kind of a horrible experience.

[jhvst]

It has surely been a long time since last feature commit, but yes, something as pointless as password recovery is now in place. Though I bit cut corners by implementing email sending with Mailgun, but that shall be just fine for the sake of my mental sanity. At the same time the project kind of got the basis of mail sending in place, but for the moment no other helper functions than SendRecoveryMail exist. I do not see the real point of making some welcome emails etc, but that's for further consideration.

Anyhow, since feeds.go and now the mail sending require quite a few pre-defined parameters it would probably be best idea to add some kind of site-wide settings panel or installation wizard or JSON configuration file or something along those lines.

I'll be also starting to separate the RethinkDB from the source code to make it easier to implement new database modules. I've been playing some with embedded Go databases, but for now there's not a lot to comment on that.

Also, first fork was done today by @drejohnson! Cheers!

[jhvst]

"Site-wide settings" were installed yesterday (@f083a8294ef7fbc404bfa8d7ad319f2e9cb5fd44). Now there is an installation wizard when the system notices a fresh installation. That also skips the need of declaring the Mailgun API keys manually in the users.go file.

The global settings can be accessed throughout the application by using the Settings keyword.

[jhvst]

I've recently started out making tests (a0a758a). For a start, they will be mainly covering the JSON routes, as those usually expose more data and therefore are better to be tested more throughout.

The testing library used is ginkgo, as it seems to provide a lot of useful features for web server testing. CI platform is currently wercker.

[jhvst]

I'm now starting a new branch where the database will be switched to SQL. The database methods will use the gorm package, which will make it easy to switch between SQLite, MySQL and PostgreSQL depending on your needs.

[jhvst]

Database driver used now is gorm. The old repo with the rethinkdb driver can be found in its own branch at least temporarily as I test trough everything with the new driver.

[jhvst]

I'm removing Embed .tmpl and other static files into the binary from the roadmap as the gobuild.io is able to include those with the binaries. That being said, the project is now downloadable as binaries in http://gobuild.io/github.com/9uuso/vertigo (hooray!). And as cute as using an embedded database in Go sounded, it would be way too much work to get it right.

The current roadmap now only includes adding tests, but dealing with some features like password reminder is bit more complicated, but surely something that should be covered as well. I'm having bit controversial thoughts on using Mailgun, as even though I'd like Vertigo to be as independent as possible, requiring the end-user to run their own mail server might just be a shot to the leg for everyone.

[jhvst]

As for test coverage see #13. I consider tests now as done.