Metadata-Version: 1.1
Name: xmldirector.connector
Version: 0.4.0
Summary: xmldirector.connector supports mounting storages like S3, Webdav backend or local filesystem into Plone
Home-page: http://pypi.python.org/pypi/xmldirector.connector
Author: Andreas Jung
Author-email: info@zopyx.com
License: GPL
Description: xmldirector.connector
        =====================
        
        
        ``xmldirector.connector`` integrates  Plone 5 with 
        
        - local filesystem
        - WebDAV-backed backend
        - AWS S3
        - remote servers over SFTP/SSH
        
        ``xmldirector.connector`` provides a ``Connector`` content-type that
        mounts a particular storage into Plone. 
        
        No support for indexing and search mounted content.
        
        
        
        Requirements
        ------------
        
        - Plone 5.2 with Python 3.6 or higher (tested)
        
        - Supported backends:
        
            - eXist-db 
        
            - Base-X 
        
            - OwnCloud
            
            - Alfresco
        
            - Marklogic Server
        
            - AWS S3
        
            - Cloud federation services
        
              - Otixo.com
              - Storagemadeeasy.com
        
        
        Configuration
        -------------
        
        Goto the Plone control panel and click on the ``XML-Director Connector`` configlet and
        configure the your service
        
        ExistDB
        +++++++
          
        - `webdav://localhost:6080/existdb/webdav/db`
        - username and password required to access your XML database over WebDAV
        
        BaseX
        +++++
        
        - `webdav://localhost:8984/webdav`                                     
        - username and password required to access your XML database over WebDAV
        
        Owncloud
        ++++++++
        
        - `webdav://hostname:port/remote.php/webdav`
        - username and password required to access your Owncloud instance over WebDAV
        
        Alfresco
        ++++++++
        
        - `webdav://hostname:port/webdav`
        - username and password required to access your Alfresco instance over WebDAV
        
        Local filesystem
        ++++++++++++++++
        
        - `file:///path/to/some/directory`
        - no support for credentials, the referenced filesystem must be readable (and writable)
        
        AWS S3
        ++++++
            
        - `s3://bucketname`
        - enter your AWS access key as username and the AWS secret key as password
          (You need to install the Python package `fs-s3fs` through buildout).
        
        SSH/SFTP
        ++++++++
        
        - `ssh://hostname.com` or `sftp://hostname.com`
          (You need to install the Python package `fs.sshfs` through buildout).
        
        
        
        API notes
        +++++++++
        
        The implementation of `xmldirector.connector` is heavily backed by the PyFilesystem 2 API.
        Every `Connector` instance in Plone gives you access to the mounted storage through the 
        `handle = connector.get_handle()` call which is instance of `fs.base.FS`. Check
        https://docs.pyfilesystem.org for details.
        
        Compatiblity with rclone
        ------------------------
        
        An alternative to using native drivers under the hood, using `rclone`
        (https://rclone.org/) is meanwhile perhaps the better solution. `rclone` is an
        application (a commandline utility) to interact with up to 40 different storage
        systems out of the box. `rclone` also allows you to mount different storages
        directly into your filesystem (tested on Linux but supposed to work on Mac and
        Windows too).  So for example, you can mount your Dropbox and Google Drive
        storages into your local filesystem under `/mnt/dropbox` and `/mnt/drive` and
        point your connector instances to `file:///mnt/dropbox` and
        `file:///mnt/drive`.  So any interaction would happen through the filesystem
        driver of Pyfilesystem. The underlying communication with the Dropbox or Google
        Drive API would be handled by `rclone` under the hood.
        
        Security
        ++++++++
        
        The mounted storage gives you access to all contents inside the mounted
        subtree.  The mounted filesystem is sandboxed
        (https://docs.pyfilesystem.org/en/latest/concepts.html#sandboxing). So you can
        not escape and access content outside the mounted storage.
        
        Available drivers
        +++++++++++++++++
        
        Connectivity with other backend is accomplished through dedicated driverse that implementation
        the API layer between PyFilesystem 2 and the related backend. 
        See https://www.pyfilesystem.org/page/index-of-filesystems/ for all available drivers.
        
        License
        -------
        This package is published under the GNU Public License V2 (GPL 2)
        
        Source code
        -----------
        See https://bitbucket.org/onkopedia/xmldirector.connector
        
        Bugtracker
        ----------
        See https://bitbucket.org/onkopedia/xmldirector.connector
        
        
        Author
        ------
        | Andreas Jung/ZOPYX
        | Hundskapfklinge 33
        | D-72074 Tuebingen, Germany
        | info@zopyx.com
        | www.zopyx.com
        
        Changelog
        =========
        
        0.4.0 (2021-01-26)
        ------------------
        - updates JS resources
        - minor tweaks
        
        0.3.1 (2020-11-24)
        ------------------
        - uninstall profile added
        - fix for mod_dav issue when sorting entries (issue #64)
        
        0.3.0 (2020-11-04)
        ------------------
        - minor cleanup
        - removed Python 2 support
        - removed defusedxml dependency
        
        0.2.9 (2020-05-04)
        ------------------
        - added @@connector-zip-export functionality
        
        
        0.2.8 (2020-03-01)
        ------------------
        - fix for content-disposition header 
        
        0.2.5 (2020-02-05)
        ------------------
        - removed Python 3 support
        
        
        0.2.4 (2019-07-24)
        ------------------
        - Python 3 fix
        
        0.2.3 (2019-07-20)
        ------------------
        - fixed redirection upon remove
        
        0.2.2 (2019-07-20)
        ------------------
        - import fix for nested zip files 
        - updated to fs 2.4.8
        
        0.2.1 (2019-03-04)
        ------------------
        - restored Python 2.7 compatibility
        - Travis tests for Python 2.7
        
        0.2 (2019-02-20)
        ------------------
        - various fixes
        - various XML related backports
        
        0.1 (2018-12-14)
        ------------------
        - initial release
        
        
Keywords: XML Director exist-db basex owncloud alfresco existdb Plone XML Python WebDAV
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 5.2
Classifier: Framework :: Zope2
Classifier: Topic :: Software Development :: Libraries :: Python Modules
