Community-managed fork of the Arc dialect of Lisp; for commit privileges submit a pull request.
Arc Racket Perl Emacs Lisp Vim script Terra Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
CHANGES Add list comprehensions. Apr 25, 2018
extras Add help for Pd objects Dec 19, 2017
lang Make `anarki-main-namespace` a namespace, rather than a function that… Feb 21, 2018
lib Fix the ns.arc.t tests by refactoring ns.rkt into two separate files,… Aug 17, 2018
scribblings In the `anarki` Racket module, stop setting the readtable permanently… Feb 21, 2018
static Fix broken CSS. Fixes #105. Aug 12, 2018
.gitignore Write Scribble documentation for the `anarki` Racket module. Feb 21, 2018
.travis.yml Add Racket 7.0 to the build matrix. Aug 14, 2018
LICENSE Create LICENSE Oct 14, 2015
README.markdown Add a package dependency on the `sha` package. This should fix the Tr… Aug 13, 2018
ac.rkt Update the `arc-exec` comment so it will continue to make sense even … Aug 16, 2018
arc.arc Add a package dependency on the `sha` package. This should fix the Tr… Aug 13, 2018
arc.arc.t Remove one incompatibility with Arc 3.1. Apr 25, 2018
arc.cmd Handle paths with spaces on Windows. Jul 5, 2018
arc.sh Modified arc.sh for FreeBSD compatibility. Mar 4, 2018
boot.rkt Whoops, load the bracket readtable for the command line utilities again. Feb 21, 2018
brackets.rkt In the `anarki` Racket module, stop setting the readtable permanently… Feb 21, 2018
copyright arc0 Apr 12, 2009
info.rkt Add a package dependency on the `sha` package. This should fix the Tr… Aug 13, 2018
libs.arc Add list comprehensions. Apr 25, 2018
main.rkt In the `anarki` Racket module, stop setting the readtable permanently… Feb 21, 2018
old-tests.arc Prefer `require` to `load` for loading Arc libraries wherever reasona… Feb 21, 2018
run-news Clarify optional libs. Add -i command-line option. Nov 15, 2017
run-news.cmd Make the `.\run-news` command work on Windows again. Make the `.\arc`… Feb 18, 2018
run-recaptcha-test.cmd bugfixes for recaptcha implementation - still fails. Aug 2, 2018
tests.arc Fix the ns.arc.t tests by refactoring ns.rkt into two separate files,… Aug 17, 2018

README.markdown

Anarki Travis build

A publicly modifiable 'wiki-like' fork of Arc Lisp

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.

Getting started

Installation

First install Racket (v6.11 or later), then

$ raco pkg install sha
$ git clone http://github.com/arclanguage/anarki
$ cd anarki
$ ./arc.sh    # start the interactive repl
$ ./run-news  # or start News (also with the repl)

Tutorial

If you're new to Arc, or Lisp in general, a good starting point is the Arc Language Tutorial.

Documentation and help

If you run into trouble, check

News Site

Anarki comes bundled with News, a Hacker News style app.

Admins

To run News, first pick your (the admin's) username,

$ cd anarki
$ 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 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. 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 lib/news.arc. To change the port your server runs at, modify lib/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 lib/news.arc, you can load them, by typing (load "lib/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 "someone@example.com" > www/app-email  ; email
$ echo "smtp.example.com" >> www/app-email     ; smtp server
$ echo "someone@example.com" >> www/app-email  ; user
$ echo "1234" >> www/app-email                 ; password

Development

Tests

Anarki has thorough automated tests. To run them, install Mercurial, then,

# start in the anarki directory
$ hg clone https://bitbucket.org/zck/unit-test.arc
$ ./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.

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.