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