view release on metacpan or  search on metacpan

lib/Acme/AwesomeQuotes.pm  view on Meta::CPAN

}


sub checkstring {
	my $string = $_[0];
	if ($string eq '') {
		die "String is empty!\n";
	}
	elsif ((($string =~ /^`\p{Letter}${chartypes{notgrave}}*\x{0300}/) &&
	        ($string =~ /\p{Letter}${chartypes{notacute}}*\x{0301}${chartypes{notacute}}*´$/)) ||
	       ($string =~ /^`\p{Letter}${chartypes{notcaron}}*\x{030C}${chartypes{notcaron}}*´$/)) {
		die "String '$string' is *already* awesome!\n";
	}
	elsif ($string !~ /^\p{Letter}/) {
		die "String '$string' begins with a non-letter character.\n";
	}
	elsif ($string !~ /\p{Letter}\p{NonspacingMark}*$/) {
		die "String '$string' terminates with a non-letter character.\n";
	}
	else {
		1;
	}
}


1; # This is a module, so it must return true.

__END__
=pod

=encoding utf-8

=head1 NAME

Acme::AwesomeQuotes - Make your text awesome!

=head1 VERSION

version 0.02

=head1 SYNOPSIS

  use Acme::AwesomeQuotes;
  my $awesome_text = GetAwesome('Wyld Stallyns');
  say q(I'm Bill S. Preston, Esquire!);
  say q(And I'm Ted "Theodore" Logan!);
  say ('And we are ', $awesome_text, '!');

=head1 DESCRIPTION

Tired of ordinary quotation marks that lack punch?

Looking for something that can better convey just how I<awesome> your words are?

You need `àwesome quoteś´!

=head1 FUNCTIONS

=head2 GetAwesome

C<GetAwesome()> is the module’s only function, and is exported by default. It takes a single scalar string argument, and returns that string with the following changes applied:

=over 4

=item *

a grave accent (or backtick, U+0060) is prepended;

=item *

a combining grave accent is added to the first letter;

=item *

a combining acute accent is added to the final letter;

=item *

an acute accent (U+00B4) is appended;

=back

In addition, leading/trailing whitespace and punctuation is stripped, and the returned string is in NFC.

Combining characters already present in the string are respected, and existing initial/terminal grave/acute accents will not be doubled.  However, in cases where both a grave and acute accent may be applied – such as if the initial letter has an ac...

=for Pod::Coverage checkstring

=head1 LIMITATIONS

=over 4

=item *

N.B. that the first and last characters of the supplied string must be I<letters>; leading/trailing whitespace and punctuation will be stripped, and if the resulting first/last character is not a letter an exception will be raised.  Letters may be fr...

=item *

The returned string is in NFC; combining accents will therefore occur as separate characters only if there is no code point for the corresponding character+accent.

=item *

A string that is already in `àwesome quoteś´ cannot be made I<more> awesome by calling the function on it repeatedly. :)

=back

=head1 BUGS

None known, doubtless many undiscovered.

=head1 SEE ALSO

Acme::LeetSpeak L<http://search.cpan.org/~jmadler/Acme-LeetSpeak-0.01/lib/Acme/LeetSpeak.pm>

=head1 ACKNOWLEDGEMENTS

Thanks to the regulars on L<irc://irc.perl.org/perl> for the idea.  Thanks to Ævar Arnfjörð Bjarmason (avar, L<http://search.cpan.org/~avar/>) for helpful suggestions on packaging.

=head1 AUTHOR

Marcus Smith <carwash@cpan.org>