.. Space documentation master file, created by
   sphinx-quickstart on Thu Feb 28 12:56:59 2013.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Space: A Spacewalk CLI
======================

.. note::
    Keep in mind that this is a very early release, and is most likely buggy. If you encounter something, feel free to submit a pull request, or even just a ticket on Github.

    It should also be noted that there is no actual modules written yet, just the API wrapper and cli functionality.

Space is a command line interface, and python wrapper, which gives access to the Spacewalk/RHN api via python and the CLI.

Some of the tasks and queries performed via Spacewalk UI can be cumbersome, and time consuming, especially if you work with a fairly large implementation. Space helps ease the pain. 


::
    
    ~]$ space systems list -g test_group

If you don't wish to use the CLI, then all methods are available via the `swSession.call` method.

::

    from space.main import swSession

    sw = swSession(
        username='testuser',
        hostname='test.spacewalk.blah,
        password='password'
    )
    sw.login()
    sw.call('api method', arg, arg, arg)



User Guide
----------

This section will cover basic usage of this tool.

.. toctree::
   :maxdepth: 2

   ref/quickstart.rst
   ref/modules.rst



Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`