Skip to content

eschulte/emacs-web-server

Folders and files

NameName
Last commit message
Last commit date
Mar 12, 2020
Feb 17, 2014
Mar 10, 2014
Mar 10, 2014
Feb 17, 2014
Dec 18, 2013
Feb 17, 2014
May 7, 2014
Sep 6, 2014
Jul 8, 2021
Jul 8, 2021
Feb 9, 2021

Repository files navigation

                           Emacs Web Server

DESCRIPTION
    A web server in Emacs running handlers written in Emacs Lisp.

REQUIREMENTS
    Emacs 24.3 or later.

STATUS
    Supports HTTP GET and POST requests including URL-encoded
    parameters, multipart/form data and file uploads.  Supports web
    sockets.  Reasonably performant, faster than Elnode [1].  This is
    a new project without much extended use so there are likely bugs
    and potentially security issues.  That said it consists of little
    more than HTTP header parsing logic perched atop Emacs' existing
    network process primitives, so it should be fairly robust.

    [1]  http://eschulte.github.io/emacs-web-server/benchmark/

USAGE
    See the examples/ directory in this repository for examples
    demonstrating usage.  The Emacs web-server is also used to run a
    paste server [2], serve editable Org-mode pages [3] and serve
    files for Cask [4].

    [2]  https://github.com/eschulte/el-sprunge
    [3]  https://github.com/eschulte/org-ehtml
    [4]  https://github.com/cask/cask

    Available from the GNU ELPA [5].  The tutorials page [6] walks
    through usage scenarios including installing the Emacs web-server
    and running it behind a proxy.

    [5]  http://elpa.gnu.org/
    [6]  http://eschulte.github.io/emacs-web-server/tutorials/

    Run `make check' to run the included test suite.

DOCUMENTATION
    Run `make doc' to build the texinfo documentation, also available
    online [6].

    [6]  http://eschulte.github.io/emacs-web-server