Project Dependencies

Project Dependencies

This document lists the software you might need to run the software produced by Cat's Eye Technologies. This includes interpreters and compilers for the programming languages our projects are written in, the platforms or operating systems that they run on, and libraries and tools they might require when run.

It should be noted that The Cat's Eye Technologies Platform was started specifically to provide a platform where most all of Cat's Eye Technologies' software projects can run. Therefore this document may refer to that project in many places.

Some projects depend on technology which is, nowadays, considered "retrotechnology", and those project dependencies can be found in the Retrocomputing article instead of here.

Languages

ANSI C

Many of our C programs are written in C89, also colloquially known as "ANSI C". This is supported by many C compilers. Indeed, many C compilers understand an -ansi flag, as well as a -pedantic flag which makes them stick more closely to the letter of the ANSI C spec.

Some of our projects can be compiled as either ANSI C or C99. Often, ANSI C selectable by setting the environment variable ANSI to YES while running the build command (which is often make.)

C99

The disadvantage of ANSI C is that it defines only a very crude model of the world surrounding the program, and how the program can interact with it. For example, a program can sleep, but with coarse granularity; it cannot sleep for less than 1 second. Interfaces and extensions that were added to various vendors' C language since ANSI C were collected into a new standard called C99, which improved on this.

Telling a C compiler that it should treat its input files as C99 is often done with a flag such as -std=c99.

Some of our projects can be compiled as either C99 or ANSI C. Often, C99 is the default, and ANSI C, if desired. must be selected explicitly when building.

Perl

Our Perl projects are written in Perl 5. For more precise version numbers they have been tested on, see The Cat's Eye Technologies Platform.

Python

Our Python projects are written in Python 2.7. For more precise version numbers they have been tested on, see The Cat's Eye Technologies Platform.

Lua

Our Lua projects (barring any that may be in archived projects) are written in Lua 5.1 and tested with Lua 5.1.4.

Note that the 5.1.x series of Lua is not generally compatible with the 5.0.x series.

Scheme

Our Scheme projects are generally written in vanilla R5RS Scheme. Sometimes even R4RS Scheme. (And it should be noted that this is like saying "ATM Machine". But the alternatives all sound worse.) For more precise version numbers they have been tested on, see The Cat's Eye Technologies Platform.

Haskell

Haskell is a lazy functional language.

Some ancient links that still work:

Implementation: ghc

The Glasgow Haskell Compiler is dangerously close to being "the" implementation of Haskell.

It also has an interpreter, ghci.

Implementation: hugs

hugs is a Haskell interpreter. It's used in The Cat's Eye Technologies Platform because, being written in C, it builds on NetBSD. (Boostrapping ghci there would, I imagine, be quite cumbersome.)

Erlang

Our Erlang projects are written in Erlang R16 and tested with Erlang/OTP R16B03-1.

Note that this is a pretty old version of Erlang at this point.

Note that compiled Erlang modules are .beam files in the ebin directory. The source code lives in the src directory, and an Erlang compiler (such as the one which ships with Erlang/OTP) is required to build the modules.

Also note that the .beam files will have to be recompiled in order to run under recent versions (e.g. R13B) of Erlang/OTP, as the binary format has changed.

Also note there is a good chance that the sources will compile and run on an older version (say, R9C) of Erlang/OTP, but you may need to make some manual changes and system setup.

Bourne shell

We try to write our Bourne shell scripts to run on plain Bourne shell — nothing bash-specific. We try to test them on NetBSD for this purpose. As such, they run on the version of sh that ships with NetBSD 6 (which might be ash.) For more precise version numbers they have been tested on, see The Cat's Eye Technologies Platform.

NASM

In our projects, many of these NASM files were converted from older assembly-language sources written in the syntax of Turbo Assembler 3.1 (an old-school x86 assembler for MS-DOS, written by Borland.) In some cases the Turbo Assembler sources are still included in the project for historical interest, but the newer NASM sources are what the binaries should be built from.

Javascript

There is no implementation of Javascript bundled with The Cat's Eye Technologies Platform. Some of our Javascript scripts are "universal" and will run under nodejs, but we don't have a versioning plan for those yet. Most of our Javascript is intended to run in the browser and is simply kept reasonably up-to-date with current browsers. (At any given time, your mileage may of course vary.)

For laughs, here are some old Javascript links that still work:

Java

Our Java projects are, as far as I can recall, written in Java 1.6. They have not been tested recently, but when they were, it might have been under the Java SE 6 JDK 1.6.0.

An implementation of Java is not included with The Platform.

Generally, we're trying to migrate away from it. Etcha was originally written in Java, but it now has a second implementation in Javascript. (Whothm needs to go this way too.) yoob is written in Java, but I don't think any of our languages is implemented solely in yoob anymore.

Our few installations that are Java Applets have been converted into Java Web Start applications, since Java Applets are on the obsolescence track.

If you want to try installing a Java Runtime, you can apparently download a Java Runtime, after you have agreed to the "Oracle Binary Code License Agreement for Java SE".

Ruby

Some of our projects have some stuff written in Ruby — we implemented Thue in Ruby, and Castile can output Ruby — but nothing we've written relies on Ruby. (The original version of Velo was written in Ruby, but it was re-implemented in Lua.)

Therefore an implementation of Ruby is not included with The Platform.

But the Ruby things should run in Ruby 1.8 or 1.9 or thereabouts, which you could once have downloaded here if you agreed to this BSD-compatible license but apparently 1.9 is just too old and not maintained anymore.

Anyway, here is a fairly good Ruby tutorial.

Tools and Libraries

make

make is a tool for orchestrating builds.

Parsec

Parsec is a parser combinator library for Haskell.

realpath

realpath is a tool that reports the real, symbolic-link-free path for a filepath which may contain symbolic links.

I'm not sure if it's part of any standard, but it really should be, because it's very useful in scripts. It does come bundled with many Linux distributions, but not with NetBSD, so for The Platform, we wrote our own implementation in Python.

Interfaces

ANSI Terminal

When a project claims it needs this to run, it needs to run in a terminal which understand the ANSI terminal control codes (more formally known as "ECMA-48") in order for their output to be intelligible. Almost all modern consoles and terminal emulators understand these codes, sometimes under the guise of a particular terminal standard which includes them, such as vt100 or vt220. For older MS-DOS systems, a driver such as ANSI.SYS may need to be loaded.