Extended help text.

[usetaglib.git] / usetaglib.cpp

diff --git a/usetaglib.cpp b/usetaglib.cpp
index a616a2ee98fb09da30cfe402cc810a0ed11ee94b..e54b09e625ce5eaec11bd6985109f2af81f7f663 100644 (file)
--- a/usetaglib.cpp
+++ b/usetaglib.cpp
@@ -1,17 +1,18 @@
-/*
-  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 3 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/>. 
-*/
+/* Copyright (C) 2015 Alexander Schmidt <alex@treefish.org>
+ *
+ * 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 3 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/>. 
+ */

 
 #include <iostream>
 #include <iomanip>
 
 #include <iostream>
 #include <iomanip>


@@ -53,39 +54,32 @@ tagpair splitToTagPair (const string &rawarg)
   return make_pair(rawarg.substr(0, delpos), rawarg.substr(delpos+1, string::npos));
 }
 
   return make_pair(rawarg.substr(0, delpos), rawarg.substr(delpos+1, string::npos));
 }
 

-void action_eraseTag (const TagLib::FileRef f, const string &key)
+void action_eraseTag (TagLib::PropertyMap &propmap, const string &key)

 {
 {

-  TagLib::PropertyMap propmap = f.file()->properties();

   propmap.erase(key);
   propmap.erase(key);

-  f.file()->setProperties(propmap);

 }
 
 }
 

-void action_replaceTag (const TagLib::FileRef f, const tagpair &tagPair)
+void action_replaceTag (TagLib::PropertyMap &propmap, const tagpair &tagPair)

 {
 {

-  TagLib::PropertyMap propmap = f.file()->properties();

   propmap.replace(tagPair.first, argToStringList(tagPair.second));
   propmap.replace(tagPair.first, argToStringList(tagPair.second));

-  f.file()->setProperties(propmap);

 }
 
 }
 

-void action_insertTag (const TagLib::FileRef f, const tagpair &tagPair)
+void action_insertTag (TagLib::PropertyMap &propmap, const tagpair &tagPair)

 {
 {

-  TagLib::PropertyMap propmap = f.file()->properties();

   propmap.insert(tagPair.first, argToStringList(tagPair.second));
   propmap.insert(tagPair.first, argToStringList(tagPair.second));

-  f.file()->setProperties(propmap);

 }
 
 }
 

