While most "todo" demos provide an excellent cursory glance at a framework's capabilities, they typically don't convey the knowledge & perspective required to actually build real applications with it.
Read the full blog post announcing RealWorld on Medium.
Over 100 implementations have been created using various languages, libraries, and frameworks.
Explore them on CodebaseShow.
In order for Real World back-end and front-end examples to be able to work together we need to follow a predefined openapi.yml.
Download from https://github.com/vlopatka/realworld
FIXME: explanation
Run the project directly, via :exec-fn
:
$ clojure -X:run-x
Hello, Clojure!
Run the project, overriding the name to be greeted:
$ clojure -X:run-x :name '"Someone"'
Hello, Someone!
Run the project directly, via :main-opts
(-m vlopatka.realworld
):
$ clojure -M:run-m
Hello, World!
Run the project, overriding the name to be greeted:
$ clojure -M:run-m Via-Main
Hello, Via-Main!
Run the project's tests (they'll fail until you edit them):
$ clojure -T:build test
Run the project's CI pipeline and build an uberjar (this will fail until you edit the tests to pass):
$ clojure -T:build ci
This will produce an updated pom.xml
file with synchronized dependencies inside the META-INF
directory inside target/classes
and the uberjar in target
. You can update the version (and SCM tag)
information in generated pom.xml
by updating build.clj
.
If you don't want the pom.xml
file in your project, you can remove it. The ci
task will
still generate a minimal pom.xml
as part of the uber
task, unless you remove version
from build.clj
.
Run that uberjar:
$ java -jar target/realworld-0.1.0-SNAPSHOT.jar
If you remove version
from build.clj
, the uberjar will become target/realworld-standalone.jar
.
FIXME: listing of options this app accepts.
...
...
Copyright © 2023 Vlopatka
EPLv1.0 is just the default for projects generated by clj-new
: you are not
required to open source this project, nor are you required to use EPLv1.0!
Feel free to remove or change the LICENSE
file and remove or update this
section of the README.md
file!
Distributed under the Eclipse Public License version 1.0.