Changeset 3621

Show
Ignore:
Timestamp:
12/10/08 22:26:54 (3 months ago)
Author:
dmeyer
Message:

add some doc strings

Location:
trunk/metadata/src
Files:
10 modified

Legend:

Unmodified
Added
Removed
  • trunk/metadata/src/disc/audio.py

    r3537 r3621  
    4949 
    5050class AudioDisc(core.Disc): 
     51    """ 
     52    Audio CD support. It provides a list of tracks and if on Internet 
     53    connection is available it will use CDDB for the metadata. 
     54    """ 
    5155    def __init__(self,device): 
    5256        core.Disc.__init__(self) 
  • trunk/metadata/src/disc/dvd.py

    r3613 r3621  
    110110 
    111111class DVDInfo(core.Disc): 
    112  
     112    """ 
     113    DVD parser for DVD discs, DVD iso files and hard-disc and DVD 
     114    directory structures with a VIDEO_TS folder. 
     115    """ 
    113116    _keys = core.Disc._keys + [ 'length' ] 
    114117 
  • trunk/metadata/src/image/jpg.py

    r2943 r3621  
    7272 
    7373class JPG(core.Image): 
    74  
     74    """ 
     75    JPEG parser supporting EXIf and IPTC tables. The important 
     76    information is mapped to match the kaa.metadata key naming, the 
     77    complete table can be accessed with the _tables variable. 
     78    """ 
    7579    table_mapping = { 'EXIF': EXIFMap, 'IPTC': IPTC.mapping } 
    7680 
  • trunk/metadata/src/video/asf.py

    r3613 r3621  
    116116 
    117117class Asf(core.AVContainer): 
     118    """ 
     119    ASF video parser. The ASF format is also used for Microsft Windows 
     120    Media files like wmv. 
     121    """ 
    118122    def __init__(self, file): 
    119123        core.AVContainer.__init__(self) 
     
    376380 
    377381class AsfAudio(audiocore.Audio): 
     382    """ 
     383    ASF audio parser for wma files. 
     384    """ 
    378385    def __init__(self): 
    379386        audiocore.Audio.__init__(self) 
  • trunk/metadata/src/video/flv.py

    r3613 r3621  
    7878 
    7979class FlashVideo(core.AVContainer): 
    80  
     80    """ 
     81    Experimental parser for Flash videos. It requires certain flags to 
     82    be set to report video resolutions and in most cases it does not 
     83    provide that information. 
     84    """ 
    8185    table_mapping = { 'FLVINFO' : FLVINFO } 
    8286 
  • trunk/metadata/src/video/mkv.py

    r3613 r3621  
    281281class Matroska(core.AVContainer): 
    282282    """ 
    283     This is the main Matroska object 
     283    Matroska video and audio parser. If at least one video stream is 
     284    detected it will set the type to MEDIA_AV. 
    284285    """ 
    285286    media = core.MEDIA_AUDIO 
  • trunk/metadata/src/video/mp4.py

    r3258 r3621  
    170170 
    171171class MPEG4(core.AVContainer): 
    172  
     172    """ 
     173    Parser for the MP4 container format. This format is mostly 
     174    identical to Apple Quicktime and 3GP files. It maps to mp4, mov, 
     175    qt and some other extensions. 
     176    """ 
    173177    table_mapping = { 'QTUDTA': QTUDTA } 
    174178 
  • trunk/metadata/src/video/mpeg.py

    r3613 r3621  
    137137 
    138138class MPEG(core.AVContainer): 
     139    """ 
     140    Parser for various MPEG files. This includes MPEG-1 and MPEG-2 
     141    program streams, elementary streams and transport streams. The 
     142    reported length differs from the length reported by most video 
     143    players but the provides length here is correct. An MPEG file has 
     144    no additional metadata like title, etc; only codecs, length and 
     145    resolution is reported back. 
     146    """ 
    139147    def __init__(self,file): 
    140148        core.AVContainer.__init__(self) 
  • trunk/metadata/src/video/riff.py

    r3536 r3621  
    7878 
    7979class Riff(core.AVContainer): 
    80  
     80    """ 
     81    AVI parser also parsing metadata like title, languages, etc. 
     82    """ 
    8183    table_mapping = { 'AVIINFO' : AVIINFO } 
    8284 
  • trunk/metadata/src/video/vcd.py

    r2581 r3621  
    3939 
    4040class VCDFile(core.Collection): 
     41    """ 
     42    Parser for VCD files on hard-disc. It parses cue/bin file combinations. 
     43    """ 
    4144    def __init__(self, file): 
    4245        core.Collection.__init__(self)