1Revision history for Perl extension Net::Amazon: 20.62 (01/26/2013) 3 (dc) Add support for HTTP compression where available, enabled by default. 4 (cb) Add support for EAN to the US locale, as reported by Jacob Turino. 5 (cb) Add Spain and Italy locales, as implemented by Menno Blom. 6 (cb) Add some new departments in Amazon.co.jp, as implemented Naoya Ito. 7 80.61 (10/28/2011) 9 (cb) rt 71937; Amazon now requires an Associate Tag, so enforce usage. 10 (cb) The ListLookup operation has been removed from the WSDL (from 2010!), 11 scrub all of the wishlist operations as a result. 12 (cb) Update to the latest WSDL - 2011-08-01. 13 140.60 (08/01/2011) 15 (cb) Fix the page and max_pages parameter to correctly fetch the specified 16 number of pages, and start at the correct offset. Reported as rt 69201. 17 (cb) Add a method to get similar products. Patch submitted by Jennifer. 18 (cb) Push from cpanservice: Small dist maintenance. Please use latest 19 ExtUtils::MakeMaker for release. 20 210.59 (11/02/2009) 22 (cb) DigitalMusicTrack.pm was not included, reported by Matt 23 Okeson-Harlow. 24 250.58 (11/01/2009) 26 (cb) Update the Keywords library in Validate - reported by Dave 27 Hodgkinson. 28 (cb) Added customer_location and customer_name accessors to review 29 results for Scott Weisman. 30 (cb) Nathan Handler re-re-reported a man page issue, rt 46708. 31 320.57 (09/08/2009) 33 (cb) David Raab reported an incomplete kit via rt.cpan.org. Re-run 34 make manifest to address my mistake. 35 360.56 (09/07/2009) 37 (cb) Add support for searching MP3 downloads as requsted by Dave 38 Hodgkinson. 39 (cb) Required for MP3 Downloads, and inspired by Vince Veselosky's 40 fix, update aws4-itemsearch. 41 (cb) secret_key is now a required parameter. Update all of the example 42 scripts with the secret_key parameter. 43 440.55 (07/20/2009) 45 (cb) Yuichi Tateno implemented support for the SearchIndex all. 46 (cb) Vince Veselosky fixed adm/aws4-types script, and as a result 47 updated classes in Validate/Type. 48 (cb) Update to WSDL 2009-07-16. 49 500.54 (06/17/2009) 51 (cb) Alfons Wittmann reported that signing requests broke caching due 52 to the current time being incorporated into every signed URL 53 submitted. 54 550.53 (06/13/2009) 56 (cb) Nathan Handler re-reported a man page issue on Ubuntu, rt 46708. 57 I managed to fix 197 issues, except for the specific one he called 58 out in the bug. 59 600.52 (06/09/2009) 61 (cb) Nathan Handler reported a man page issue on Ubuntu, rt 46708. 62 630.51 (06/05/2009) 64 (cb) Vince Veselosky submitted a patch to support request signing, a 65 feature that is required for accessing AWS after 2009-08-15. 66 Upgrading is recommended. 67 (cb) Complete the upgrade to WSDL 2009-03-31 that was started by 68 Vince Veselosky. 69 (cb) Clean-up POD issues found by pod checker. 70 (cb) Indicate the code has moved to github.com. 71 (cb) Update the README to reflect the actual date of the WSDL. 72 730.50 (07/29/2008) 74 (cb) Michael Hendricks submitted a patch to guarantee that error 75 messages are stored as an arrayref. 76 770.49 (04/24/2008) 78 (cb) Make an effort to return the price of an item. Check for the 79 price of an item in the following order: Amazon's price, third 80 party new, and then third party used. This issue was reported 81 by a least two different people via Mike Schilli. 82 830.48 (01/13/2008) 84 (cb) Fix from MATSUU Takuto for ReleaseDate, and Title. These methods 85 have been moved to the base class. The theatrical release date 86 is now separate from the release date function. 87 880.47 (12/16/2007) 89 (cb) Fix an issue on Darwin with Perl 5.10. Yet another issue found 90 by CPAN testers - thanks! 91 (cb) Aethon ?? (aethon@gmail.com) pointed out that OurPrice() was not 92 returning the correct price information. This has been an issue 93 since the cutover to AWS4, and is a great catch. 94 950.46 (11/16/2007) 96 (cb) Serge Dubrouski <sergeyfd@gmail.com> submitted a patch for returning 97 the width and height of the small, medium, and large images. 98 990.45 (11/11/2007) 100 (cb) Gregor Hermann <gregor+debian@comodo.priv.at> submitted a patch to 101 prevent canned tests from contacting the Amazon.com. 102 (cb) Jochen Cichon <joschi@vfnet.de> reported a bug when specifying 103 multiple ResponseGroups. 104 (cb) Update to the latest WSDL, version 2007-10-29. 105 1060.44 (11/03/2007) 107 (cb) Patch by Carl Franks <fireartist@gmail.com> to add support for 108 returning the currency code, and unformatted price. 109 (cb) Patch by Carl Franks <fireartist@gmail.com> to address the confusion 110 between release date, and publication date. Prior to version 0.44 111 release date was the publication date. Now release date is the 112 release date, and a function to return the publication date has been 113 added. 114 1150.43 (06/20/2007) 116 (cb) Simon Wistow <simon@thegestalt.org> found an bug with wishlist 117 processing, which would cause Net::Amazon to give up prematurely. 118 (cb) Be more graceful when dealing with Small ResponseGroups by trying 119 to avoid Perl warnings. 120 (cb) Added a gross hack to deal with Amazon's wishlist handling to ensure 121 the wishlist test can actually pass. 122 1230.42 (06/18/2007) 124 (cb) Add scripts to automatically generate the canned test data. 125 (cb) Serge Dubrouski <sergeyfd@gmail.com> noted an inconsistency in the 126 documentation for ImageUrl{Small,Medium,Large}. When I converted to 127 AWS4 I renamed these functions accidently. Add back the old function 128 names, and keep the new functions around. 129 1300.41 (04/10/2007) 131 (cb) Tümer Garip <tgarip@neu.edu.tr> found a long standing bug for the 132 Music properties whereby track data were not correctly captured, and 133 returned. 134 (cb) Fix the Artist test to account for this lapse in the future, and add 135 more tests as well. 136 1370.40 (03/12/2007) 138 (cb) UPC accepts a search index, so process it. 139 (cb) Fix the documentation for ProductName. 140 (cb) Make ProductName an alias for [Tt]itle, both ProductName suggestions 141 were from Frank Tobia <frank.tobia@gmail.com>. 142 (cb) Add searches for director and title, contributed by Carl Franks 143 <fireartist@gmail.com>. 144 1450.39 (02/18/2007) 146 (cb) Update documentation, 10-digit vs. 13-digit ISBN was incorrect. 147 (cb) Add support for searching by EAN. This is only valid for 148 non-US locations. Suggested by Nick Faarvang. 149 (cb) Remove UPC ItemSearch'es for non-US locales, it is invalid. 150 (cb) Fix a long standing bug when validating search against non-US 151 locales. 152 1530.38 (01/24/2007) 154 (cb) Update documentation, dewey_decimal_number is for non-fiction 155 only. 156 (cb) Add support for searching by ISBN. 157 (cb) UPC is an ItemLookup, not an ItemSearch. 158 1590.37 (01/23/2007) 160 (cb) Update to WSDL 01-17-2007. 161 (cb) Update index.html to indicate a differences between AWS3 and 162 AWS4 releases. 163 (cb) Add POD for all types of item searches. 164 (cb) Add actor, and author to the SEARCH_TYPE_CLASS_MAP. 165 (cb) README is generated from Amazon.pm, update Amazon.pm with the 166 changes made to README, and regenerate README. 167 (cb) Mike Schilli found a bug with non-US locales for Reviews where 168 TotalVotes was always zero. This caused a bogus warning. 169 1700.36 (01/09/2007) 171 (cb) Christopher Boumenot is taking over has maintainer of Net::Amazon. 172 (cb) Update the library to use AWS4 from AWS3. The changes involved 173 are quite deep. While I have strived to keep interfaces the same 174 that was not always possible. I am sure there are still bugs 175 to be had that need to be fixed. 176 (cb) Add searching by Author, Actor, MusicLabel, and Publisher. 177 (cb) Add the property functions numpages(), dewey_decimal(), and 178 SuperSaverShipping(). 179 (cb) Add new property classes for CE (consumer electronics), Software, 180 and VideoGames. 181 (cb) Restrucure the fetch code to reduce the need to directly poke 182 the XML where applicable. There is still cleanup that needs to 183 be done. 184 (cb) Remove the need to explicitly specify mode parameters. 185 (cb) Autogenerate libraries based on data from Amazon's ECS specs to 186 determine a default mode for the user. 187 (cb) Autogenerate libraries based on data form Amazon's ECS specs to 188 determine the search types available for a given. This 189 information is also locale specific. 190 (cb) Cleanup locale support, and add support for France, and Canada. 191 Locale support needs more testing. 192 (cb) Add support for the different search response types in AWS4: 193 small, medium, large, similarities, reviews, etc. The search 194 response type is automatically determined based on search mode. 195 1960.35 (02/04/2006) 197 (ms) Took starring() out of eg/asin_dvd, looks like it is no longer 198 supported by amzn (reported by Joseph Ronie). 199 2000.34 (07/11/2005) 201 (ms) Added similar_asins() to Net::Amazon::Property 202 (ms) Steven Alyari reported a caching problem on v5.8.1-RC3/darwin, 203 where perl's hashes are stored differently between invocations 204 of the same program, confusing Net::Amazon's URL-based caching 205 algorithm. Applied his fix, which sorts the query arguments. 206 2070.33 (02/23/2005) 208 (ms) Makefile.PL prerequisite changed from undef to '0'. 209 (ms) Greg McCann <greg@cambria.com> added ThirdPartyProductInfo. 210 (ms) Added Exchange requests with help by Greg McCann <greg@cambria.com>. 211 2120.32 (10/16/2004) 213 (ms) Greg McCann <greg@cambria.com> added CollectiblePrice, 214 CollectibleCount, NumberOfOfferings, UsedCount, ThirdPartyNewPrice, 215 ThirdPartyNewCount as default properties. To get (*Count, 216 NumberOfOfferings), specify "offer" => "All" in the request. 217 2180.31 (09/22/2004) 219 (ms) Lance P Cleveland <lance@lancecleveland.com> noticed that somewhere 220 between 0.26 and 0.30 the properties() method lost the ability to 221 be called in scalar context and return only the first result. Added 222 logic to re-enable it. 223 2240.30 (09/14/2004) 225 (ms) Lance Cleveland <lancec@proactivewm.com> provided a patch to 226 fix a typo which caused N::A::Request::Similar to fail. Added more 227 documentation on request classes and test cases for all constructors. 228 2290.29 (08/12/2004) 230 (ms) Brian <brianbrian@gmail.com> contributed code for querying sellers. 231 Added docs and test cases. Added a new hierarchy N::A::Result/* 232 to deal with responses containing results which aren't Amazon items. 233 (ms) fixed bug in _convert_option: Override target option only if 234 it doesn't exist already. 235 2360.28 (08/04/2004) 237 (ms) ASIN search can now process several asin numbers with one request. 238 Dan Kreft <dan@kreft.net> cleaned up the implementation of 239 Request.pm, ASIN.pm and a bunch of other files. 240 (ms) Tatsuhiko Miyagawa <miyagawa@livedoor.jp> provided a patch for 241 load errors on search(blended => ...), a fix for a bug with 242 single/multiple ProductLine(s), and a suggestion for using 243 ForceArray which XML::Simple. Added test cases for this patch. 244 (ms) Added xml_parse() method to Net::Amazon::Response which Net::Amazon 245 now calls to parse the returned XML. This enables the response 246 class (which can override it) to creatively interpret the 247 response XML to form the response data structure. 248 (ms) Added strict warnings to each and every module 249 (ms) Added dump_responses() for easier response canning. 250 2510.27 (07/27/2004) 252 (ms) Richard Giliam <nirosys@nirostasis.net> added the isbn() 253 method to the Book.pm property. 254 (ms) Andy Grundman <andy@hybridized.org> provided a patch to 255 enforce Amazon's no-more-than-1-request-per-second rule. 256 A new parameter 'strict' has been added to the Net::Amazon 257 constructor, which will limit the number of requests if 258 set to 1. Defaults to 1. 259 2600.26 (07/07/2004) 261 (ms) Added ProductDescription to Properties.pm 262 (ms) Applied patch by Robert Rothenberg <wlkngowl@i-2000.com> for 263 Media and NumMedia properties. 264 2650.25 (06/19/2004) 266 (ms) Applied patch by Robert Rothenberg <wlkngowl@i-2000.com> to 267 Properties.pm that returns the browse_nodes (categories) for 268 a result. 269 (ms) Dave Holland <dave@biff.org.uk> suggested to provide access 270 to the user agent's proxy settings. Now, proxy settings via 271 environment variables are supported (env_proxy()) as well as 272 passing Net::Amazon->new(); a prepped LWP::UserAgent instance 273 via the 'ua' parameter (see docs). 274 (ms) Accessors are no longer created in the constructors, but on the 275 package level. Thanks to tony@tmtm.com who reported this to the 276 CPAN bug tracker. 277 2780.24 (06/10/2004) 279 (ms) Fixed test bug in 007Manufacturer.t 280 (ms) Applied patch by Steve Rushe <steve@deeden.co.uk> for book->binding() 281 2820.23 (06/06/2004) 283 (ms) Evaldas Imbrasas <evaldas@wolfram.com> suggested to add SalesRank 284 to Properties.pm -- added field and test case. 285 (ms) Added eg/dejazz, a sample program to retrieve the 10 best-selling 286 jazz CDs in Germany, as presented by an article in iX magazine. 287 2880.22 (05/09/2004) 289 (ms) fixed warnings during make test (backwards-compatible without 290 tracks()) 291 (ms) Batara Kesuma <bkesuma@gaijinweb.com> sent in a patch to 292 access TotalPages (now available as $resp->total_pages()). 293 2940.21 (03/21/2004) 295 (ms) Tatsuhiko Miyagawa <miyagawa@livedoor.jp> provided a patch to 296 adapt N:A for Amazon's change of "locale=jp" requests, which 297 should be sent to xml.amazon.co.jp, instead of xml.amazon.com: 298 http://forums.prospero.com/n/mb/message.asp?webtag=am-assocdevxml&msg=4629.1&ctx=4096 299 (ms) added tracks() to N:A::Properties::Music to list track titles of CDs 300 3010.20 (03/08/2004) 302 (ms) rayg <rayg@varchars.com> added textstream search and support 303 for sorting results. 304 (ms) added directors(), director() and starring() to DVD.pm 305 3060.19 (02/13/2004) 307 (ms) Michael Coulter <mjc@bitz.ca> noticed that eg/review had the 308 wrong path to Review.pm. 309 (ms) Sam Smith <s@msmith.net> noticed that the dependency on 310 LWP::UserAgent was missing from the documentation. 311 (ms) Bill Fitzpatrick provided a patch implementing and testing 312 Manufacturer searches. 313 3140.18 (12/22/2003) 315 (ms) Brian Hirt <bhirt@mobygames.com> provided a patch for 316 multiple error messages returned by some requests to AMZN. 317 There's two accessors now, Response->messages() returning 318 a ref to an array of error messages, and Response->message() 319 returning them stringed together for backwards compatibility. 320 (ms) Padraic Renaghan <padraic@renaghan.com> provided a patch 321 for access to upc/media/nummedia fields in Music.pm 322 (ms) Fixed test suite warnings with perl 5.8.2 in N::A::Property::Book. 323 3240.17 (11/18/2003) 325 (ms) Robert Graff <rgraff@workingdemo.com> provided a patch for 326 'blended' searches. 327 3280.16 (10/10/2003) 329 (ms) Replaced 'legacy call' onca/xml2 by onca/xml3, according to 330 the AWS newsletter. 331 (ms) Martin Streicher <martin.streicher@apress.com> enhanced the 332 "power" search script (in /eg) to limit searches to page 333 ranges if so requested. 334 3350.15 (08/24/2003) 336 (ms) Martin Streicher <martin.streicher@apress.com> provided support 337 for Amazon's "Power Search". Added documentation and test case. 338 (ms) Jackie Hamilton <kira@cgi101.com> provided a patch plus 339 documentation for Browse Nodes. Added test case. 340 3410.14 (08/12/2003) 342 (ms) Mike Evron <evronm@dtcinc.net> suggested to implement caching 343 for responses. Added a Cache::File-based implementation. 344 3450.13 (08/07/2003) 346 (ms) Added customer reviews for all properties. Changed default 347 request mode to 'heavy' for that. Now all properties have a 348 review_set() method returning a 349 Net::Amazon::Attribute::ReviewSet object, which in turn offers 350 a reviews() method delivering a list of 351 Net::Amazon::Attribute::Review objects. Check the man pages 352 for details. eg/review shows an example. 353 3540.12 (07/24/2003) 355 (ms) Mike Evron <evronm@dtcinc.net> noticed that the SYNOPSIS code 356 on the main documentation page had the wrong "search" syntax 357 -- thanks, Mike! 358 (ms) Changed all tests to process canned data, live tests turned out 359 to be too unreliable, due to Amazon's "best effort" responses. 360 If you want the test suite to process live data, you need to 361 set the environment variable NET_AMAZON_LIVE_TESTS. 362 3630.11 (07/14/2003) 364 (ms) Added 'Similar Searches' API 365 (ms) Adapted for new amazon.de and amazon.co.uk searches 366 3670.10 (06/28/2003) 368 (ms) Adapted wishlist test case for change in AMZN's catalog 369 (ms) Added docs for new Net::Amazon homepage at net-amazon.sourceforge.net 370 and mailing list 371 (ms) Helper in place to assist XML::Simple in choosing the right parser, 372 to avoid install problems due to XML::SAX::RTF. 373 3740.09 (06/24/2003) 375 (ms) Tony Bowden <tony@kasei.com> suggested to have a $ua->search 376 method, abstracting the usage of the different request objects. 377 Implemented that. 378 (ms) Resolved warnings and strict errors in test cases 379 3800.08 (06/22/2003) 381 (ms) Changed dependencies to 5.006, XML::Simple and LWP::UserAgent 382 3830.07 (06/10/2003) 384 (ms) fixed bug with single-item-wishlists 385 (ms) Lists printed as strings now have numbered bullets 386 (ms) Tests are using new wishlist 1XL5DWOUFMFVJ (Net::Amazon) 387 (ms) Added tests with canned reponses 388 3890.06 (06/07/2003) 390 (ms) applied workaround for AMZN's wishlist bug: If a wishlist 391 is longer than 10 items, AMZN returns the first 10 items with 392 no indication if there's any followup pages. The workaround 393 just tries to fetch another batch in case there's exactly 10 and 394 hides eventually encountered errors. 395 396 Dan Sully <daniel@electricrain.com> provided a patch 397 to suppress a warning in case a music item isn't returning a 'year' 398 field 399 400 Barnaby Claydon <bclaydon@perseus.com> reported a couple of problems 401 with wishlists, they're fixed by the following patches: 402 403 (ms) Added new property Net::Amazon::Property::DVD 404 405 (ms) Changed as_string() of default Net::Amazon::Property (used if 406 we come across a 'Toy' or 'Video Game' category) to return 407 a more human-readable format. 408 409 (ms) Implemented retry strategy on Amazon's temporary errors, if we 410 encounter one, we'll sleep for 1 sec and then retry at most 411 twice. 412 413 (ms) Accessors have been changed to return an empty string if 414 a value hasn't been specified in XML. Products without price and 415 other anomalies won't cause perl warnings anymore. 416 4170.05 (05/31/2003) 418 Martha Greenberg <marthag@mit.edu> provided bug reports 419 and patches for 420 * 'music' parameter for UPC searches (fixed in doc) 421 * Net::Amazon::Property::Music now deals correctly with 422 CDs by multiple artists. 423 * missing documentation of 'locale' parameter 424 425 (ms) Net::Amazon now takes the 'locale' parameter also in 426 the main Net::Amazon object's constructor. 427 4280.04 (05/29/2003) 429 Dan Sully <daniel@electricrain.com> provided a patch 430 to check if a response indeed contains the {Details} hash. 431 4320.03 (05/06/2003) 433 (ms) properties returns empty list on failure now 434 435 Martha Greenberg <marthag@mit.edu> provided patch for 436 * the now mandatory associates-id in the query 437 * two documentation bugs 438 439 Konstantin Gredeskoul <kig@get.topica.com> also provided an almost 440 identical patch to the problem :). 441 4420.02 443 (ms) documentation updated 444 4450.01 446 (ms) where it all started 447