CVS commit: pkgsrc/net/clive

[Thomas Klausner <wiz%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   wiz
Date:           Sat Jul 18 19:52:27 UTC 2009

Modified Files:
        pkgsrc/net/clive: Makefile distinfo
Removed Files:
        pkgsrc/net/clive: PLIST

Log Message:
Update to 2.2.1. Set LICENSE.

Version 2.2.1
(June 21, 2009)

 User-visible changes:
  * Add: support for Vimeo (closes issue #19)
  * Add: return codes for each error case (closes issue #22)
  * Fix: return code is always 0 (closes issue #20)
  * Change: --hosts output now matches cclive output

Version 2.2.0
(June 14, 2009)

FOREWORD
--------

This release is a major overhaul aimed to fix the previous design flaws
and clean up the codebase. Note that 2.2.0 breaks compatibility with
the earlier versions of clive.

Most users will not notice much differences after upgrading to 2.2.0
but those users who have used clive for anything more than "clive URL"
should read the changes carefully. The summary of changes section
includes more detailed changes that is recommended reading for all
users and maintainers.

2.2.0 changes the license from ISC to GPLv3. The license was last
changed in 2.1.0 to ISC but has now been reverted back to GPLv3 after
some further consideration.

Config::Tiny has been replaced with Getopt::ArgvFile. The latter had
some advantages over Config::Tiny that lead to the switch. For example,
instead of trying to memorize the (often confusing) config variable
names, users can now use command line options in the config file.

This also means that everytime a new feature is added to the program,
we are no longer required to modify the code responsible for parsing
the config file. Using Getopt::ArgvFile also required adding only one
line of code to the project whereas Config::Tiny required several.

cache no longer reads by default. This means that --cache-read option
must be invoked for clive to read previously stored video records
from the cache. The change was made after seeing how most users found
the reading from cache too confusing and frequently reported expired
link errors such as HTTP 403 as bugs even though the behaviour was
documented in the manual page. DAERTM?

--emit-csv now outputs very few details about the videos. Only those
fields that are known to be any use are printed out.

2.2.0 also removes a number of less used features that have lingered
in the project since the 1.x. Most of these features were never
requested and have only been burdening the program codebase since
their introduction.

Part time hackers and/or developers will notice that clive now follows
a new OO design -- as well as Perl5 allows it. While there are still
some considerations regarding the design and limitations that could not
quite be ported from C++ used in cclive, WYSIWYG.

Package/port maintainers will want to read the README file. The previously
used GNU Makefile is no longer used and clive installation now depends on
ExtUtils::MakeMaker instead.

SUMMARY of CHANGES
------------------

 User-visible changes:

  * License change
    1. ISC -> GPLv3
    2. Last changed in 2.1.0 (-> ISC)

  * Slight improvements to program startup time

  * Config file format changes (Config::Tiny -> Getopt::ArgvFile)
    1. Command line options can now be used in config file
    2. Breaks compatibility with previous versions
    3. Cleaner and new format allows using cmdline options in configs
    4. Format was last changed in 2.0.0
    Example:
    -----------------------------------------------
        # Config::Tiny: clive 2.0 - 2.1
        cat >> ~/.config/clive/config
        [http]
            proxy = "http://foo:1234";
        [output]
            savedir = "/home/user/videos"

        # Getopt::ArgvFile: clive 2.2
        cat >> ~/.cliverc
        --proxy="http://foo:1234";
        --savedir="/home/user/videos"
    -----------------------------------------------

  * Fix: Redtube video title parsing

  * Cache changes
    1. Cache is now passive (read:no, write:yes)
    2. Add: --cache- option prefix
    3. New option: --cache-read, --no-cache
    5. Rename: misc. options (e.g. --show -> --cache-dump)
    6. Record field changes
        o Breaks compatibility with previous versions
    7. New field delimiter '#'
    8. New field order

  * File path changes
    1. ~/.config/clive/config -> ~/.cliverc
    2. ~/.config/clive/recall -> ~/.clivelast
    3. ~/.config/clive/cache -> ~/.clivecache

  * --format changes
    1. Add: --format=best support (closes  issue #15 )
    2. Rename: mp4 -> fmt18 (Youtube)
    3. Rename: Dailymotion ID spark -> flv

  * Bugfixes
    1. cURL error handling
    2. Google mp4 support
    3. Do not strip link params (closes debian bug #530659)
    4. --format=fmt6 (no longer supported by Youtube?)
    5. Dailymotion ID parsing

  * New options:
    1. --home-dir
    2. --recall-file
    3. --cache-file
    4. --no-cclass
    5. --raw
    6. --stop-after (closes issue #18)

  * --emit-csv: changes to CSV fields (cleanup, print only the necessary fields)
    1. clive 2.0 - 2.1:
        page_link,          video_link,     filename,   file_length_mb,
        file_length_bytes,  video_id,       time_stamp, page_title,
        initial_length,     remaining_bytes
    2. clive 2.2:
        base_filename, file_length, video_link

  * Remove options:
    1. --savebatch
    2. --renew (now obsolete)
    3. --youtube-user (broken since 2.1)
    4. --youtube-pass (...)
    5. --no-login (...)
    6. --clivepass (...)
    7. --emit-xml
    8. --background
    9. --progress
    10. --output
    11. --append
    12. --paste
    13. --format=fmt6

  * Other changes:
    1. Long options: aliases (e.g. --output_file | --output-file | --outputfile)
    2. --filename-format: new specifiers, rename some of the old ones
    3. --format: exit with an error if id is not recognized by clive
    4. Rename: -r -> -l (--recall)
    5. Many short options have been removed (or reused)

Version 2.1.14
(May 25, 2009)

 User-visible changes:
  * Add: support for youtube-nocookie.com (closes issue #12)
  * Add: fmt35 format ID for Youtube [closes issue #10 (and #13)]
  * Fix: liveleak id parsing
  * Rename: --format IDs for Youtube
    ** mp4_hd -> fmt22
    ** 3gpp -> fmt17
    ** xflv -> fmt6
  * Rename: --output-video -> --output-file
  * Rename: output:file -> output:filename_format (config file)
  * Remove: --overwrite option (use --output-file instead)


To generate a diff of this commit:
cvs rdiff -u -r1.22 -r1.23 pkgsrc/net/clive/Makefile
cvs rdiff -u -r1.9 -r0 pkgsrc/net/clive/PLIST
cvs rdiff -u -r1.17 -r1.18 pkgsrc/net/clive/distinfo

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.