Command line tools for Adapt

Adapt Command Line Interface

To install the Adapt CLI, first be sure to install NodeJS and git, then from the command line run:-

    npm install -g adapt-cli
adapt create {type} {path} [{branch}]

type - What to create. Only the value "course" is currently supported. path - The directory of the new course. branch - Optional - The branch of the framework to be downloaded.

For example...

adapt create course "My Course"

This will download the Adapt framework and create an new course in the directory "My Course", in your current directory.

adapt create component {name} [{branch}]

name - The name of the new component. branch - Optional - The branch of the component template to be downloaded. The default is master.

If you run this in an existing course, the component will be created in the src/components directory. Otherwise it will be created in the current directory.

adapt search {name or partial name of plugin to search for}
adapt install {name of plugin}

Additionally you can install a specific version of a plugin.

adapt install {name of plugin}#{version}

Anywhere that you are required to provide a name of a plugin it can be either fully qualified with 'adapt-' or optionally you can omit the prefix an just use the plugin name.

Therefore these commands are equivalent:

adapt install adapt-my-plugin
adapt install my-plugin

Installed plugins are saved to adapt.json.

adapt ls

This will display the installed plugins and the required version. * denotes that any version is permitted, this is the default.

adapt install
adapt uninstall {name of plugin}

The plugin system is powered by Bower. Each plugin should be a valid bower package and they should be registered with the Adapt registry.

See Developing plugins for more information on defining your plugins package.

From within a plugin directory

adapt register

name and repository will be read from bower.json in the current directory.

The package will be registered with the registry on a first come first serve basis.

Release History

  • 0.0.22 - Added the ls command.
  • 0.0.21 - Fixed an issue where the new slug library does not maintain case.
  • 0.0.19 - Removed slug library due to annoying python dependency, added create component command.
  • 0.0.18 - Fixed Issue #23
  • 0.0.17 - Added extra check current working directory for installing. See Issue #23
  • 0.0.16 - Improved download progress bar; fixed dependency of the download package to a fork to avoid version conflict with decompress package. This should be temporary until the conflict is resolved.
  • 0.0.15 - fixed Issue #22
  • 0.0.14 - fixed Issue #15
  • 0.0.13 - Added support for versions of plugins (#14) and --version command
  • 0.0.12 - fixed Issue #13
  • 0.0.11 - fixed Issue #12
  • 0.0.10 - fixed Issue #2 & #8
  • 0.0.9 - fixed Issue #7
  • 0.0.8 - Added 'create' command, fixed Issue #6
  • 0.0.7 - fixed Issue #3
  • 0.0.6 - Added 'register' command
  • 0.0.5 - Added adapt.json (dependency list)
  • 0.0.3 - Added uninstall command ...