Skip to content

Commit

Permalink
- "Undeprecate" sessioning configurations using this package
Browse files Browse the repository at this point in the history
  • Loading branch information
dataflake committed Jul 6, 2021
1 parent 0af836c commit f17db68
Show file tree
Hide file tree
Showing 3 changed files with 16 additions and 15 deletions.
5 changes: 5 additions & 0 deletions CHANGES.rst
Expand Up @@ -4,6 +4,11 @@ Changelog
6.2 (unreleased)
----------------

- "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


Expand Down
22 changes: 9 additions & 13 deletions README.rst
Expand Up @@ -20,19 +20,15 @@ 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::
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>
Expand Down
4 changes: 2 additions & 2 deletions setup.py
Expand Up @@ -36,7 +36,7 @@
namespace_packages=['Products'],
package_dir={'': 'src'},
classifiers=[
'Development Status :: 7 - Inactive',
'Development Status :: 6 - Mature',
'Environment :: Web Environment',
'Framework :: Zope',
'Framework :: Zope :: 4',
Expand All @@ -61,7 +61,7 @@
'AccessControl',
'Acquisition',
'six',
'tempstorage',
'tempstorage >= 5.2',
'Products.ZODBMountPoint',
'ZODB',
'Zope >= 4.0b5',
Expand Down

0 comments on commit f17db68

Please sign in to comment.