| 1 | package File::Kit; | ||
| 2 | |||
| 3 | use strict; | ||
| 4 | use warnings; | ||
| 5 | |||
| 6 | use File::Kvpar; | ||
| 7 | use File::Copy qw(copy move); | ||
| 8 | |||
| 9 | use vars qw($VERSION); | ||
| 10 | $VERSION = '0.04'; | ||
| 11 | |||
| 12 | use constant ADDFILE => 'ADDFILE'; | ||
| 13 | use constant RMVFILE => 'RMVFILE'; | ||
| 14 | |||
| 15 | sub new { | ||
| 16 | my $cls = shift; | ||
| 17 | unshift @_, 'path' if @_ % 2; | ||
| 18 | my $self = bless { | ||
| 19 | 'meta' => {}, | ||
| 20 | 'files' => [], | ||
| 21 | 'move' => \&move, | ||
| 22 | @_, | ||
| 23 | }, $cls; | ||
| 24 | $self->init; | ||
| 25 | } | ||
| 26 | |||
| 27 | sub path { $_[0]->{'path'} } | ||
| 28 | |||
| 29 | sub init { | ||
| 30 | my ($self) = @_; | ||
| 31 | my $path = $self->path; | ||
| 32 | -d $path ? $self->load($path) : $self->create($path) if defined $path; | ||
| 33 | return $self; | ||
| 34 | } | ||
| 35 | |||
| 36 | sub load { | ||
| 37 | my ($self, $path) = @_; | ||
| 38 | my $kitkv = $self->{'kitkv'} ||= File::Kvpar->new('<+', "$path/kit.kv"); | ||
| 39 | my $fileskv = $self->{'fileskv'} ||= File::Kvpar->new('<+', "$path/files.kv"); | ||
| 40 | $self->{'meta'} = $kitkv->head; | ||
| 41 | $self->{'files'} = [ $fileskv->elements ]; | ||
| 42 | return $self; | ||
| 43 | } | ||
| 44 | |||
| 45 | sub create { | ||
| 46 | my ($self, $path) = @_; | ||
| 47 | mkdir $path or die "Can't mkdir $path: $!"; | ||
| 48 | mkdir "$path/files" or die "Can't mkdir $path/files: $!"; | ||
| 49 | my $kitkv = $self->{'kitkv'} ||= File::Kvpar->new('>+', "$path/kit.kv"); | ||
| 50 | my $fileskv = $self->{'fileskv'} ||= File::Kvpar->new('>+', "$path/files.kv"); | ||
| 51 | $kitkv->write($self->{'meta'}); | ||
| 52 | $self->{'files'} ||= []; | ||
| 53 | return $self; | ||
| 54 | } | ||
| 55 | |||
| 56 | sub edit { | ||
| 57 | my ($self) = @_; | ||
| 58 | $self->{'edits'} ||= []; | ||
| 59 | return $self; | ||
| 60 | } | ||
| 61 | |||
| 62 | sub add { | ||
| 63 | my $self = shift; | ||
| 64 | my $edits = $self->{'edits'} ||= []; | ||
| 65 | my @files; | ||
| 66 | foreach (@_) { | ||
| 67 | if (ref $_) { | ||
| 68 | @files % 2 or die; | ||
| 69 | push @files, $_; | ||
| 70 | } | ||
| 71 | else { | ||
| 72 | @files % 2 or push @files, {}; | ||
| 73 | push @files, $_; | ||
| 74 | } | ||
| 75 | } | ||
| 76 | push @files, {} if @files % 2; | ||
| 77 | while (@files) { | ||
| 78 | my ($path, $meta) = splice @files, 0, 2; | ||
| 79 | push @$edits, [ ADDFILE, $path, $meta ]; | ||
| 80 | } | ||
| 81 | return $self; | ||
| 82 | } | ||
| 83 | |||
| 84 | sub save { | ||
| 85 | my ($self) = @_; | ||
| 86 | my %fh; | ||
| 87 | my $fileskv = $self->{'fileskv'}; | ||
| 88 | my $root = $self->path; | ||
| 89 | my $edits = $self->{'edits'} ||= []; | ||
| 90 | while (@$edits) { | ||
| 91 | local $_ = shift; | ||
| 92 | my ($action, @params) = @$_; | ||
| 93 | if ($action eq ADDFILE) { | ||
| 94 | @params == 2 or die; | ||
| 95 | my ($path, $meta) = @params; | ||
| 96 | my $name = basename($path); | ||
| 97 | $meta->{'origin'} = $path; | ||
| 98 | $meta->{'name' } = $name; | ||
| 99 | my $newpath = "$root/files/$name"; | ||
| 100 | if ($self->{'move'}->($path, $newpath)) { | ||
| 101 | $fileskv->append($meta); | ||
| 102 | } | ||
| 103 | else { | ||
| 104 | die; | ||
| 105 | } | ||
| 106 | } | ||
| 107 | elsif ($action eq RMVFILE) { | ||
| 108 | die "RMVFILE not yet implemented"; | ||
| 109 | @params == 1 or die; | ||
| 110 | my ($file) = @params; | ||
| 111 | my @filemeta = grep { $file eq $_->{'#'} } $fileskv->elements; | ||
| 112 | 1; | ||
| 113 | } | ||
| 114 | } | ||
| 115 | @{ $self->{'edits'} } = (); | ||
| 116 | return $self; | ||
| 117 | } | ||
| 118 | |||
| 119 | sub files { | ||
| 120 | my ($self) = @_; | ||
| 121 | my $files = $self->{'files'} ||= []; | ||
| 122 | return @$files if @$files; | ||
| 123 | return @$files = $self->{'kvfiles'}->elements; | ||
| 124 | } | ||
| 125 | |||
| 126 | 1; | ||
| 127 | |||
| 128 | =pod | ||
| 129 | |||
| 130 | =head1 NAME | ||
| 131 | |||
| 132 | File::Kit - Gather files and their metadata together in one place | ||
| 133 | |||
| 134 | =head1 SYNOPSIS | ||
| 135 | |||
| 136 | $kit = File::Kit->new($dir); | ||
| 137 | $kit = File::Kit->create($dir, %meta); | ||
| 138 | $kit->add($filepath1, \%filemetadata1, $filepath2, \%filemetadata2, ...); | ||
| 139 | @filenames = $kit->files; | ||
| 140 | $file = $kit->file($filename); | ||
| 141 | $kit->remove(@filepaths); | ||
| 142 | $meta = $kit->get(@kitmetadatakeys); | ||
| 143 | $kit->set(%kitmetadata); | ||
| 144 | $kit->save; | ||
| 145 | |||
| 146 | =cut |