The Ur/Web programming language
Standard ML UrWeb C Emacs Lisp JavaScript Lex Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Build Status

The Ur/Web Programming Language

Implementation of a domain-specific functional programming language for web applications. Please see the Ur/Web project web site for much more information! Here's a summary:

Ur is a programming language in the tradition of ML and Haskell, but featuring a significantly richer type system. Ur is functional, pure, statically typed, and strict. Ur supports a powerful kind of metaprogramming based on row types.

Ur/Web is Ur plus a special standard library and associated rules for parsing and optimization. Ur/Web supports construction of dynamic web applications backed by SQL databases. The signature of the standard library is such that well-typed Ur/Web programs "don't go wrong" in a very broad sense. Not only do they not crash during particular page generations, but they also may not:

  • Suffer from any kinds of code-injection attacks
  • Return invalid HTML
  • Contain dead intra-application links
  • Have mismatches between HTML forms and the fields expected by their handlers
  • Include client-side code that makes incorrect assumptions about the "AJAX"-style services that the remote web server provides
  • Attempt invalid SQL queries
  • Use improper marshaling or unmarshaling in communication with SQL databases or between browsers and web servers

This type safety is just the foundation of the Ur/Web methodology. It is also possible to use metaprogramming to build significant application pieces by analysis of type structure. For instance, the demo includes an ML-style functor for building an admin interface for an arbitrary SQL table. The type system guarantees that the admin interface sub-application that comes out will always be free of the above-listed bugs, no matter which well-typed table description is given as input.

The Ur/Web compiler also produces very efficient object code that does not use garbage collection. These compiled programs will often be even more efficient than what most programmers would bother to write in C. For example, the standalone web server generated for the demo uses less RAM than the bash shell. The compiler also generates JavaScript versions of client-side code, with no need to write those parts of applications in a different language.

Simple Invocation

Here's a simple example of compiling, running, and accessing an application included with the Ur/Web distribution.

urweb demo/hello
demo/hello.exe &
wget http://localhost:8080/Hello/main -O -

Simple Installation

The normal UNIX-style build and installation procedure works (where the make program needs to be GNU Make, and where ./autogen.sh must be run first only if starting from a Git checkout rather than a release tarball).

./configure
make
sudo make install

However, some popular platforms have standard packages for Ur/Web, making installation and uninstallation even easier.

In Debian, Ubuntu, and Other Related Linux Distributions

apt-get install urweb

In Homebrew for Mac OS

brew install urweb

For More Detail

See the reference manual. Links to packages for other platforms also appear on the project home page.