Installing the Command-line Client
==================================

Each operating system has a different requirement to get ready for the command line tool.  Mostly these depend on the libxml2 and libxslt libraries.  Windows requires a binary package of RDFLib.

Installing the Command-line Client will also install all remaining dependencies (such as the
:term:`DataONE Common Library for Python` and the :term:`DataONE Client Library for Python`).

This documentation does not cover installing Python.

After installation, the client will be installed into the python scripts directory.  For example:

Ubuntu and MacOS: ::

  /usr/local/bin/dataone

Windows: ::

  C:\Apps\Python27\Scripts\dataone


Ubuntu
------

Ubuntu 10.04LTS uses Python 2.6 by default. ::

  $ sudo apt-get install python2.6-dev python-setuptools libxml2-dev libxslt-dev
  $ sudo easy_install DataONE_CommandLine

Ubuntu 12.04LTS uses Python 2.7 by default. ::

  $ sudo apt-get install python2.7-dev python-setuptools libxml2-dev libxslt-dev
  $ sudo easy_install DataONE_CommandLine

MacOS
-----

This has been tested on 10.6, 10.7, and 10.8. ::

  $ sudo env STATIC_DEPS=true easy_install --allow-hosts=lxml.de,*.python.org lxml==2.3.4
  $ sudo easy_install DataONE_CommandLine

Windows
-------

This has been tested on Windows 7 with Python 2.6 and Windows 8 (Developer's Preview) with Python 2.7.

This also requires the binary package of RDFLib (which is available from DataONE). ::

  C:\> easy_install "https://repository.dataone.org/software/python_products/d1_cli/rdflib-2.4.2-py2.7-win32.egg"
  C:\> easy_install DataONE_CommandLine
 
  
Alternative method: :term:`subversion`
--------------------------------------

The source code is available for the Common library, the Client library as well as
the Command-line client from the DataONE repository: ::

  $ svn co https://repository.dataone.org/software/cicore/tags/D1_COMMON_PYTHON_v1.0.1 d1_common_python
  $ svn co https://repository.dataone.org/software/cicore/tags/D1_LIBCLIENT_PYTHON_v1.0.1 d1_libclient_python
  $ svn co https://repository.dataone.org/software/cicore/tags/D1_CLIENT_CLI_v1.0.1 d1_client_cli

Perform whatever preparatory steps are required for your platform (see above).  Then, change into each directory
and install each package: ::

  $ cd d1_common_python
  $ python setup.py install --user
  $ cd ../d1_libclient_python
  $ python setup.py install --user
  $ cd ../d1_client_cli
  $ python setup.py install --user
  $ cd ..