Skip to content
This repository has been archived by the owner on Aug 23, 2024. It is now read-only.

pantheon-systems/terminus-installer

Repository files navigation

terminus-installer : An installer script for Terminus, Pantheon's CLI

Status

Build Status Dependency Status Deprecated

About

This repository houses the source for and PHAR archive of the Terminus Installer script. Its goal is to provide a fail-proof installation method for users less familiar with manual installation methods such as Composer and Git, or those simply wanting a single-step process to get it running on their local machines.

Index

Component Description Notes
bin User-executable scripts
builds PHAR copies of the script
scripts Scripts for creating PHAR archives of the source and maintaining the source code
src Source code for the script
tests Tests for maintaining the codebase

Developing & Running

Running

Use the following line to install Terminus:

curl -O https://raw.githubusercontent.com/pantheon-systems/terminus-installer/master/builds/installer.phar && php installer.phar install

Developing

  1. Create an issue on this repository to discuss the change you propose should be made.
  2. Fork this repository.
  3. Clone the forked repository.
  4. Run composer install at the repository root directory to install all necessary dependencies.
  5. Make changes to the code.
  6. Run the test suite. The tests must pass before any code will be accepted.
  7. Commit your changes and push them up to your fork.
  8. Open a pull request on this repository to merge your fork.

Your pull request will be reviewed by Pantheon and changes may be requested before the code is accepted.

Debugging

No tips at present.

Known Issues/Limitations

  • If the bin directory is unavailable, Terminus cannot be automatically set up as a command. A symlink or an alias to the Terminus executable be made in either the ~/.bashrc or ~/.bash_profile files.

Runtime Dependencies

  • A command-line client
  • PHP
  • PHP-CLI
  • cURL

Runtime Configuration

There are options you can set to configure your installation.

  • --bin-dir=<dir> Where <dir> is the location of your bin directory. Defaults to /usr/local/bin.
  • --install-dir=<dir> Where <dir> is the directory to which you want Composer to install Terminus. If not given, Terminus will be installed to your current working directory.
  • --install-version=<version> Where <version> is any released version of Terminus. If not given, the latest version will be installed.

These can be used by adding them to the installer call from above like so:

curl -O https://raw.githubusercontent.com/pantheon-systems/terminus-installer/master/builds/installer.phar && php installer.phar install --install-version=1.2.3 --install-dir=/tmp/terminus

Testing

Tests are run via the .scripts/test.sh script. Components thereof can be run as follows:

  • composer cs runs the code sniffer to ensure all code is appropriately formatted.
  • composer phpunit runs the PHPUnit unit tests.
  • composer behat runs the Behat feature tests

Managing Third-Party Libraries

Dependencies are easily updated by Composer. To update this codebase:

  1. Check out a new branch off of an up-to-date copy of master.
  2. Run composer update at the repository root directory.
  3. Run the test suite. If there are errors, address them.
  4. Commit the changes, push the branch, and create a pull request for the update.

Deployment

New versions are automatically deployed once an update is accepted into the master branch.

About

Installer for Pantheon Terminus

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published