Skip to content

Commit

Permalink
Merge pull request #14 from zopefoundation/document_deprecation
Browse files Browse the repository at this point in the history
Document deprecation of this package.
  • Loading branch information
dwt committed Aug 14, 2019
2 parents 5b8009d + a8c05b0 commit c5d99c2
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 1 deletion.
7 changes: 6 additions & 1 deletion CHANGES.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ Changelog
5.1 (unreleased)
----------------

- Nothing changed yet.
- Package is now officially deprecated as it was broken for many years. This
was/ is common knowledge in the zope community, but was not documented
anywhere and thus this package was still used by many community members
without knowing this. See
(`#8 <https://github.com/zopefoundation/tempstorage/issues/8>`_)
(`#12 <https://github.com/zopefoundation/tempstorage/issues/12>`_)


5.0 (2019-05-10)
Expand Down
9 changes: 9 additions & 0 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,12 @@ A storage implementation which uses RAM to persist objects, much like
MappingStorage. Unlike MappingStorage, it needs not be packed to get rid of
non-cyclic garbage and it does rudimentary conflict resolution. This is a
ripoff of Jim's Packless bsddb3 storage.

**Please note: Usage of this package is deprecated, as it is known to randomly lose data, especially with Zope 4.**

For a detailed discussion see `#8 <https://github.com/zopefoundation/tempstorage/issues/8>`_ as well as `#12 <https://github.com/zopefoundation/tempstorage/issues/12>`_

To replace server-side sessions, cookies are probably your best bet, as these also get rid of any denial of service problems that server side sessions are vulnerable to.

If you need server side storage of sessions, consider using a normal store rather than tempstorage for your session data.
For details and suggestions see `this discussion in the pull request <https://github.com/zopefoundation/tempstorage/pull/14#issuecomment-520318459>`_ as well as the discussion in the aforementioned bug reports as well as `the discussion in Zope about the removal of the generated configuration <https://github.com/zopefoundation/Zope/pull/684>`_.

0 comments on commit c5d99c2

Please sign in to comment.