README

CommandLineLib3 is a simple-to-use PHP component that provides a high-quality command line parser via a fluid interface.

System-Wide Installation

CommandLineLib3 should be installed using the PEAR Installer. This installer is the PHP community's de-facto standard for installing PHP components.

sudo pear channel-discover pear.phix-project.org
sudo pear install --alldeps phix/CommandLineLib3

As A Dependency On Your Component

If you are creating a component that relies on CommandLineLib3, please make sure that you add CommandLineLib to your component's package.xml file:

<dependencies>
  <required>
    <package>
      <name>CommandLineLib3</name>
      <channel>pear.phix-project.org</channel>
      <min>3.0.0</min>
      <max>3.999.9999</max>
    </package>
  </required>
</dependencies>

Usage

The best documentation for CommandLineLib3 are the unit tests, which are shipped in the package. You will find them installed into your PEAR repository, which on Linux systems is normally /usr/share/php/test.

Development Environment

If you want to patch or enhance this component, you will need to create a suitable development environment. The easiest way to do that is to install phix4componentdev:

# phix4componentdev
sudo apt-get install php5-xdebug
sudo apt-get install php5-imagick
sudo pear channel-discover pear.phix-project.org
sudo pear -D auto_discover=1 install -Ba phix/phix4componentdev

You can then clone the git repository:

# CommandLineLib3
git clone git://github.com/stuartherbert/CommandLineLib.git

Then, install a local copy of this component's dependencies to complete the development environment:

# build vendor/ folder
phing build-vendor

To make life easier for you, common tasks (such as running unit tests, generating code review analytics, and creating the PEAR package) have been automated using phing. You'll find the automated steps inside the build.xml file that ships with the component.

Run the command 'phing' in the component's top-level folder to see the full list of available automated tasks.

License

See LICENSE.txt for full license details.