summaryrefslogtreecommitdiffstats
path: root/doc/index.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/index.rst')
-rw-r--r--doc/index.rst56
1 files changed, 56 insertions, 0 deletions
diff --git a/doc/index.rst b/doc/index.rst
new file mode 100644
index 0000000..2ff1263
--- /dev/null
+++ b/doc/index.rst
@@ -0,0 +1,56 @@
+libgfapi-python
+===============
+
+This is the official python bindings for `GlusterFS <http://www.gluster.org>`_
+libgfapi C library interface.
+
+Installation
+------------
+
+Install from source:
+
+.. code-block:: console
+
+ $ git clone https://review.gluster.org/libgfapi-python
+ $ cd libgfapi-python
+ $ sudo python setup.py install
+
+Example Usage
+-------------
+
+.. code-block:: python
+
+ from gluster import gfapi
+
+ # Create virtual mount
+ volume = gfapi.Volume('10.7.1.99', 'datavolume')
+ volume.mount()
+
+ # Create directory
+ volume.mkdir('dir1', 0755)
+
+ # List directories
+ volume.listdir('/')
+
+ # Create new file and write to it
+ with volume.fopen('somefile.txt', 'w+') as f:
+ f.write("Winter is coming.")
+
+ # Open and read file
+ with volume.fopen('somefile.txt', 'r') as f:
+ print f.read()
+
+ # Delete file
+ volume.unlink('somefile.txt')
+
+ # Unmount the volume
+ volume.unmount()
+
+
+API Reference
+-------------
+
+.. toctree::
+ :maxdepth: 2
+
+ api-reference