Googlecl

From DreamHost
Jump to: navigation, search
The instructions provided in this article or section are considered advanced.

You are expected to be knowledgeable in the UNIX shell.
Support for these instructions is not available from DreamHost tech support.
Server changes may cause this to break. Be prepared to troubleshoot this yourself if this happens.
We seriously aren't kidding about this.

The instructions provided in this article or section require shell access unless otherwise stated.

You can use the PuTTY client on Windows, or SSH on UNIX and UNIX-like systems such as Linux or Mac OS X.
Your account must be configured for shell access in the Control Panel.
More information may be available on the article's talk page.


Googlecl is a python-powered command line interface to many Google services. It is possible to install it on shared and virtual servers. Note: This tutorial assumes you are using bash, which is the default shell at DreamHost.

Downloading and extracting

Go to the googlecl downloads page, and find the latest tar.gz file (googlecl-0.9.10.tar.gz at the time of this writing). Issue the following commands:

 wget http://googlecl.googlecode.com/files/googlecl-0.9.10.tar.gz
 tar xzf googlecl-0.9.10.tar.gz

Installation

The googlecl installation process varies depending on which type of DreamHost you have.

Installation for a shared server user account

If you have standard (shared) DreamHost Service, the installation process will need to be followed for each user you need. First, create the directories that are needed for the installation and use of googlecl:

mkdir $HOME/lib
mkdir $HOME/lib/python
mkdir $HOME/.config
mkdir $HOME/.config/googlecl
mkdir $HOME/bin

Then, use a command line text editor like nano to add the following lines to $HOME/.bash_profile:

export PYTHONPATH="$HOME/lib/python"
PATH=$PATH:$HOME/bin
export PATH

Exit SSH and log back in so your changes to $HOME/.bash_profile can take affect. Then cd to the googlecl directory like so:

cd googlecl-0.9.10

Finally, run the setup script:

python setup.py install --home=~

Installation on a VPS

Installation on a VPS is easier by far. Simply issue the fallowing commands from a VPS admin account:

cd googlecl-0.9.10
sudo python setup.py install

Googlecl will be installed for all of the users on your system.

Note: Each user will still need to create the proper directories so that googlecl will have a place to store it's settings.

mkdir $HOME/.config
mkdir $HOME/.config/googlecl

Testing

Use the googlecl example scripts to test your installation.

See also

External links

The googlecl project
The install page from the googlecl wiki
The manual page from the googlecl wiki