Metadata-Version: 2.1
Name: Products.TemporaryFolder
Version: 7.0
Summary: Zope temporary folder support.
Home-page: https://github.com/zopefoundation/Products.TemporaryFolder
Author: Zope Foundation and Contributors
Author-email: zope-dev@zope.dev
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
Classifier: Development Status :: 6 - Mature
Classifier: Environment :: Web Environment
Classifier: Framework :: Zope
Classifier: Framework :: Zope :: 5
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.7
License-File: LICENSE.txt
Requires-Dist: setuptools
Requires-Dist: AccessControl
Requires-Dist: Acquisition
Requires-Dist: tempstorage (>=5.2)
Requires-Dist: Products.ZODBMountPoint
Requires-Dist: ZODB
Requires-Dist: Zope (>=4.0b5)

.. image:: https://github.com/zopefoundation/Products.TemporaryFolder/actions/workflows/tests.yml/badge.svg
        :target: https://github.com/zopefoundation/Products.TemporaryFolder/actions/workflows/tests.yml

.. 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
-----------
Before release 5.2 of the ``tempstorage`` package sessioning configurations
using this temporary folder implementation were discouraged because the
temporary storage backend could lose data. This is no longer the case.

Don't forget to add or uncomment the temporary storage database definition
as shown below in your Zope configuration if you want to instantiate a
temporary folder. After a Zope restart, visit the Zope Management Interface
and select ZODB Mount Point from the list of addable items to activate the
temporary folder mount point::

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

When upgrading from version 5.3 to 6.0 and removing the ZODB Mount Point
configuration shown above from your Zope configuration you need to manually
delete the ``/temp_folder`` object in the ZMI before restarting your Zope
instance with version 6.0. If you see tracebacks
``ZConfig.ConfigurationError: No database configured for mount point at
/temp_folder`` after the upgrade, please reinstate the ``zodb_db temporary``
Zope configuration as shown above, restart Zope and manually delete
``/temp_folder``. Then remove the ``zodb_db temporary`` configuration and
restart Zope.

Changelog
=========

7.0 (2023-02-01)
----------------

- Drop support for Python 2.7, 3.5, 3.6.


6.3 (2022-12-16)
----------------

- Fix insidious buildout configuration bug for tests against Zope 4.

- Add support for Python 3.10 and 3.11.


6.2 (2021-07-06)
----------------

- "Undeprecate" sessioning configurations using this package
  because ``tempstorage`` version 5.2 fixed the data loss issue.
  (`#16
  <https://github.com/zopefoundation/Products.TemporaryFolder/issues/16>`_)

- Update package configuration.


6.1 (2021-03-16)
----------------

- Add support for Python 3.9.


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.
