blob: f58cb8c960bc86235e1a49d951dec9683cbe8ae7 (
plain)
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
|
# -*- perl -*- Lintian::Storage::MLDBM
#
# Copyright (C) 2022 Felix Lechner
#
# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the Free
# Software Foundation; either version 2 of the License, or (at your option)
# any later version.
#
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
# more details.
#
# You should have received a copy of the GNU General Public License along with
# this program. If not, see <http://www.gnu.org/licenses/>.
package Lintian::Storage::MLDBM;
use v5.20;
use warnings;
use utf8;
use BerkeleyDB;
use Const::Fast;
use MLDBM qw(BerkeleyDB::Btree Storable);
use Path::Tiny;
use Syntax::Keyword::Try;
use Unicode::UTF8 qw(encode_utf8 decode_utf8);
const my $EMPTY => q{};
const my $HYPHEN => q{-};
use Moo;
use namespace::clean;
=head1 NAME
Lintian::Storage::MLDBM - store multi-level hashes on disk
=head1 SYNOPSIS
use Lintian::Storage::MLDBM;
=head1 DESCRIPTION
Lintian::Storage::MLDBM provides an interface to store data on disk to preserve memory.
=head1 INSTANCE METHODS
=over 4
=item tempfile
=item tied_hash
=cut
has tempfile => (is => 'rw');
has tied_hash => (is => 'rw', default => sub { {} });
=item create
=cut
sub create {
my ($self, $description) = @_;
$description //= $EMPTY;
$description .= $HYPHEN
if length $description;
my $stem = "mldbm-$description";
my $tempfile
= Path::Tiny->tempfile(TEMPLATE => $stem . 'XXXXXXXX', UNLINK => 0);
$self->tempfile($tempfile);
try {
tie(
%{$self->tied_hash}, 'MLDBM',
-Filename => $tempfile->stringify,
-Flags => DB_CREATE
);
} catch {
die encode_utf8("Cannot create database in $tempfile: $@");
};
return;
}
=item DEMOLISH
=cut
sub DEMOLISH {
my ($self, $in_global_destruction) = @_;
untie %{$self->tied_hash};
$self->tempfile->remove
if defined $self->tempfile;
return;
}
=back
=head1 AUTHOR
Originally written by Felix Lechner <felix.lechner@lease-up.com> for
Lintian.
=head1 SEE ALSO
lintian(1)
=cut
1;
# Local Variables:
# indent-tabs-mode: nil
# cperl-indent-level: 4
# End:
# vim: syntax=perl sw=4 sts=4 sr et
|
