Metadata-Version: 1.0
Name: ro-manager
Version: 0.2.5
Summary: Research Object manager (command line tool)
Home-page: https://github.com/wf4ever/ro-manager
Author: Graham Klyne
Author-email: gk-pypi@ninebynine.org
License: MIT
Description: Research Object manager command line tool
        
        Research Objects are semantically rich aggregations of resources [1] that bring
        together data, methods and people in scientific investigations.  For further
        information, see:
        * What is an RO?
          - http://www.wf4ever-project.org/wiki/pages/viewpage.action?pageId=2065079 
        * Wf4Ever Research Object Model
          - http://wf4ever.github.com/ro/
        
        Research Object Manager (RO Manager) is a simple command line tool for creating and
        manipulating Research Objects in a local file system, and for exchanging them with a
        Research Object Digital Library (RODL):
        * http://www.wf4ever-project.org/wiki/display/docs/RO+management+tool
        * http://www.wf4ever-project.org/wiki/display/docs/RO+Manager+FAQ
        
        
        == Dependencies ==
        
        - Python 2.7.
        - Linux/Unix type system.
          This software has not been tested under Windows, but may work.
        - The sample scripts are written to run under BASH
        - Python pip utility, or git, depending on the installation option used.
        
        
        == Installation overview ==
        
        This is just a summary of the installation options.
        More detailed explanations can be found below.
        
        There are two main options for installation: the first is from the Python 
        Package Index (PyPI) which requires that the Python pip utility is installed:
        
          pip install ro-manager
          ro-manager-test
        
        The other option is to take a copy of the source code from GitHub, and install
        from that, which requires that the git source code management tool is
        installed:
        
          cd (some working directory)
          git clone https://github.com/wf4ever/ro-manager.git ro-manager
          cd ro-manager
          python setyp.by build
          python setup.py install
          ro-manager-test
        
        For further information on installing git on various systems, see:
        * http://git-scm.com/download
        * http://git-scm.com/book/en/Getting-Started-Installing-Git
        * http://www.devdaily.com/mac-os-x/how-install-git-mac-os-x-osx
        * https://help.ubuntu.com/community/Git
        
        For further information on installing pip on various systems, see:
        * http://stackoverflow.com/questions/4986896/
        * http://www.saltycrane.com/blog/2010/02/how-install-pip-ubuntu/
        * http://stackoverflow.com/questions/4750806/how-to-install-pip-on-windows
        
        Once pip is installed, it can be used to install virtualenv, if needed.
        
        
        == System-wide install from PyPI ==
        
        RO-manager can be installed from the Python Package Index (PyPI) using 'pip'.
        
        This is the simplest option for installing RO Manager, and does not require
        a copy of the RO Manager code be obtained from GitHub, but generally does
        require that you have root access on the computer where it is installed:
        
        Prerequisites are python 2.7 (http://python.org/download/releases/2.7/) and 
        pip (http://pypi.python.org/pypi/pip, http://www.pip-installer.org/).
        
        1. Install:
           
             sudo pip install ro-manager
        
           (You may be asked for a password to confirm root access privilege.)
        
        2. Test:
        
             ro-manager-test
             ro help
        
        
        == "Virtual environment" install from PyPI ==
        
        If you don't have root privileges, or if you want to create a temporary
        or local copy of the RO Manager installation, this can be done using the
        Python "virtual environment" facility.  The following assumes that Python
        "virtualenv" is installed (http://pypi.python.org/pypi/virtualenv),  This
        method does not require that a copy of RO Manager software be obtained
        from GitHub.  A disadvantage of this method is that the Python virtual
        environment must always be activated in order to run RO Manager.
        
        You will need to choose a working directory where the Python virtual 
        environment will be created.  We'll call this $RO_MANAGER.
        
        Prerequisites are python 2.7 (http://python.org/download/releases/2.7/),
        virtualenv (http://pypi.python.org/pypi/virtualenv) and 
        pip (http://pypi.python.org/pypi/pip, http://www.pip-installer.org/).
        
        1. Create and activate virtual environment:
        
             cd $RO_Manager
             virtualenv roenv
             source roenv/bin/activate
        
           To subsequently revert to the system default Python environment:
           
             deactivate
        
           To remove a temporary virtual environment, including any software
           that has been installed there:
        
             deactivate
             rm -rf $RO_MANAGER/roenv
        
        2. Install RO Manager:
        
             pip install ro-manager
        
        3. Test:
        
             ro-manager-test
             ro help
        
        
        == To install from GitHub ==
        
        RO Manager can also be installed using a copy of the software obtained
        from GitHub.  This may be advantageous if you need to access the most
        recent version of the software.  (The copy uploaded to PyPI may lag the
        development copy in GitHub.)
        
        Prerequisites are python 2.7 (http://python.org/download/releases/2.7/) and git (http://git-scm.com/).
        
        1. Obtain a copy of software from GitHub:
        
           In the first instance, the command used will be a "git clone ...":
        
           Choose a working directory where the RO Manager software will be
           stored:
        
             cd (working directory)
             git clone https://github.com/wf4ever/ro-manager.git ro-manager
             cd ro-manager
        
           The current working directory is now the $RO_MANAGER directory.
        
           To obtain subsequent updates, go into the ro-manager directory
           tree and use "git pull":
           
             cd $RO_MANAGER
             git pull
        
        2. (Optional) Use Python virtualenv to create and activate an environment
           for installing RO manager.  There are two advantages to doing this:
           (a) not needing root privileges to install ro-manager, and 
           (b) using a Python environment version different from the system default.
           The main disadvantage of using a new Python virtual environment is
           that it must be activated every time before RO Manager can be run.
        
             cd $RO_Manager
             virtualenv roenv
             source roenv/bin/activate
        
        3. Go to directory $RO_MANAGER/src
        
             cd $RO_MANAGER/src
        
        4. Build the installation package:
        
             python setup.py build
        
        5. Install the package and its dependencies
        
           If installing into a Python virtual environment:
        
             python setup.py install
           
           If *not* installing into a Python virtual environment, 
           this command must be run as root:
           
             sudo python setup.py install
           
        6. Test the installation
        
             ro-manager-test
        
           The following should be displayed:
        
             $ ro-manager-test 
             .......................................................................................................
             ----------------------------------------------------------------------
             Ran 103 tests in 13.406s
        
             OK
             $ 
        
        7. To run RO manager to display a summary of commands and options:
        
             ro help
        
        
        == Using RO Manager ==
        
        See also the documentation at http://www.wf4ever-project.org/wiki/display/docs/RO+management+tool
        
        Directory $RO_MANAGER/src/samples contains some bash shell scripts that are 
        examples for creating, annotating and displaying simple Research Objects.
        
        Note that the ro config command needs to be run to set up a 
        configuration for your environment, though it can be re-run to update 
        the details.  Most ro config values are currently ignored.  The important 
        value is -b <robase>, which indicates a disk area where Research Objects
        are managed.
        
        Look inside the file $RO_MANAGER/src/samples/ro_sample.sh to see what the 
        individual commands used look like.
        
        For example, to create and manipulate a simple example Research Object:
        
          cd $RO_MANAGER/src/samples
          ./ro_sample.sh
        
        The output should look something like this:
        
            $ ./ro_sample.sh 
            --------
            ro config -b /usr/workspace/wf4ever-ro-manager/src/rocommand/test/robase
                      -r http://calatola.man.poznan.pl/robox/dropbox_accounts/1/ro_containers/2
                      -p d41d8cd98f00b204e9800998ecf8427e
                      -u Test user -e testuser@example.org
            ro configuration written to /Users/graham
            --------
            mkdir: rocommand/test/robase/test-create-RO: File exists
            cp: /ro-test-1/*: No such file or directory
            ro create "Test Create RO" -d "rocommand/test/robase/test-create-RO" -i "RO-id-testCreate"
            ro status -d "rocommand/test/robase/test-create-RO"
            Research Object status
              identifier:  RO-id-testCreate, title: Test Create RO
              creator:     Test user, created: 2011-09-15T15:12:17
              path:        /usr/workspace/wf4ever-ro-manager/src/rocommand/test/robase/test-create-RO
              uri:         file:///usr/workspace/wf4ever-ro-manager/src/rocommand/test/robase/test-create-RO/#
              description: Test Create RO
            ro list -d "rocommand/test/robase/test-create-RO"
            test-create-RO/.ro/manifest.rdf
            test-create-RO/README-ro-test-1
            test-create-RO/subdir1/subdir1-file.txt
            test-create-RO/subdir2/subdir2-file.txt
            --------
            ro annotate rocommand/test/robase/test-create-RO/subdir1/subdir1-file.txt title "subdir1-file.txt title"
            ro annotations -d "rocommand/test/robase/test-create-RO/subdir1" rocommand/test/robase/test-create-RO/subdir1/subdir1-file.txt 
            file:///usr/workspace/wf4ever-ro-manager/src/rocommand/test/robase/test-create-RO/subdir1/subdir1-file.txt
              title: subdir1-file.txt title
            --------
            ro annotate rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt type "subdir2-file.txt type"
            ro annotate rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt keywords "subdir2-file.txt foo,bar"
            ro annotate rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt description "subdir2-file.txt description\nline 2"
            ro annotate rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt format "subdir2-file.txt format"
            ro annotate rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt title "subdir2-file.txt title"
            ro annotate rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt created "20110914T12:00:00"
            ro annotations -d "rocommand/test/robase/test-create-RO/subdir2" rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt 
            file:///usr/workspace/wf4ever-ro-manager/src/rocommand/test/robase/test-create-RO/subdir2/subdir2-file.txt
              type: subdir2-file.txt type
              title: subdir2-file.txt title
              format: subdir2-file.txt format
              keywords: subdir2-file.txt foo,bar
              created: 20110914T12:00:00
              description: subdir2-file.txt description\nline 2
            --------
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
