Skip to main content

xmldirector.connector supports mounting storages like S3, Webdav backend or local filesystem into Plone

Project 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 2.7 and Python 3.6 (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.

Security

The mounted storage gives you access to all contents inside the mounted subtree. The mount is sandboxes (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)

Author

Andreas Jung/ZOPYX
Hundskapfklinge 33
D-72074 Tuebingen, Germany
www.zopyx.com

Changelog

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
xmldirector.connector-0.2.1.zip (1.7 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page