Metadata-Version: 2.0
Name: bitnigma
Version: 1.1.0
Summary: Python byte-enabled Enigma-like simulation.
Home-page: https://github.com/spgill/bitnigma
Author: Samuel P. Gillispie II
Author-email: spgill@vt.edu
License: MIT
Keywords: enigma machine encrypt encryption rotor rotors
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6

Enigma Byte Machine === Using the same principles that `my 'classic'
Enigma simulation <http://github.com/spgill/enigma>`__ is built on; I
reverse-engineered a newer, stronger, more robust Enigma encryption
scheme that is capable of encoding any standard 8-bit character (also
known as a byte). By removing the 26 character limitation, we are now
able to encrypt entire binary files using the same basic mechanics as
the original Enigma machine.

Technical Details
-----------------

-  Developed and tested on Python 3.6.1 for Windows.

   -  support for other python versions (>= 3.6.0) and other operating
      systems is likely, but not guaranteed.

-  Designed to be invoked as a module, but can be run from the
   ``__main__.py`` script just as well.
-  Can be imported and used in your own applications, but no
   documentation is provided yet (though it shouldn't be too hard to
   figure out).
-  Requires ``requests`` module and internet connection to correctly
   build readme (conversion from Markdown to reStructuredText).

Downloading
-----------

This package is now available on PyPI, and may be installed using
``pip install bitnigma`` or directly from the repo using
``pip install git+git://github.com/spgill/bitnigma``.

Usage
-----

::

    usage: python -m bitnigma [-h] [--plugboard PLUGBOARD [PLUGBOARD ...]]
                       [--rotors ROTORS [ROTORS ...]] [--reflector REFLECTOR]
                       [--state STATE] [--state-create] [--state-update]
                       [--state-print] [--state-seed STATE_SEED]
                       [--state-seed-file STATE_SEED_FILE] [--input INPUT]
                       [--input-std] [--input-path INPUT_PATH] [--output-std]
                       [--output-path OUTPUT_PATH] [--chunk-size CHUNK_SIZE]
                       [--benchmark] [--progress]

    Process some data through a simulated Enigma machine

    optional arguments:
      -h, --help            show this help message and exit
      --plugboard PLUGBOARD [PLUGBOARD ...], -pl PLUGBOARD [PLUGBOARD ...]
                            Specify a list of byte pairings for the plugboard. ex;
                            10:25 50:77 102:33
      --rotors ROTORS [ROTORS ...], -ro ROTORS [ROTORS ...]
                            Specify a list of rotors in the following format:
                            SHORTNAME[:SETTING] ex; byte1:52
      --reflector REFLECTOR, -rf REFLECTOR
                            Specify a reflector by its shortname.
      --state STATE, -s STATE
                            Path for the state file (reading or writing). States
                            can be used in lieu of manually specifying rotors and
                            reflectors every time.
      --state-create, -sc   Take the plugboard, rotor, and reflector args and save
                            them to the state file (and then exit).
      --state-update, -su   After processing, save the changed rotor state back to
                            the state file. This allows for a continuous rotor
                            progression over multiple program invocations. THERE
                            IS NO ROLLBACK, SO BACK UP THE STATE.
      --state-print, -sp    Print the state information to stdout and then exit.
      --state-seed STATE_SEED, -ss STATE_SEED
                            String seed for to create a randomly generated state.
      --state-seed-file STATE_SEED_FILE, -ssf STATE_SEED_FILE
                            File to use as seed for a randomly generated state.
      --input INPUT, -i INPUT
                            Input a string via this command line argument.
      --input-std, -is      Read data from stdin pipe.
      --input-path INPUT_PATH, -ip INPUT_PATH
                            Open and read data from file path.
      --output-std, -os     Write output to the stdout pipe.
      --output-path OUTPUT_PATH, -op OUTPUT_PATH
                            Write output to the specified file path.
      --chunk-size CHUNK_SIZE, -c CHUNK_SIZE
                            Chunk size for reading and writing data.
      --benchmark, -b       Benchmark the processing time (prints results to
                            stderr).
      --progress, -p        Show the progress meter; written to stderr.


