Dave Cardwell: UK Perl Programmer
http://perlprogrammer.co.uk/
2007-03-07T03:45:00Z
Dave Cardwell
dave+feed@perlprogrammer.co.uk
Catalyst::Model::S3 - Catalyst Model for Amazon’s S3 web service
http://perlprogrammer.co.uk/module/Catalyst::Model::S3/
2007-03-07T03:30:00Z
I’m happy to announce the release of a new Perl module, Catalyst::Model::S3.
]]>
<p>
I’m happy to announce the release of a new Perl module, Catalyst::Model::S3.
</p>
<h2 id="what-is-it">
What is it?
</h2>
<p>
From the module’s documentation…
</p>
<blockquote cite="http://search.cpan.org/dist/Catalyst-Model-S3/">
This is a <a href="http://www.catalystframework.org/">Catalyst</a> model class that interfaces with Amazon’s Simple Storage Service. See the <a href="http://search.cpan.org/dist/Net-Amazon-S3/">Net::Amazon::S3</a> documentation for a description of the methods available. For more on S3 visit: <a href="http://aws.amazon.com/s3" title="Amazon S3">http://aws.amazon.com/s3</a>
</blockquote>
<h2 id="where-can-i-get-it">
Where can I get it?
</h2>
<p>
You can download Catalyst::Model::S3 from <a href="http://search.cpan.org/dist/Catalyst-Model-S3/">CPAN</a> or find it in the <a href="http://dev.catalystframework.org/repos/Catalyst/trunk/Catalyst-Model-S3/">Catalyst subversion repository</a>.
</p>
<p>
Please don’t hesitate to <a href="http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Model-S3">report bugs / request features</a>.
</p>
<div class="feedflare">
<a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=jMUz2pJh"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=jMUz2pJh" border="0"></img></a> <a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=LO8RNwj3"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=LO8RNwj3" border="0"></img></a>
</div>
Serving Catalyst::View::TT templates from a DBIC model
http://perlprogrammer.co.uk/catalyst/serving-catalyst::view::tt-templates-from-a-dbic-model/
2007-03-03T22:45:00Z
Template::Provider::DBIC I wanted to write a quick tutorial describing how to deploy it in your Catalyst projects.
]]>
<p>
Following yesterday’s release of <a href="/modules/Template::Provider::DBIC/">Template::Provider::DBIC</a> I wanted to write a quick tutorial describing how to deploy it in your <a href="http://www.catalystframework.org/">Catalyst</a> projects.
</p>
<h2 id="create-your-schema">
Create your schema
</h2>
<p>
The minimal <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/Schema.pm">DBIx::Class::Schema</a> required to store your templates is as follows…
</p>
<pre><code>package MyApp::Schema::Template;
use base qw/ DBIx::Class /;
__PACKAGE__->load_components( 'PK::Auto', 'Core' );
__PACKAGE__->table('template');
__PACKAGE__->add_columns(
'name', { data_type = 'VARCHAR', size => 4 },
'modified', { data_type = 'DATETIME' },
'content', { data_type = 'TEXT' },
);
__PACKAGE__->set_primary_key('name');
__PACKAGE__->add_unique_constraint( 'name', ['name'] );
1;</code></pre>
<h2 id="create-your-view">
Create your view
</h2>
<p>
The <a href="http://www.template-toolkit.org/">Template Toolkit</a> lets you specify providers through the <code>LOAD_TEMPLATES</code> configuration option…
</p>
<pre><code>package MyApp::View::TT;
use base qw/ Catalyst::View::TT /;
use Template::Provider::DBIC::Schema;
__PACKAGE__->config({
LOAD_TEMPLATES => [
Template::Provider::DBIC::Schema->new({
RESULTSET => MyApp->model('Template'),
}),
],
});
1;</code></pre>
<h2>
You’re now using DBIx::Class for your templates
</h2>
<p>
Congratulations! The Template::Provider::DBIC documentation contains further details about <a href="/modules/Template::Provider::DBIC/#options">configuration options</a>, <a href="/modules/Template::Provider::DBIC/#use-with-other-providers">use with other providers</a>, and serving templates from <a href="/modules/Template::Provider::DBIC/#synopsis">multiple ResultSets</a>.
</p>
<div class="feedflare">
<a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=KDWpxL4P"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=KDWpxL4P" border="0"></img></a> <a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=NumdGsSb"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=NumdGsSb" border="0"></img></a>
</div>
Template::Provider::DBIC - Load templates using DBIx::Class.
http://perlprogrammer.co.uk/module/Template::Provider::DBIC/
2007-03-03T22:40:00Z
Template object to fetch its data using DBIx::Class instead of, or in addition to, the default filesystem-based Template::Provider.
]]>
<p>
You can download Template::Provider::DBIC from <a href="http://search.cpan.org/dist/Template-Provider-DBIC/">CPAN</a> or find it in the <a href="http://dev.catalyst.perl.org/repos/bast/trunk/Template-Provider-DBIC/">DBIx::Class subversion repository</a>.
</p>
<h2 id="version">
Version
</h2>
<p>
This document describes Template::Provider::DBIC version 0.01
</p>
<h2 id="synopsis">
Synopsis
</h2>
<pre><code>use My::DBIC::Schema;
use Template;
use Template::Provider::DBIC;
my $schema = My::DBIC::Schema->connect(
$dsn, $user, $password, \%options
);
my $resultset = $schema->resultset('Template');</code></pre>
<p>
If all of your templates are stored in a single table the most convenient method is to pass the provider a <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/ResultSet.pm">DBIx::Class::ResultSet</a>.
</p>
<pre><code>my $template = Template->new({
LOAD_TEMPLATES => [
Template::Provider::DBIC->new({
RESULTSET => $resultset,
# Other template options like
# COMPILE_EXT...
}),
],
});
# Process the template 'my_template' from the
# resultset 'Template'.
$template->process('my_template');
# Process the template 'other_template' from the
# resultset 'Template'.
$template->process('other_template');</code></pre>
<p>
Alternatively, where your templates are stored in several tables you can pass a <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/Schema.pm">DBIx::Class::Schema</a> and specify the result set and template name in the form <code>ResultSet/template_name</code>.
</p>
<pre><code>my $template2 = Template->new({
LOAD_TEMPLATES => [
Template::Provider::DBIC->new({
SCHEMA => $schema,
# Other template options...
}),
],
});
# Process the template 'my_template' from the
# resultset 'Template'.
$template->process('Template/my_template');
# Process the template 'my_template' from the
# resultset 'Other'.
$template->process('Other/my_template');</code></pre>
<p>
In cases where both are supplied, the more specific RESULTSET will take precedence.
</p>
<h2 id="description">
Description
</h2>
<p>
Template::Provider::DBIC allows a <a href="http://search.cpan.org/dist/Template-Toolkit/lib/Template.pm">Template</a> object to fetch its data using <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class.pm">DBIx::Class</a> instead of, or in addition to, the default filesystem-based <a href="http://search.cpan.org/dist/Template-Toolkit/lib/Template/Provider.pm">Template::Provider</a>.
</p>
<h3 id="schema">
Schema
</h3>
<p>
This provider requires a schema containing at least the following:
</p>
<ul>
<li>
A column containing the template name. When <code>$template->provider($name)</code> is called the provider will search this column for the corresponding <code>$name</code>. For this reason the column must be a unique key, else an exception will be raised.
</li>
<li>
A column containing the actual template content itself. This is what will be compiled and returned when the template is processed.
</li>
<li>
A column containing the time the template was last modified. This must return - or be inflated to - a date string recognisable by <a href="http://search.cpan.org/dist/TimeDate/lib/Date/Parse.pm">Date::Parse</a>.
</li>
</ul>
<h3 id="options">
Options
</h3>
<p>
In addition to supplying a RESULTSET or SCHEMA and the standard <a href="http://search.cpan.org/dist/Template-Toolkit/lib/Template/Provider.pm">Template::Provider</a> options, you may set the following preferences:
</p>
<dl>
<dt>
COLUMN_NAME
</dt>
<dd>
The table column that contains the template name. This will default to 'name'.
</dd>
<dt>
COLUMN_CONTENT
</dt>
<dd>
The table column that contains the template data itself. This will default to 'content'.
</dd>
<dt>
COLUMN_MODIFIED
</dt>
<dd>
The table column that contains the date that the template was last modified. This will default to 'modified'.
</dd>
</dl>
<h3 id="use-with-other-providers">
Use with other providers
</h3>
<p>
By default Template::Provider::DBIC will raise an exception when it cannot find the named template. When TOLERANT is set to true it will defer processing to the next provider specified in LOAD_TEMPLATES where available. For example:
</p>
<pre><code>my $template = Template->new({
LOAD_TEMPLATES => [
Template::Provider::DBIC->new({
RESULTSET => $resultset,
TOLERANT => 1,
}),
Template::Provider->new({
INCLUDE_PATH => $path_to_templates,
}),
],
});</code></pre>
<h3 id="caching">
Caching
</h3>
<p>
When caching is enabled, by setting COMPILE_DIR and/or COMPILE_EXT, Template::Provider::DBIC will create a directory consisting of the database DSN and table name. This should prevent conflicts with other databases and providers.
</p>
<h2 id="public-methods">
Public Methods
</h2>
<h3>
->fetch( $name )
</h3>
<p>
This method is called automatically during <a href="http://search.cpan.org/dist/Template-Toolkit/lib/Template.pm">Template</a>'s <code>->process()</code> and returns a compiled template for the given <code>$name</code>, using the cache where possible.
</p>
<h2 id="diagnostics">
Diagnostics
</h2>
<p>
In addition to errors raised by <a href="http://search.cpan.org/dist/Template-Toolkit/lib/Template/Provider.pm">Template::Provider</a> and <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class.pm">DBIx::Class</a>, Template::Provider::DBIC may generate the following error messages:
</p>
<dl>
<dt>
A valid DBIx::Class::Schema or ::ResultSet is required
</dt>
<dd>
One of the SCHEMA or RESULTSET configuration options <em>must</em> be provided.
</dd>
<dt>
%s not valid: must be of the form $table/$template
</dt>
<dd>
When using Template::Provider::DBIC with a <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/Schema.pm">DBIx::Class::Schema</a> object, the template name passed to <code>->process()</code> must start with the name of the result set to search in.
</dd>
<dt>
'%s' is not a valid result set for the given schema
</dt>
<dd>
Couldn't find the result set %s in the given <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/Schema.pm">DBIx::Class::Schema</a> object.
</dd>
<dt>
Could not retrieve '%s' from the result set '%s'
</dt>
<dd>
Unless TOLERANT is set to true failure to find a template with the given name will raise an exception.
</dd>
</dl>
<h2 id="dependencies">
Dependencies
</h2>
<p>
Template::Provider::DBIC requires the following modules:
</p>
<ul>
<li>
<a href="http://search.cpan.org/dist/Template-Toolkit/lib/Template/Provider.pm">Template::Provider</a>
</li>
<li>
<a href="http://search.cpan.org/dist/TimeDate/lib/Date/Parse.pm">Date::Parse</a>
</li>
</ul>
<p>
Additionally, use of this module requires an object of the class <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/Schema.pm">DBIx::Class::Schema</a> or <a href="http://search.cpan.org/dist/DBIx-Class/lib/DBIx/Class/ResultSet.pm">DBIx::Class::ResultSet</a>.
</p>
<h2 id="bugs">
Bugs
</h2>
<p>
Please report any bugs or feature requests to <a href="mailto:bug-template-provider-dbic%20at%20rt.cpan.org">bug-template-provider-dbic at rt.cpan.org</a>, or through the web interface at <a href="http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Template-Provider-DBIC">rt.cpan.org</a>.
</p>
<h2 id="support">
Support
</h2>
<p>
You can find documentation for this module with the perldoc command.
</p>
<pre><code>perldoc Template::Provider::DBIC</code></pre>
<p>
You may also look for information at:
</p>
<ul>
<li>
<a href="http://perlprogrammer.co.uk/modules/Template::Provider::DBIC/">Template::Provider::DBIC</a>
</li>
<li>
<a href="http://annocpan.org/dist/Template-Provider-DBIC">AnnoCPAN: Annotated CPAN documentation</a>
</li>
<li>
<a href="http://rt.cpan.org/NoAuth/Bugs.html?Dist=Template-Provider-DBIC">RT: CPAN's request tracker</a>
</li>
<li>
<a href="http://search.cpan.org/dist/Template-Provider-DBIC">Search CPAN</a>
</li>
</ul>
<h2 id="author">
Author
</h2>
<p>
<a href="http://davecardwell.co.uk/">Dave Cardwell</a>
</p>
<h2 id="copyright-and-license">
Copyright and license
</h2>
<p>
Copyright © 2007 Dave Cardwell. All rights reserved.
</p>
<p>
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See <a href="http://search.cpan.org/perldoc?perlartistic">perlartistic</a>.
</p>
<div class="feedflare">
<a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=64xT4hL6"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=64xT4hL6" border="0"></img></a> <a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=8IrGcHdV"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=8IrGcHdV" border="0"></img></a>
</div>
How to set up SPF / Sender ID records with 123-reg
http://perlprogrammer.co.uk/e-mail/how-to-set-up-spf-sender-id-records-with-123-reg/
2007-03-02T06:45:00Z
After registering this domain over at 123-reg.co.uk I went about the usual business of setting up sub-domains, whois details and e-mail. This, however, was this first time I’d used their control panel to set up SPF and Sender ID DNS records. If you’re already familiar with SPF and Sender ID you can skip the next section.
]]>
<p>
After registering this domain over at <a href="http://www.123-reg.co.uk/affiliate2.cgi?id=AF163054">123-reg.co.uk</a> I went about the usual business of setting up sub-domains, whois details and e-mail. This, however, was this first time I’d used their control panel to set up <abbr>SPF</abbr> and Sender ID <abbr title="Domain Name System">DNS</abbr> records. If you’re already familiar with <abbr>SPF</abbr> and Sender ID you can <a href="#using-your-records-with-123-reg">skip the next section</a>.
</p>
<h2 id="spf-records-sender-id">
<abbr>SPF</abbr> Records? Sender ID!?
</h2>
<p>
If you’re here looking for information about <a href="http://en.wikipedia.org/wiki/Sunscreen#Sun_protection_factor" title="Wikipedia’s entry about sun protection factor">sunscreen</a> I’m afraid you’ve come to the wrong place. From <a href="http://www.openspf.org/" title="The SPF Project">the horse</a>’s mouth:
</p>
<blockquote cite="http://www.openspf.org/Introduction">
<abbr title="SPF Classic">SPFv1</abbr> allows the owner of a domain to specify their mail sending policy, e.g. which mail servers they use to send mail from their domain.
</blockquote>
<p>
<a href="http://www.microsoft.com/mscorp/safety/technologies/senderid/default.mspx">Sender ID</a> uses similar mechanisms and syntax to validate e-mail sender addresses, but differs in <em>what</em> it validates and what “layer” of the e-mail system it is concerned with.
</p>
<p>
Their respective syntaxes are beyond the scope of this tutorial and you’ll have to create your own before continuing. In my case I am using <a href="http://www.google.com/a/">Google Apps</a> for my mail, so the appropriate <abbr>SPF</abbr> and Sender ID records are respectively:
</p>
<pre><code>v=spf1 include:aspmx.googlemail.com -all
spf2.0/pra include:aspmx.googlemail.com -all</code></pre>
<h2 id="using-your-records-with-123-reg">
Using your records with 123-reg
</h2>
<ol>
<li>
Log in to your 123-reg control panel and choose the appropriate domain.
</li>
<li>
Choose “Manage <abbr>DNS</abbr>”.
</li>
<li>
Under “Add new entry” enter “@” for the name, “TXT” for the type, and use your <abbr>SPF</abbr> record for “Content”.
<span><img src="/e-mail/how-to-set-up-spf-sender-id-records-with-123-reg/add-a-new-spf-dns-entry-with-123-reg.png" width="400" height="50" alt="Add a new SPF DNS entry with 123-reg"></span>
</li>
<li>
Repeat the last step for your Sender ID token.
</li>
</ol>
<p>
It’s as simple as that! There are <a href="http://www.openspf.org/Tools">various tools</a> for testing your new set-up.
</p>
<div class="feedflare">
<a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=E1cxYdsl"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=E1cxYdsl" border="0"></img></a> <a href="http://feeds.feedburner.com/~f/perlprogrammer-full?a=XXKbJIGU"><img src="http://feeds.feedburner.com/~f/perlprogrammer-full?i=XXKbJIGU" border="0"></img></a>
</div>