Mutagen

-----------------

* ID3:

* Support for the iTunes non-standard TSO2 and TSOC frames.
* Attempt to recover from bad SYLT frames. :bug:`2`
* Attempt to recover from faulty extended header flags. :bug:`4` :bug:`21`
* Fix a bug in ID3v2.4 footer flag detection, :bug:`5`

* MP4:

* Don't fail or double-encode UTF-8 strings when given a str.
* Don't corrupt 64 bit atom sizes when resizing atoms. :bug:`17`

* EasyID3:

* Extension API for defining new "easy" tags at runtime.
* Support for many, many more tags.

* OggVorbis, OggSpeex: Handle bitrates below 0 as per the spec. :bug:`30`
* EasyMP4: Like EasyID3, but for iTunes MPEG-4 files.
* mutagen.File: New 'easy=True' argument to create new EasyMP3, EasyMP4,
EasyTrueAudio, and EasyID3FileType instances.

-----------------

* Website / code repository move.
* Bug Fixes:

* EasyID3: Invalid keys now raise KeyError (and ValueError).
* mutagen.File: .flac files with an ID3 tag will be opened as FLAC.

* MAJOR API INCOMPATIBILITY!!!!

* Python 2.6 has required us to rename the .format attribute of M4A/MP4
cover atoms, because it conflicts with the new str.format method.
It has been renamed .imageformat.

-----------------

* Bug Fixes:

* mutagen.File: Import order no longer affects what type is returned.
* mutagen.id3: Compression of frames is now disabled.
* mutagen.flac.StreamInfo: Fix channel mask (support channels > 2). :bug:`35`
* mutagen.mp3: Ignore Xing headers if they are obviously wrong.

-----------------

* Bug Fixes:

* MP4/M4A: Fixed saving of atoms with 64-bit size on 64-bit platforms.
* MP4: Conversion of 'gnre' atoms to '\xa9gen' text atoms now correctly
produces a list of string values, not just a single value.
* ID3: Broken RVA2 frames are now discarded. (Vladislav Naumov)
* ID3: Use long integers when appropriate.
* VCommentDict: Raise UnicodeEncodeErrors when trying to use a Unicode
key that is not valid ASCII; keys are also normalized to ASCII
str objects. (Forest Bond)

* Tests:
* FLAC: Use 2**64 instead of 2**32 to test overflow behavior.

-----------------

* Bug Fixes:

* FLAC: Raise IOError, instead of UnboundLocalError, when trying
to open a non-existent file. (Lukáš Lalinský, Debian 448734)
* Throw out invalid frames when upgrading from 2.3 to 2.4.
* Fixed reading of Unicode strings from ASF files on big-endian
platforms.

* TCP/TCMP support. (Debian 452231)
* Faster implementation of file-writing when mmap fails, and
exclusive advisory locking when available.
* Test cases to ensure Mutagen is not vulnerable to CVE-2007-4619.
It is not now, nor was it ever.
* Use VBRI header to calculate length of VBR MP3 files if the Xing
header is not found.

-----------------

* Write important ID3v2 frames near the start. (Lukáš Lalinský)
* Clean up distutils functions.