Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
It's All Text! Editor Daemon
branch: master

This branch is 88 commits behind docwhat:master

Failed to load latest commit information.
.settings Force resources to be NL UTF-8
extensions removed narfs, reformatted.
src
.classpath Store eclipse settings in git.
.fbprefs Store eclipse settings in git.
.gitignore Added the beginning of the JNLP stuff.
.project Store eclipse settings in git.
CREDITS.md Various development bits and bobs.
INSTALL
LICENSE.txt
README.md Improved the README
nb-configuration.xml Added style checker from maven to NetBeans
nbactions.xml
pom.xml Added the beginning of the JNLP stuff.
test.sh Fixed test.sh

README.md

It's All Text! Editor Daemon

This is a server that will open text data in the editor of your choice.

It is based on HTTP, so that it can be used in an ajax style by plugins (or conceivably web pages).

Bugs and Issues

See the github Issue tracker

Project Tracking

See the Pivotal Tracker for It's All Text!.

API

Ping

Verify that the server is running.

GET /ping

Returns the string pong.

Send a file to the editor

POST /edit requires auth-token.

Arguments:

extension : Extension for the file. text : The text. url : The URL for the text. id : The textarea id or identifier.

Returns a token or fail.

Retrieve the result of an edit

GET /edit/<token> requires auth-token.

Returns: document : If the document has changed. nochange : If the document hasn't changed. fail : If the token isn't valid or some other error has happened.

Open preferences

GET /preferences requires auth-token.

Returns ok or fail.

Authenticate/Token Exchange

GET /hello

Returns ok.

IATed pops up a dialog box saying that someone is trying to access IATed and has a 6 digit number to enter into the web browser to allow access. Similar to bluetooth connections.

GET /hello with auth=NNNNNN

If this is passed in, then the popup goes away and an auth-token is returned.

Example sessions.

The letter b: is the browser's requests. s: is the server's response. Side-effects are in square braces ([]).

Initial authentication

b: GET /hello
s: ok [a popup with a six digit number is shown]
b: GET /hello?auth=<NNNNNN>
s: auth-token=<MMMMMMMMMMMMMMMMM>

Editing session

b: POST /edit text=<textarea data> url=<someurl> id=<textarea-id>
s: <token>
b: GET /edit/<token>
s: nochange
b: GET /edit/<token>
s: <next textarea data>

Java Notes

JAX-RS

Using the Jersey implementation of JAX-RS. The API is in the java.ws.rs.* package.

Something went wrong with that request. Please try again.