lib/pnd_tinyxml.cpp

   1
   2 #include <stdio.h>
   3 #include "tinyxml/tinyxml.h"
   4 #include "../include/pnd_pxml.h"
   5 #include "pnd_tinyxml.h"
   6 #include "pnd_logger.h"
   7
   8 //Easily change the tag names if required (globally in this file):
   9 #include "pnd_pxml_names.h"
  10
  11 extern "C" {
  12
  13 char *pnd_pxml_get_attribute(TiXmlElement *elem, const char *name)
  14 {
  15         const char *value = elem->Attribute(name);
  16         if (value)
  17                 return strdup(value);
  18         else
  19                 return NULL;
  20 }
  21
  22 unsigned char pnd_pxml_parse_titles(const TiXmlHandle hRoot, pnd_pxml_t *app) {
  23   TiXmlElement *pElem;
  24   app->titles_alloc_c = 4;  //TODO: adjust this based on how many titles a PXML usually has. Power of 2.
  25
  26   app->titles = (pnd_localized_string_t *)malloc(sizeof(pnd_localized_string_t) * app->titles_alloc_c);
  27   if (!app->titles) return (0); //errno = NOMEM
  28
  29   // Go through all title tags and load them.
  30   // - Check if newer style titles sub-block exists; if so, use that.
  31   //   - if not, fall back to old style
  32   //     - failing that, crash earth into sun
  33   if ( (pElem = hRoot.FirstChild(PND_PXML_NODENAME_TITLES).Element()) ) {
  34     // newer <titles> block
  35
  36     pElem = pElem -> FirstChildElement ( PND_PXML_ENAME_TITLE );
  37
  38     while ( pElem ) {
  39
  40       // handle <title lang="en_US">Program Title</title>
  41       //
  42
  43       // parse out the text and lang
  44       char *text, *lang;
  45
  46       if ( ! ( text = strdup ( pElem -> GetText() ) ) ) {
  47         continue;
  48       }
  49
  50       if ( ! ( lang = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_TITLELANG ) ) ) {
  51         continue;
  52       }
  53
  54       // increment counter; if we're running out of buffers, grow to handle the new strings
  55       app -> titles_c++;
  56
  57       if ( app -> titles_c > app -> titles_alloc_c ) {
  58         // we don't have enough strings allocated
  59         app -> titles_alloc_c <<= 1;
  60         app -> titles = (pnd_localized_string_t *)realloc((void*)app->titles, app->titles_alloc_c);
  61         if (!app->titles) return (0); //errno = ENOMEM
  62       }
  63
  64       // populate the stringbuf
  65       pnd_localized_string_t *title = &app->titles[app->titles_c - 1];
  66       title->language = lang;
  67       title->string = text;
  68
  69       // next
  70       pElem = pElem -> NextSiblingElement ( PND_PXML_ENAME_TITLE );
  71
  72     } // foreach
  73
  74   } else {
  75     // older style <title> entry series
  76
  77     for ( pElem = hRoot.FirstChild(PND_PXML_ENAME_TITLE).Element(); pElem;
  78           pElem = pElem->NextSiblingElement(PND_PXML_ENAME_TITLE))
  79     {
  80
  81       if ( ! pElem->GetText() ) {
  82         continue;
  83       }
  84
  85       char *text = strdup(pElem->GetText());
  86       if (!text) continue;
  87
  88       char *lang = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_TITLELANG);
  89       if (!lang) continue;
  90
  91       app->titles_c++;
  92       if (app->titles_c > app->titles_alloc_c) //we don't have enough strings allocated
  93       {
  94         app->titles_alloc_c <<= 1;
  95         app->titles = (pnd_localized_string_t *)realloc((void*)app->titles, app->titles_alloc_c);
  96         if (!app->titles) return (0); //errno = ENOMEM
  97       }
  98
  99       pnd_localized_string_t *title = &app->titles[app->titles_c - 1];
 100       title->language = lang;
 101       title->string = text;
 102
 103       //pnd_log ( PND_LOG_DEFAULT, (char*)"    Title/Lang: %s/%s\n", text, lang );
 104
 105     } // for
 106
 107   } // new or old style <title(s)>
 108
 109   return ( 1 );
 110 }
 111
 112 unsigned char pnd_pxml_parse_descriptions(const TiXmlHandle hRoot, pnd_pxml_t *app) {
 113   TiXmlElement *pElem;
 114   app->descriptions_alloc_c = 4; //TODO: adjust this based on how many descriptions a PXML usually has. Power of 2.
 115
 116   app->descriptions = (pnd_localized_string_t *)malloc(sizeof(pnd_localized_string_t) * app->descriptions_alloc_c);
 117   if (!app->descriptions)
 118   {
 119     app->descriptions_alloc_c = 0;
 120     return (0); //errno = NOMEM
 121   }
 122
 123   // similar logic to how <titles> or <title> is parsed
 124   // - if <titles> block is found, use that; otherwise fall back to <title> deprecated form
 125   if ( (pElem = hRoot.FirstChild ( PND_PXML_NODENAME_DESCRIPTIONS).Element() ) ) {
 126     // newer style <descriptions> block
 127
 128     pElem = pElem -> FirstChildElement ( PND_PXML_ENAME_DESCRIPTION );
 129
 130     while ( pElem ) {
 131
 132       char *text, *lang;
 133
 134       if ( ! ( text = strdup ( pElem -> GetText() ) ) ) {
 135         continue;
 136       }
 137
 138       if ( ! ( lang = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_DESCRLANG ) ) ) {
 139         continue;
 140       }
 141
 142       app->descriptions_c++;
 143       if (app->descriptions_c > app->descriptions_alloc_c) //we don't have enough strings allocated
 144       {
 145         app->descriptions_alloc_c <<= 1;
 146         app->descriptions = (pnd_localized_string_t*)realloc((void*)app->descriptions, app->descriptions_alloc_c * sizeof(pnd_localized_string_t) );
 147         if (!app->descriptions) return (0); //errno = ENOMEM
 148       }
 149
 150       pnd_localized_string_t *description = &app->descriptions[app->descriptions_c - 1];
 151       description->language = lang;
 152       description->string = text;
 153
 154       // next
 155       pElem = pElem -> NextSiblingElement ( PND_PXML_ENAME_DESCRIPTION );
 156
 157     } // foreach
 158
 159   } else {
 160     // fallback to older approach
 161
 162     for (pElem = hRoot.FirstChild(PND_PXML_ENAME_DESCRIPTION).Element(); pElem;
 163          pElem = pElem->NextSiblingElement(PND_PXML_ENAME_DESCRIPTION))
 164     {
 165
 166       if ( ! pElem->GetText() ) {
 167         continue;
 168       }
 169
 170       char *text = strdup(pElem->GetText());
 171       if (!text) continue;
 172
 173       char *lang = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_DESCRLANG);
 174       if (!lang) continue;
 175
 176       app->descriptions_c++;
 177       if (app->descriptions_c > app->descriptions_alloc_c) //we don't have enough strings allocated
 178       {
 179         app->descriptions_alloc_c <<= 1;
 180         app->descriptions = (pnd_localized_string_t*)realloc((void*)app->descriptions, app->descriptions_alloc_c * sizeof(pnd_localized_string_t) );
 181         if (!app->descriptions) return (0); //errno = ENOMEM
 182       }
 183
 184       pnd_localized_string_t *description = &app->descriptions[app->descriptions_c - 1];
 185       description->language = lang;
 186       description->string = text;
 187     } // for
 188
 189   } // new form or old form?
 190
 191   return ( 1 );
 192 }
 193
 194 unsigned char pnd_pxml_parse ( const char *pFilename, char *buffer, unsigned int length, pnd_pxml_t **apps ) {
 195
 196   //Load the XML document
 197   TiXmlDocument doc;
 198   doc.Parse(buffer);
 199
 200   unsigned char appwrappermode = 0; // >=1 -> using <application>...</application> wrapper
 201   unsigned char appcount = 0;
 202   pnd_pxml_t *app = NULL;
 203
 204   TiXmlElement *pElem = NULL;
 205   TiXmlElement *appElem = NULL;
 206
 207   //Find the root element
 208   TiXmlHandle hDoc(&doc);
 209   TiXmlHandle hRoot(0);
 210
 211   pElem = hDoc.FirstChild("PXML").Element();
 212   if (!pElem) return (0);
 213
 214   // new Strategy; really, we want multiple app support within a PXML, without the lameness of
 215   // multiple <PXML>..</PXML> within a single PXML.xml file. As such, we should have an app within
 216   // an <application>..</application> wrapper level, with the ID on that. Further, the icon and
 217   // .desktop filenames can have a # appended which is the application-count-# within the PXML,
 218   // so that they can have their own .desktop and icon without collisions, but still use the
 219   // same unique-id if they want to.
 220   //   To avoid breaking existing PXML's (even though we're pre-launch), can detect if ID
 221   // is present in PXML line or not; if not, assume application mode?
 222   hRoot = TiXmlHandle(pElem);
 223
 224   if ( hRoot.FirstChild(PND_PXML_APP).Element() != NULL ) {
 225     appwrappermode = 1;
 226     appElem = hRoot.FirstChild(PND_PXML_APP).Element();
 227     hRoot = TiXmlHandle ( appElem );
 228   }
 229
 230   // until we run out of applications in the PXML..
 231   while ( 1 ) {
 232
 233     //pnd_log ( PND_LOG_DEFAULT, (char*)"  App #%u inside of PXML %s\n", appcount, pFilename );
 234
 235     // create the buffer to hold the pxml
 236     apps [ appcount ] = (pnd_pxml_t*) malloc ( sizeof(pnd_pxml_t) );
 237     memset ( apps [ appcount ], '\0', sizeof(pnd_pxml_t) );
 238
 239     // due to old code, just make life easier a minute..
 240     app = apps [ appcount ];
 241     if ( appwrappermode ) {
 242       app -> subapp_number = appcount;
 243     } else {
 244       app -> subapp_number = 0;
 245     }
 246
 247     //Get unique ID first.
 248     if ( appwrappermode ) {
 249       app->unique_id = pnd_pxml_get_attribute(appElem, PND_PXML_ATTRNAME_UID);
 250       //pnd_log ( PND_LOG_DEFAULT, (char*)"  Subapp #%u has unique_id %s\n", appcount, app -> unique_id );
 251       app->appdata_dirname = pnd_pxml_get_attribute(appElem, PND_PXML_ATTRNAME_APPDATANAME);
 252     } else {
 253       app->unique_id = pnd_pxml_get_attribute(hRoot.Element(), PND_PXML_ATTRNAME_UID);
 254       //pnd_log ( PND_LOG_DEFAULT, (char*)"  Only-app #%u has unique_id %s\n", appcount, app -> unique_id );
 255     }
 256
 257     //Everything related to the title:
 258     pnd_pxml_parse_titles(hRoot, app);
 259
 260     //Everything description-related:
 261     pnd_pxml_parse_descriptions(hRoot, app);
 262
 263     //Everything launcher-related in one tag:
 264     if ( (pElem = hRoot.FirstChild(PND_PXML_ENAME_EXEC).Element()) )
 265      {
 266        app->background = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_EXECBG); //if this returns NULL, the struct is filled with NULL. No need to check.
 267        app->standalone = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_EXECSTAL);
 268        app->exec       = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_EXECCMD);
 269        app->startdir   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_EXECWD);
 270        app->exec_no_x11     = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_EXECNOX11);
 271        app->execargs   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_EXECARGS);
 272      }
 273
 274     //The app icon:
 275     if ( (pElem = hRoot.FirstChild(PND_PXML_ENAME_ICON).Element()) ) {
 276       app->icon       = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_ICONSRC);
 277     }
 278
 279     // <info>
 280     if ( (pElem = hRoot.FirstChild(PND_PXML_ENAME_INFO).Element()) )
 281      {
 282        app-> info_name = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_INFONAME );
 283        app-> info_filename = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_INFOSRC );
 284        app-> info_type = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_INFOTYPE );
 285      }
 286
 287     //The preview pics:
 288     if ( (pElem = hRoot.FirstChild(PND_PXML_NODENAME_PREVPICS).Element()) )
 289     {
 290       //TODO: Change this if pnd_pxml_t gains the feature of more pics than 2.
 291       if ( (pElem = pElem->FirstChildElement(PND_PXML_ENAME_PREVPIC)) )
 292       {
 293         app->previewpic1 = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_PREVPICSRC);
 294
 295         if ( (pElem = pElem->NextSiblingElement(PND_PXML_ENAME_PREVPIC)) )
 296         {
 297           app->previewpic2 = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_PREVPICSRC);
 298         }
 299       }
 300     } //previewpic
 301
 302     //The author info:
 303     if ( (pElem = hRoot.FirstChild(PND_PXML_ENAME_AUTHOR).Element()) )
 304     {
 305       app->author_name    = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_AUTHORNAME);
 306       app->author_website = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_AUTHORWWW);
 307       //TODO: Uncomment this if the author gets email support.
 308       //app->author_email = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_AUTHOREMAIL));
 309     }
 310
 311     //The version info:
 312     if ( (pElem = hRoot.FirstChild(PND_PXML_ENAME_VERSION).Element()) )
 313     {
 314       app->version_major   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_VERMAJOR);
 315       app->version_minor   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_VERMINOR);
 316       app->version_release = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_VERREL);
 317       app->version_build   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_VERBUILD);
 318     }
 319
 320     //The OS version info:
 321     if ( (pElem = hRoot.FirstChild(PND_PXML_ENAME_OSVERSION).Element()) )
 322     {
 323       app->osversion_major   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_OSVERMAJOR);
 324       app->osversion_minor   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_OSVERMINOR);
 325       app->osversion_release = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_OSVERREL);
 326       app->osversion_build   = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_OSVERBUILD);
 327     }
 328
 329     int i; //For now, we need to keep track of the index of categories.
 330     //Categories:
 331     if ( (pElem = hRoot.FirstChildElement(PND_PXML_NODENAME_CATS).Element()) ) //First, enter the "categories" node.
 332     {
 333       i = 0;
 334
 335       //Goes through all the top-level categories and their sub-categories. i helps limit these to 2.
 336       for (pElem = pElem->FirstChildElement(PND_PXML_ENAME_CAT); pElem && i < 2;
 337            pElem = pElem->NextSiblingElement(PND_PXML_ENAME_CAT), i++)
 338       {
 339         //TODO: Fix pnd_pxml_t so that there can be more than 2 category 'trees' and more than 2 subcategories. Then this can be removed.
 340         switch (i)
 341         {
 342         case 0: //first category counts as the main cat for now
 343           app->main_category = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_CATNAME);
 344           break;
 345
 346         case 1: //...second as the alternative
 347           app->altcategory = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_CATNAME);
 348         }
 349
 350         TiXmlElement *pSubCatElem; //the sub-elements for a main category.
 351         int j = 0; //the subcategory index within this category
 352
 353         //Goes through all the subcategories within this category. j helps limit these to 2.
 354         for (pSubCatElem = pElem->FirstChildElement(PND_PXML_ENAME_SUBCAT); pSubCatElem && j < 2;
 355              pSubCatElem = pSubCatElem->NextSiblingElement(PND_PXML_ENAME_SUBCAT), j++)
 356         {
 357           char *subcat = pnd_pxml_get_attribute(pSubCatElem, PND_PXML_ATTRNAME_SUBCATNAME);
 358           if (!(subcat)) continue;
 359
 360           //TODO: This is ugly. Fix pnd_pxml_t so that there can be more than 2 category 'trees' and more than 2 subcategories. Then this can be removed.
 361           switch (j | (i << 1))
 362           {
 363           case 0:
 364             app->subcategory1 = subcat;
 365             break;
 366           case 1:
 367             app->subcategory2 = subcat;
 368             break;
 369           case 2:
 370             app->altsubcategory1 = subcat;
 371             break;
 372           case 3:
 373             app->altsubcategory2 = subcat;
 374           }
 375         }
 376       }
 377     }
 378
 379     //All file associations:
 380     //Step into the associations node
 381     if ( (pElem = hRoot.FirstChild(PND_PXML_NODENAME_ASSOCS).Element()) )
 382     {
 383       i = 0;
 384       //Go through all associations. i serves as index; since the format only supports 3 associations we need to keep track of the number.
 385       for (pElem = pElem->FirstChildElement(PND_PXML_ENAME_ASSOC); pElem && i < 3;
 386            pElem = pElem->NextSiblingElement(PND_PXML_ENAME_ASSOC), i++)
 387       {
 388         char *name = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_ASSOCNAME);
 389         char *filetype = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_ASSOCFTYPE);
 390         char *paramter = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_ASSOCARGS);
 391
 392         if (!(name && filetype && paramter)) continue;
 393
 394         switch(i) //TODO: same problem here: only 3 associations supported
 395         {
 396         case 0:
 397         {
 398           app->associationitem1_name      = name;
 399           app->associationitem1_filetype  = filetype;
 400           app->associationitem1_parameter = paramter;
 401           break;
 402         }
 403         case 1:
 404         {
 405           app->associationitem2_name      = name;
 406           app->associationitem2_filetype  = filetype;
 407           app->associationitem2_parameter = paramter;
 408           break;
 409         }
 410         case 2:
 411         {
 412           app->associationitem3_name      = name;
 413           app->associationitem3_filetype  = filetype;
 414           app->associationitem3_parameter = paramter;
 415         }
 416         }
 417       }
 418     }
 419
 420     //Performance related things (aka: Clockspeed XD):
 421     pElem = hRoot.FirstChild(PND_PXML_ENAME_CLOCK).Element();
 422     if (pElem)
 423     {
 424       app->clockspeed = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_CLOCKFREQ);
 425     }
 426
 427     // Package
 428     pElem = hRoot.FirstChild ( PND_PXML_ENAME_PACKAGE ).Element();
 429     if ( pElem ) {
 430       app -> package_name = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_PACKAGE_NAME );
 431       app -> package_release_date = pnd_pxml_get_attribute ( pElem, PND_PXML_ATTRNAME_PACKAGE_DATE );
 432     }
 433
 434     // mkdir request
 435     if ( (pElem = hRoot.FirstChild(PND_PXML_NODENAME_MKDIR).Element()) ) {
 436
 437       // seek <dir>
 438       if ( (pElem = pElem->FirstChildElement(PND_PXML_ENAME_MKDIR)) ) {
 439         char *t;
 440
 441         if ( ( t = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_MKDIRPATH) ) ) {
 442           // first <dir>, so just replace it wholesale; we use strdup so we can free() easily later, consistently. Mmm, leak seems imminent.
 443           app -> mkdir_sp = strdup ( t );
 444         }
 445
 446         while ( ( pElem = pElem -> NextSiblingElement ( PND_PXML_ENAME_MKDIR ) ) ) {
 447
 448           if ( ( t = pnd_pxml_get_attribute(pElem, PND_PXML_ATTRNAME_MKDIRPATH) ) ) {
 449             char *foo = (char*) malloc ( strlen ( app -> mkdir_sp ) + strlen ( t ) + 1 /*:*/ + 1 /*\0*/ );
 450
 451             if ( foo ) {
 452               sprintf ( foo, "%s:%s", app -> mkdir_sp, t );
 453               free ( app -> mkdir_sp );
 454               app -> mkdir_sp = foo;
 455             } // assuming we got ram, lets cat it all together
 456
 457           } // got another elem?
 458
 459         } // while
 460
 461       } // found a <dir>
 462
 463 #if 0
 464       if ( app -> mkdir_sp ) {
 465         printf ( "mkdir: %s\n", app -> mkdir_sp );
 466       }
 467 #endif
 468
 469     } // mkdir
 470
 471     // if in <application> mode, do we find another app?
 472     if ( appwrappermode ) {
 473       appElem = appElem -> NextSiblingElement ( PND_PXML_APP );
 474       if ( ! appElem ) {
 475         //pnd_log ( PND_LOG_DEFAULT, (char*)"  No more applications within PXML\n" );
 476         break; // no more applications
 477       }
 478       // got another application..
 479       //pnd_log ( PND_LOG_DEFAULT, "  Found another applications within PXML\n" );
 480       appwrappermode++;
 481       hRoot = TiXmlHandle ( appElem );
 482
 483       appcount++;
 484
 485       if ( appcount == PXML_MAXAPPS ) {
 486         return ( 1 ); // thats all we can handle; we're not going to auto-extend this
 487       }
 488
 489     } else {
 490       break; // single-app old PXML
 491     }
 492
 493   } // while finding apps
 494
 495   return (1);
 496 }
 497
 498 } // extern C