https://github.com/arclanguage/anarki
Community-managed fork of the Arc dialect of Lisp; for commit privileges submit a pull request.
https://github.com/arclanguage/anarki
arc darwin linux lisp lisp-1 macos racket-lang webapp
Last synced: about 1 month ago
JSON representation
Community-managed fork of the Arc dialect of Lisp; for commit privileges submit a pull request.
- Host: GitHub
- URL: https://github.com/arclanguage/anarki
- Owner: arclanguage
- License: other
- Created: 2008-03-14T20:13:58.000Z (about 17 years ago)
- Default Branch: master
- Last Pushed: 2023-06-05T03:57:35.000Z (almost 2 years ago)
- Last Synced: 2024-03-25T21:54:34.573Z (about 1 year ago)
- Topics: arc, darwin, linux, lisp, lisp-1, macos, racket-lang, webapp
- Language: Arc
- Homepage: http://arclanguage.github.io
- Size: 3.41 MB
- Stars: 1,161
- Watchers: 70
- Forks: 167
- Open Issues: 25
-
Metadata Files:
- Readme: README.markdown
- Changelog: CHANGES/README
Awesome Lists containing this project
README
# Anarki [](https://github.com/arclanguage/anarki/actions/workflows/ci.yml)
## A publicly modifiable 'wiki-like' fork of [Arc Lisp](http://www.paulgraham.com/arc.html)
The intention is to be *extremely permissive* in accepting patches. For commit
privileges, just submit your first pull request or ask on [**Arc Language Forum**](http://arclanguage.org/forum).
## Getting started
### Installation
First [install **Racket** (v7.7 or later)](http://racket-lang.org), then in a terminal, run:
$ raco pkg install sha
$ git clone http://github.com/arclanguage/anarki
$ cd anarki
You can start the interactive repl with:
$ ./arc.sh
Or start news (and the repl) with:
$ cd apps/news
$ ./run-news
### Tutorial
If you're new to **Arc**, or **Lisp** in general, a good starting point is the [**Tutorial**](https://arclanguage.github.io/tut-anarki.html).
### Documentation and help
If you run into trouble, check
* [**Arc Language Forum**](http://arclanguage.org/forum)
* [**Arc Language Wiki**](http://sites.google.com/site/arclanguagewiki)
* [**Arc Language Documentation**]( https://arclanguage.github.io/ref)
* **Arc's built-in help system** by typing `(help)` at the repl
## News Site
**Anarki** comes bundled with **News**, a [**Hacker News**](https://news.ycombinator.com) style app.
### Admins
To run **News**, first pick your (the admin's) username,
$ cd anarki/apps/news
$ mkdir www
$ echo __username__ > www/admins
You can have multiple admins. Add them all to `www/admins`, separated by whitespace.
### Starting the server
**Warning**: *If you are already running a **News** site, migrating to this fork
might mess up your site's data. Come [talk to us](http://arclanguage.org/forum)
first, and be sure to make a backup before the migration.*
Now bring up the server,
$ ./run-news
There'll be a pause while the server loads up, with some messages, then you'll
see the `arc>` prompt.
Go to [http://localhost:8080](http://localhost:8080). Click on **login**, and
create the account for your username. You should now be logged in as an admin.
(Don't worry about `user break` or `error writing` messages.)
### Customization
To customize **News**, change the variables at the top of `apps/news/news.arc`. To change the port your server runs at, modify `apps/news/run-news.arc`.
Any interactive changes to the prompt will be reflected immediately in the server, without needing to restart it. Hence if you make any changes to `apps/news/news.arc`, you can load them, by typing `(load "apps/news/news.arc")` in the repl. If you stop the server or it dies for some reason, previously entered commands are available in the command history (at least if you have **Readline** installed).
### HTTPS
You may want to serve **News** securely over **HTTPS**. An example configuration for running **Nginx** with **SSL** as a reverse proxy for **News** can be found in `anarki/extras/news.nginx.conf`.
### Resetting passwords
For password reset mails to be sent out, your must set up an email account to send these from,
$ echo "[email protected]" > www/app-email ; email
$ echo "smtp.example.com" >> www/app-email ; smtp server
$ echo "[email protected]" >> www/app-email ; user
$ echo "1234" >> www/app-email ; password
## Development
### Tests
**Anarki** has thorough automated tests.
# start in the anarki directory
$ ./arc.sh
arc> (load "tests.arc")
**Anarki** is explicitly not constrained to maintain compatibility with upstream
releases, and compatibility status may swing wildly from commit to commit
depending on who takes an interest. To see a list of what's different, type
`(incompatibilities)` at the repl. If you make an incompatible change, please
update this list.
Anybody is welcome to make changes to Anarki, but please make sure the tests
continue to pass. Since we rely on the unit-test.arc test harness, please also
run its tests before committing any changes:
$ ./arc.sh
(require 'lib/unit-test.arc/unit-test.arc)
(load "unit-test.arc/tests.arc")
(test-and-error-on-failure)
### Racket interop
**Racket** expressions can be evaluated with the `($ ...)` syntax. For instance, `(($ crypto-random-bytes) 16)` obtains the `crypto-random-bytes` function from **Racket** and makes a call to it.
If you write lots of **Racket** code and you just want to use **Anarki** for part of a bigger project, you can `raco pkg install anarki` and use **Anarki** to write **Racket** modules:
#lang anarki
(:provide function-for-use-in-racket)
(= racket-import ($.dynamic-require ...))
(load "relative/path.arc")
(def utility-for-use-in-racket (x)
(* x (racket-import x))
#### Scope
Note that **Anarki** does not have private module scopes; the `(:provide ...)` section is just there to make it easy to `require` an **Anarki**-based library from **Racket**.
#### Keyword arguments
**Anarki** has some issues passing *keyword arguments* to **Racket** functions, but **Racket**'s `keyword-apply` can be used for that.