NAME

       Catmandu::Store::Hash - An in-memory store

SYNOPSIS

          use Catmandu;

          my $store = Catmandu->store('Hash');

          my $obj1 = $store->bag->add({ name => 'Patrick' });

          printf "obj1 stored as %s\n" , $obj1->{_id};

          # Force an id in the store
          my $obj2 = $store->bag->add({ _id => 'test123' , name => 'Nicolas' });

          my $obj3 = $store->bag->get('test123');

          $store->bag->delete('test123');

          $store->bag->delete_all;

          # All bags are iterators
          $store->bag->each(sub { ... });
          $store->bag->take(10)->each(sub { ... });

DESCRIPTION

       A Catmandu::Store::Hash is an in-memory Catmandu::Store backed by a hash for fast
       retrieval combined with a doubly linked list for fast traversal.

METHODS

   new([init_data => [...] ])
       Create a new Catmandu::Store::Hash. Optionally provide as init_data an array ref of data:

           my $store = Catmandu->store('Hash', init_data => [
                  { _id => 1, data => foo } ,
                  { _id => 2, data => bar }
           ]);

           # or in a catmandu.yml configuration file:

           ---
           store:
              hash:
                package: Hash
                options:
                   init_data:
                      - _id: 1
                        data: foo
                      - _id: 2
                        data: bar

INHERITED METHODS

       This Catmandu::Store implements:

       Catmandu::Store
       Catmandu::Droppable
       Catmandu::Transactional

       Each Catmandu::Bag in this Catmandu::Store implements:

       Catmandu::Bag
       Catmandu::Droppable