Users who have contributed to this file

About GCLI

GCLI is a Graphical Command Line Interpreter.

GCLI is a command line for modern computers. When command lines were invented,
computers were resource-limited, disconnected systems with slow multi-tasking
and poor displays. The design of the Unix CLI made sense in 1970, but over 40
years on, considering the pace of change, there are many improvements we can
make.

CLIs generally suffer from poor discoverability; It's hard when faced with a
blank command line to work out what to do. As a result the majority of programs
today use purely graphical user interfaces, however in doing so, they lose some
of the benefits of CLIs. CLIs are still used because generally, in the hands of
a skilled user they are faster, and have a wider range of available options.

GCLI attempts to get the best of the GUI world and the CLI world to produce
something that is both easy to use and learn as well as fast and powerful.

GCLI has a type system to help ensure that users are inputting valid commands
and to enable us to provide sensible context sensitive help. GCLI provides
integration with JavaScript rather than being an alternative (like CoffeeScript).

History

GCLI was born as part of the
Bespin project and was
discussed at the time. The command line component
survived the rename of Bepsin to Skywriter and the merger with Ace, got a name
of it's own (Cockpit) which didn't last long before the project was named GCLI.
It is now being used in the Firefox's web console where it doesn't have a
separate identity but it's still called GCLI outside of Firefox. It is also
used in Eclipse Orion.

Environments

GCLI is designed to work in a number of environments:

As a component of Firefox developer tools.

As an adjunct to Orion/Ace and other online editors.

As a plugin to any web-page wishing to provide its own set of commands.

As part of a standalone web browser extension with it's own set of commands.

Accessibility

The command line uses TAB as a method of completing current input, this
prevents use of TAB for keyboard navigation. Instead of using TAB to move to
the next field you can use F6. In addition to F6, ALT+TAB, CTRL+TAB, META+TAB
make an attempt to move the focus on. How well this works depends on your
OS/browser combination.

Embedding GCLI

There are 3 basic steps in using GCLI in your system.

Import a GCLI JavaScript file.
For serious use of GCLI you are likely to be creating a custom build (see
below) however if you just want to have a quick play, you can use
gcli-uncompressed.js from the gh-pages branch of GCLI
Just place the following wherever you place your script files.

The createTerminal() function takes an options objects which allows
customization. At the current time the documentation of these object is left
to the source.

Backwards Compatibility

The goals of the GCLI project are:

Aim for very good backwards compatibility with code required from an
'index' module. This means we will not break code without a cycle of
deprecation warnings.

There are currently 3 'index' modules:

gcli/index (all you need to get started with GCLI)

demo/index (a number of demo commands)

gclitest/index (GCLI test suite)

Code from these modules uses the module pattern to prevent access to internal
functions, so in essence, if you can get to it from an index module, you
should be ok.

We try to avoid needless change to other modules, however we don't make any
promises, and don't provide a deprecation cycle.

Code from other modules uses classes rather than modules, so member variables
are exposed. Many classes mark private members using the _underscorePrefix
pattern. Particular care should be taken if access is needed to a private
member.

Creating Custom Builds

GCLI uses DryIce to create custom builds.
If dryice is installed (npm install .) then you can create a built
version of GCLI simply using node gcli.js standard. DryIce supplies a custom
module loader to replace RequireJS for built applications.

The build will be output to the built directory. The directory will be
created if it doesn't exist.