.. -*- rst -*-

====================================
User-visible changes in GetMediumURL
====================================

0.0a5 (2012/01/29)
==================

- Fixed YouTube plugin.

- Merge ``getmediumurl.format.SimpleFormat`` into
  ``getmediumurl.format.Format``, since there are no other subclasses
  of ``Format`` and it doesn't need to be abstract.

- Use single source for Python 2.6 or later and 3.1 or later (tested
  with 2.7 and 3.2).

0.0a4 (2011/08/12)
==================

- Fixed YouTube and Tube8 plugins.

- Removed ``getmediumurl.utils.CAN_READ_HTML`` since ``lxml`` is
  required since 0.0a2 and this constant was always true.

- ``getmediumurl.format.Format`` now has a ``codecs`` property
  containing a set of codec names used by the format (currently only
  the YouTube plugin finds them).  The ``content_type`` property
  returns whole Content-Type header with parameters, while
  ``mime_type`` is the type without parameters.

- ``getmediumurl.matcher.Matcher`` fields ``plugins`` and ``disabled``
  and the ``get_plugin`` method are deprecated.  They will be removed
  in next release to not need ``OrderedDict`` which is not useful in
  typical uses of this package.  Methods ``available_plugins`` and
  ``disabled_plugins`` allow listing plugin names and reasons why they
  are disabled.

0.0a3 (2011/07/28)
==================

- Modules reading and caching documents at URLs were split into the
  `URLReader`_ package available separately.  Their API is mostly
  rewritten.

- Python 2.5 support removed.

- Included a plugin-testing script.  Still needs documentation and
  refactoring.

- Many plugin changes.

.. _`URLReader`: http://hg.mtjm.eu/urlreader/

0.0a2 (2011/03/06)
==================

- Separated medium-related (metadata and formats) methods and
  attributes of ``getmediumurl.plugin.Plugin`` into
  ``getmediumurl.medium.Medium`` and added a method to get many media
  from a single plugin.  Needs changes in all plugins but not in
  applications using the properties of ``Plugin``.

- Add optional argument ``fast`` to ``Matcher.match`` to disable
  matching to plugins needing to check the page content, using
  ``Plugin`` attribute of the same name.

- Support at least some media linked to by the page (e.g. YouTube
  embedded videos).  It requires a plugin matching it on only URL and
  not having too many media linked.

- Require ``lxml``, dropping compatibility with other XML or HTML
  parsers (might also make plugins faster and simpler to implement).

- Don't use ``epydoc``, slightly update Sphinx-generated
  documentation.  Comments and docstrings used there are now
  dual-licensed under GNU FDL 1.3 or later.

- Allow setting values of properties decorated by
  ``getmediumurl.cache.cachedproperty``, e.g. to use in plugins
  getting data about media without fetching their own page.

- Remove ``dalealplay`` plugin, it never worked.

- Add new plugins for some pages using Flash players with FLV files,
  and for videos linked by Atom feeds.

0.0a1 (2010/12/19)
==================

- Redone YouTube video downloading.

- Use a database supported by ``anydbm`` or ``dbm`` module in
  ``getmediumurl.readercache.directory_cache``, so longer URLs are
  cached.

- Fixed Dailymotion plugin.

- All plugins have a ``formats`` method to get an iterable of medium
  format descriptions (instances of ``getmediumurl.format.Format``).
  Plugins which supported separate high quality media now get the
  medium of lowest or highest video area.  For most other plugins the
  format descriptions are incomplete.

0.0a0 (2010/12/02)
==================

Initial release, made to simplify installation.

=================
Copying this file
=================

Copyright © 2010, 2011  Michał Masłowski  <mtjm@mtjm.eu>

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.
