git.sesse.net Git - vlc/blob - modules/demux/playlist/xspf.c

   1 /*******************************************************************************
   2  * xspf.c : XSPF playlist import functions
   3  *******************************************************************************
   4  * Copyright (C) 2006 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Daniel Stränger <vlc at schmaller dot de>
   8  *          Yoann Peronneau <yoann@videolan.org>
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *******************************************************************************/
  24 /**
  25  * \file modules/demux/playlist/xspf.c
  26  * \brief XSPF playlist import functions
  27  */
  28
  29 #include <vlc/vlc.h>
  30 #include <vlc/input.h>
  31 #include <vlc/intf.h>
  32
  33 #include "playlist.h"
  34 #include "vlc_xml.h"
  35 #include "vlc_strings.h"
  36 #include "vlc_url.h"
  37 #include "xspf.h"
  38
  39 struct demux_sys_t
  40 {
  41     playlist_item_t *p_item_in_category;
  42     input_item_t **pp_tracklist;
  43     int i_tracklist_entries;
  44     int i_identifier;
  45     char * psz_base;
  46 };
  47
  48 static int Control( demux_t *, int, va_list );
  49 static int Demux( demux_t * );
  50
  51 /**
  52  * \brief XSPF submodule initialization function
  53  */
  54 int E_(Import_xspf)( vlc_object_t *p_this )
  55 {
  56     DEMUX_BY_EXTENSION_OR_FORCED_MSG( ".xspf", "xspf-open",
  57                                       "using XSPF playlist reader" );
  58     return VLC_SUCCESS;
  59 }
  60
  61 void E_(Close_xspf)( vlc_object_t *p_this )
  62 {
  63     demux_t *p_demux = (demux_t *)p_this;
  64     FREENULL( p_demux->p_sys->psz_base);
  65     free( p_demux->p_sys );
  66 }
  67
  68 /**
  69  * \brief demuxer function for XSPF parsing
  70  */
  71 int Demux( demux_t *p_demux )
  72 {
  73     int i_ret = VLC_SUCCESS;
  74     xml_t *p_xml = NULL;
  75     xml_reader_t *p_xml_reader = NULL;
  76     char *psz_name = NULL;
  77     input_item_t *p_input;
  78     INIT_PLAYLIST_STUFF;
  79     p_demux->p_sys->p_item_in_category = p_item_in_category;
  80     p_demux->p_sys->pp_tracklist = NULL;
  81     p_demux->p_sys->i_tracklist_entries = 0;
  82     p_demux->p_sys->i_identifier = -1;
  83     p_demux->p_sys->psz_base = NULL;
  84
  85     /* create new xml parser from stream */
  86     p_xml = xml_Create( p_demux );
  87     if( !p_xml )
  88         i_ret = VLC_ENOMOD;
  89     else
  90     {
  91         p_xml_reader = xml_ReaderCreate( p_xml, p_demux->s );
  92         if( !p_xml_reader )
  93             i_ret = VLC_EGENERIC;
  94     }
  95
  96     /* locating the root node */
  97     if( i_ret == VLC_SUCCESS )
  98     {
  99         do
 100         {
 101             if( xml_ReaderRead( p_xml_reader ) != 1 )
 102             {
 103                 msg_Err( p_demux, "can't read xml stream" );
 104                 i_ret = VLC_EGENERIC;
 105             }
 106         } while( i_ret == VLC_SUCCESS &&
 107                  xml_ReaderNodeType( p_xml_reader ) != XML_READER_STARTELEM );
 108     }
 109     /* checking root node name */
 110     if( i_ret == VLC_SUCCESS )
 111     {
 112         psz_name = xml_ReaderName( p_xml_reader );
 113         if( !psz_name || strcmp( psz_name, "playlist" ) )
 114         {
 115             msg_Err( p_demux, "invalid root node name: %s", psz_name );
 116             i_ret = VLC_EGENERIC;
 117         }
 118         FREE_NAME();
 119     }
 120
 121     i_ret = parse_playlist_node( p_demux, p_playlist, p_current, NULL,
 122                                  p_xml_reader, "playlist" );
 123     HANDLE_PLAY_AND_RELEASE;
 124     if( p_xml_reader )
 125         xml_ReaderDelete( p_xml, p_xml_reader );
 126     if( p_xml )
 127         xml_Delete( p_xml );
 128     return VLC_SUCCESS;
 129 }
 130
 131 /** \brief dummy function for demux callback interface */
 132 static int Control( demux_t *p_demux, int i_query, va_list args )
 133 {
 134     return VLC_EGENERIC;
 135 }
 136
 137 /**
 138  * \brief parse the root node of a XSPF playlist
 139  * \param p_demux demuxer instance
 140  * \param p_playlist playlist instance
 141  * \param p_item current playlist item
 142  * \param p_input current input item
 143  * \param p_xml_reader xml reader instance
 144  * \param psz_element name of element to parse
 145  */
 146 static vlc_bool_t parse_playlist_node COMPLEX_INTERFACE
 147 {
 148     char *psz_name=NULL;
 149     char *psz_value=NULL;
 150     vlc_bool_t b_version_found = VLC_FALSE;
 151     int i_node;
 152     xml_elem_hnd_t *p_handler=NULL;
 153
 154     xml_elem_hnd_t pl_elements[] =
 155         { {"title",        SIMPLE_CONTENT,  {.smpl = set_item_info} },
 156           {"creator",      SIMPLE_CONTENT,  {.smpl = set_item_info} },
 157           {"annotation",   SIMPLE_CONTENT,  {NULL} },
 158           {"info",         SIMPLE_CONTENT,  {NULL} },
 159           {"location",     SIMPLE_CONTENT,  {NULL} },
 160           {"identifier",   SIMPLE_CONTENT,  {NULL} },
 161           {"image",        SIMPLE_CONTENT,  {NULL} },
 162           {"date",         SIMPLE_CONTENT,  {NULL} },
 163           {"license",      SIMPLE_CONTENT,  {NULL} },
 164           {"attribution",  COMPLEX_CONTENT, {.cmplx = skip_element} },
 165           {"link",         SIMPLE_CONTENT,  {NULL} },
 166           {"meta",         SIMPLE_CONTENT,  {NULL} },
 167           {"extension",    COMPLEX_CONTENT, {.cmplx = parse_extension_node} },
 168           {"trackList",    COMPLEX_CONTENT, {.cmplx = parse_tracklist_node} },
 169           {NULL,           UNKNOWN_CONTENT, {NULL} }
 170         };
 171
 172     /* read all playlist attributes */
 173     while( xml_ReaderNextAttr( p_xml_reader ) == VLC_SUCCESS )
 174     {
 175         psz_name = xml_ReaderName( p_xml_reader );
 176         psz_value = xml_ReaderValue( p_xml_reader );
 177         if( !psz_name || !psz_value )
 178         {
 179             msg_Err( p_demux, "invalid xml stream @ <playlist>" );
 180             FREE_ATT();
 181             return VLC_FALSE;
 182         }
 183         /* attribute: version */
 184         if( !strcmp( psz_name, "version" ) )
 185         {
 186             b_version_found = VLC_TRUE;
 187             if( strcmp( psz_value, "0" ) && strcmp( psz_value, "1" ) )
 188                 msg_Warn( p_demux, "unsupported XSPF version" );
 189         }
 190         /* attribute: xmlns */
 191         else if( !strcmp( psz_name, "xmlns" ) )
 192             ;
 193         else if( !strcmp( psz_name, "xml:base" ) )
 194         {
 195             p_demux->p_sys->psz_base = decode_URI_duplicate( psz_value );
 196         }
 197         /* unknown attribute */
 198         else
 199             msg_Warn( p_demux, "invalid <playlist> attribute:\"%s\"", psz_name);
 200
 201         FREE_ATT();
 202     }
 203     /* attribute version is mandatory !!! */
 204     if( !b_version_found )
 205         msg_Warn( p_demux, "<playlist> requires \"version\" attribute" );
 206
 207     /* parse the child elements - we only take care of <trackList> */
 208     while( xml_ReaderRead( p_xml_reader ) == 1 )
 209     {
 210         i_node = xml_ReaderNodeType( p_xml_reader );
 211         switch( i_node )
 212         {
 213             case XML_READER_NONE:
 214                 break;
 215             case XML_READER_STARTELEM:
 216                 /*  element start tag  */
 217                 psz_name = xml_ReaderName( p_xml_reader );
 218                 if( !psz_name || !*psz_name )
 219                 {
 220                     msg_Err( p_demux, "invalid xml stream" );
 221                     FREE_ATT();
 222                     return VLC_FALSE;
 223                 }
 224                 /* choose handler */
 225                 for( p_handler = pl_elements;
 226                      p_handler->name && strcmp( psz_name, p_handler->name );
 227                      p_handler++ );
 228                 if( !p_handler->name )
 229                 {
 230                     msg_Err( p_demux, "unexpected element <%s>", psz_name );
 231                     FREE_ATT();
 232                     return VLC_FALSE;
 233                 }
 234                 FREE_NAME();
 235                 /* complex content is parsed in a separate function */
 236                 if( p_handler->type == COMPLEX_CONTENT )
 237                 {
 238                     if( p_handler->pf_handler.cmplx( p_demux,
 239                                                      p_playlist,
 240                                                      p_item,NULL,
 241                                                      p_xml_reader,
 242                                                      p_handler->name ) )
 243                     {
 244                         p_handler = NULL;
 245                         FREE_ATT();
 246                     }
 247                     else
 248                     {
 249                         FREE_ATT();
 250                         return VLC_FALSE;
 251                     }
 252                 }
 253                 break;
 254
 255             case XML_READER_TEXT:
 256                 /* simple element content */
 257                 FREE_ATT();
 258                 psz_value = xml_ReaderValue( p_xml_reader );
 259                 if( !psz_value )
 260                 {
 261                     msg_Err( p_demux, "invalid xml stream" );
 262                     FREE_ATT();
 263                     return VLC_FALSE;
 264                 }
 265                 break;
 266
 267             case XML_READER_ENDELEM:
 268                 /* element end tag */
 269                 psz_name = xml_ReaderName( p_xml_reader );
 270                 if( !psz_name )
 271                 {
 272                     msg_Err( p_demux, "invalid xml stream" );
 273                     FREE_ATT();
 274                     return VLC_FALSE;
 275                 }
 276                 /* leave if the current parent node <playlist> is terminated */
 277                 if( !strcmp( psz_name, psz_element ) )
 278                 {
 279                     FREE_ATT();
 280                     return VLC_TRUE;
 281                 }
 282                 /* there MUST have been a start tag for that element name */
 283                 if( !p_handler || !p_handler->name
 284                     || strcmp( p_handler->name, psz_name ))
 285                 {
 286                     msg_Err( p_demux, "there's no open element left for <%s>",
 287                              psz_name );
 288                     FREE_ATT();
 289                     return VLC_FALSE;
 290                 }
 291
 292                 if( p_handler->pf_handler.smpl )
 293                 {
 294                     p_handler->pf_handler.smpl( p_item, NULL, p_handler->name,
 295                                                 psz_value );
 296                 }
 297                 FREE_ATT();
 298                 p_handler = NULL;
 299                 break;
 300
 301             default:
 302                 /* unknown/unexpected xml node */
 303                 msg_Err( p_demux, "unexpected xml node %i", i_node );
 304                 FREE_ATT();
 305                 return VLC_FALSE;
 306         }
 307         FREE_NAME();
 308     }
 309     return VLC_FALSE;
 310 }
 311
 312 /**
 313  * \brief parses the tracklist node which only may contain <track>s
 314  */
 315 static vlc_bool_t parse_tracklist_node COMPLEX_INTERFACE
 316 {
 317     char *psz_name=NULL;
 318     int i_node;
 319     int i_ntracks = 0;
 320
 321     /* now parse the <track>s */
 322     while( xml_ReaderRead( p_xml_reader ) == 1 )
 323     {
 324         i_node = xml_ReaderNodeType( p_xml_reader );
 325         if( i_node == XML_READER_STARTELEM )
 326         {
 327             psz_name = xml_ReaderName( p_xml_reader );
 328             if( !psz_name )
 329             {
 330                 msg_Err( p_demux, "unexpected end of xml data" );
 331                 FREE_NAME();
 332                 return VLC_FALSE;
 333             }
 334             if( strcmp( psz_name, "track") )
 335             {
 336                 msg_Err( p_demux, "unexpected child of <trackList>: <%s>",
 337                          psz_name );
 338                 FREE_NAME();
 339                 return VLC_FALSE;
 340             }
 341             FREE_NAME();
 342
 343             /* parse the track data in a separate function */
 344             if( parse_track_node( p_demux, p_playlist, p_item, NULL,
 345                                    p_xml_reader,"track" ) == VLC_TRUE )
 346                 i_ntracks++;
 347         }
 348         else if( i_node == XML_READER_ENDELEM )
 349             break;
 350     }
 351
 352     /* the <trackList> has to be terminated */
 353     if( xml_ReaderNodeType( p_xml_reader ) != XML_READER_ENDELEM )
 354     {
 355         msg_Err( p_demux, "there's a missing </trackList>" );
 356         FREE_NAME();
 357         return VLC_FALSE;
 358     }
 359     psz_name = xml_ReaderName( p_xml_reader );
 360     if( !psz_name || strcmp( psz_name, "trackList" ) )
 361     {
 362         msg_Err( p_demux, "expected: </trackList>, found: </%s>", psz_name );
 363         FREE_NAME();
 364         return VLC_FALSE;
 365     }
 366     FREE_NAME();
 367
 368     msg_Dbg( p_demux, "parsed %i tracks successfully", i_ntracks );
 369
 370     return VLC_TRUE;
 371 }
 372
 373 /**
 374  * \brief parse one track element
 375  * \param COMPLEX_INTERFACE
 376  */
 377 static vlc_bool_t parse_track_node COMPLEX_INTERFACE
 378 {
 379     input_item_t *p_new_input = NULL;
 380     int i_node;
 381     char *psz_name=NULL;
 382     char *psz_value=NULL;
 383     xml_elem_hnd_t *p_handler=NULL;
 384
 385     xml_elem_hnd_t track_elements[] =
 386         { {"location",     SIMPLE_CONTENT,  {NULL} },
 387           {"identifier",   SIMPLE_CONTENT,  {NULL} },
 388           {"title",        SIMPLE_CONTENT,  {.smpl = set_item_info} },
 389           {"creator",      SIMPLE_CONTENT,  {.smpl = set_item_info} },
 390           {"annotation",   SIMPLE_CONTENT,  {NULL} },
 391           {"info",         SIMPLE_CONTENT,  {NULL} },
 392           {"image",        SIMPLE_CONTENT,  {NULL} },
 393           {"album",        SIMPLE_CONTENT,  {.smpl = set_item_info} },
 394           {"trackNum",     SIMPLE_CONTENT,  {.smpl = set_item_info} },
 395           {"duration",     SIMPLE_CONTENT,  {.smpl = set_item_info} },
 396           {"link",         SIMPLE_CONTENT,  {NULL} },
 397           {"meta",         SIMPLE_CONTENT,  {NULL} },
 398           {"extension",    COMPLEX_CONTENT, {.cmplx = skip_element} },
 399           {NULL,           UNKNOWN_CONTENT, {NULL} }
 400         };
 401
 402     while( xml_ReaderRead( p_xml_reader ) == 1 )
 403     {
 404         i_node = xml_ReaderNodeType( p_xml_reader );
 405         switch( i_node )
 406         {
 407             case XML_READER_NONE:
 408                 break;
 409
 410             case XML_READER_STARTELEM:
 411                 /*  element start tag  */
 412                 psz_name = xml_ReaderName( p_xml_reader );
 413                 if( !psz_name || !*psz_name )
 414                 {
 415                     msg_Err( p_demux, "invalid xml stream" );
 416                     FREE_ATT();
 417                     return VLC_FALSE;
 418                 }
 419                 /* choose handler */
 420                 for( p_handler = track_elements;
 421                      p_handler->name && strcmp( psz_name, p_handler->name );
 422                      p_handler++ );
 423                 if( !p_handler->name )
 424                 {
 425                     msg_Err( p_demux, "unexpected element <%s>", psz_name );
 426                     FREE_ATT();
 427                     return VLC_FALSE;
 428                 }
 429                 FREE_NAME();
 430                 /* complex content is parsed in a separate function */
 431                 if( p_handler->type == COMPLEX_CONTENT )
 432                 {
 433                     if( !p_new_input )
 434                     {
 435                         msg_Err( p_demux,
 436                                  "at <%s> level no new item has been allocated",
 437                                  p_handler->name );
 438                         FREE_ATT();
 439                         return VLC_FALSE;
 440                     }
 441                     if( p_handler->pf_handler.cmplx( p_demux,
 442                                                      p_playlist,
 443                                                      NULL, p_new_input,
 444                                                      p_xml_reader,
 445                                                      p_handler->name ) )
 446                     {
 447                         p_handler = NULL;
 448                         FREE_ATT();
 449                     }
 450                     else
 451                     {
 452                         FREE_ATT();
 453                         return VLC_FALSE;
 454                     }
 455                 }
 456                 break;
 457
 458             case XML_READER_TEXT:
 459                 /* simple element content */
 460                 FREE_ATT();
 461                 psz_value = xml_ReaderValue( p_xml_reader );
 462                 if( !psz_value )
 463                 {
 464                     msg_Err( p_demux, "invalid xml stream" );
 465                     FREE_ATT();
 466                     return VLC_FALSE;
 467                 }
 468                 break;
 469
 470             case XML_READER_ENDELEM:
 471                 /* element end tag */
 472                 psz_name = xml_ReaderName( p_xml_reader );
 473                 if( !psz_name )
 474                 {
 475                     msg_Err( p_demux, "invalid xml stream" );
 476                     FREE_ATT();
 477                     return VLC_FALSE;
 478                 }
 479                 /* leave if the current parent node <track> is terminated */
 480                 if( !strcmp( psz_name, psz_element ) )
 481                 {
 482                     FREE_ATT();
 483                     playlist_BothAddInput( p_playlist, p_new_input,
 484                                            p_demux->p_sys->p_item_in_category,
 485                                            PLAYLIST_APPEND, PLAYLIST_END );
 486                     if( p_demux->p_sys->i_identifier <
 487                         p_demux->p_sys->i_tracklist_entries )
 488                     {
 489                         p_demux->p_sys->pp_tracklist[
 490                             p_demux->p_sys->i_identifier ] = p_new_input;
 491                     }
 492                     else
 493                     {
 494                         if( p_demux->p_sys->i_identifier >
 495                             p_demux->p_sys->i_tracklist_entries )
 496                         {
 497                             p_demux->p_sys->i_tracklist_entries =
 498                                 p_demux->p_sys->i_identifier;
 499                         }
 500                         INSERT_ELEM( p_demux->p_sys->pp_tracklist,
 501                                      p_demux->p_sys->i_tracklist_entries,
 502                                      p_demux->p_sys->i_tracklist_entries,
 503                                      p_new_input );
 504                     }
 505                     return VLC_TRUE;
 506                 }
 507                 /* there MUST have been a start tag for that element name */
 508                 if( !p_handler || !p_handler->name
 509                     || strcmp( p_handler->name, psz_name ))
 510                 {
 511                     msg_Err( p_demux, "there's no open element left for <%s>",
 512                              psz_name );
 513                     FREE_ATT();
 514                     return VLC_FALSE;
 515                 }
 516
 517                 /* special case: location */
 518                 if( !strcmp( p_handler->name, "location" ) )
 519                 {
 520                     char *psz_uri=NULL;
 521                     /* there MUST NOT be an item */
 522                     if( p_new_input )
 523                     {
 524                         msg_Err( p_demux, "item <%s> already created",
 525                                  psz_name );
 526                         FREE_ATT();
 527                         return VLC_FALSE;
 528                     }
 529                     psz_uri = decode_URI_duplicate( psz_value );
 530
 531                     if( psz_uri )
 532                     {
 533                         if( p_demux->p_sys->psz_base &&
 534                             !strstr( psz_uri, "://" ) )
 535                         {
 536                            char* psz_tmp = malloc(
 537                                    strlen(p_demux->p_sys->psz_base) +
 538                                    strlen(psz_uri) +1 );
 539                            if( !psz_tmp )
 540                            {
 541                                msg_Err( p_demux, "out of memory");
 542                                return VLC_FALSE;
 543                            }
 544                            sprintf( psz_tmp, "%s%s",
 545                                     p_demux->p_sys->psz_base, psz_uri );
 546                            free( psz_uri );
 547                            psz_uri = psz_tmp;
 548                         }
 549                         p_new_input = input_ItemNewExt( p_playlist, psz_uri,
 550                                                         NULL, 0, NULL, -1 );
 551                         p_new_input->p_meta = vlc_meta_New();
 552                         free( psz_uri );
 553                         input_ItemCopyOptions( p_item->p_input, p_new_input );
 554                         psz_uri = NULL;
 555                         FREE_ATT();
 556                         p_handler = NULL;
 557                     }
 558                     else
 559                     {
 560                         FREE_ATT();
 561                         return VLC_FALSE;
 562                     }
 563                 }
 564                 else if( !strcmp( p_handler->name, "identifier" ) )
 565                 {
 566                     p_demux->p_sys->i_identifier = atoi( psz_value );
 567                 }
 568                 else
 569                 {
 570                     /* there MUST be an item */
 571                     if( !p_new_input )
 572                     {
 573                         msg_Err( p_demux, "item not yet created at <%s>",
 574                                  psz_name );
 575                         FREE_ATT();
 576                         return VLC_FALSE;
 577                     }
 578                     if( p_handler->pf_handler.smpl )
 579                     {
 580                         p_handler->pf_handler.smpl( NULL, p_new_input,
 581                                                     p_handler->name,
 582                                                     psz_value );
 583                         FREE_ATT();
 584                     }
 585                 }
 586                 FREE_ATT();
 587                 p_handler = NULL;
 588                 break;
 589
 590             default:
 591                 /* unknown/unexpected xml node */
 592                 msg_Err( p_demux, "unexpected xml node %i", i_node );
 593                 FREE_ATT();
 594                 return VLC_FALSE;
 595         }
 596         FREE_NAME();
 597     }
 598     msg_Err( p_demux, "unexpected end of xml data" );
 599     FREE_ATT();
 600     return VLC_FALSE;
 601 }
 602
 603 /**
 604  * \brief handles the supported <track> sub-elements
 605  */
 606 static vlc_bool_t set_item_info SIMPLE_INTERFACE
 607 {
 608     /* exit if setting is impossible */
 609     if( !psz_name || !psz_value || !p_input )
 610         return VLC_FALSE;
 611
 612
 613     /* re-convert xml special characters inside psz_value */
 614     resolve_xml_special_chars( psz_value );
 615
 616     /* handle each info element in a separate "if" clause */
 617     if( !strcmp( psz_name, "title" ) )
 618     {
 619         p_input->psz_name = strdup( (char*)psz_value );
 620     }
 621     else if( !strcmp( psz_name, "creator" ) )
 622     {
 623         vlc_meta_SetArtist( p_input->p_meta, psz_value );
 624     }
 625     else if( !strcmp( psz_name, "album" ) )
 626     {
 627         vlc_meta_SetAlbum( p_input->p_meta, psz_value );
 628
 629     }
 630     else if( !strcmp( psz_name, "trackNum" ) )
 631     {
 632         vlc_meta_SetTracknum( p_input->p_meta, psz_value );
 633     }
 634     else if( !strcmp( psz_name, "duration" ) )
 635     {
 636         long i_num = atol( psz_value );
 637         p_input->i_duration = i_num*1000;
 638     }
 639     return VLC_TRUE;
 640 }
 641
 642
 643 /**
 644  * \brief parse the extension node of a XSPF playlist
 645  */
 646 static vlc_bool_t parse_extension_node COMPLEX_INTERFACE
 647 {
 648     char *psz_name = NULL;
 649     char *psz_value = NULL;
 650     char *psz_title = NULL;
 651     int i_node;
 652     xml_elem_hnd_t *p_handler = NULL;
 653
 654     xml_elem_hnd_t pl_elements[] =
 655         { {"node",  COMPLEX_CONTENT, {.cmplx = parse_extension_node} },
 656           {"item",  COMPLEX_CONTENT, {.cmplx = parse_extitem_node} },
 657           {NULL,    UNKNOWN_CONTENT, {NULL} }
 658         };
 659
 660     /* read all extension node attributes */
 661     while( xml_ReaderNextAttr( p_xml_reader ) == VLC_SUCCESS )
 662     {
 663         psz_name = xml_ReaderName( p_xml_reader );
 664         psz_value = xml_ReaderValue( p_xml_reader );
 665         if( !psz_name || !psz_value )
 666         {
 667             msg_Err( p_demux, "invalid xml stream @ <node>" );
 668             FREE_ATT();
 669             return VLC_FALSE;
 670         }
 671         /* attribute: title */
 672         if( !strcmp( psz_name, "title" ) )
 673         {
 674             psz_title = unescape_URI_duplicate( psz_value );
 675         }
 676         /* unknown attribute */
 677         else
 678             msg_Warn( p_demux, "invalid <node> attribute:\"%s\"", psz_name);
 679
 680         FREE_ATT();
 681     }
 682
 683     /* attribute title is mandatory except for <extension> */
 684     if( !strcmp( psz_element, "node" ) && !psz_title )
 685     {
 686         msg_Warn( p_demux, "<node> requires \"title\" attribute" );
 687         return VLC_FALSE;
 688     }
 689     if( psz_title ) free( psz_title );
 690
 691     /* parse the child elements */
 692     while( xml_ReaderRead( p_xml_reader ) == 1 )
 693     {
 694         i_node = xml_ReaderNodeType( p_xml_reader );
 695         switch( i_node )
 696         {
 697             case XML_READER_NONE:
 698                 break;
 699             case XML_READER_STARTELEM:
 700                 /*  element start tag  */
 701                 psz_name = xml_ReaderName( p_xml_reader );
 702                 if( !psz_name || !*psz_name )
 703                 {
 704                     msg_Err( p_demux, "invalid xml stream" );
 705                     FREE_ATT();
 706                     return VLC_FALSE;
 707                 }
 708                 /* choose handler */
 709                 for( p_handler = pl_elements;
 710                      p_handler->name && strcmp( psz_name, p_handler->name );
 711                      p_handler++ );
 712                 if( !p_handler->name )
 713                 {
 714                     msg_Err( p_demux, "unexpected element <%s>", psz_name );
 715                     FREE_ATT();
 716                     return VLC_FALSE;
 717                 }
 718                 FREE_NAME();
 719                 /* complex content is parsed in a separate function */
 720                 if( p_handler->type == COMPLEX_CONTENT )
 721                 {
 722                     if( p_handler->pf_handler.cmplx( p_demux,
 723                                                      p_playlist,
 724                                                      p_item, NULL,
 725                                                      p_xml_reader,
 726                                                      p_handler->name ) )
 727                     {
 728                         p_handler = NULL;
 729                         FREE_ATT();
 730                     }
 731                     else
 732                     {
 733                         FREE_ATT();
 734                         return VLC_FALSE;
 735                     }
 736                 }
 737                 break;
 738
 739             case XML_READER_TEXT:
 740                 /* simple element content */
 741                 FREE_ATT();
 742                 psz_value = xml_ReaderValue( p_xml_reader );
 743                 if( !psz_value )
 744                 {
 745                     msg_Err( p_demux, "invalid xml stream" );
 746                     FREE_ATT();
 747                     return VLC_FALSE;
 748                 }
 749                 break;
 750
 751             case XML_READER_ENDELEM:
 752                 /* element end tag */
 753                 psz_name = xml_ReaderName( p_xml_reader );
 754                 if( !psz_name )
 755                 {
 756                     msg_Err( p_demux, "invalid xml stream" );
 757                     FREE_ATT();
 758                     return VLC_FALSE;
 759                 }
 760                 /* leave if the current parent node is terminated */
 761                 if( !strcmp( psz_name, psz_element ) )
 762                 {
 763                     FREE_ATT();
 764                     return VLC_TRUE;
 765                 }
 766                 /* there MUST have been a start tag for that element name */
 767                 if( !p_handler || !p_handler->name
 768                     || strcmp( p_handler->name, psz_name ))
 769                 {
 770                     msg_Err( p_demux, "there's no open element left for <%s>",
 771                              psz_name );
 772                     FREE_ATT();
 773                     return VLC_FALSE;
 774                 }
 775
 776                 if( p_handler->pf_handler.smpl )
 777                 {
 778                     p_handler->pf_handler.smpl( p_item, NULL, p_handler->name,
 779                                                 psz_value );
 780                 }
 781                 FREE_ATT();
 782                 p_handler = NULL;
 783                 break;
 784
 785             default:
 786                 /* unknown/unexpected xml node */
 787                 msg_Err( p_demux, "unexpected xml node %i", i_node );
 788                 FREE_ATT();
 789                 return VLC_FALSE;
 790         }
 791         FREE_NAME();
 792     }
 793     return VLC_FALSE;
 794 }
 795
 796 /**
 797  * \brief parse the extension item node of a XSPF playlist
 798  */
 799 static vlc_bool_t parse_extitem_node COMPLEX_INTERFACE
 800 {
 801     char *psz_name = NULL;
 802     char *psz_value = NULL;
 803     int i_href = -1;
 804
 805     /* read all extension item attributes */
 806     while( xml_ReaderNextAttr( p_xml_reader ) == VLC_SUCCESS )
 807     {
 808         psz_name = xml_ReaderName( p_xml_reader );
 809         psz_value = xml_ReaderValue( p_xml_reader );
 810         if( !psz_name || !psz_value )
 811         {
 812             msg_Err( p_demux, "invalid xml stream @ <item>" );
 813             FREE_ATT();
 814             return VLC_FALSE;
 815         }
 816         /* attribute: href */
 817         if( !strcmp( psz_name, "href" ) )
 818         {
 819             i_href = atoi( psz_value );
 820         }
 821         /* unknown attribute */
 822         else
 823             msg_Warn( p_demux, "invalid <item> attribute:\"%s\"", psz_name);
 824
 825         FREE_ATT();
 826     }
 827
 828     /* attribute href is mandatory */
 829     if( i_href < 0 )
 830     {
 831         msg_Warn( p_demux, "<item> requires \"href\" attribute" );
 832         return VLC_FALSE;
 833     }
 834
 835     if( i_href > p_demux->p_sys->i_tracklist_entries )
 836     {
 837         msg_Warn( p_demux, "invalid \"href\" attribute" );
 838         return VLC_FALSE;
 839     }
 840     return VLC_TRUE;
 841 }
 842
 843 /**
 844  * \brief skips complex element content that we can't manage
 845  */
 846 static vlc_bool_t skip_element COMPLEX_INTERFACE
 847 {
 848     char *psz_endname;
 849
 850     while( xml_ReaderRead( p_xml_reader ) == 1 )
 851     {
 852         if( xml_ReaderNodeType( p_xml_reader ) == XML_READER_ENDELEM )
 853         {
 854             psz_endname = xml_ReaderName( p_xml_reader );
 855             if( !psz_endname )
 856                 return VLC_FALSE;
 857             if( !strcmp( psz_element, psz_endname ) )
 858             {
 859                 free( psz_endname );
 860                 return VLC_TRUE;
 861             }
 862             else
 863                 free( psz_endname );
 864         }
 865     }
 866     return VLC_FALSE;
 867 }