Metadata-Version: 1.1
Name: eea.downloads
Version: 1.4
Summary: EEA Downloads Media Storage
Home-page: http://eea.github.io
Author: European Environment Agency
Author-email: webadmin@eea.europa.eu
License: GPL version 2
Description: =============
        EEA Downloads
        =============
        .. image:: http://ci.eionet.europa.eu/job/eea.downloads-www/badge/icon
          :target: http://ci.eionet.europa.eu/job/eea.downloads-www/lastBuild
        .. image:: http://ci.eionet.europa.eu/job/eea.downloads-plone4/badge/icon
          :target: http://ci.eionet.europa.eu/job/eea.downloads-plone4/lastBuild
        
        EEA Downloads (Media Storage) mounts a file-system directory within ZODB
        
        Contents
        ========
        
        .. contents::
        
        Main features
        =============
        
        1. Mounts a file-system directory within ZODB
        
        Install
        =======
        
        - Within your buildout define environment-vars per instance::
        
            [instance]
            environment-vars +=
              EEADOWNLOADS_NAME downloads
              EEADOWNLOADS_PATH ${buildout:directory}/var/downloads
        
        
        - Make sure that registered file-system directory exists and the
          zope effective-user has read access there::
        
            $ mkdir -p var/downloads
        
        - Add eea.downloads to your eggs section in your buildout and re-run buildout::
        
            [instance]
            eggs +=
              eea.downloads
            zcml +=
              eea.downloads
        
        - You can download a sample buildout from
          https://github.com/eea/eea.downloads/tree/master/buildouts/plone4
        - Install eea.downloads within Site Setup > Add-ons
        
        Getting started
        ===============
        
        1. Login to ZMI
        2. Navigate to Plone > downloads
        
        Storage adapter
        ===============
        This package defines a storage interface IStorage that you can use to get
        generated files system paths and Plone related URLs.
        Default strategy of storing files is::
        
            EEADOWNLOADS_PATH / UID / MODIFIED / ID.EXTENSION
        
        Here is an example::
        
            >>> from eea.downloads.interfaces import IStorage
            >>> store = IStorage(context).of('pdf')
            >>> store.filepath()
            '/opt/downloads/uid-21323e2321312/3213213/context-id.pdf'
        
            >>> store.absolute_url()
            'http://localhost:8080/Plone/downloads/uid-21323e2321312/3213213/context-id.pdf'
        
        You can always provide a custom IStorage adapter for your Zope objects if you
        need other file-system storage layout.
        
        Dependencies
        ============
        
        1. `Products.CMFCore`_
        2. `collective.monkeypatcher`_
        
        Source code
        ===========
        
        - Latest source code (Plone 4 compatible):
          https://github.com/eea/eea.downloads
        
        
        Copyright and license
        =====================
        The Initial Owner of the Original Code is European Environment Agency (EEA).
        All Rights Reserved.
        
        The EEA Progress Bar (the Original Code) is free software;
        you can redistribute it and/or modify it under the terms of the GNU
        General Public License as published by the Free Software Foundation;
        either version 2 of the License, or (at your option) any later
        version.
        
        More details under docs/License.txt
        
        
        Funding
        =======
        
        EEA_ - European Environment Agency (EU)
        
        .. _EEA: http://www.eea.europa.eu/
        .. _`collective.monkeypatcher`: http://pypi.python.org/pypi/collective.monkeypatcher
        .. _`Products.CMFCore`: http://pypi.python.org/pypi/Products.CMFCore
        
        Changelog
        =========
        
        1.4 - (2016-03-31)
        ------------------
        * Bug fix: Fix Plone 4 buildout install.sh permissions
          [avoinea]
        
        1.3 - (2016-03-31)
        ------------------
        * Bug fix: Warn if EEADOWNLOADS_PATH is not set and fallback to CLIENT_HOME/tmp
          instead of crashing entire application
          [avoinea]
        * Bug fix: Warn if EEADOWNLOADS_NAME is not set and fallback to CLIENT_HOME/tmp
          instead of crashing entire application
          [avoinea]
        
        1.2 - (2015-03-17)
        ------------------
        * Change: Switched to curl in the jenkins build install script
          [olimpiurob refs #22402]
        * Change: Changed fetch url for jenkins build install script to the install
          script from the main EEA CPB repository
          [olimpiurob refs #22402]
        
        1.1 - (2014-10-01)
        ------------------
        * Feature: registered .lock files for the "Filesystem Directory View"
          [ghicaale refs #20972]
        
        1.0 - (2014-09-15)
        ------------------
        * Upgrade step: Within "Plone > Site setup > Add-ons" install EEA Downloads
          [voineali refs #20677]
        * Pre-upgrade step: Make sure that the folder defined within EEADOWNLOADS_PATH
          exists on disk and Zope effective-user has read and write access within it.
          If you use ZEO and have more that one Zope instance, this folder should be
          shared for all Zope instances.
          [voineali refs #20677]
        * Pre-upgrade step: Within your buildout define environment-vars per instance:
          EEADOWNLOADS_NAME and EEADOWNLOADS_PATH
          [voineali refs #20677]
        
        
Keywords: eea zope plone python
Platform: UNKNOWN
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Programming Language :: Zope
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: License :: OSI Approved :: Mozilla Public License 1.0 (MPL)
