Metadata-Version: 2.1
Name: linsharecli
Version: 1.1.1
Summary: LinShare command line interface.
Home-page: https://github.com/fred49/linshare-cli
Author: Frederic MARTIN
Author-email: frederic.martin.fma@gmail.com
License: GPL3
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
License-File: LICENSE.txt

linsharecli
============

Description
-----------

This package contains the [LinShare](http://linshare.org "Open Source secure
files sharing application") command line interface.

This module contains two scripts :

* linsharecli : the user cli.

  You can use this script to upload, download or delete documents stored in
  LinShare. 

* linshareadmcli : the admin cli.

  This script let you configure LinShare server through the command line.
  Domains, ldap connections, functionnalities, and more can be displayed or
  updated through this tool.

Installation
------------

You can install this module using : ``pip install linsharecli``.


QuickStart :
------------

``$ linsharecli.py --user myuser --host https://my.server.com/linshare -P password documents list``

If you want to use a configuration file to preset the server, your login or some
addditional parameters, you can generate the default configuration file like
this :

``$ linsharecli-config generate``

or for the admin script:

``$ linshareadmcli-config generate``


The configuration file, by default ~/.linshare-cli.cfg will  contains a section
called "server" :

 [server]

 # Attribute (str) : HOST

 ;host=



Each lines which begins with "#" or ";" are comments.
"str" is the type of data we are expecting, str for string, bool for boolean (true, false) or int for integer.
Every optional attributes, like host, are prefixed by ";".
Mandatory attributes are not prefixed.


Advanced usage :
----------------

You can have multiple configuration using multiple sections, ex:


[server-my-second-config]

# Attribute (str) : HOST

;host=


The you can use it through the -s option:

``$ linshareadmcli -s my-second-config domains list``

You can also list all available configurations using:

``$ linshareadmcli list``




