New Implementation of Pointless Programming Language Reference

A new implementation of the Pointless Programming Language Reference is underway!  Changes include the ability to edit the PLR as well as a new API for including the PLR in your own project or writing custom viewers/editors.

The system consists of 2 parts:

  1. A script that produces an XML representation of the database.
  2. A script that accepts <change/> snippets and applies them to the database

The database is stored as a git repository so all changes are tracked individually.  However due to a limitation of most free/low cost hosts that prevent shell access (for commands like ‘git commit’), changes must be written to a local file which is not under version control.  To get around this limitation all changes are also written to a change log file.  Periodically an off-site script downloads the change log, applies the changes to the git repo one-by-one, clears the change log and replaces the server version of the database with the updated version.

xml.py?languages
An xml file representing the contents of the database.  Other sites can use this to display the PLR in their site/application.  Use the languages parameter to restrict the xml to a subset of languages.

change.py?id&name&comment&code&links&add&language
A script that accepts change data and writes that data to the database.  The change is also written to a change log file.

** This implementation and API are still under active development and are subject to change at any time.  A small subset of this functionality is currently implemented, with the rest to come over the next few days.  Contributing via this API before it is stable is guaranteed to lead to lost data.  I will announce when the API is stable.

Advertisements