-int action_printTags (const TagLib::FileRef f)
+int action_printTags (const TagLib::FileRef f, TagLib::PropertyMap &propmap)

 {
   if(f.tag()) {
 {
   if(f.tag()) {

-    TagLib::PropertyMap tags = f.file()->properties();

     unsigned int longest = 0;
     unsigned int longest = 0;

-    for(TagLib::PropertyMap::ConstIterator i = tags.begin(); i != tags.end(); ++i) {
+    for(TagLib::PropertyMap::ConstIterator i = propmap.begin(); i != propmap.end(); ++i) {

       if (i->first.size() > longest) {
        longest = i->first.size();
       }
     }
     cout << "-- TAG (properties) --" << endl;
       if (i->first.size() > longest) {
        longest = i->first.size();
       }
     }
     cout << "-- TAG (properties) --" << endl;

-    for(TagLib::PropertyMap::ConstIterator i = tags.begin(); i != tags.end(); ++i) {
+    for(TagLib::PropertyMap::ConstIterator i = propmap.begin(); i != propmap.end(); ++i) {

       for(TagLib::StringList::ConstIterator j = i->second.begin(); j != i->second.end(); ++j) {
        cout << i->first << "=" << *j << endl;
       }
       for(TagLib::StringList::ConstIterator j = i->second.begin(); j != i->second.end(); ++j) {
        cout << i->first << "=" << *j << endl;
       }


@@ -114,21 +108,36 @@ int action_printAudio (const TagLib::FileRef f)
 }
 
 void printHelp ()
 }
 
 void printHelp ()

-{
+{  

   cout << "Usage: usetaglib [ACTION]... [FILE]..." << endl;
   cout << "Usage: usetaglib [ACTION]... [FILE]..." << endl;

-  cout << "List and edit tags on mediafiles in formats supported by libtag." << endl;
+  cout << "Read and edit meta-data of audio formats supported by taglib." << endl;

   cout << endl;
   cout << "-h, --help   Show this help" << endl;
   cout << endl;
   cout << "ACTIONS" << endl;
   cout << endl;
   cout << "-h, --help   Show this help" << endl;
   cout << endl;
   cout << "ACTIONS" << endl;

-  cout << setfill(' ') << setw(45) << left << "  -l, --list"
+  cout << "  If multiple actions are specified they are executed in given order." << endl;
+  cout << endl;
+  cout << setfill(' ') << setw(37) << left << "  -l, --list"

        << "list all tags (implicit if no action specified)"<< endl;
        << "list all tags (implicit if no action specified)"<< endl;

-  cout << setfill(' ') << setw(45) << left << "  -e, --erase=TAGNAME"
-       << "erase tag with name TAGNAME"<< endl;
-  cout << setfill(' ') << setw(45) << left << "  -r, --replace=TAGNAME=TAGVAL[=TAGVAL...]"
-       << "replace tag TAGNAME with list of values TAGVAL"<< endl;
-  cout << setfill(' ') << setw(45) << left << "  -i, --insert=TAGNAME=TAGVAL[=TAGVAL...]"
-       << "insert list of values TAGVAL for tag TAGNAME"<< endl;
+  cout << setfill(' ') << setw(37) << left << "  -a, --listaudio"
+       << "show audio information"<< endl;
+  cout << setfill(' ') << setw(37) << left << "  -e, --erase=TAGNAME"
+       << "erase tag TAGNAME"<< endl;
+  cout << setfill(' ') << setw(37) << left << "  -r, --replace=TAGNAME=TAGVALSPEC"
+       << "replace tag TAGNAME with value TAGVALSPEC"<< endl;
+  cout << setfill(' ') << setw(37) << left << "  -i, --insert=TAGNAME=TAGVALSPEC"
+       << "insert value TAGVALSPEC for tag TAGNAME"<< endl;
+  cout << endl;
+  cout << "TAGVALSPEC" << endl;
+  cout << "  a list of values separated by '=': val1=val2=val3..." << endl;
+  cout << endl;
+  cout << "EXAMPLES" << endl;
+  cout << "  usetaglib file.ogg" << endl;
+  cout << "  usetaglib -e ALBUM file.flac" << endl;
+  cout << "  usetaglib -r \"ALBUM=New Album\" -i ARTIST=Horst=Hubert file.mp3" << endl;
+  cout << "  usetaglib -r ARTIST=Horst -l file1.ogg file2.mp3" << endl;
+  cout << "  usetaglib -i \"ALBUMARTIST=Horst und Hubert\" file.ogg" << endl;
+  cout << "  usetaglib --insert=\"ALBUMARTIST=Horst und Hubert\" file.ogg" << endl;

 }
   
 int main(int argc, char *argv[])
 }
   
 int main(int argc, char *argv[])


@@ -195,20 +204,28 @@ int main(int argc, char *argv[])
         }
     }
 
         }
     }
 

+  if ( optind == argc ) {
+    printHelp();
+    return 0;
+  }
+  

   if (requestedActions.size() == 0)
     requestedActions.push_back( make_pair(LIST, "") );
   if (requestedActions.size() == 0)
     requestedActions.push_back( make_pair(LIST, "") );

-  
+        

   for(int i = optind; i < argc; i++) {
     cout << "******************** \"" << argv[i] << "\" ********************" << endl;
     TagLib::FileRef f(argv[i]);
 
     if(f.isNull())
       continue;
   for(int i = optind; i < argc; i++) {
     cout << "******************** \"" << argv[i] << "\" ********************" << endl;
     TagLib::FileRef f(argv[i]);
 
     if(f.isNull())
       continue;

+
+    TagLib::PropertyMap propmap = f.file()->properties();    
+    bool FCHANGED = false;

     
     for (actionqueue::iterator actit = requestedActions.begin(); actit != requestedActions.end(); ++actit) {
       switch (actit->first) {
       case LIST:
     
     for (actionqueue::iterator actit = requestedActions.begin(); actit != requestedActions.end(); ++actit) {
       switch (actit->first) {
       case LIST:

-       action_printTags(f);
+       action_printTags(f, propmap);

        break;
        
       case AUDIO:
        break;
        
       case AUDIO:


@@ -216,20 +233,26 @@ int main(int argc, char *argv[])
        break;
        
       case ERASE:
        break;
        
       case ERASE:

-       action_eraseTag(f, actit->second);
+       action_eraseTag(propmap, actit->second);
+       FCHANGED = true;

        break;
        
       case REPLACE:
        break;
        
       case REPLACE:

-       action_replaceTag(f, splitToTagPair(actit->second));
+       action_replaceTag(propmap, splitToTagPair(actit->second));
+       FCHANGED = true;

        break;
 
       case INSERT:
        break;
 
       case INSERT:

-       action_insertTag(f, splitToTagPair(actit->second));
+       action_insertTag(propmap, splitToTagPair(actit->second));
+       FCHANGED = true;

        break;
       }
     }
        break;
       }
     }

-    
-    f.file()->save();
+
+    if (FCHANGED) {
+      f.file()->setProperties(propmap);
+      f.file()->save();
+    }

   }
   
   return 0;
   }
   
   return 0;