2020-02-18 14:36:44 +00:00
|
|
|
# pinkblackrose
|
2019-12-17 11:47:15 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
FIXME: description
|
2019-12-17 11:47:15 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
## Developing
|
2019-12-17 11:47:15 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
### Setup
|
2019-12-17 11:47:15 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
When you first clone this repository, run:
|
2019-12-17 11:47:15 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
```sh
|
|
|
|
lein duct setup
|
|
|
|
```
|
2019-12-16 05:24:58 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
This will create files for local configuration, and prep your system
|
|
|
|
for the project.
|
2020-02-18 14:36:44 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
### Environment
|
2020-02-18 14:36:44 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
To begin developing, start with a REPL.
|
2020-02-18 14:36:44 +00:00
|
|
|
|
2020-02-19 02:37:43 +00:00
|
|
|
```sh
|
|
|
|
lein repl
|
|
|
|
```
|
|
|
|
|
|
|
|
Then load the development environment.
|
|
|
|
|
|
|
|
```clojure
|
|
|
|
user=> (dev)
|
|
|
|
:loaded
|
|
|
|
```
|
|
|
|
|
|
|
|
Run `go` to prep and initiate the system.
|
|
|
|
|
|
|
|
```clojure
|
|
|
|
dev=> (go)
|
|
|
|
:duct.server.http.jetty/starting-server {:port 3000}
|
|
|
|
:initiated
|
|
|
|
```
|
|
|
|
|
|
|
|
By default this creates a web server at <http://localhost:3000>.
|
|
|
|
|
|
|
|
When you make changes to your source files, use `reset` to reload any
|
|
|
|
modified files and reset the server. Changes to CSS or ClojureScript
|
|
|
|
files will be hot-loaded into the browser.
|
|
|
|
|
|
|
|
```clojure
|
|
|
|
dev=> (reset)
|
|
|
|
:reloading (...)
|
|
|
|
:resumed
|
|
|
|
```
|
|
|
|
|
|
|
|
If you want to access a ClojureScript REPL, make sure that the site is loaded
|
|
|
|
in a browser and run:
|
|
|
|
|
|
|
|
```clojure
|
|
|
|
dev=> (cljs-repl)
|
|
|
|
Waiting for browser connection... Connected.
|
|
|
|
To quit, type: :cljs/quit
|
|
|
|
nil
|
|
|
|
cljs.user=>
|
|
|
|
```
|
|
|
|
|
|
|
|
### Testing
|
|
|
|
|
|
|
|
Testing is fastest through the REPL, as you avoid environment startup
|
|
|
|
time.
|
|
|
|
|
|
|
|
```clojure
|
|
|
|
dev=> (test)
|
|
|
|
...
|
|
|
|
```
|
|
|
|
|
|
|
|
But you can also run tests through Leiningen.
|
|
|
|
|
|
|
|
```sh
|
|
|
|
lein test
|
|
|
|
```
|
|
|
|
|
|
|
|
## Legal
|
2020-02-18 14:36:44 +00:00
|
|
|
|
|
|
|
Copyright © 2020 FIXME
|