Metadata-Version: 1.1
Name: makwa
Version: 1.0.2
Summary: A password hashing function that supports delegation
Home-page: https://github.com/AntonKueltz/makwa
Author: Anton Kueltz
Author-email: kueltz.anton@gmail.com
License: UNKNOWN
Description: =====
        Makwa
        =====
        
        
        .. image:: https://travis-ci.org/AntonKueltz/makwa.svg?branch=master
            :target: https://travis-ci.org/AntonKueltz/makwa
        .. image:: https://badge.fury.io/py/makwa.svg
            :target: https://badge.fury.io/py/makwa
        
        Makwa is a password hashing function designed by Thomas Pornin. This implementation is in pure python with no 3rd party dependencies. From the `Passwords14 Slides`_:
        
        .. code::
        
            Makwa is a candidate to the Password Hashing Competition.
        
            Main characteristics:
            * based on modular arithmetics
            * CPU-only cost (not memory-hard)
            * algebraic structure enables advanced features: offline work
            * factor increase, fast path, escrow
            * can be delegated
            * named after the Ojibwe name for the American black bear
        
        Reference Material
        ==================
        
        - `Homepage`_
        - `Spec Paper`_
        - `Passwords14 Slides`_
        
        .. _Homepage: http://www.bolet.org/makwa/
        .. _Spec Paper: http://www.bolet.org/makwa/makwa-spec-20150422.pdf
        .. _Passwords14 Slides: http://www.bolet.org/makwa/Makwa-Passwords14LV.pdf
        
        Installation
        ============
        
        .. code:: bash
        
            pip install makwa
        
        Usage
        =====
        
        .. code:: python
        
            from makwa import hashpw, checkpw
        
            hashed_pw = hashpw(
                password,
                n,
                h=<hash function>,
                salt=<optional salt>,
                work_factor=<rounds>,
                pre_hash=<True|False>,
                post_hash=<length|None>
            )
            # returns a boolean
            is_valid = checkpw(
                password,
                hashed_pw,
                n,
                h=<hash function>
            )
        
Keywords: makwa password hashing kdf
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security :: Cryptography
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
