https://github.com/awncorp/zing-store-rocks
RocksDB Storage for Zing Abstractions
https://github.com/awncorp/zing-store-rocks
perl perl5 rocksdb
Last synced: 7 months ago
JSON representation
RocksDB Storage for Zing Abstractions
- Host: GitHub
- URL: https://github.com/awncorp/zing-store-rocks
- Owner: awncorp
- License: other
- Created: 2020-12-26T17:14:23.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-12-26T19:36:30.000Z (over 5 years ago)
- Last Synced: 2025-01-01T11:27:29.871Z (over 1 year ago)
- Topics: perl, perl5, rocksdb
- Language: Perl
- Homepage: https://metacpan.org/release/Zing-Store-Rocks
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README
- Changelog: CHANGES
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
NAME
Zing::Store::Rocks - RocksDB Storage
ABSTRACT
RocksDB Storage Abstraction
SYNOPSIS
use File::Spec;
use Zing::Encoder::Dump;
use Zing::Store::Rocks;
my $store = Zing::Store::Rocks->new(
root => File::Spec->catfile(
File::Spec->tmpdir, rand
),
);
# $store->drop;
DESCRIPTION
This package provides a RockDB-specific storage adapter for use with
data persistence abstractions. The "client" attribute accepts a RocksDB
object.
INHERITS
This package inherits behaviors from:
Zing::Store
LIBRARIES
This package uses type constraints from:
Zing::Types
ATTRIBUTES
This package has the following attributes:
client
client(InstanceOf["RocksDB"])
This attribute is read-only, accepts (InstanceOf["RocksDB"]) values,
and is optional.
root
root(Str)
This attribute is read-only, accepts (Str) values, and is optional.
METHODS
This package implements the following methods:
decode
decode(Str $data) : HashRef
The decode method decodes the data provided and returns the data as a
hashref.
decode example #1
# given: synopsis
$store->decode('{"status"=>"ok"}');
drop
drop(Str $key) : Int
The drop method removes (drops) the item from the datastore.
drop example #1
# given: synopsis
$store->drop('zing:main:global:model:temp');
encode
encode(HashRef $data) : Str
The encode method encodes and returns the data provided.
encode example #1
# given: synopsis
$store->encode({ status => 'ok' });
keys
keys(Str @keys) : ArrayRef[Str]
The keys method returns a list of keys under the namespace of the
datastore or provided key.
keys example #1
# given: synopsis
my $keys = $store->keys('zing:main:global:model:temp');
keys example #2
# given: synopsis
$store->send('zing:main:global:model:temp', { status => 'ok' });
my $keys = $store->keys('zing:main:global:model:temp');
lpull
lpull(Str $key) : Maybe[HashRef]
The lpull method pops data off of the top of a list in the datastore.
lpull example #1
# given: synopsis
$store->lpull('zing:main:global:model:items');
lpull example #2
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 'ok' });
$store->lpull('zing:main:global:model:items');
lpush
lpush(Str $key, HashRef $val) : Int
The lpush method pushed data onto the top of a list in the datastore.
lpush example #1
# given: synopsis
$store->lpush('zing:main:global:model:items', { status => '1' });
lpush example #2
# given: synopsis
$store->lpush('zing:main:global:model:items', { status => '0' });
$store->lpush('zing:main:global:model:items', { status => '0' });
recv
recv(Str $key) : Maybe[HashRef]
The recv method fetches and returns data from the datastore by its key.
recv example #1
# given: synopsis
$store->recv('zing:main:global:model:temp');
recv example #2
# given: synopsis
$store->send('zing:main:global:model:temp', { status => 'ok' });
$store->recv('zing:main:global:model:temp');
rpull
rpull(Str $key) : Maybe[HashRef]
The rpull method pops data off of the bottom of a list in the
datastore.
rpull example #1
# given: synopsis
$store->rpull('zing:main:global:model:items');
rpull example #2
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 1 });
$store->rpush('zing:main:global:model:items', { status => 2 });
$store->rpull('zing:main:global:model:items');
rpush
rpush(Str $key, HashRef $val) : Int
The rpush method pushed data onto the bottom of a list in the
datastore.
rpush example #1
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 'ok' });
rpush example #2
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 'ok' });
$store->rpush('zing:main:global:model:items', { status => 'ok' });
send
send(Str $key, HashRef $val) : Str
The send method commits data to the datastore with its key and returns
truthy.
send example #1
# given: synopsis
$store->send('zing:main:global:model:temp', { status => 'ok' });
size
size(Str $key) : Int
The size method returns the size of a list in the datastore.
size example #1
# given: synopsis
my $size = $store->size('zing:main:global:model:items');
size example #2
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 'ok' });
my $size = $store->size('zing:main:global:model:items');
slot
slot(Str $key, Int $pos) : Maybe[HashRef]
The slot method returns the data from a list in the datastore by its
index.
slot example #1
# given: synopsis
my $model = $store->slot('zing:main:global:model:items', 0);
slot example #2
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 'ok' });
my $model = $store->slot('zing:main:global:model:items', 0);
test
test(Str $key) : Int
The test method returns truthy if the specific key (or datastore)
exists.
test example #1
# given: synopsis
$store->rpush('zing:main:global:model:items', { status => 'ok' });
$store->test('zing:main:global:model:items');
test example #2
# given: synopsis
$store->drop('zing:main:global:model:items');
$store->test('zing:main:global:model:items');
AUTHOR
Al Newkirk, awncorp@cpan.org
LICENSE
Copyright (C) 2011-2019, Al Newkirk, et al.
This is free software; you can redistribute it and/or modify it under
the terms of the The Apache License, Version 2.0, as elucidated in the
"license file"
.
PROJECT
Wiki
Project
Initiatives
Milestones
Contributing
Issues