prepare graph api and new core

try to get grapher example working

simplify the grapher api, add a waveform grapher example

support process pipes concatenation (ie: pipe1 | pipe2)

add IProcessor.release()

- add processing pipes support, using ProcessPipe and operator overloading
- add tests/api/test_pipe.py and rename tests/api/test.py to test_lolevel.py
- remove all buffersize constraints in core/api
- replace IProcessor.set_input_format() with setup(), which also resets the processor
- suppress IProcessor.input_format()
- replace IProcessor.output_format() with channels() and samplerate()
- remove IGrapher.set_nframes(), this is implementation specific
- add short guitar.wav (sweep samples drives my crazy ;)
- shorten example processor names (GainEffect -> Gain, etc...)

rename testnewcore.py to testcomponent.py

component:
- add ability ro register abstract classes. These can register as implementing
  some interfaces, but are by default not listed by implementations()
- add automatic interface-to-component __doc__ propagation, with the
  @interfacedoc method decorator

api:
- general idea: prepare for processor "pipes" high-level api
- move process() into IProcessor, make it a generic method
- add IProcessors methods that relate to buffersize, and input/output format
- add IDecoder.nframes()
- add IEffect, an interface for effect processors

tests:
- fix testnewcore.py
- add test and examples of processors implementing the new api and component
  system

others:
- add empty Metadata class

encoder : replace sox by ffmpeg for decoding (buggy now for flac and wav encoding)

add missing component.py

core: add processor buffersize (default 65536), required to be a power of 2 and >= 4096
for proper support of fft-based analyzers and similar
refactor api:
- improve documentation
- remove IEncoder.finish(), same as process() with nframes < buffersize
- remove format(), description() and such from IDecoder, a decoder can handle multiple
  formats so this information is dynamic
- add duration(), samplerate(), channels() etc... to IDecoder, obsoleting all
  corresponding analyzers
- add IGrapher.process()
- require IGrapher.render() to return a PIL image instead of streaming binary data,
  and move the width/height arguments into the constructor
- add IAnalyzer.process()
- add IValueAnalyzer and let dc, maxlevel and meanlevel analyzers implement it
- move result() into IValueAnalyzer. This method may not be adequate for other types of analyzers

- merge all api's into timeside.api
- add core.get_processor()
- put all exceptions into exceptions.py
- use SubProcessError instead of EncodeProcesError, DecodeProcessError and VampProcessError
- rename TimeSideError to Error (= timeside.Error)

- move id() into to IProcessor, all processors are required to implement this static method
- MetaProcessor now ensures that all id's are wellformed and unique and raise an exception otherwise
- add id() to all encoders and decoders, and make it static in analyzers and graphers
- remove underscores and shorten a couple of id's, see the doc of IProcessor.id()

- move generic component/interface architecture from core to component.py
- add Processor, MetaProcessor and processors() to core
- add IProcessor base interface for all processor interfaces
- let IAnalyzer, IGrapher, IEncoder and IDecoder subclass IProcessor
- let all actual processor classes descend from Processor
- use processors() instead of implementations() in test.py
- add listprocessors.py test script

core: the descendants of a component implementing an interface do not automatically implement this interface anymore

- turn all such methods as name(), id(), file_extension() into static methods
- add the self argument to non static methods in interfaces for clarity
- encode api: the constructor doesn't conflict anymore with the new core, fixme gone

encode api: revert to methods instead of data members (format, description, ..), for support of __doc__

replace the core with the new core:
- requires absolutely no change in the encode, decode, analyze and graph code
- the test scripts needed a few changes

modify test.py for support of an alternative magic module, as the one found in Debian Lenny (??)

encode api: use data members instead of methods for format, description, file extension and mime_type

migrate TimeSideError into new core (shouldn't be there though)

add new core:
- less intrusive component/interface mechanism
- no need for a component manager
- one can create several instances of a component (no singleton)
- component constructors do not need component manager anymore
- unit test included

fix trivial syntax error

refactor encode api

api: remove IEncoder.set_cache_dir()

cleanup descriptions

validate against sox 14.3

get decoder by mime type, cross coding tests

fix decoder output and metadata management

more audio tests

get first encoder test

grapher testing

add init

make a processor call test, new api debug

rename IMediaItemAnalyzer to IAnalyzer

add metadata comments

fix analyze paths

mv img

mv img

cleanup

fix format descriptions

modify encode and decode apis, adapt each plugins

rename decode and encode cores

rename analysis

change export to decode/encode

reorder deps

first dependencies

add core then ExtensionPoint class, fix module names

first import of export, graph and analysis related classes

import TimeSide UI 0.1, add GPL license file

Initial directory structure.