Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/corydolphin/python-bcrypt
DEPRECATED. An up to date fork of py-bcrypt, Python 3 and Python 2 compatible, compiles on Windows, Mac, Linux
https://github.com/corydolphin/python-bcrypt
Last synced: 19 days ago
JSON representation
DEPRECATED. An up to date fork of py-bcrypt, Python 3 and Python 2 compatible, compiles on Windows, Mac, Linux
- Host: GitHub
- URL: https://github.com/corydolphin/python-bcrypt
- Owner: corydolphin
- License: other
- Created: 2012-08-26T21:45:47.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-05-29T19:24:47.000Z (over 10 years ago)
- Last Synced: 2024-11-09T23:02:27.738Z (about 1 month ago)
- Language: C
- Homepage:
- Size: 329 KB
- Stars: 31
- Watchers: 5
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- AwesomeCompiler - python-bcrypt
README
OUTDATED
===========
The Google Code project has seen a revival including a number of important updates. I do not have time to manage maintaining compatibility and integrating the improvements. I believe the Google Code project now addresses most of the issues this project solved, please see [Google Code project](http://code.google.com/p/py-bcrypt/).
Python BCrypt (Old out of date README as of 2014)
============
[](https://travis-ci.org/wcdolphin/py-bcrypt)
An up to date fork of py-bcrypt, Python 3 and Python 2 compatible, compiles on Windows, Mac, Linux.
This repository is a continuation of the [Google Code project](http://code.google.com/p/py-bcrypt/), which has not been updated in more than a year.
Most notably, this branch compiles under Windows, OSx and Linux, on both Python 3 and Python 2.
These patches and this work is community driven, and your contributions will be actively accepted and reviewed.
### Installation
Installation is a breeze!
```sh
$ pip install python-bcrypt
```
If you are running windows, either follow this [guide](http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/) to configure Python to compile C extensios, or download a [precompiled Windows installer](https://pypi.python.org/pypi?:action=display&name=python-bcrypt&version=0.3.1)!
### Usage
Simple example usage is as follows
```python
import bcrypt
# Hash a password for the first time
hashed = bcrypt.hashpw(password, bcrypt.gensalt())
# gensalt's log_rounds parameter determines the complexity
# the work factor is 2**log_rounds, and the default is 12
hashed = bcrypt.hashpw(password, bcrypt.gensalt(10))
# Check that an unencrypted password matches one that has
# previously been hashed
if bcrypt.hashpw(plaintext, hashed) == hashed:
print "It matches"
else:
print "It does not match"
```
### Support
####This branch is automatically tested on:
* linux Python 2.6
* linux Python 2.7
* linux Python 3.2
* linux Python 3.3
####Manually tested on:
Python 2.7 X86 and Python 2.7 X86-64
* Windows 7 32bit and 64bit Visual C++ 2012 (MSVC11)
* Windows 7 32bit and 64bit Visual C++ 2010 (MSVC10)
* Windows 7 32bit and 64bit Visual C++ 2008 (MSVC9) (Same compiler as Python 2.7, suggested)
* Windows 8 32bit and 64bit Visual C++ 2008 (MSVC9) (Same compiler as Python 2.7, suggested)
### Contributing
To help, clone this repository and get building!
To install, use the standard Python distutils incantation:
```sh
$ python setup.py build
$ python setup.py install
```
Regression tests are located in `tests/test.py`
### Contributions
The original authors whose patches are included in this author are:
[email protected]
Providing the basis for this patch, fixing compilation flags and ifdefs [patch](http://code.google.com/p/py-bcrypt/issues/attachmentText?id=1&aid=10003000&name=py-bcrypt_11.patch&token=EFCIp9qVR4pi3SaJ7kDaVmy3OQc%3A1346047268712)
[email protected]
Extending the patch and fixing memset + bzero issues to make the code more standards compliant [patch](http://code.google.com/p/py-bcrypt/issues/attachmentText?id=1&aid=10008000&name=py-bcrypt.patch&token=esLPoSRqwBo90FHQ2B_NOyZbtas%3A1346047268714)
Original README
------------
__py-bcrypt__ is an implementation the OpenBSD Blowfish password hashing
algorithm, as described in "A Future-Adaptable Password Scheme" by Niels
Provos and David Mazieres: http://www.openbsd.org/papers/bcrypt-paper.ps
This system hashes passwords using a version of Bruce Schneier's
Blowfish block cipher with modifications designed to raise the cost of
off-line password cracking. The computation cost of the algorithm is
parametised, so it can be increased as computers get faster.
py-bcrypt requires Python 2.4. Older versions may work, but the
bcrypt.gensalt() method won't - it requires the cryptographic random
number generator os.urandom() introduced in 2.4.
To install, use the standard Python distutils incantation:
$ python setup.py build
$ python setup.py install
Regression tests are in the test/test.py file. This is deliberately in
a subdirectory so it does not mistakenly pick up the top-level bcrypt/
directory.
py-bcrypt is licensed under a ISC/BSD licence. The underlying Blowfish
and password hashing code is taken from OpenBSD's libc. See the LICENSE
file for details.
Please report bugs to Damien Miller . Please check the
TODO file first, in case your problem is something I already know about
(please send patches!)
A simple example that demonstrates most of the features:
A simple example that demonstrates most of the features:
```
import bcrypt
# Hash a password for the first time
hashed = bcrypt.hashpw(password, bcrypt.gensalt())
# gensalt's log_rounds parameter determines the complexity
# the work factor is 2**log_rounds, and the default is 12
hashed = bcrypt.hashpw(password, bcrypt.gensalt(10))
# Check that an unencrypted password matches one that has
# previously been hashed
if bcrypt.hashpw(plaintext, hashed) == hashed:
print "It matches"
else:
print "It does not match"
```