microblog VS clojure-style-guide

In this blog, we're going to address the "on any website" part of a Search Solution. Or at least - propose a starting point for it. There are many great tutorials out there for a deep dive on Flask - one of the best from my colleague Miguel.

- https://blog.miguelgrinberg.com/post/the-flask-mega-tutorial...

If you'd like to deploy a web app, Flask is your best friend. It's very user friendly and there's a lot of great tutorials online. The only thing you'd need other than Python knowledge is some basic understanding of HTML/CSS and Jinja notation for variables, both of which are pretty intuitive to learn. Good luck!

I can't speak highly enough of Miguel Grinberg's work with Python/Flask (https://blog.miguelgrinberg.com/post/the-flask-mega-tutorial...) and the community he's created around it, for both beginners and advanced folks.

Racing through his mega tutorial was a great refresher for me on the fundamentals, and it's easy to plug in computer vision & related libraries/extensions/packages.

Use miguel grinberg’s tutorial https://blog.miguelgrinberg.com/post/the-flask-mega-tutorial-part-i-hello-world

I got a recommendation (from a few places) to use Miguel Grinberg's microblog series to help me get up to speed on some flask things. I'm on ch 15 with blueprints, and am running into pylint cyclic import errors, both on my app and in the actual project (https://github.com/miguelgrinberg/microblog/tree/v0.15?search=1)

In the project root directory create a folder called static with one subfolder called js and another called css. The js folder will contain all of the needed local JavaScript files while the css folder will contain all the CSS stylesheets. In the js folder create a file called index.js and in the css folder one called style.css. Just leave them empty for now. If you want to find out more about web development with Flask I suggest you try out this tutorial. Your current project structure should like this:

https://blog.miguelgrinberg.com/post/the-flask-mega-tutorial-part-i-hello-world is not perfect, but a great start.

Fixed link to that style guide entry: https://guide.clojure.style/#opt-commas-in-map-literals

Per that style guide, the above map would be formatted like this (on HN, just indent by two spaces):

  {:a 1

As for the broader question of Clojure style, there are style guides like https://github.com/bbatsov/clojure-style-guide and tools like clj-kondo to help learn and reinforce important practices.

Basically, you learn the expected places to put whitespace, make sure to edit your code accordingly and all of the parens will be automatically closed and adjusted. Using parinfer—which you can also combine with the more traditional paredit—makes writing Clojure code a lot like writing Python.

Also, there are guidelines, the styleguide, clj-kondo, kibit etc. And if you don't review your interns/juniors code to teach them good practices - you're doing it wrong (well, this one is true for any practical PL out there).

Another good resource is https://guide.clojure.style/ -- the (unofficial) community style guide for Clojure.

It's not an answer to your question but i can refer you to https://github.com/bbatsov/clojure-style-guide

The same could be said about the "Clojure Style Guide" from the Cider guy. As a matter of fact, there was an issue about it that was quickly declined https://github.com/bbatsov/clojure-style-guide/issues/232

Formatting is not that great, see https://github.com/bbatsov/clojure-style-guide btw