Skip to content
Gabriel Weaver edited this page Mar 20, 2017 · 5 revisions

( Home | Documentation | News | Blog )

XUTools: eXTended UNIX Text-Processing Tools - Documentation

Install XUTools

Prerequisites

Installation (Windows 7)

First, we are going to install the prerequisites.

  • Install Python.
  • Open the command prompt. If you have installed Python at the default location, then add Python to the path: PATH C:\Python27;%PATH%
  • Unzip the Pyparsing file to extract the pyparsing-1.5.6 directory. From within this directory, run python setup.py install.
  • Double click on the Numpy installer

Now, we are ready to install XUTools

  • Download XUTools
  • Unzip the zip file
  • For notation purposes, let XUTOOLS_HOME denote the unzipped XUTools directory.
    You can move XUTOOLS_HOME to somewhere that you want to install XUTOOLS.
  • ``C:> cd $XUTOOLS_HOME
  • Run the test suite: python .src\run_test_suite.py. All of the test cases should pass. Currently, you should see a some output that corresponds to visual verification of behavior. This is bad test writing and will be fixed.
  • Add xutools to the path. PATH C:\XUTOOLS_HOME\src\xutools\cmd;%PATH%
  • Add the xutools modules to PYTHONPATH. C:> set PYTHONPATH=%PYTHONPATH%;C:\XUTOOLS_HOME\src
  • Try some of the usage EXAMPLES for xugrep(1), xuwc(1), and xudiff(1). Please note that the example data files reside in XUTOOLS_HOME.
  • You are ready to go! Stay tuned for more.

Installation (OS X/Linux)

  • Download XUTools
  • Unzip the zip file if OS X does not do so for you automatically.
  • For notation purposes, let XUTOOLS_HOME denote the unzipped XUTools directory. You can move XUTOOLS_HOME to somewhere that you want to install XUTOOLS (/usr/local/)
  • $ cd XUTOOLS_HOME
  • $ make test. All of the test cases should pass.
  • source config/xutools.env
  • Try some of the usage EXAMPLES for xugrep(1), xuwc(1), and xudiff(1). Please note that the example data files reside in XUTOOLS_HOME.
  • You are ready to go! Stay tuned for more.

Creative Commons License
XUTools Wiki by Gabriel A. Weaver is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.