Metadata-Version: 1.1
Name: eea.downloads
Version: 2.0
Summary: EEA Downloads Media Storage
Home-page: https://github.com/collective/eea.downloads
Author: European Environment Agency: IDM2 A-Team
Author-email: eea-edw-a-team-alerts@googlegroups.com
License: GPL version 2
Description: =============
        EEA Downloads
        =============
        .. image:: http://ci.eionet.europa.eu/job/eea/job/eea.downloads/job/master/badge/icon
          :target: http://ci.eionet.europa.eu/job/eea/job/eea.downloads/job/master/display/redirect
        
        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 Downloads (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
        =========
        
        2.0 - (2017-12-12)
        ------------------
        * Change: Replace eeacms/zptlint with eeacms/plone-test:4 zptlint
          [avoinea refs #90415]
        
        1.9 - (2017-11-07)
        ------------------
        * Change: Remove Sphinx generated documentation
          [petchesi-iulian refs #88212]
        
        1.8 - (2017-09-11)
        ------------------
        * Change: Possibility to register FS dirs from other projects
          [avoinea]
        
        1.7 - (2017-04-24)
        ------------------
        * Change: updated package information
          [eduard-fironda]
        
        1.6 - (2016-12-05)
        ------------------
        * Feature: added translations
          [irina-botez]
        
        1.5 - (2016-05-19)
        ------------------
        * Bug fix: Fix pylint warnings
          [chiridra refs #71940]
        
        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 Add-ons Plone Zope
Platform: UNKNOWN
Classifier: Framework :: Zope2
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Programming Language :: Zope
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
