rubylibcrack 0.1.0

data/History.txt

@@ -0,0 +1,3 @@
+== 0.1.0 / 2007-08-07
+
+* Initial release.

data/Manifest.txt

@@ -0,0 +1,13 @@
+History.txt
+
+Manifest.txt
+
+README.txt
+
+Rakefile
+
+test/test_rubylibcrack.rb
+
+ext/rubylibcrack.c
+
+ext/extconf.rb

data/README.txt

@@ -0,0 +1,208 @@
+rubylibcrack
+
+  By: Mark Somerville (on behalf of Purchasing Card Consultancy limited)
+
+  URL: http://mark.scottishclimbs.com/ (http://www.pccl.info/)
+
+== DESCRIPTION:
+  
+A Ruby binding to the password strength checker, libcrack/cracklib.
+
+== FEATURES/PROBLEMS:
+  
+A very simple password class with methods, weak? and strong? to check a password.
+A suitable message is provided if the password is weak.
+
+== SYNOPSIS:
+
+Usage:
+
+  >> require "rubygems"
+  => true
+  >> require "rubylibcrack"
+  => true
+  >> my_password = Password.new("hello001")
+  => "hello001"
+  >> my_password.strong?
+  => false
+  >> my_password.message
+  => "it is based on a dictionary word"
+
+== REQUIREMENTS:
+
+* Cracklib and the development libraries:
+  - Gentoo will have these if cracklib is installed
+  - Redhat and Fedora will require cracklib-devel
+  - Ubuntu will require cracklib-devel
+
+== INSTALL:
+
+* sudo gem install rubycracklib
+
+== LICENSE:
+
+  GNU LESSER GENERAL PUBLIC LICENSE
+  Version 3, 29 June 2007
+
+  Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+  Everyone is permitted to copy and distribute verbatim copies
+  of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+  the terms and conditions of version 3 of the GNU General Public
+  License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions. 
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+  General Public License, and the "GNU GPL" refers to version 3 of the GNU
+  General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+  other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+  by the Library, but which is not otherwise based on the Library.
+  Defining a subclass of a class defined by the Library is deemed a mode
+  of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+  Application with the Library.  The particular version of the Library
+  with which the Combined Work was made is also called the "Linked
+  Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+  Corresponding Source for the Combined Work, excluding any source code
+  for portions of the Combined Work that, considered in isolation, are
+  based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+  object code and/or source code for the Application, including any data
+  and utility programs needed for reproducing the Combined Work from the
+  Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+  without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+  facility refers to a function or data to be supplied by an Application
+  that uses the facility (other than as an argument passed when the
+  facility is invoked), then you may convey a copy of the modified
+  version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+  a header file that is part of the Library.  You may convey such object
+  code under terms of your choice, provided that, if the incorporated
+  material is not limited to numerical parameters, data structure
+  layouts and accessors, or small macros, inline functions and templates
+  (ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+  taken together, effectively do not restrict modification of the
+  portions of the Library contained in the Combined Work and reverse
+  engineering for debugging such modifications, if you also do each of
+  the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version. 
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+  Library side by side in a single library together with other library
+  facilities that are not Applications and are not covered by this
+  License, and convey such a combined library under terms of your
+  choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+  of the GNU Lesser General Public License from time to time. Such new
+  versions will be similar in spirit to the present version, but may
+  differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+  Library as you received it specifies that a certain numbered version
+  of the GNU Lesser General Public License "or any later version"
+  applies to it, you have the option of following the terms and
+  conditions either of that published version or of any later version
+  published by the Free Software Foundation. If the Library as you
+  received it does not specify a version number of the GNU Lesser
+  General Public License, you may choose any version of the GNU Lesser
+  General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+  whether future versions of the GNU Lesser General Public License shall
+  apply, that proxy's public statement of acceptance of any version is
+  permanent authorization for you to choose that version for the
+  Library.

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'hoe'
+
+Hoe.new('rubylibcrack', "0.1.0") do |p|
+  p.rubyforge_name = 'rubylibcrack'
+  p.author =  p.paragraphs_of('README.txt', 1..1).to_s.strip.sub("By: ", "")
+  p.email = 'rubyforge@scottishclimbs.com'
+  p.summary = p.paragraphs_of('README.txt', 3).to_s.sub("== DESCRIPTION:", "")
+  p.description = p.paragraphs_of('README.txt', 3).to_s.sub("== DESCRIPTION:", "")
+  p.url = p.paragraphs_of('README.txt', 2..2).to_s.strip.sub("URL: ", "")
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.spec_extras["files"] = [ "ext/rubylibcrack.c", "Rakefile" ]
+  p.spec_extras["extensions"] = "ext/extconf.rb"
+end
+
+desc "Builds the extension"
+task :build_extension do
+  system "cd ext; ruby extconf.rb; make; cd ../"
+end
+
+desc "Cleans the files compiled by build_extension"
+task :clean_extension do
+  system "cd ext; rm dictconfig.h rubylibcrack.so rubylibcrack.o Makefile; cd ../"
+end
+
+desc "Run the unit tests"
+task :test => [ :build_extension ] do
+  Rake::Task[ :clean_extension ].invoke
+end

data/ext/extconf.rb

@@ -0,0 +1,7 @@
+require 'mkmf'
+File.open(File.dirname(__FILE__)+'/dictconfig.h', "a") do |dictconfig|
+  dictconfig << '#define DICTPATH "/usr/lib64/cracklib_dict"'
+  dictconfig << "\n"
+end
+$libs = append_library($libs, "crack")
+create_makefile('rubylibcrack')

data/ext/rubylibcrack.c

@@ -0,0 +1,49 @@
+#include <ruby.h>
+#include <crack.h>
+#include "dictconfig.h"
+
+/*
+ * Runs FascistCheck and returns if the password is regarded as weak or not.
+ * If it is, the class variable @message is set to the value of the error message.
+ */
+static VALUE t_weak(VALUE self)
+{
+  char *failure_message;
+  failure_message = (char *) FascistCheck(STR2CSTR(self), DICTPATH);
+  if(failure_message)
+  {
+    rb_iv_set(self, "@message", rb_str_new2(failure_message));
+    return Qtrue;
+  }
+  else
+  {
+    return Qfalse;
+  }
+}
+
+/*
+ * Runs FascistCheck and returns if the password is regarded as strong or not.
+ * If it isn't, the class variable @message is set to the value of the error message.
+ */
+static VALUE t_strong(VALUE self)
+{
+  VALUE weak;
+  weak = t_weak(self);
+  if(weak == Qtrue)
+  {
+    return Qfalse;
+  }
+  else
+  {
+    return Qtrue;
+  }
+}
+
+VALUE cPassword;
+
+void Init_rubylibcrack() {
+  cPassword = rb_define_class("Password", rb_cString);
+  rb_define_attr(cPassword, "message", 1, 0);
+  rb_define_method(cPassword, "weak?", t_weak, 0);
+  rb_define_method(cPassword, "strong?", t_strong, 0);
+}

data/test/test_rubylibcrack.rb

@@ -0,0 +1,23 @@
+require "test/unit"
+unless File.exist?(File.dirname(__FILE__)+"/../ext/rubylibcrack.so")
+  puts "You must build the extension before running these tests. The rake task :test calls the :build_extension task and does all this for you."
+  puts 'Alternatively, you can run this command: "cd ext; ruby extconf.rb; make; cd ../"'
+  exit 0
+end
+require File.dirname(__FILE__)+"/../ext/rubylibcrack"
+
+class PasswordTest < Test::Unit::TestCase
+  def test_password
+    poor_password = Password.new("hello")
+    assert_kind_of Password, poor_password
+    assert !poor_password.strong?
+    assert poor_password.weak?
+    assert_not_nil poor_password.message
+
+    good_password = Password.new("jUY d3 i5 gr38")
+    assert_kind_of Password, good_password
+    assert good_password.strong?
+    assert !good_password.weak?
+    assert_nil good_password.message
+  end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: rubylibcrack
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2007-12-28 00:00:00 +00:00
+summary: A Ruby binding to the password strength checker, libcrack/cracklib.
+require_paths: 
+- ext
+email: rubyforge@scottishclimbs.com
+homepage: http://mark.scottishclimbs.com/ (http://www.pccl.info/)
+rubyforge_project: rubylibcrack
+description: A Ruby binding to the password strength checker, libcrack/cracklib.
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Mark Somerville (on behalf of Purchasing Card Consultancy limited)
+files: 
+- ext/rubylibcrack.c
+- Rakefile
+- History.txt
+- Manifest.txt
+- README.txt
+test_files: 
+- test/test_rubylibcrack.rb
+rdoc_options: 
+- --main
+- README.txt
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+executables: []
+
+extensions: 
+- ext/extconf.rb
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+    version: