NAME

Crypt::OTP26 - a classic form of encryption

DESCRIPTION

This implements a mod-26 One Time Pad encryption, similar to the sort classically used with pen and paper, as described in http://en.wikipedia.org/wiki/One_time_pad

Its primary use is to explore the intriguing situation detailed at http://itre.cis.upenn.edu/~myl/languagelog/archives/003314.html

NB: We don't handle the cases of generating or securely transmitting the pads themselves.

Also, only lower case alpha (ascii 'a-z') characters are handled. If you are actually encrypting and transmitting useful and valuable data, you should use a proper strong crypto module.

And though it's based on the OneTimePad concept, it actually supports the pad being shorter or longer than the encrypted text, in which case it is truncated or repeated as appropriate. So... don't do that!

METHODS

new

    my $otp = Crypt::OTP26->new();

crypt

Encrypts an alpha text (a-z) with an alpha pad (a-z), by performing mod26 addition on it.

    my $encrypted = $otp->crypt( $pad, $text ); 
        # though it's commutative, so can be in either order 

    my $encrypted = $otp->crypt( 'aced', 'scam' ); 
        # returns 'seep'

decrypt

Decrpyts a previously encrypted text using mod26 sutraction.

    my $encrypted = $otp->decrypt( $crypt, $pad );
    my $encrypted = $otp->decrypt( 'aced', 'seep' ); 
        # returns 'scam'

char2int

Return the mod26 integer value of an ascii character.

    my $int = $otp->char2int('a'); 
        # returns 0

int2char

    my $char = $otp->int2char( 1 ); 
        # returns 'b'

Will always return 'a'-'z'

crypt_char

    my $char = $otp->crypt_char( 'a', 's' ); 
        # returns 's'

Crypts 2 characters by performing mod26 addition on them. Called internally by crypt above.

decrypt_char

Decrypts the character with the appropriate letter from the pad, by performing mod26 subtraction. Called internally decrypt above.

    my $char = $otp->decrypt_char( $crypt_char, $pad_char );
    my $char = $otp->decrypt_char( 't', 's' ); 
        # returns 'b'

mk_stream

Private method for iterating the pad and the string.

AUTHOR

    (C) 2009
    osfameron@cpan.org

    May be distributed under the same conditions as Perl itself

Repo is at http://github.com/osfameron/crypt-otp26/

(Clone url: git://github.com/osfameron/crypt-otp26.git )