1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
package DR::Tarantool;
=head1 NAME
DR::Tarantool - perl driver for L<tarantool|http://tarantool.org>
=head1 SYNOPSIS
use DR::Tarantool ':constant', 'tarantool';
use DR::Tarantool ':all';
my $tnt = tarantool
host => '127.0.0.1',
port => 123,
spaces => {
...
}
;
$tnt->update( ... );
my $tnt = coro_tarantool
host => '127.0.0.1',
port => 123,
spaces => {
...
}
;
use DR::Tarantool ':constant', 'async_tarantool';
async_tarantool
host => '127.0.0.1',
port => 123,
spaces => {
...
},
sub {
...
}
;
$tnt->update(...);
=head1 DESCRIPTION
The module provides sync and async drivers for
L<tarantool|http://tarantool.org>.
The driver uses libtarantool* libraries for making requests and
parsing responses.
=cut
use 5.010001;
use strict;
use warnings;
use Carp;
$Carp::Internal{ (__PACKAGE__) }++;
use base qw(Exporter);
our %EXPORT_TAGS = (
client => [ qw( tarantool async_tarantool coro_tarantool) ],
constant => [
qw(
TNT_INSERT TNT_SELECT TNT_UPDATE TNT_DELETE TNT_CALL TNT_PING
TNT_FLAG_RETURN TNT_FLAG_ADD TNT_FLAG_REPLACE TNT_FLAG_BOX_QUIET
TNT_FLAG_NOT_STORE
)
],
);
our @EXPORT_OK = ( map { @$_ } values %EXPORT_TAGS );
$EXPORT_TAGS{all} = \@EXPORT_OK;
our @EXPORT = @{ $EXPORT_TAGS{client} };
our $VERSION = '0.15';
=head1 EXPORT
=head2 tarantool
connects to L<tarantool|http://tarantool.org> in sync mode using
L<DR::Tarantool::SyncClient>.
=cut
sub tarantool {
require DR::Tarantool::SyncClient;
no warnings 'redefine';
*tarantool = sub {
DR::Tarantool::SyncClient->connect(@_);
};
goto \&tarantool;
}
=head2 async_tarantool
connects to L<tarantool|http://tarantool.org> in async mode using
L<DR::Tarantool::AsyncClient>.
=cut
sub async_tarantool {
require DR::Tarantool::AsyncClient;
no warnings 'redefine';
*async_tarantool = sub {
DR::Tarantool::AsyncClient->connect(@_);
};
goto \&async_tarantool;
}
=head2 coro_tarantol
connects to L<tarantool|http://tarantool.org> in async mode using
L<DR::Tarantool::CoroClient>.
=cut
sub coro_tarantool {
require DR::Tarantool::CoroClient;
no warnings 'redefine';
*coro_tarantool = sub {
DR::Tarantool::CoroClient->connect(@_);
};
goto \&coro_tarantool;
}
=head2 :constant
Exports constants to use in request as flags:
=over
=item TNT_FLAG_RETURN
If You use the flag, driver will return tuple that were
inserted/deleted/updated.
=item TNT_FLAG_ADD
Try to add tuple. Return error if tuple is already exists.
=item TNT_FLAG_REPLACE
Try to replace tuple. Return error if tuple isn't exists.
=back
=cut
require XSLoader;
XSLoader::load('DR::Tarantool', $VERSION);
*TNT_PING = \&DR::Tarantool::_op_ping;
*TNT_CALL = \&DR::Tarantool::_op_call;
*TNT_INSERT = \&DR::Tarantool::_op_insert;
*TNT_UPDATE = \&DR::Tarantool::_op_update;
*TNT_DELETE = \&DR::Tarantool::_op_delete;
*TNT_SELECT = \&DR::Tarantool::_op_select;
*TNT_FLAG_RETURN = \&DR::Tarantool::_flag_return;
*TNT_FLAG_ADD = \&DR::Tarantool::_flag_add;
*TNT_FLAG_REPLACE = \&DR::Tarantool::_flag_replace;
*TNT_FLAG_BOX_QUIET = \&DR::Tarantool::_flag_box_quiet;
*TNT_FLAG_NOT_STORE = \&DR::Tarantool::_flag_not_store;
=head2 :all
Exports all functions and constants.
=head1 SEE ALSO
The module uses L<DR::Tarantool::SyncClient> and (or)
L<DR::Tarantool::AsyncClient>.
=head1 COPYRIGHT AND LICENSE
Copyright (C) 2011 Dmitry E. Oboukhov <unera@debian.org>
Copyright (C) 2011 Roman V. Nikolaev <rshadow@rambler.ru>
This program is free software, you can redistribute it and/or
modify it under the terms of the Artistic License.
=head1 VCS
The project is placed git repo on github:
L<https://github.com/unera/dr-tarantool/>.
=cut
1;
|
