Tree @rel_0_3_2014_0819 (Download .tar.gz)
yoob is a framework for implementing esoteric programming languages in Java. It aims to make it easy for a user to experiment with a large number of esolangs with a minimal install burden (i.e. in a Java applet), and to make it easy for designers to rapidly implement and showcase their esolangs.
See also: yoob.js.
yoob provides interfaces and base classes for components commonly used in the implementation of esolangs, including program states, playfields, and tapes. This allows one to implement an esolang, similar to existing esolangs, fairly rapidly.
yoob "understands" how to control, display, and animate an esolang, so long as it is implemented in a way that conforms to the interfaces that it provides. It uses this "understanding" to provide a graphical, interactive Java GUI (potentially in an applet) for developing in the language. It could also in theory provide other interfaces, such as a traditional command-line interface, to any yoob-conformant implementation.
A Note on Tapes
Tapes are depicted vertically, rotated 90 clockwise from the traditional horizontal orientation: the "left" of the tape is at the top of the display and the "right" of the tape is at the bottom. This is because in many esolangs, each tape cell may contain an unbounded integer, and in Arabic numeral notation, this takes up more horizontal area than vertical; thus displaying the tape vertically is a more efficient use of screen area.
The current released version of yoob is 0.3. There are a few minor UI improvements in this version, but the main enhancement is that example programs are modelled as proper Java objects, and they support being loaded from remote URLs. This allows esolang implementations which are under one license to have example programs which are under another license; this in turn allows a few esolang implementations (Ale, Sceql, Qdeql) to be released in this distribution without embedded (possibly non-public domain) example programs, thus keeping the whole distribution in the public domain.
The previous released version of yoob was 0.2. I decided to release it, in spite of the source being embarassingly bad, so that the masses might mock it, and perhaps, in their collective moment of weakness, submit patches, or at least actionable flames (note: actionable.)
Version 0.1 of yoob was purely a technology preview and was never officially released.
The API should not be expected to be stable through the 0.x series.
yoob development is hosted on Bitbucket:
Bugs may be reported (and features requested) on the Issue Tracker:
(Scavenged from some miscellaneous notes I made at one point. Not sure how much of this duplicates what's on the Issue Tracker.)
- Allow different alternate views to be selected between. (3)
- Actual error handling.
- Specify which example program to initially select on command line (1)
- A test harness, including specifying how many cycles to run and what playfields/tapes should look like afterwards and mocking I/O (5)
- Improve BasicStack to raise an exception or something on underflow.
- Allow PRNG to be seeded (not just seeded but supplied with a series of values to produce)
- Welcome panel - HTML doesn't cut it in some browsers (?)
- Document the policy for mutation of Playfields and Tapes and States and such. (?)
For Further Information
For further information, please see the yoob wiki on Bitbucket.
git clone https://git.catseye.tc/yoob/
- Incorporate Ypsilax and noit o' mnain worb into this repo. Chris Pressey 6 years ago
- I have to wonder what that was all about? This seems to work fine. Cat's Eye Technologies 6 years ago
- Do. Not. Store. Classfiles. in. Repository. Cat's Eye Technologies 6 years ago
- Rectify file permissions. catseye 7 years ago
- Add .fooignores, grab classfiles for jar maximally. catseye 7 years ago
- Support building a jar. Use the jar in the demo page. catseye 7 years ago
- Dist. org. guidelines: shows how yoob can be used, thus, in demo. catseye 7 years ago
- See also: yoob.js. catseye 7 years ago
- Add sample HTML page presenting the applet. catseye 7 years ago
- Add an UNLICENSE to drive home that it's in the public domain. catseye 7 years ago