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 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
www.zopyx.com

Changelog

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

Project details


Download files

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

Source Distribution

xmldirector.connector-0.2.4.3.tar.gz (1.4 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page