|
bgneal@51
|
1 .. m209 documentation master file, created by
|
|
bgneal@51
|
2 sphinx-quickstart on Thu Jul 4 18:12:07 2013.
|
|
bgneal@51
|
3 You can adapt this file completely to your liking, but it should at least
|
|
bgneal@51
|
4 contain the root `toctree` directive.
|
|
bgneal@51
|
5
|
|
bgneal@51
|
6 Welcome to m209's documentation!
|
|
bgneal@51
|
7 ================================
|
|
bgneal@51
|
8
|
|
bgneal@52
|
9 :Author: Brian Neal <bgneal@gmail.com>
|
|
bgneal@52
|
10 :Version: |release|
|
|
bgneal@52
|
11 :Date: |today|
|
|
bgneal@52
|
12 :Home Page: https://bitbucket.org/bgneal/m209/
|
|
bgneal@52
|
13 :License: MIT License (see LICENSE.txt)
|
|
bgneal@52
|
14 :Documentation: http://m209.readthedocs.org/
|
|
bgneal@52
|
15 :Support: https://bitbucket.org/bgneal/m209/issues
|
|
bgneal@52
|
16
|
|
bgneal@52
|
17 Introduction
|
|
bgneal@52
|
18 ------------
|
|
bgneal@52
|
19
|
|
bgneal@52
|
20 ``m209`` is a complete `M-209`_ simulation library and command-line application
|
|
bgneal@52
|
21 written in Python 3. ``m209`` is historically accurate, meaning that it can
|
|
bgneal@52
|
22 exchange messages with an actual M-209 cipher machine.
|
|
bgneal@52
|
23
|
|
bgneal@52
|
24 It is hoped that this library will be useful to M-209 enthusiasts, historians,
|
|
bgneal@52
|
25 and students interested in cryptography.
|
|
bgneal@52
|
26
|
|
bgneal@52
|
27 ``m209`` strives to be Pythonic, easy to use, and comes with both unit tests
|
|
bgneal@52
|
28 and documentation. ``m209`` is a library for building applications for
|
|
bgneal@52
|
29 encrypting and decrypting M-209 messages. ``m209`` also ships with a simple
|
|
bgneal@52
|
30 command-line application that can encrypt & decrypt messages for scripting and
|
|
bgneal@52
|
31 experimentation.
|
|
bgneal@52
|
32
|
|
bgneal@56
|
33 Documentation
|
|
bgneal@56
|
34 -------------
|
|
bgneal@52
|
35
|
|
bgneal@56
|
36 Contents:
|
|
bgneal@54
|
37
|
|
bgneal@56
|
38 .. toctree::
|
|
bgneal@56
|
39 tutorial
|
|
bgneal@56
|
40 :maxdepth: 2
|
|
bgneal@55
|
41
|
|
bgneal@55
|
42
|
|
bgneal@52
|
43 Requirements
|
|
bgneal@52
|
44 ------------
|
|
bgneal@52
|
45
|
|
bgneal@52
|
46 ``m209`` is written in Python_, specifically Python 3.3. It has no other
|
|
bgneal@52
|
47 requirements or dependencies.
|
|
bgneal@52
|
48
|
|
bgneal@52
|
49 Installation
|
|
bgneal@52
|
50 ------------
|
|
bgneal@52
|
51
|
|
bgneal@52
|
52 ``m209`` is available on the `Python Package Index`_ (PyPI). You can install it
|
|
bgneal@52
|
53 using pip_::
|
|
bgneal@52
|
54
|
|
bgneal@52
|
55 $ pip install m209 # install
|
|
bgneal@52
|
56 $ pip install --upgrade m209 # upgrade
|
|
bgneal@52
|
57
|
|
bgneal@55
|
58 You may also download a tarball or .zip file of the latest code by visiting the
|
|
bgneal@55
|
59 Downloads tab on the `m209 Bitbucket page`_. Alternatively if you use
|
|
bgneal@52
|
60 Mercurial_, you can clone the repository with the following command::
|
|
bgneal@52
|
61
|
|
bgneal@52
|
62 $ hg clone https://bitbucket.org/bgneal/m209
|
|
bgneal@52
|
63
|
|
bgneal@52
|
64 If you did not use pip, you can install with this command::
|
|
bgneal@52
|
65
|
|
bgneal@52
|
66 $ python setup.py install
|
|
bgneal@52
|
67
|
|
bgneal@52
|
68 Support & Source
|
|
bgneal@52
|
69 ----------------
|
|
bgneal@52
|
70
|
|
bgneal@52
|
71 All support takes place at the `m209 Bitbucket page`_. Please enter any
|
|
bgneal@52
|
72 feature requests or bugs into the `issue tracker`_.
|
|
bgneal@52
|
73
|
|
bgneal@51
|
74 Indices and tables
|
|
bgneal@51
|
75 ==================
|
|
bgneal@51
|
76
|
|
bgneal@51
|
77 * :ref:`genindex`
|
|
bgneal@51
|
78 * :ref:`modindex`
|
|
bgneal@51
|
79 * :ref:`search`
|
|
bgneal@51
|
80
|
|
bgneal@52
|
81
|
|
bgneal@52
|
82 .. _M-209: http://en.wikipedia.org/wiki/M-209
|
|
bgneal@52
|
83 .. _Python: http://www.python.org
|
|
bgneal@52
|
84 .. _Python Package Index: http://pypi.python.org/pypi/m209/
|
|
bgneal@52
|
85 .. _m209 Bitbucket page: https://bitbucket.org/bgneal/m209
|
|
bgneal@52
|
86 .. _pip: http://www.pip-installer.org
|
|
bgneal@52
|
87 .. _Mercurial: http://mercurial.selenic.com/
|
|
bgneal@52
|
88 .. _issue tracker: https://bitbucket.org/bgneal/m209/issues
|
