fix INSTALL rst, add INSTALL.html

add tests.api module

clean examples, fix test_pipe

improve spectrogram test

fix spec default

add tests module

fix no core call

fix grapher core defaults

fix bad default scheme

rename color_scheme

add INSTALL and few infos

add sub modules to setup

fix many wrong init, fix decoder unknown uri, add dependencies

change example decoder name

rm audiolab from examples

revert module loading

fix setup for scripts

make script executable

fix bad tools module for scripts

fix script path

add scripts, rm bad header

fix bad desc dict

make it a real module with a setup

push example processors to modules, rm old modules

fix wrong buffer loops

fix bad scheme test

add waveform batch tool with scheme prefs

reduce FFT size, add scheme test, trying to fix bad spectrum

update test files (2)

update test samples

fix img path properties

add new audio test files, looping waveform tests with audio test files

rm obsolete test, to be rewritten

change processor module title, remove obsolete processors, cleanup

fix grapher buffer tasks, use URI for decoding in tests

cleanup grapher tests

rm epydoc

add epydoc HTML docs

- fix waveform peaks and centroid
- remove unnecessary adapters
- tested WAV, FLAC, OGG and MP3, mono and stereo. decoder OK
- TODO : breaks spectrogram linearity

tests/api/gstreamer.py: use actual number of channels to convert buffer

- fix multiple spectral centroid calls

- add a spectrogram example

- add mp3 sample example

- cleanup

- fix waveform scaling
- fix spectral centroid process (need a few more optimizations)
- hurray \o/ !

mv graphe module to grapher

minor api enhancement: add IValueAnalyzer.__str__()

api: require to call parent from setup(), fix and clarify IDecoder.resolution()

- adapt graph core to the new api
- WARNING, at the moment, the waveform peaks don't scale to the image width. Will be fixed later.
- add a test : tests/api/test_pipe_waveform.py
- rm tests/api/test_pipe2.py

tests/api/: add use_gst option to test files

tests/api/gstreamer.py: added first draft of gstreamer decoder/encoder

add a script to run all unit tests at once

use the custom test runner and base testcase in component test

turn input adapter test into a unit test

add custom unittest runner (grouping by test cases) and a custom base TestCase

turn testcomponent into a unittest test case

restore input adapter nframes() suppressed in r123

avoid unnecessary copy operations in input adapter

tests/api/: fix gain computation

remove absurd input adapter nframes() method: the adapter isn't meant to deal with processor output

tests/api/test_pipe.py: fix gain computation

tests/api/test_lolevel.py: fix gain computation

tests/api/test_lolevel.py: add option to pass a filename on the command line

remove debugging leftover

rely on ndarray.ndim for decoder reshaping

- add example processor illustrating FixedSizeInputAdapter usage
- require IProcessor.processor() to always return a 2D array (even for 1 channel)
- fix example FileDecoder, so that it properly returns a 2D array when channels=1

fix input adapter eod return value when the total number of frames is a multiple of the buffer size

typos

- add FixedSizeInputAdapter utility
- make nframes() a common IProcessor method, and add an nframes argument to IProcessor.setup()
- release processors from Processor destructor
- remove IDecoder.duration(), redundant with nframes and samplerate

remove grapher of test.py

re-cleanup cores

cleanup cores, fix max_level id

reset graph processes, fix no streaming error

tests/api/: only import os.path, use os.path.join

{encode,decode}/core.py: remove unused xml imports

tests/api/test_lolevel.py: use os.path.join

fix graph instance and use audiolab.Sndfile in examples

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