Metadata-Version: 1.1
Name: Stegano
Version: 0.8
Summary: A pure Python Steganography module.
Home-page: https://github.com/cedricbonhomme/Stegano
Author: Cédric Bonhomme
Author-email: cedric@cedricbonhomme.org
License: GPLv3
Description: Stéganô
        =======
        
        .. image:: https://img.shields.io/pypi/pyversions/Stegano.svg?style=flat-square
            :target: https://pypi.python.org/pypi/Stegano
        
        .. image:: https://img.shields.io/pypi/v/Stegano.svg?style=flat-square
            :target: https://github.com/cedricbonhomme/Stegano/releases/latest
        
        .. image:: https://img.shields.io/pypi/l/Stegano.svg?style=flat-square
            :target: https://www.gnu.org/licenses/gpl-3.0.html
        
        .. image:: https://img.shields.io/travis/cedricbonhomme/Stegano/master.svg?style=flat-square
            :target: https://travis-ci.org/cedricbonhomme/Stegano
        
        .. image:: https://img.shields.io/coveralls/cedricbonhomme/Stegano/master.svg?style=flat-square
           :target: https://coveralls.io/github/cedricbonhomme/Stegano?branch=master
        
        .. image:: https://img.shields.io/github/stars/cedricbonhomme/Stegano.svg?style=flat-square
            :target: https://github.com/cedricbonhomme/Stegano/stargazers
        
        .. image:: https://img.shields.io/badge/SayThanks.io-%E2%98%BC-1EAEDB.svg?style=flat-square
            :target: https://saythanks.io/to/cedricbonhomme
        
        
        `Stéganô <https://github.com/cedricbonhomme/Stegano>`_, a pure Python
        Steganography module.
        
        Steganography is the art and science of writing hidden messages in such a way
        that no one, apart from the sender and intended recipient, suspects the
        existence of the message, a form of security through obscurity. Consequently,
        functions provided by Stéganô only hide messages, without encryption.
        Steganography is often used with cryptography.
        
        Installation
        ------------
        
        .. code:: bash
        
            $ sudo pip install Stegano
        
        You will be able to use Stéganô in your Python programs or as a command line
        tool.
        
        
        Usage
        -----
        
        A `tutorial <https://stegano.readthedocs.io>`_ is available.
        
        
        Use Stéganô as a library in your Python program
        '''''''''''''''''''''''''''''''''''''''''''''''
        
        If you want to use Stéganô in your Python program you just have to import the
        appropriate steganography technique. For example:
        
        .. code:: python
        
            >>> from stegano import lsb
            >>> secret = lsb.hide("./tests/sample-files/Lenna.png", "Hello World")
            >>> secret.save("./Lenna-secret.png")
            >>>
            >>> clear_message = lsb.reveal("./Lenna-secret.png")
        
        
        Use Stéganô as a program
        ''''''''''''''''''''''''
        
        Hide a message
        ~~~~~~~~~~~~~~
        
        
        .. code:: bash
        
            $ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m "Secret Message" -o Lena1.png
        
        Reveal the message
        ~~~~~~~~~~~~~~~~~~
        
        .. code:: bash
        
            $ stegano-lsb reveal -i Lena1.png
            Secret Message
        
        
        Hide the message with the Sieve of Eratosthenes
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: bash
        
            $ stegano-lsb-set hide -i ./tests/sample-files/Lenna.png -m 'Secret Message' --generator eratosthenes -o Lena2.png
        
        The message will be scattered in the picture, following a set described by the
        Sieve of Eratosthenes. Other sets are available. You can also use your own
        generators.
        
        This will make a steganalysis more complicated.
        
        
        Running the tests
        -----------------
        
        .. code:: bash
        
            $ python -m unittest discover -v
        
        
        Contact
        -------
        
        `Cédric Bonhomme <https://www.cedricbonhomme.org>`_
        
        |
        
        Release History
        ===============
        
        0.8 (2017-05-06)
        ----------------
        * updated command line. All commands are now prefixed with *stegano-*;
        * improved type hints;
        * it is possible to load and save images from and to file objects (BytesIO);
        * improved checks when revealing a message with the lsbset module fails.
        
        0.7.1 (2017-05-05)
        ------------------
        
        * improved generators for the lsb-set module;
        * improved tests for the generators;
        * improved type hints.
        
        0.7 (2017-05-04)
        ----------------
        
        * unicode is now supported. By default UTF-8 encoding is used. UTF-32LE can also
          be used to hide non-ASCII characters. UTF-8 (8 bits) is the default choice
          since it is possible to hide longer messages with it.
        * improved checks with type hints.
        
        0.6.9 (2017-03-10)
        ------------------
        
        * introduces some type hints (PEP 484);
        * more tests for the generators and for the tools module;
        * updated descriptions of generators;
        * fixed a bug with a generator that has been previously renamed.
        
        0.6.8 (2017-03-08)
        ------------------
        
        * bugfix: fixed #12: Error when revealing a hidden binary file in an image.
        
        0.6.7 (2017-02-21)
        ------------------
        
        * bugfix: added missing dependency in the setup.py file.
        
        0.6.6 (2017-02-20)
        ------------------
        
        * improved docstrings for the desciption of the generators;
        * improved the command which displays the list of generators.
        
        0.6.5 (2017-02-16)
        ------------------
        
        * added a command to list all available generators for the lsb-set module;
        * test when the data image is coming via byte stream, for the lsb module.
        
        
        0.6.4 (2017-02-06)
        ------------------
        
        * a command line for the 'red' module has been added;
        * bugfix: fixed a bug in the lsb-set command line when the generator wasn't
          specified by the user.
        
        0.6.3 (2017-01-29)
        ------------------
        
        * Support for transparent PNG images has been added (lsb and lsbset modules).
        
        0.6.2 (2017-01-19)
        ------------------
        
        * bugfix: solved a bug when the image data is coming via byte streams (ByteIO),
          for the exifHeader hiding method.
        
        0.6.1 (2016-08-25)
        ------------------
        
        * reorganization of the steganalysis sub-module.
        
        0.6 (2016-08-04)
        ------------------
        
        * improvements of the command line of Stéganô. The use of Stéganô through the
          command line has slightly changed ('hide' and 'reveal' are now sub-parameters
          of the command line). No changes if you use Stéganô as a module in your
          software. The documentation has been updated accordingly.
        
        0.5.5 (2016-08-03)
        ------------------
        
        * bugfix: Incorrect padding size in `base642string` in tools.base642binary().
        
        0.5.4 (2016-05-22)
        ------------------
        
        * the generator provided to the functions lsbset.hide() and lsbset.reveal() is
          now a function. This is more convenient for a user who wants to use a custom
          generator (not in the module lsbset.generators).
        * performance improvements for the lsb and lsbset modules.
        
        0.5.3 (2016-05-19)
        ------------------
        
        * reorganization of all modules. No impact for the users of Stegano.
        
        0.5.2 (2016-05-18)
        ------------------
        
        * improvements and bug fixes for the exifHeader module;
        * added unit tests for the exifHeader module;
        * improvements of the documentation.
        
        0.5.1 (2016-04-16)
        ------------------
        
        * minor improvements and bug fixes;
        * added unit tests for the slsb and slsbset modules.
        
        0.5 (2016-03-18)
        ----------------
        
        * management of greyscale images.
        
        0.4.6 (2016-03-12)
        ------------------
        
        * bugfix when the length of the message to hide is not divisible by 3,
          for the slsb and slsbset module.
        
        0.4.5 (2015-12-23)
        ------------------
        * bugfix.
        
        0.4.4 (2015-12-23)
        ------------------
        
        * new project home page;
        * minor updated to the documentation.
        
        0.4.3 (2015-10-06)
        ------------------
        
        * bug fixes for Python 3;
        * bug fixes in the scripts in *./bin*.
        
        0.4.2 (2015-10-05)
        ------------------
        
        * first stable release on PypI.
        
        0.4 (2012-01-02)
        ----------------
        
        This release introduces a more advanced LSB (Least Significant Bit) method
        based on integers sets. The sets generated with Python generators
        (Sieve of Eratosthenes, Fermat, Carmichael numbers, etc.) are used to select
        the pixels used to hide the information. You can use these new methods in your
        Python codes as a Python module or as a program in your scripts.
        
        0.3 (2011-04-15)
        ----------------
        
        * you can now use Stéganô as a library in your Python program;
          (python setup.py install) or as a 'program' thanks to the scripts provided
          in the bin directory;
        * new documentation (reStructuredText) comes with Stéganô.
        
        0.2 (2011-03-24)
        ----------------
        
        * this release introduces some bugfixes and a major speed improvement of the
          *reveal* function for the LSB method. Moreover it is now possible to hide a
          binary file (ogg, executable, etc.);
        * a new technique for hiding/revealing a message in a JPEG picture by using the
          description field of the image is provided.
        
Platform: Linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Security
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
