Metadata-Version: 2.1
Name: Products.TemporaryFolder
Version: 6.0
Summary: Zope temporary folder support.
Home-page: https://github.com/zopefoundation/Products.TemporaryFolder
Author: Zope Foundation and Contributors
Author-email: zope-dev@zope.org
License: ZPL 2.1
Project-URL: Issue Tracker, https://github.com/zopefoundation/Products.TemporaryFolder/issues
Project-URL: Sources, https://github.com/zopefoundation/Products.TemporaryFolder
Keywords: Zope ZODB temporary storage folder
Platform: UNKNOWN
Classifier: Development Status :: 7 - Inactive
Classifier: Environment :: Web Environment
Classifier: Framework :: Zope :: 4
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
Requires-Dist: setuptools
Requires-Dist: AccessControl
Requires-Dist: Acquisition
Requires-Dist: six
Requires-Dist: tempstorage
Requires-Dist: Products.ZODBMountPoint
Requires-Dist: ZODB
Requires-Dist: Zope (>=4.0b5)

.. image:: https://travis-ci.org/zopefoundation/Products.TemporaryFolder.svg?branch=master
   :target: https://travis-ci.org/zopefoundation/Products.TemporaryFolder

.. image:: https://coveralls.io/repos/github/zopefoundation/Products.TemporaryFolder/badge.svg?branch=master
   :target: https://coveralls.io/github/zopefoundation/Products.TemporaryFolder?branch=master

.. image:: https://img.shields.io/pypi/v/Products.TemporaryFolder.svg
   :target: https://pypi.org/project/Products.TemporaryFolder/
   :alt: Current version on PyPI

.. image:: https://img.shields.io/pypi/pyversions/Products.TemporaryFolder.svg
   :target: https://pypi.org/project/Products.TemporaryFolder/
   :alt: Supported Python versions

Overview
========

Zope temporary storage / folder support.


Please note
-----------
`Temporary Folders` and the `temporarystorage` ZODB storage depend on
the ``tempstorage`` package, which is known to randomly lose data under Zope
4 and up. If you want to use the sessioning support in Zope please visit
https://zope.readthedocs.io/en/latest/zopebook/Sessions.html#alternative-server-side-session-backends-for-zope-4
for alternate sessioning implementations that don't use `Temporary Folder`.

Because it is unsafe, Zope will no longer magically create a
`Temporary Folder` object at ``/temp_folder``. If you think you still need a 
`Temporary Folder`, please add a temporary storage database definition like
the one below to your Zope configuration, restart Zope, and use the ZMI add
list to create an object of type `ZODB Mount Point`. If the storage
configuration is valid you will see a list of configured mount points and the
option to create the container in the ZODB::

  <zodb_db temporary>
      <temporarystorage>
        name Temporary database (for sessions)
      </temporarystorage>
      mount-point /temp_folder
      container-class Products.TemporaryFolder.TemporaryContainer
  </zodb_db>

Changelog
=========

6.0 (2020-09-01)
----------------

- split ``Products.ZODBMountPoint`` into separate package
  and removed all code that automatically instatiates a temporary
  folder and sessioning artifacts on Zope startup.
  (`#12
  <https://github.com/zopefoundation/Products.TemporaryFolder/issues/12>`_)


5.3 (2019-04-15)
----------------

- improve the README

- Specify supported Python versions using ``python_requires`` in setup.py
  (`Zope#481 <https://github.com/zopefoundation/Zope/issues/481>`_)

- Added support for Python 3.8


5.2 (2018-11-06)
----------------

- Add support for Python 3.7.

- Update forms to Bootstrap ZMI.
  (`#6 <https://github.com/zopefoundation/Products.TemporaryFolder/pull/6>`_)

- Fix logging traceback in Python 2.
  [pbauer]

- Fix creating a temp_folder in Python 2.
  (`#7 <https://github.com/zopefoundation/Products.TemporaryFolder/pull/7>`_)


5.1 (2018-06-06)
----------------

- Bring back Application initialization (creation of BrowserIdManager and
  SessionDataManager in the ZODB on first startup).
  This release requires Zope >= 4.0b5.

- Drop support for Python 3.4.


5.0 (2018-04-13)
----------------

- Remove dysfunctional LowConflictConnection.

- Add support for Python 3.4, 3.5 and 3.6.

4.0 (2016-08-02)
----------------

- Add in code of `Products.TemporaryFolder` and `Products.ZODBMountPoint`.

- Require `Zope >= 4`.

3.0 (2016-08-02)
----------------

- Create a separate distribution called `Products.TemporaryFolder` without
  any code inside it. This allows projects to depend on this project
  inside the Zope 2.13 release line.



