TryAPL: Difference between revisions
|Line 29:||Line 29:|
=== API ===
=== API ===
== In media ==
== In media ==
Revision as of 21:44, 27 June 2021
Since version 3.0, TryAPL's front end and back end are completely separate, with a very simple API, and no server-side state. This has enabled the community to develop their own interfaces to the back-end.
TryAPL.org is the original and main web interface for the back-end:
TryAPL Mini is an alternative web interface written in Elm, focusing on exploration of primitives. Half of the screen is used to display information about whichever glyph the user last hovered their mouse over on the built-in language bar.
Chat box exec
Chat box exec is a userscript that adds an Execute button (⍎) to right of the message input area in Stack Exchange's chat rooms. Clicking this button, or hitting access-key x, executes the first line of the text that is currently in the message input area, and appends the result to the area, while also formatting the message to be rendered in monospace font. One can then hit the send button or press Enter to submit the message. With a userscript extension (for example Tampermonkey) installed, navigating to the raw file, should cause the extension to suggest automated installation. Alternatively, the script can be downloaded from the userscripts GitHub repository of Razetime, or from the Greasyfork userscript host under the name Chat box exec.
Stack Exchange moderator "hyper-neutrino" hosts a chatbot using TryAPL's name and icon, active in two Stack Exchange chat rooms; the APL Orchard and the Stack Exchange's sandbox chat room. To use it, write inline code or a multi-line code block, and prepend
⋄ to lines you wish to run, in any of the two chat rooms:
TryAPL Bot is a Twitter bot run by Rodrigo Girão Serrão using TryAPL icon. It responds to tweets that mention it. To use it, post a tweet that contains the bot's handle (
@tryaplbot) and code in backticks, for example
`⍳3`. Multiple such code sections can be included in a single message, and assignments made in earlier ones are preserved for the later ones. Since tweets do not support any type of formatting, the bot responds with an image of an APL session where the requested code has been entered, and the result is shown. It also includes a link to try the expression on TryAPL.org and if the result is a single line that can fit in the tweet, it is included there too.
Requests to TryAPL's backend consist of submitting a POST request to https://tryapl.org/Exec containing a 4-element list
["state", size, "hash", "input"] where the first three elements can use the placeholder values
0. The server responds with a similar 4-element list
["state", size, "hash", ["lines", "of", "output"]]. The first three elements are kept on the front-end and sent back with the next request, or cleared to restart with default state.
If the output begins with a backspace character (U+08) then the actual output only begins after the second backspace character, and the text between the two backspace characters describes the role of the text. As 27 Jun 2021, only one tag has been implemented,
"\bhelp\b" for which the text is the URL of help page requested by
- Brian Becker: The Story of TryAPL.org at Dyalog '12
- Brian Becker and Adám Brudzewsky: Try APL Online at Dyalog '17
- Richard Park: TryAPL - The Next Generation webinar
TryAPL is frequently featured on Hacker News:
- June 10, 2012
- Sept 3, 2013
- June 24, 2015
- March 2, 2018
- Oct 3, 2018
- Feb 28, 2019
- March 28, 2019
- Aug 7, 2019
- Sep 11, 2020
- Oct 18, 2020
- Jun 10, 2021 (lots of comments)
On occasion, the server has been overwhelmed by the increased traffic, known as a hug of death.