DBIx::Class Support

Handel now uses DBIx::Class instead of Class::DBI as the default ORM. Many thanks to the DBix::Class folk for all the support. Without the flexibility that DBIx::Class provides, Handel 1.0 would be a much less flexible.

Rose::DB::Object Support

For those who prefer working with Rose instead, Handel::Storage::RDBO 1.0 has also been released.

Schema Alterations

You can now add/remove columns from/to the default classes and schema with only a few lines of code.

Interchangable Schemas

If you already have an existing schema in your application, Handel can now use that instead of it's own.

Abstract Storage Layer

Handel now uses an abstract storage layer for cart/order operations. The default layer is Handel::Storage::DBIC and a Handel::Storage::RDBO layer is also available. New storage layers may be written (XML, LDAP, SOAP, Amazon, Google, etc) and can be used by your Handel code with almost no code changes.

Module::Starter QuickStart

Handel now includes a Module::Starter module and scripts to quick get a custom cart/order system up an running and deploy the schema to an existing database.

Pre 1.0 Compat Layer

To make the conversion to 1.0 a little less painful, 1.0 includes a few Compat modules allowing you used the old API with a new 1.0 install.

Tests, Tests, and More Tests

In addition to all of the new features and refactoring, Handel now has a plethora of tests and a 99% test coverage. That means that the code base is considered to be very stable and all new code has been accounted for.

The new version should be available on a CPAN mirror nearest you shortly. As always, you can find the latest version in the Subversion repository. If you need help, please join the mailing list or stop by #handel@irc.perl.org.

Happy Carting!

0.99_19 Thur June 21 21:02:36 2007

• Storage->setup now puts non-accessor keys into %$self
• Removed incomplete L10N Lexicons
• Cleanup coverage before 1.0 release
• DBIx::Class 0.08 Released & Required
• Added AutoCommit to Handel::Test
• Tweaked failing checkout process tests

0.99_18 Wed Apr 18 19:55:09 2007

• Added --version to handel.pl/handel.bat
• Fixed Handel::Compat::Currency pod
• Updated prereq to use DBIx::Class 0.07999_02
• Added skips for DBD::SQLite 1.13 (teh devil) causing failing tests
• Updated Perl::Critic tests

Once 1.0 is kicked out the door, I need to spend some time getting the RDBO storage layer up to date. Then, it's back to Mango.

With any luck, I'll try and post about progress often.

Through all of my tinkering with the Handel::Currency class to do conversions, formatting and integrate inflation into DBIx::Class, I kept feeling the urge to put some parts of it on CPAN because it felt like reusable code. During a few down days, I did just that. Thus, Data::Currency and DBIx::Class::InflateColumn::Currency were born.

During that process, I had a chance to clean up the Handel::Currency API into something more precise for non Handel users. The biggest change was that format is now just a property get/set like code is. It simply sets the preferred format of the current currency object. The act of formatting a currency object into a string has been moved to as_string. This felt sane because format can be verbish and nounish when talking about the currency object, so I chose to make it play the property role. As a matter of old code, stringify now is the same as as_string, rather than returning value.

So, for those using Handel 0.33, nothing is changing. When you upgrade to Handel 1.0, you can still use the Handel::Compat::Currency module if you like. For those of you using a recent version of Handel 0.99_xx, your code will have to change to use as_string instead of format. These changes will be in 0.99_17 once it hits CPAN and should be commited to the repository sometime soon.

I only feel slight bad about that. It is a developer release after all. :-)

• Added \%options/order_by to search/items in Cart/Order
• Added has_column to DBIC Storage to use ResultSource->has_column
• Added has_column to Result/DBIC Result
• Fixed TT demo code. Maybe that will die some day. Seriously. Two words: Catalyst Helpers. :-)
• Fixed issue where Compat Currency convert failed with converter returns 0
• Changed quickstart setup script to *_handel.pl
• Added 0700 perms to handel.pl app script
• Storage::process_error now only dies Handel::Exception subclasses instead of all blessed objects
• Renamed DBIC schema classes into Schema::DBIC space, like their RDBO cousins

• Reworked init_db/Storage connection with the help of John Siracusa
• Storage connection_info is now just like the DBIC storage connection_info
• Requires latest version of Rose::DB from svn/0.732 when released
• Fixed pod typo in Storage::Order::Item

The dist includes the requisite storage, schema, and result classes needed to use Handel 1.0 with Rose::DB::Object classes instead of the DBIx::Class schema classes.

