| Text-Template-Simple documentation | Contained in the Text-Template-Simple distribution. |
Text::Template::Simple::Cache::ID - Cache ID generator
TODO
This document describes version 0.83 of Text::Template::Simple::Cache::ID
released on 9 February 2011.
TODO
Constructor
Generates an unique cache id for the supplied data.
Returns the generated cache ID.
Set the cache ID.
Burak Gursoy <burak@cpan.org>.
Copyright 2004 - 2011 Burak Gursoy. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.12.1 or, at your option, any later version of Perl 5 you may have available.
| Text-Template-Simple documentation | Contained in the Text-Template-Simple distribution. |
package Text::Template::Simple::Cache::ID; use strict; use warnings; use vars qw($VERSION); use overload q{""} => 'get'; use Text::Template::Simple::Constants qw( MAX_FL RE_INVALID_CID ); use Text::Template::Simple::Util qw( LOG DEBUG DIGEST fatal ); $VERSION = '0.83'; sub new { my $class = shift; my $self = bless do { \my $anon }, $class; return $self; } sub get { my $self = shift; return ${$self}; } sub set { ## no critic (ProhibitAmbiguousNames) my $self = shift; my $val = shift; ${$self} = $val if defined $val; return; } sub generate { # cache id generator my($self, $data, $custom, $regex) = @_; if ( ! $data ) { fatal('tts.cache.id.generate.data') if ! defined $data; LOG( IDGEN => 'Generating ID from empty data' ) if DEBUG; } $self->set( $custom ? $self->_custom( $data, $regex ) : $self->DIGEST->add( $data )->hexdigest ); return $self->get; } sub _custom { my $self = shift; my $data = shift or fatal('tts.cache.id._custom.data'); my $regex = shift || RE_INVALID_CID; $data =~ s{$regex}{_}xmsg; # remove bogus characters my $len = length $data; # limit file name length $data = substr $data, $len - MAX_FL, MAX_FL if $len > MAX_FL; return $data; } sub DESTROY { my $self = shift || return; LOG( DESTROY => ref $self ) if DEBUG; return; } 1; __END__