stepped-augustus 1.1.0

A variation of the Augustus Cipher that offsets space-separated words based on the position of each character.

stepped-augustus

A variation of the Augustus Cipher that offsets space-separated words based on the position of each character; contrary to what Augustus had originally practiced, letters wrap around instead of presenting a special case.

"Whenever he wrote in cipher, he wrote B for A, C for B, and the rest of the letters on the same principle, using AA for X."

Suetonius, Life of Augustus 88

Installation

Through pip:

> python -m pip install stepped-augustus

Usage

As a CLI application:

> augustus -h
usage: augustus [-h] [--direction {left,right}] [--multiplier MULTIPLIER] message

Ciphers a given message.

positional arguments:
  message               The message to be ciphered

optional arguments:
  -h, --help            show this help message and exit
  --direction {left,right}
                        The direction to cipher the message to
  --multiplier MULTIPLIER
                        The multiplier to be applied when ciphering a message

> augustus "Hello, World" --direction right --multiplier 1
Igopt, Xqupi

> augustus "Igopt, Xqupi" --direction left --multiplier 1
Hello, World

As a package:

>>> from augustus import SteppedAugustus
>>>
>>> SteppedAugustus("Hello, World", 1).right_cipher
'Igopt, Xqupi'
>>>
>>> SteppedAugustus("Igopt, Xqupi", 1).left_cipher
'Hello, World'
>>>
>>> # Alternatively the _cipher method can be used for lazy
>>> # evaluation and customizing the direction.
>>>
>>> for char in SteppedAugustus("Hello", 1)._cipher(1):
...     print(char)