Public archive for the Return to Ritherdon project.
https://www.nicolaellisandritherdon.com
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
102 lines
1.6 KiB
102 lines
1.6 KiB
2 years ago
|
# ritherdon-archive
|
||
|
|
||
|
Archive of Ritherdon and Nicola Ellis.
|
||
|
|
||
|
# Usage
|
||
|
|
||
|
Run from sources:
|
||
|
|
||
|
make run
|
||
|
# aka sbcl --load run.lisp
|
||
|
|
||
|
choose your lisp:
|
||
|
|
||
|
LISP=ccl make run
|
||
|
|
||
|
or build and run the binary:
|
||
|
|
||
|
```
|
||
|
$ make build
|
||
|
$ ./ritherdon-archive [name]
|
||
|
Hello [name] from ritherdon-archive
|
||
|
```
|
||
|
|
||
|
## Init config file
|
||
|
|
||
|
Create a config file:
|
||
|
|
||
|
cp config-example.lisp config.lisp
|
||
|
|
||
|
You can override global variables (for example, the port, which can be
|
||
|
handy if you run the app from sources, without building a binary and
|
||
|
using the `--port` flag.
|
||
|
|
||
|
The config file is `load`ed before the web server starts (see the `(main)`).
|
||
|
|
||
|
|
||
|
## Roswell integration
|
||
|
|
||
|
Roswell is an implementation manager and [script launcher](https://github.com/roswell/roswell/wiki/Roswell-as-a-Scripting-Environment).
|
||
|
|
||
|
A POC script is in the roswell/ directory.
|
||
|
|
||
|
Your users can install the script with `craig/ritherdon-archive`.
|
||
|
|
||
|
# Dev
|
||
|
|
||
|
Load the .asd, quickload it then
|
||
|
|
||
|
```
|
||
|
CL-USER> (ritherdon-archive/web:start-app)
|
||
|
```
|
||
|
|
||
|
See also:
|
||
|
|
||
|
- `web::load-config &key port load-init-p`
|
||
|
|
||
|
|
||
|
## Tests
|
||
|
|
||
|
Tests are defined with [Fiveam](https://common-lisp.net/project/fiveam/docs/).
|
||
|
|
||
|
Run them from the terminal with `make test`. You should see a failing test.
|
||
|
|
||
|
```bash
|
||
|
$ make test
|
||
|
Running test suite TESTMAIN
|
||
|
Running test TEST1 f
|
||
|
Did 1 check.
|
||
|
Pass: 0 ( 0%)
|
||
|
Skip: 0 ( 0%)
|
||
|
Fail: 1 (100%)
|
||
|
|
||
|
Failure Details:
|
||
|
--------------------------------
|
||
|
TEST1 in TESTMAIN []:
|
||
|
|
||
|
3
|
||
|
|
||
|
evaluated to
|
||
|
|
||
|
3
|
||
|
|
||
|
which is not
|
||
|
|
||
|
=
|
||
|
|
||
|
to
|
||
|
|
||
|
2
|
||
|
|
||
|
Makefile:15: recipe for target 'test' failed
|
||
|
|
||
|
$ echo $?
|
||
|
2
|
||
|
```
|
||
|
|
||
|
On Slime, load the test package and run `run!`.
|
||
|
|
||
|
---
|
||
|
|
||
|
Licence: BSD
|