Status of the APLTree library in 2018
{$author}, {$company}
{$date}
What is the APLTree library
- Started in 2009 as a collection of classes
- Solving every-day problems
- Lived on the APL wiki
Advantages
- Open source
- Used in real-life applications
- Well documented
- Come with exhaustive test cases
Examples
- High-level error trapping
- Powerful and flexible test framework
- Markdown-to-HTML5 converter
- Comparison utilities (fns, opr, scripts, workspaces)
- Reading and writing from / to the Windows Registry
- Instantiating INI files
- Communication between Windows Service Manager and an APL app
- Dealing with files and directories
- … (read: many more)
Status end of 2017
A collection of…
- classes
- workspaces
- applications
- user commands
A total mess!
The Changes
- Move from the APL wiki to GitHub
- Split into:
- APLTree
Just library classes:
- APL-cation
Applications and user commands:
New APLTree classes
- EventCodes
Provides symbolic names for all trappable event codes in Dyalog APL
Example: rather than code:
:Trap 1 2 3 4 5you may code
:Trap ##.EventCodes.(WS_FULL SYNTAX_ERROR INDEX_ERROR RANK_ERROR LENGTH_ERROR)
Major changes
- MarkAPL: supports LeanPub extensions
- Fire: simplification
New Applications
- Meddy – a Markdown editor
Cons:
- Pretty basic editor
Pros:
- Uses MarkAPL and therefore supports all MarkAPL features
- Offers a TreeView created from headers for navigation
- Allows injection of…
- parameters
- complex Markdown expressions
- Powerful “Find” and “Replace”
Start Meddy and demonstrate quickly what it can do, particularly…
- TOC (TreeView)
- Inject parameters
- Inject complex Markdown expressions
- LeanPub extensions
- Presentations
- Interrupt, trace through F5 and discuss
EventCodes
New User Commands
- CodeBrowser
- Takes a workspace or a namespace as input
- Creates a stand-alone HTML file from it that comprehends all the code
- Allows jumping around through links
- Allows hiding code blocks
- Under Windows it offers a GUI for parameter specification
- Markdown2HTML
- Takes names of Markdown files as input
- Creates HTML5 file(s) from that with MarkAPL
- Executable under program control
Demonstrate…
- CodeBrowser with -gui on
⎕SE - Markdown2HTML
Git - Pros
- Supports any workflow
- Vast documenation
- Extremely powerful
- Everybody seems to go for it
Git - Cons
- Supports any workflow
- Vast documenation (no groups, ordered alphabetically)
- Extremely powerful
Example: git blame
Why GitHub?
- Platform for saving (and accessing) releases
- Issue tracker
- Pull requests
- Wiki
- Project management
- Home pages for users and/or organizations
- Home pages for projects
- Tagging and searching
- Free (except for private projects)