Added packaged version of jBCrypt 0.3

Author: jeremyh

LICENSE

@@ -0,0 +1,18 @@
+jBCrypt is subject to the following license:
+
+/*
+ * Copyright (c) 2006 Damien Miller <[email protected]>
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+

README.md

@@ -0,0 +1,66 @@
+# JBCrypt
+jBCrypt is an implementation the OpenBSD Blowfish password hashing algorithm,
+as described in ["A Future-Adaptable Password
+Scheme"](http://www.openbsd.org/papers/bcrypt-paper.ps) by Niels Provos and
+David Mazieres.  
+
+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 parameterised, so it can be
+increased as computers get faster.  
+
+JUnit regression tests are available in in TestBCrypt.java
+
+jBCrypt is licensed under a ISC/BSD licence. See the LICENSE file for details.
+
+Please report bugs to Damien Miller <[email protected]>. 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:
+
+	// Hash a password for the first time
+	String 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 10
+	String hashed = BCrypt.hashpw(password, BCrypt.gensalt(12));
+
+	// Check that an unencrypted password matches one that has
+	// previously been hashed
+	if (BCrypt.checkpw(candidate, hashed))
+		System.out.println("It matches");
+	else
+		System.out.println("It does not match");
+
+There is also a [C#/.NET port by Derek Slager](http://derekslager.com/blog/posts/2007/10/bcrypt-dotnet-strong-password-hashing-for-dotnet-and-mono.ashx)
+
+
+# Package notes
+
+This is an alternative distribution of [jBCrypt](http://www.mindrot.org/projects/jBCrypt). It has been
+packaged to ease use in existing applications &mdash; especially those using
+Apache Maven. 
+
+The code is unchanged from the original jBCrypt 0.3, however:
+
+- The classes have been moved to a java package to avoid pollution of the
+  global namespace. *org.mindrot* was chosen to reflect their original origin.
+- The JBCrypt class javadoc has been changed to version 0.3. The official
+  package incorrectly contains 0.2 as the stated version.
+- A pom.xml file has been added for use with Maven 
+
+## Maven setup
+
+Install it to your local Maven repository:
+
+	mvn clean javadoc:jar source:jar install
+
+Use it in your project by adding the following to your project *pom.xml*:
+
+        <dependency>
+            <groupId>org.mindrot</groupId>
+            <artifactId>jbcrypt</artifactId>
+            <version>0.3</version>
+        </dependency>
+

TODO

@@ -0,0 +1,4 @@
+nothing yet
+
+$Id: TODO,v 1.1.1.1 2006/05/24 05:23:22 djm Exp $
+

pom.xml

@@ -0,0 +1,25 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>org.mindrot</groupId>
+  <artifactId>jbcrypt</artifactId>
+  <version>0.3</version>
+  <packaging>jar</packaging>
+
+  <name>jbcrypt</name>
+  <url>http://www.mindrot.org/projects/jBCrypt</url>
+
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>3.8.1</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>