-
Notifications
You must be signed in to change notification settings - Fork 33
State of the art
This page outlines the state of the Red Spider Project at the time of the last update. Check out the network graph for a complete visual summary of all recent commits and the issue list for a complete overview of all unresolved issues.
Last update: 3. November 2013
Since the start of the project, about 17 people have contributed in one way or another. More than twice that many people have expressed interest, for example by forking the project or by posting to our forum thread. During busy periods, like now, five or more people may be actively contributing at the same time.
Apart from code, project members have created and maintained documentation (including this wiki), artwork, i.e. our logo and thee candidates for an ASCII art mascot, and the IRC channel. The forum thread is also still available as a communication channel.
Our infrastructure partly consists of GitHub and partly of our own code. GitHub provides the source code management, the issue tracker and the wiki. Our own programs (in particular setup.py, rsshell and rshelp) take care of configuration, installation, online documentation and of course the Red Spider enviroment itself.
There is still enough room for improvement in our documentation and infrastructure.
These programs are directly available for use when you get started:
Main article: setup.py
For an installation guide, see Getting started.
This is the installation script, which creates a few additional folders within the project root, copies some files and makes some additions to the user configuration. These steps enable the operation of rsshell (see below). Together, setup.py and rsshell make up most of the infrastructure of the project.
Currently setup.py can only "install" interpreted scripts because there hasn't been a need yet for installing compiled languages. Big changes are planned which should make the installation procedure a lot more general (see section "Plans" below).
Main article: rsshell
Initially known as "the first command", this shell wrapper creates a suitable environment for other Red Spider software to operate in. Inside rsshell you can run any installed Red Spider command by just typing its name. The environment that rsshell creates ensures that the programs can find all their stuff even if your working directory happens to be at the other end of the filesystem. In other words, this is your portal into the "Red Spider world".
rsshell itself can always be run regardless of your working directory, thanks to setup.py.
Without arguments, this command gives you a list of available commands. This list is also shown when you start rsshell. With an argument it will look for corresponding documentation, first in /doc (see Project directory overview) and then in an internal list of commands that can print their own documentation. So you can do the following:
rshelp rshelp # explains rshelp, taken from /doc rshelp xkcd-fetch # explains xkcd-fetch, produced by running xkcd-fetch -h rshelp json-parse # tells you that there is no documentation available
You can document anything you want by placing a file about it in /doc, not just commands. So for example if you place a file named beer.txt in /doc, rshelp beer will reproduce what you've written about beer.
As the name suggests, this command fetches xkcd comics with their metadata from the web and caches them on your hard drive. It can also print the metadata for a given comic in your terminal. Note that the program will wait for input (and may hence seem to run forever if you don't enter anything) unless you pass the -n flag. Run xkcd-fetch -h for a short manual.
xkcd-fetch is also work in progress; see the milestone "Overhaul xkcd-fetch".
This command uses the cache from xkcd-fetch to search for xkcd comics that match a given regular expression (it does not download new data). The numbers of the comics that match the search expression are printed on stdout.
This is a tool for quickly inspecting JSON data from the command line. It's a bit technical but can be very useful. Run rshelp json-parse for an explanation.
Calculates your RPG-style "level" in a programming language based on the number of lines of code you've written. When you first start using it, choose a directory where you'll keep track of your progress and run level_up -i <directory>. After that, every time you add code to the directory you can just run level_up. The program will display a popup if you moved a level up.
Testing is provided in test/level_up and a short usage message is shown if you run level_up -h.
A very simple command for "summoning" files, which wraps the OS' builtin command for opening files from the command line in their default associated program. You can give it any number of paths and URLs and it will launch all of them.
A fun command that displays random quotes from the xkcd IRC channel. It manages an offline cache for when you have no internet connection. Run with the -h option for a quick manual.
Applies Gödel numbering to translate numbers into formulas and vice versa. Call without arguments for an explanation.
This program returns a random number that was determined with a fair dice roll, like in comic 221. There's not much to explain about this command.
The following commands were pushed to GitHub but haven't been merged into master yet:
An adventure shell, letting you explore the file system as if you were playing a text adventure.
Related issue: #37.
Also an adventure game, but browsing the web instead.
Branch: zed0/advbrowser.
Related issue: #36.
A Markov chain random text generator.
Old branch: ovvy/rtext.
Help request: #49.
New branch: jgonggrijp/rtext.
Request to pull new branch into old branch: ovvy/#1.
An ASCII art generator that takes a random image from a given directory.
Branch: ovvy/rascii.
Help request: #49.
Changes the wallpaper to an xkcd comic of your choosing under Windows.
The first challenge is to add instructions so that other people can build the application using just the source from GitHub. The next challenge is to have it automatically installed by setup.py (only on Windows). In addition it would be nice if the app could rely on the database of xkcd-fetch (see above). The final challenge is to make it work on Mac OS X and Linux as well.
Branch: BRNMan/master.
Help request: #50.
The "Game of Spiders", a Conway's Game of Life clone that offers two species (colors) instead of one and that lets you pick from several universe topologies. See this post and this post for more information.
It currently only works under Windows.
Branch: xen-0/game-of-spiders.
Related issue: #24.
A convenience command for hackers that automatically deals with the boilerplate needed to start a new topic branch. This command is still in its infancy.
Request issue: #35.
Branch: JonETMeans/creto.
Pull request: #42.
Help request: #51.
A humorous text game where you are challenged to survive the raptor apocalypse. Development only just started out.
Branch: WesleyAC/raptorgame.
An insurance savings calculator directly inspired by http://xkcd.com/42.
Branch: rytonbay/master.
Pull request: #54.
Several participants have expressed intentions to work on various aspects of the project. The list below is not meant to be exhaustive.
- Develop a proper build system based on CMake, in order to use it as a backend for setup.py. See issue #33 and the associated milestone.
- Make setup.py create configuration files for use with rsshell. This should add a lot of flexibility and open up new possibilities. See issue #31.
- Create an RPG-style variant of rsshell that communicates with existing games such as advshell and level_up. (FireRogue, still orienting)