Metadata-Version: 2.1
Name: vessel
Version: 2.0.2
Summary: Cache and contain utilities.
Home-page: https://github.com/Exahilosys/vessel
Author: Exahilosys
License: MIT
Platform: UNKNOWN
Requires-Dist: pathing
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'

Installing
==========

.. code-block:: bash

  pip3 install vessel

Cache Usage
-----------

.. code-block:: py

  import vessel

  # basic
  cache = vessel.Cache(2)
  # all methods return tuples of entries affected
  cache.create((0, 19), {'id': 0, 'age': 19, 'name': 'Hazel'}) # hi
  cache.create((0, 23), {'id': 0, 'age': 23, 'name': 'Baiy'}) # hi
  cache.create((1, 21), {'id': 0, 'age': 21, 'name': 'George'}) # hi
  cache.update((0, 23), {'name': 'Bailey'}) # woops
  cache.update((0,), {'school': '5th GL'}) # new data
  cache.delete((0, 19)) # bye hazel
  cache.delete((0,)) # bye everyone

  # simple
  cache = vessel.DBCache(('id', 'age'))
  # no need to specify keys
  cache.create({'id': 0, 'age': 19, 'name': 'Hazel'})
  cache.create({'id': 0, 'age': 23, 'name': 'Baiy'})
  cache.create({'id': 1, 'age': 31, 'name': 'George'})
  cache.update({'id': 0, 'age': 23, 'name': 'Bailey'})
  cache.update({'id': 0, 'school': '5th GL'})
  cache.delete((0, 19))
  cache.delete((0,))

Links
-----

- `Documentation <https://vessel.readthedocs.io/en/compat>`_


