.. _spkg_pickleshare:

pickleshare: A 'shelve' like datastore with concurrency support
===============================================================

Description
-----------

PickleShare - a small 'shelve' like datastore with concurrency support

Like shelve, a PickleShareDB object acts like a normal dictionary.
Unlike shelve, many processes can access the database simultaneously.
Changing a value in database is immediately visible to other processes
accessing the same database.

Concurrency is possible because the values are stored in separate files.
Hence the "database" is a directory where all files are governed by
PickleShare.

Type
----

standard


Dependencies
------------

- $(PYTHON)
- $(PYTHON_TOOLCHAIN)

Version Information
-------------------

package-version.txt::

    0.7.5

install-requires.txt::

    pickleshare >=0.7.5


Equivalent System Packages
--------------------------

conda:

.. CODE-BLOCK:: bash

    $ conda install  pickleshare


macports:
install the following packages: py-pickleshare

opensuse:

.. CODE-BLOCK:: bash

    $ sudo zypper install python3-pickleshare


void:

.. CODE-BLOCK:: bash

    $ sudo xbps-install  python3-pickleshare


See https://repology.org/project/pickleshare/versions, https://repology.org/project/python:pickleshare/versions


However, these system packages will not be used for building Sage
because using Python site-packages is not supported by the Sage distribution;
see :trac:`29023`

