finish tags hierarchy schema change
[id3fs.git] / lib / ID3FS / DB.pm
1 package ID3FS::DB;
2
3 use strict;
4 use warnings;
5 use DBI;
6 use ID3FS::AudioFile;
7 use Cwd;
8
9 our $SCHEMA_VERSION=1;
10 my $dbfile=".id3fs";
11
12 sub new
13 {
14     my $proto=shift;
15     my $class=ref($proto) || $proto;
16     my $self={};
17     bless($self,$class);
18
19     $self->{me}=shift;
20     $self->{verbose}=shift;
21     my $init=shift;
22     my $dbpath=shift;
23     $self->{base}=shift;
24     my $fallbackdir=shift;
25
26     $dbpath=$self->find_db($init, $dbpath, $fallbackdir);
27     return undef unless($dbpath);
28     $self->{absbase}=Cwd::abs_path($self->{base});
29
30     my $connectstr="dbi:SQLite:dbname=$dbpath";
31     my ($user, $pass)=("", "");
32     if($self->{postgres})
33     {
34         $connectstr="dbi:Pg:dbname=id3fs";
35         $user="ianb";
36         $pass="foo";
37     }
38     my $exists=-f $dbpath;
39     $self->{dbh}=DBI->connect($connectstr, $user, $pass,
40                               { AutoCommit=>1 } );
41     unless(defined($self->{dbh}))
42     {
43         die("$self->{me}: DB Error: " . $DBI::errstr . "\n");
44     }
45
46     if($exists)
47     {
48         $self->checkschema();
49     }
50     else
51     {
52         $self->create();
53     }
54     $self->enable_foreign_keys();
55     return $self;
56 }
57
58 sub find_db
59 {
60     my($self, $init, $dbpath, $fallbackdir)=@_;
61     my $file=undef;
62     my $base=undef;
63     if(defined($dbpath))
64     {
65         $file=$dbpath;
66     }
67     if(defined ($self->{base}))
68     {
69         $file="$self->{base}/$dbfile" unless defined($file);
70         $base=$self->{base};
71     }
72     elsif(defined($fallbackdir) && -d $fallbackdir)
73     {
74         my $path=Cwd::abs_path($fallbackdir);
75         do
76         {
77             $file="$path/$dbfile";
78             $base=$path;
79             $path=~s/(.*)\/.*/$1/;
80         }
81         while(! -f $file && length($path) && -d $path);
82         if(! -f $file)
83         {
84             $file="$fallbackdir/$dbfile";
85             $base=$fallbackdir;
86         }
87     }
88     if(!-f $file && !$init)
89     {
90         print "$self->{me}: db not found at $file\n";
91         return undef;
92     }
93     $self->{base}=$base;
94     return $file;
95 }
96
97 sub base_dir { return shift->{base}; }
98
99 sub create
100 {
101     my($self,$name)=@_;
102     my @schema=split(/\n\n/,join("", <DATA>));
103     close(DATA);
104     for my $cmd (@schema)
105     {
106         $self->{dbh}->do($cmd);
107     }
108     if($self->{postgres})
109     {
110         $self->cmd("CREATE SEQUENCE seq");
111     }
112     else
113     {
114         my %indexes=( "idx_files_id"  => "files (id)",
115                       "idx_fxt_both"  => "files_x_tags (files_id, tags_id)",
116                       "idx_fxt_files" => "files_x_tags (files_id)",
117                       "idx_fxt_tags"  => "files_x_tags (tags_id)",
118                       "idx_tags_id"   => "tags (id)",
119                       "idx_tags_name" => "tags (name)");
120         for my $index (keys %indexes)
121         {
122             $self->{dbh}->do("CREATE INDEX $index ON " . $indexes{$index});
123         }
124     }
125     $self->cmd("INSERT INTO id3fs (schema_version, last_update) VALUES (?, ?)",
126                $SCHEMA_VERSION, time());
127 }
128
129 sub checkschema
130 {
131     my $self=shift;
132     my ($version)=$self->cmd_onerow("SELECT schema_version from id3fs");
133     if(!defined($version) || $version != $SCHEMA_VERSION)
134     {
135         die("$self->{me}: id3fs database version " .
136             defined($version) ? $version : '""' .
137             "not known, current version is $SCHEMA_VERSION.\n");
138     }
139 }
140
141 sub analyze
142 {
143     my $self=shift;
144     $self->cmd("ANALYZE");
145 }
146
147 sub enable_foreign_keys
148 {
149     my $self=shift;
150     $self->cmd("PRAGMA foreign_keys = ON");
151 }
152
153 sub last_update
154 {
155     my($self, $newval)=@_;
156     if(defined($newval))
157     {
158         $self->cmd("UPDATE id3fs SET last_update=?", $newval);
159     }
160     else
161     {
162         ($newval)=$self->cmd_onerow("SELECT last_update from id3fs");
163     }
164     return $newval;
165 }
166
167 sub cmd_sth
168 {
169     my($self, $sql, @params)=@_;
170     my $sth=$self->{dbh}->prepare($sql);
171     my $idx=1;
172     for my $param (@params)
173     {
174         $param="" unless(defined($param));
175         $sth->bind_param($idx++, $param);
176     }
177     $sth->execute();
178     return $sth;
179 }
180
181 sub tags
182 {
183     my($self, @constraints)=@_;
184     if(!@constraints) # /
185     {
186         # FIXME: add ALL?
187         my $sql="SELECT DISTINCT name FROM tags;";
188         my $tags=$self->cmd_rows($sql);
189         return(map { $_->[0]; } @$tags);
190     }
191     my @ids=();
192
193     my $main_sql_start=("SELECT t2.name\n" .
194                         "\tFROM (\n" .
195                         $self->tags_subselect(@constraints) .
196                         ") AS subselect\n" .
197                       "INNER JOIN files_x_tags ON subselect.files_id=files_x_tags.files_id\n" .
198                       "INNER JOIN tags t2 ON files_x_tags.tags_id=t2.id\n" .
199                       "WHERE t2.id NOT IN (");
200     my $main_sql_end=")\nGROUP BY t2.name;";
201     # FIXME: generalise more?
202
203     while(my $constraint=shift @constraints)
204     {
205         my $cid=$constraint->{id};
206         push(@ids, $cid);
207     }
208     @ids = map( { "\"$_\""; } grep { defined; } @ids) unless($self->{postgres});
209     my $tagstr=join(", ", @ids);
210     my $sql = ($main_sql_start . $tagstr .
211                $main_sql_end);
212     print "SQL: $sql\n";
213     my $result=$self->cmd_rows($sql);
214     my @tagnames=map { $_->[0]; } @$result;
215     print "SUBNAMES: ", join(', ', @tagnames), "\n";
216     return(@tagnames);
217 }
218
219 sub tag_values
220 {
221     my($self, $tagid)=@_;
222     my $sql=("SELECT DISTINCT name FROM tags\n" .
223              "WHERE parents_id=?");
224     my $tags=$self->cmd_rows($sql, $tagid);
225     my @tags=map { $_->[0]; } @$tags;
226     @tags=map { length($_) ? $_ : "NOVALUE"; } @tags;
227     return @tags;
228 }
229
230 sub artists
231 {
232     my($self, @constraints)=@_;
233     if(!@constraints) # /ALL
234     {
235         my $sql="SELECT DISTINCT name FROM artists;";
236         my $tags=$self->cmd_rows($sql);
237         return(map { $_->[0]; } @$tags);
238     }
239     my @ids=();
240     my $sql=("SELECT artists.name FROM (\n" .
241              $self->tags_subselect(@constraints) .
242              ") AS subselect\n" .
243              "INNER JOIN files ON subselect.files_id=files.id\n" .
244              "INNER JOIN artists ON files.artists_id=artists.id\n" .
245              "GROUP BY artists.name;");
246     print "SQL: $sql\n";
247     my $result=$self->cmd_rows($sql);
248     my @tagnames=map { $_->[0]; } @$result;
249     print "ARTISTS: ", join(', ', @tagnames), "\n";
250     return(@tagnames);
251 }
252
253 sub albums
254 {
255     my($self, @constraints)=@_;
256     my @ids=();
257     # FIXME: rework PathElements
258     if(ref($constraints[$#constraints]) eq "ID3FS::PathElement::Artist")
259     {
260         return $self->artist_albums($constraints[$#constraints]->{id}, @constraints);
261     }
262     my $sql=("SELECT albums.name\n" .
263              "\tFROM (\n" .
264              $self->tags_subselect(@constraints) .
265              "\t) AS subselect\n" .
266              "INNER JOIN files ON subselect.files_id=files.id\n" .
267              "INNER JOIN albums ON files.albums_id=albums.id\n" .
268              "GROUP BY albums.name;");
269     my $result=$self->cmd_rows($sql);
270     my @names=map { $_->[0]; } @$result;
271     print "ALBUMS: ", join(', ', @names), "\n";
272     return(@names);
273 }
274
275 sub artist_albums
276 {
277     my($self, $artist_id, @constraints)=@_;
278     my $sql=("SELECT albums.name FROM (\n" .
279              $self->tags_subselect(@constraints) .
280              "\t) AS subselect\n" .
281              "INNER JOIN files ON subselect.files_id=files.id\n" .
282              "INNER JOIN albums ON albums.id=files.albums_id\n\t" .
283              "INNER JOIN artists ON artists.id=files.artists_id\n\t" .
284              "WHERE artists.id=? and albums.name <> ''\n\t" .
285              "GROUP BY albums.name\n");
286     print "ARTIST_ALBUMS SQL: $sql\n";
287     my $result=$self->cmd_rows($sql, $artist_id);
288     my @albums=map { $_->[0]; } @$result;
289     print "ALBUMS: ", join(', ', @albums), "\n";
290     return(@albums);
291 }
292
293 sub artist_tracks
294 {
295     my($self, $artist_id, @constraints)=@_;
296     my $sql=("SELECT files.name FROM (\n" .
297              $self->tags_subselect(@constraints) .
298              "\t) AS subselect\n" .
299              "INNER JOIN files ON subselect.files_id=files.id\n" .
300              "INNER JOIN artists ON artists.id=files.artists_id\n\t" .
301              "INNER JOIN albums  ON albums.id=files.albums_id\n\t" .
302              "WHERE artists.id=? AND albums.name=''\n\t" .
303              "GROUP BY files.name\n");
304     print "ARTIST_TRACKS SQL: $sql\n";
305     my $result=$self->cmd_rows($sql, $artist_id);
306     my @names=map { $_->[0]; } @$result;
307     print "ARTISTTRACKS: ", join(', ', @names), "\n";
308     return(@names);
309 }
310
311 sub album_tracks
312 {
313     my($self, $artist_id, $album_id)=@_;
314     my $sql=("SELECT files.name FROM files\n\t" .
315              "INNER JOIN albums  ON albums.id=files.albums_id\n\t" .
316              "INNER JOIN artists ON artists.id=files.artists_id\n\t" .
317              "WHERE artists.id=? AND albums.id=?\n\t" .
318              "GROUP BY files.name\n");
319     print "ALBUM_TRACKS SQL($artist_id, $album_id): $sql\n";
320     my $result=$self->cmd_rows($sql, $artist_id, $album_id);
321     my @names=map { $_->[0]; } @$result;
322     print "TRACKS: ", join(', ', @names), "\n";
323     return(@names);
324 }
325
326 sub tracks
327 {
328     my($self, @constraints)=@_;
329     # FIXME: rework PathElements
330     if(ref($constraints[$#constraints]) eq "ID3FS::PathElement::Artist")
331     {
332         return $self->artist_tracks($constraints[$#constraints]->{id}, @constraints);
333     }
334     elsif(ref($constraints[$#constraints]) eq "ID3FS::PathElement::Album")
335     {
336         my $artist_id=0;
337         my $artist=$constraints[($#constraints)-1];
338         if(defined($artist) && (ref($artist) eq "ID3FS::PathElement::Artist"))
339         {
340             # should always happen
341             $artist_id=$artist->{id};
342         }
343         return $self->album_tracks($artist_id, $constraints[$#constraints]->{id});
344     }
345
346     my $sql=("SELECT files.name\n" .
347              "\tFROM (\n" .
348              $self->tags_subselect(@constraints) .
349              "\t) AS subselect\n" .
350              "INNER JOIN files ON files.id=subselect.files_id\n" .
351              "GROUP BY files.name;");
352     print "SQL: $sql\n";
353     my $result=$self->cmd_rows($sql);
354     my @names=map { $_->[0]; } @$result;
355     print "TRACKS: ", join(', ', @names), "\n";
356     return(@names);
357 }
358
359 sub filename
360 {
361     my($self, $mountpoint, @constraints)=@_;
362     if(ref($constraints[$#constraints]) eq "ID3FS::PathElement::File")
363     {
364         my $id=$constraints[$#constraints]->{id};
365         my $sql=("SELECT paths.name, files.name FROM files\n" .
366                  "INNER JOIN paths ON files.paths_id=paths.id\n" .
367                  "WHERE files.id=?\n" .
368                  "GROUP BY paths.name, files.name");
369         print "FILENAME SQL: $sql\n";
370         my ($path, $name)=$self->cmd_onerow($sql, $id);
371         my $id3fs_path=join('/', map { $_->{name}; }  @constraints);
372         return($self->relativise($path, $name, $mountpoint, $id3fs_path));
373     }
374     die("DB::filename: unhandled case\n"); #FIXME
375 }
376
377 sub tags_subselect
378 {
379     my($self,@constraints)=@_;
380     use Data::Dumper;
381     my @tags=();
382     my @tags_vals=();
383     my $lasttag='';
384 #    print "CONSTRAINTS: \n", Dumper \@constraints;
385     for my $constraint (@constraints)
386     {
387 #       print ref($constraint),"\n";
388         if(ref($constraint) eq "ID3FS::PathElement::Tag")
389         {
390             if($self->tag_has_values($constraint->{id}))
391             {
392 #               print "HASVALUES\n";
393                 $lasttag=$constraint->{id} if defined($constraint->{id});
394             }
395             else
396             {
397 #               print "NOVALUES\n";
398                 push(@tags, $constraint->{id}) if(defined($constraint->{id}));
399             }
400         }
401         elsif(ref($constraint) eq "ID3FS::PathElement::Tagval")
402         {
403 #           print "TAGVAL\n";
404             push(@tags_vals, [$lasttag, $constraint->{id}]) if defined($constraint->{id});
405         }
406     }
407     unless($self->{postgres})
408     {
409         @tags=map{ "\"$_\""; } @tags;
410         @tags_vals=map( { [ map({ "\"$_\""; } @$_ ) ] } @tags_vals);
411     }
412 #    print "TAGS\n", Dumper \@tags;
413 #    print "\nVALS\n", Dumper(\@tags_vals), "\n";
414     my $sql=("\tSELECT files_x_tags.files_id FROM tags t1\n" .
415              "\tINNER JOIN files_x_tags ON t1.id=files_x_tags.tags_id\n");
416     my @clauses=();
417     if(@tags)
418     {
419         push(@clauses, "(t1.id IN ( " . join(', ', @tags) ." ) )");
420     }
421     for my $pair (@tags_vals)
422     {
423         my($tag, $val)=@$pair;
424         push(@clauses, "( t1.parents_id=$tag AND t1.id=$val )");
425     }
426     if(@clauses)
427     {
428         $sql .= "\tWHERE\n\t\t" . join("\n\t\tOR ", @clauses) . "\n";
429     }
430     return $sql;
431 }
432
433
434 sub relativise
435 {
436     my($self, $path, $name, $mountpoint, $id3fs_path)=@_;
437     $id3fs_path=~s/(.*)\/.*/$1/;
438     my $rpath="$self->{absbase}/$path";
439     my $vpath="$mountpoint/$id3fs_path";
440     my @path=split(/\//,$rpath);
441     my @rel=split(/\//,$vpath);
442     #absolute paths have empty first element due to leading /
443     shift(@path) if($path[0] eq "");
444     shift(@rel)  if($rel[0]  eq "");
445     if($path[0] ne $rel[0])
446     {
447         #no path in common, return absolute
448         print "FAIL: NO PATHS IN COMMON\n";
449         return $name;
450     }
451     # f: /home/foo/bar/baz.mp3
452     # r: /home/ianb/music/albums
453     while(@path && @rel && ($path[0] eq $rel[0]))
454     {
455         shift(@path);
456         shift(@rel);
457         print "POP ";
458     }
459     print "\n";
460     my $upcount=scalar(@rel);
461     my $result="../" x $upcount;
462     $result .= join("/",@path);
463     $result .= "/$name";
464     return $result;
465 }
466
467 sub bare_tags
468 {
469     my($self)=@_;
470     my $sql=("SELECT tags.name FROM tags\n" .
471              "WHERE tags.parents_id=''\n" .
472              "GROUP BY tags.name\n");
473     my $result=$self->cmd_rows($sql);
474     my @names=map { $_->[0]; } @$result;
475     return (@names);
476 }
477
478 sub tags_with_values
479 {
480     # FIXME: only shows one level of tag depth
481     my($self)=@_;
482     my $sql=("SELECT p.name, t.name  FROM tags t\n" .
483              "INNER JOIN tags p ON t.parents_id=p.id\n" .
484              "GROUP BY p.name, t.name\n");
485 #    print "SQL: $sql\n";
486     my $result=$self->cmd_rows($sql);
487     my $tags={};
488     for my $pair (@$result)
489     {
490         push(@{$tags->{$pair->[0]}}, $pair->[1]);
491     }
492     return $tags;
493 }
494
495 sub id
496 {
497     my($self, $type, $val)=@_;
498     my $sql="SELECT id FROM $type WHERE name=?";
499     my ($id)=$self->cmd_onerow($sql, $val);
500     return($id);
501 }
502
503 sub add
504 {
505     my($self,$path)=@_;
506     my $relpath=$path;
507     $relpath =~ s/^\Q$self->{base}\E\/?//;
508     my($filepart,$pathpart);
509     if($path !~ /\//)
510     {
511         $pathpart='';
512         $filepart=$relpath;
513     }
514     else
515     {
516         ($pathpart, $filepart) = ($relpath =~ /(.*)\/(.*)/);
517     }
518     my $file=ID3FS::AudioFile->new($path, $self->{me});
519     return unless(defined($file));
520     my $artist=$file->artist();
521     my $album=$file->album();
522     my $v1genre=$file->v1genre();
523     my $year=$file->year();
524     my $audiotype=$file->audiotype();
525     my @tags=$file->tags();
526     my $haspic=$file->haspic();
527
528     $artist=undef unless($self->ok($artist));
529     print "$self->{me}: $path: no artist tag defined\n" unless(defined($artist));
530     my $artist_id=$self->add_to_table("artists",  $artist);
531     my $path_id=$self->add_to_table("paths", $pathpart);
532     $album=undef unless($self->ok($album));
533     if($self->{verbose} && !defined($album))
534     {
535         print "$self->{me}: $path: no album tag defined\n";
536     }
537
538     my $albums_id=$self->add_to_table("albums", $album);
539     my $file_id=$self->add_to_table("files", $filepart,
540                                     { "artists_id" => $artist_id,
541                                       "albums_id"  => $albums_id,
542                                       "paths_id"   => $path_id });
543     for my $tag (@tags)
544     {
545         $self->add_tag($file_id, @$tag);
546     }
547
548     if($self->ok($year))
549     {
550         $self->add_tag($file_id, "year", $year);
551         if($year=~/^(\d\d\d)\d$/)
552         {
553             $self->add_tag($file_id, "decade", "${1}0s");
554         }
555     }
556
557     if($self->ok($v1genre))
558     {
559         $self->add_tag($file_id, "v1genre", $v1genre);
560     }
561
562     if($haspic)
563     {
564         $self->add_tag($file_id, "haspic", undef);
565     }
566 }
567
568 sub add_tag
569 {
570     my($self, $file_id, @tags)=@_;
571     my $parent_id=undef;
572     for my $tag (@tags)
573     {
574         my $tag_id=$self->add_to_table("tags",  $tag,
575                                        { "parents_id" => $parent_id });
576         $self->add_relation("files_x_tags",
577                             { "files_id" => $file_id,
578                               "tags_id"  => $tag_id });
579         $parent_id=$tag_id;
580     }
581 }
582
583 sub add_to_table
584 {
585     my($self, $table, $name, $extradata)=@_;
586     my $id=$self->lookup_id($table, $name);
587     unless(defined($id))
588     {
589         my $sql="INSERT INTO $table (";
590         $sql .= "id, " if($self->{postgres});
591         my @fields=qw(name);
592         if(defined($extradata))
593         {
594             push(@fields, sort keys(%$extradata));
595         }
596         $sql .= join(", ", @fields);
597         $sql .=") VALUES (";
598         $sql .=") nextval('seq'), " if($self->{postgres});
599         $sql .= join(", ", map { "?"; } @fields);
600         $sql .= ");";
601         $id=$self->cmd_id($sql, $name, map { $extradata->{$_} || ""; } sort keys %$extradata);
602     }
603     return $id;
604 }
605
606 sub add_relation
607 {
608     my ($self, $relname, $fields)=@_;
609     return if($self->relation_exists($relname, $fields));
610     my $sql="INSERT INTO $relname (";
611     $sql .= join(", ", sort keys(%$fields));
612     $sql .= ") VALUES (";
613     $sql .= join(", ", map { "?"; } sort keys(%$fields));
614     $sql .= ");";
615     $self->cmd($sql, map { $fields->{$_}; } sort keys(%$fields));
616 }
617
618 sub lookup_id
619 {
620     my($self, $table, $name)=@_;
621     my($id)=$self->cmd_onerow("SELECT id FROM $table where name=?", $name);
622     return $id;
623 }
624
625 sub tag_has_values
626 {
627     my($self, $id)=@_;
628     my $sql=("SELECT COUNT(*) FROM tags\n\t" .
629              "WHERE tags.parents_id=?\n");
630     my ($rows)=$self->cmd_onerow($sql, $id);
631     return $rows;
632 }
633
634 sub files_in
635 {
636     my ($self, $dir)=@_;
637     $dir=~s/^$self->{base}\/?//;
638     my $sql=("SELECT files.name FROM files\n" .
639              "INNER JOIN paths ON files.paths_id=paths.id\n" .
640              "WHERE paths.name=?\n");
641     my $files=$self->cmd_rows($sql, $dir);
642     return(map { $_->[0]; } @$files);
643 }
644
645 sub prune_directories
646 {
647     my($self)=@_;
648     my $sql=("SELECT name, id FROM paths ORDER BY name\n");
649     my $pathsref=$self->cmd_rows($sql);
650     my @ids=();
651     for my $pathpair (@$pathsref)
652     {
653         my($path, $id)=@$pathpair;
654         my $fullpath="$self->{absbase}/$path";
655         unless(-d $fullpath)
656         {
657             push(@ids, $id)
658         }
659     }
660     $self->prune_paths(@ids);
661     return scalar(@ids);
662 }
663
664 sub prune_paths
665 {
666     my($self, @ids)=@_;
667     return unless(@ids);
668     my $sql=("DELETE FROM files WHERE paths_id IN (\n\t" .
669              join(', ', map { "\"$_\""; } @ids). "\n\t)");
670     print "SQL: \n", $sql, "\n";
671     $self->cmd($sql);
672 }
673
674 sub remove_unused
675 {
676     my($self)=@_;
677     my $sql=<<'EOT';
678    DELETE FROM artists WHERE id IN (
679        SELECT artists.id FROM artists
680        LEFT JOIN files ON files.artists_id=artists.id
681        WHERE files.id IS NULL);
682
683    DELETE FROM albums WHERE id IN (
684        SELECT albums.id FROM albums
685        LEFT JOIN files ON files.albums_id=albums.id
686        WHERE files.id IS NULL);
687
688    DELETE FROM paths WHERE id IN (
689        SELECT paths.id FROM paths
690        LEFT JOIN files ON files.paths_id=paths.id
691        WHERE files.id IS NULL);
692
693    DELETE FROM files_x_tags WHERE files_id IN (
694        SELECT files_x_tags.files_id FROM files_x_tags
695        LEFT JOIN files ON files.id=files_x_tags.files_id
696        WHERE files.id IS NULL);
697
698    DELETE FROM tags WHERE id IN (
699        SELECT tags.id FROM tags
700        LEFT JOIN files_x_tags ON files_x_tags.tags_id=tags.id
701        WHERE files_x_tags.files_id IS NULL);
702
703 EOT
704     print "SQL: $sql\n";
705     my @sql=split(/\n\n/, $sql);
706     $self->cmd($_) for (@sql);
707 }
708
709 sub relation_exists
710 {
711     my ($self, $relname, $fields)=@_;
712     my $sql="SELECT count(1) FROM $relname WHERE ";
713     my @exprs=();
714     my @vals=();
715     for my $field (keys %$fields)
716     {
717         push(@exprs,$field);
718         push(@vals,$fields->{$field});
719     }
720     $sql .= join(' AND ', map { "$_=?"; } @exprs);
721     my ($ret)=$self->cmd_onerow($sql, @vals);
722     return $ret;
723 }
724
725 sub ok
726 {
727     my($self, $thing)=@_;
728     return(defined($thing) && length($thing) && $thing =~ /\S+/);
729 }
730
731 sub cmd
732 {
733     my ($self, @args)=@_;
734     # don't care about retcode
735     $self->cmd_sth(@args);
736 }
737
738 sub cmd_onerow
739 {
740     my ($self, @args)=@_;
741     my $sth=$self->cmd_sth(@args);
742     return($sth->fetchrow_array());
743 }
744
745 sub cmd_rows
746 {
747     my ($self, @args)=@_;
748     my $sth=$self->cmd_sth(@args);
749     return $sth->fetchall_arrayref();
750 }
751
752 sub cmd_id
753 {
754     my ($self, @args)=@_;
755     $self->cmd_sth(@args);
756     return($self->last_insert_id());
757 }
758
759 sub last_insert_id
760 {
761     my $self=shift;
762     if($self->{postgres})
763     {
764         return $self->{dbh}->last_insert_id(undef, undef, undef, undef,
765                                             { sequence => "seq" });
766     }
767     else
768     {
769         return $self->{dbh}->last_insert_id("","","","");
770     }
771 }
772
773 __DATA__
774
775 CREATE TABLE id3fs (
776     schema_version INTEGER,
777     last_update
778 );
779
780 CREATE TABLE paths (
781     id INTEGER PRIMARY KEY,
782     name text
783 );
784
785 CREATE TABLE artists (
786     id INTEGER PRIMARY KEY,
787     name text
788 );
789
790 CREATE TABLE albums (
791     id INTEGER PRIMARY KEY,
792     name text
793 );
794
795 CREATE TABLE files (
796     id INTEGER PRIMARY KEY,
797     name text,
798     artists_id,
799     albums_id,
800     paths_id,
801     FOREIGN KEY(artists_id) REFERENCES artists(id) ON DELETE CASCADE ON UPDATE CASCADE,
802     FOREIGN KEY(albums_id)  REFERENCES albums(id)  ON DELETE CASCADE ON UPDATE CASCADE,
803     FOREIGN KEY(paths_id)   REFERENCES paths(id)   ON DELETE CASCADE ON UPDATE CASCADE
804 );
805
806 CREATE TABLE tags (
807     id INTEGER PRIMARY KEY,
808     parents_id INTEGER,
809     name text
810 );
811
812 CREATE TABLE files_x_tags (
813     files_id INTEGER,
814     tags_id INTEGER,
815     FOREIGN KEY(files_id) REFERENCES files(id) ON DELETE CASCADE ON UPDATE CASCADE,
816     FOREIGN KEY(tags_id)  REFERENCES tags(id)  ON DELETE CASCADE ON UPDATE CASCADE
817 );
818