To use RDBO instead of DBIC, all you have to do is change the storage_class in your storage classes generated by the bootstrap:

package MyApp::Storage::Cart;
use strict;
use warnings;

BEGIN {

    use base qw/Handel::Storage::DBIC::Cart/;

};

becomes:

package MyApp::Storage::Cart;
use strict;
use warnings;

BEGIN {

    use base qw/Handel::Storage::RDBO::Cart/;

};

You will need to do this in the Cart, Cart::Item, Order, and Order::Item storage classes. At some point I will change the generation scripts to allow one to specify DBIC or RDBO during code generation.

Handel-Storage-RDBO-0.01_01 should be available on CPAN shortly, and requires Handel 1.0, which doesn't yet exist. Please use the latest code from the 1.0 branch for now until I get another dev release out the door:

http://svn.handelframework.com/CPAN/Handel/branches/DBIC-1.0/

-=Chris

I still have to make Perl::Critic happy with the test suite (test labels). The L!0N lexicons need completed, and the demos still need fixed. This might possibly be the last dev release before 1.0.

• L10N files now use constant-like keys rather than english errors
• L10N::es_es.pm reworked by Diego Kuperman
• L10N::fr reworked by Pierrick DINTRAT
• Added l10n_lexicon_synced.t to ensure language lexicons are synced with each other via key checks
• Removed constraint_uuid check from Checkout order/cart since it's not subclass friendly (RT#19813,TKP)
• Checkout cart now throws an exception of now order can be found matching the search criteria
• Converted tests to use Handel::Test
• Cleanup tests against Perl::Critic
• Fixed Checkout prototype mismatch warning under perl > 5.8.8
• Added more config tests for MP1/MP2
• Added more Schema connect tests
• Added more Base tests
• Added Iterator tests
• Fixed bug in Iterator:::DBIC where first increments the resulset
• Fixed issue in Cat Helpers that treated MyApp::Controller:: as a valid name
• Added Catalyst Model setup tests
• Added Catalyst Scaffold Helper tests
• Added checkout_class to Order pod
• Added Module::Starter::Handel to help kickstart Handel projects
• Added currency_code_column to storage so DBIC inflators can set currency code using another column in the row
• Removed formatting options from Currency->convert now that it always returns a currency object instead of formatted strings
• Reworked Handel::Currency to be more object like with its parameters
• Added Handel::Compat::Currency, inserted automatically when loading Handel::Compat
• Added compat_currency.t tests
• Converted to Module::Pluggable::Object
• Cart restore now throws exception on unknown mode like it was supposed to
• Only create currency converter when calling convert for the first time
• Added handel.pl quickstart scripts for Module::Starter::Handel apps
• Added Catalyst::Helper::Handel to create entire cat app w/ starter subclasses
• Huge test coverage. 99% w00t!
• Mostly Perl::Critic happy...except for some test labels
• Probably last release before 1.0!

To create a new project, call the module-starter script passing in the class parameter, the project name and the other parameters required by module-starter:

module-starter --class=Module::Starter::Handel --module=MyProject \
    --author="Me" --email="me@example.com" --verbose

and you should end up with some nice new spiffy project modules:

Created MyProject
Created MyProject\lib\MyProject
Created MyProject\lib\MyProject\Cart.pm
Created MyProject\lib\MyProject\Cart
Created MyProject\lib\MyProject\Cart\Item.pm
Created MyProject\lib\MyProject\Storage
Created MyProject\lib\MyProject\Storage\Cart.pm
Created MyProject\lib\MyProject\Storage\Cart
Created MyProject\lib\MyProject\Storage\Cart\Item.pm
Created MyProject\lib\MyProject\Order.pm
Created MyProject\lib\MyProject\Order
Created MyProject\lib\MyProject\Order\Item.pm
Created MyProject\lib\MyProject\Storage\Order.pm
Created MyProject\lib\MyProject\Storage\Order
Created MyProject\lib\MyProject\Storage\Order\Item.pm
Created MyProject\lib\MyProject\Checkout.pm
Created MyProject\t
Created MyProject\t\pod-coverage.t
Created MyProject\t\pod.t
Created MyProject\t\boilerplate.t
Created MyProject\t\00-load.t
Created MyProject\.cvsignore
Created MyProject\Makefile.PL
Created MyProject\MANIFEST
Created starter directories and files