paynow_sdk 1.0.7 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0febf8d3514812c9f0392a6417ed17c1d4f519f07251ce6a9659a78f375ec6c3
-  data.tar.gz: 5f034666444d3ddacebdd377314d7c94f64b81aa84da51e0a078ed7adb41b5d9
+  metadata.gz: f1be5484904e0a877deed189e8dbe9a8906886edcded0c04aac46ce1e1b8cf3e
+  data.tar.gz: a88347664070162bb65c04a1b8b21c52866815b68b6e75a3357383e7504c7474
 SHA512:
-  metadata.gz: 33f098361c36515417986d6fb747a1d173b2979d8f4e055e1e7748cf5e89818ce36a596974626b16e2f0ba6df2f74118576472fdc7054ca241e165d7888c32c4
-  data.tar.gz: 1109e5cd490c1ffc2f3589120e3ed31ae96873dd7cdf536dc6155c072e4c3f6fdb5cbf43367d0f59d84d9358054560e2c8155d9a7c45e4810c2882a6a35e15a1
+  metadata.gz: 607f3b4284d6a50834487b820cca17fcfbcd641c5f56d520ddfb3de35690f078851dab90551a9b3a55a11c70d59f18cb23e2d422b4c975fc9b3ee5eaaa43a711
+  data.tar.gz: e358f5d8945163b703c8b0811c44c1ca78676b897f21e9ca70793327927277def9c58ac12a388de03f231c17bb091aed49d15b56a984c09dea0960601d70faf4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    paynow_sdk (1.0.7)
+    paynow_sdk (1.0.8)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -94,13 +94,15 @@ The SDK exposes a handy method that you can use to check the status of a transac
 
 ```ruby
 # Check the status of the transaction with the specified poll url
-# Now you see why you need to save that url ;-)
-status = paynow.check_transaction_status(poll_url)
+#if you saved your poll url in the database you can use this function "PaynowStatus.check_transcation_status(poll_url)" to check the status of the payment
+
+status = PaynowStatus.check_transcation_status(poll_url)
 
 if status.paid
-	# Yay! Transaction was paid for. Update transaction?
+	render page
+	print "Payment successfull"
 else
-    # Handle that
+	print "Not Paid"
 end
 ```
 
@@ -142,12 +144,6 @@ if response.success
     link = response.redirect_url
 
     poll_url = response.poll_url
-
-    status = paynow.check_transaction_status(poll_url)
-    if status.paid
-        #create a record in the database e.g orders table
-        print "Payment Status: " + status.status
-    end
 end
 ```
 

data/lib/paynow_sdk.rb

@@ -5,6 +5,33 @@ require "uri"
 require "net/http"
 
 #throws error when hash from Paynow does not match locally generated hash
+module PaynowStatus
+  def paid
+    status_paid = check_transaction_status(poll_url)
+    status_paid["status"] == "Paid"
+  end
+
+  def check_transaction_status(poll_url)
+    url = URI(poll_url)
+
+    http = Net::HTTP.new(url.host, url.port)
+    http.use_ssl = true
+    http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+    request = Net::HTTP::Post.new(url)
+    request["content-type"] = "application/x-www-form-urlencoded"
+
+    response = http.request(request)
+    response.read_body
+
+    response_object = rebuild_response(response.read_body)
+    response_object
+  end
+
+  def rebuild_response(response)
+    URI.decode_www_form(response).to_h
+  end
+end
 
 class HashMismatchException < Exception
   def initialize(message)
@@ -15,7 +42,6 @@ end
 #Returns the status of the payment
 
 class StatusResponse
-  @@paid = true
   @@status = ""
   @@amount = 0.0
   @@reference = ""
@@ -30,7 +56,9 @@ class StatusResponse
     if update
       status_update(data)
     else
-      @status = data["status"]
+      if data.include?("status")
+        @status = data["status"]
+      end
       if data.include?("amount")
         @amount = data["amount"]
       end
@@ -46,12 +74,6 @@ class StatusResponse
     end
   end
 
-  def self.paid; @@paid; end
-  def self.paid=(val); @@paid = val; end
-
-  def paid; @paid = @@paid if @paid.nil?; @paid; end
-  def paid=(val); @paid = val; end
-
   def self.status; @@status; end
   def self.status=(val); @@status = val; end
 
@@ -302,23 +324,6 @@ class Paynow
     InitResponse.new(response_object)
   end
 
-  def check_transaction_status(poll_url)
-    url = URI(poll_url)
-
-    http = Net::HTTP.new(url.host, url.port)
-    http.use_ssl = true
-    http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-
-    request = Net::HTTP::Post.new(url)
-    request["content-type"] = "application/x-www-form-urlencoded"
-
-    response = http.request(request)
-    response.read_body
-
-    response_object = rebuild_response(response.read_body)
-    StatusResponse.new(response_object, false)
-  end
-
   #web payments
 
   def build(payment)

data/lib/paynow_sdk/version.rb

@@ -1,3 +1,3 @@
 module PaynowSdk
-  VERSION = "1.0.7"
+  VERSION = "1.0.8"
 end

data/vendor/bundle/ruby/2.7.0/bin/httparty

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by RubyGems.
+#
+# The application 'httparty' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'rubygems'
+
+version = ">= 0.a"
+
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+
+if Gem.respond_to?(:activate_bin_path)
+load Gem.activate_bin_path('httparty', 'httparty', version)
+else
+gem "httparty", version
+load Gem.bin_path("httparty", "httparty", version)
+end

data/vendor/bundle/ruby/2.7.0/bin/rake

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by RubyGems.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'rubygems'
+
+version = ">= 0.a"
+
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+
+if Gem.respond_to?(:activate_bin_path)
+load Gem.activate_bin_path('rake', 'rake', version)
+else
+gem "rake", version
+load Gem.bin_path("rake", "rake", version)
+end

data/vendor/bundle/ruby/2.7.0/bin/restclient

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by RubyGems.
+#
+# The application 'rest-client' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'rubygems'
+
+version = ">= 0.a"
+
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+
+if Gem.respond_to?(:activate_bin_path)
+load Gem.activate_bin_path('rest-client', 'restclient', version)
+else
+gem "rest-client", version
+load Gem.bin_path("rest-client", "restclient", version)
+end

data/vendor/bundle/ruby/2.7.0/extensions/x86_64-darwin-18/2.7.0/unf_ext-0.0.7.7/gem_make.out

@@ -0,0 +1,16 @@
+current directory: /Users/macbookpro/Desktop/works/paynow-ruby-sdk/vendor/bundle/ruby/2.7.0/gems/unf_ext-0.0.7.7/ext/unf_ext
+/Users/macbookpro/.rbenv/versions/2.7.1/bin/ruby -I /Users/macbookpro/.rbenv/versions/2.7.1/lib/ruby/2.7.0 -r ./siteconf20200916-48631-169lwni.rb extconf.rb
+checking for -lstdc++... yes
+creating Makefile
+
+current directory: /Users/macbookpro/Desktop/works/paynow-ruby-sdk/vendor/bundle/ruby/2.7.0/gems/unf_ext-0.0.7.7/ext/unf_ext
+make "DESTDIR=" clean
+
+current directory: /Users/macbookpro/Desktop/works/paynow-ruby-sdk/vendor/bundle/ruby/2.7.0/gems/unf_ext-0.0.7.7/ext/unf_ext
+make "DESTDIR="
+compiling unf.cc
+linking shared-object unf_ext.bundle
+
+current directory: /Users/macbookpro/Desktop/works/paynow-ruby-sdk/vendor/bundle/ruby/2.7.0/gems/unf_ext-0.0.7.7/ext/unf_ext
+make "DESTDIR=" install
+/usr/local/bin/ginstall -c -m 0755 unf_ext.bundle ./.gem.20200916-48631-1rv6y7x

data/vendor/bundle/ruby/2.7.0/extensions/x86_64-darwin-18/2.7.0/unf_ext-0.0.7.7/mkmf.log

@@ -0,0 +1,35 @@
+have_library: checking for -lstdc++... -------------------- yes
+
+"clang -o conftest -I/Users/macbookpro/.rbenv/versions/2.7.1/include/ruby-2.7.0/x86_64-darwin18 -I/Users/macbookpro/.rbenv/versions/2.7.1/include/ruby-2.7.0/ruby/backward -I/Users/macbookpro/.rbenv/versions/2.7.1/include/ruby-2.7.0 -I. -I/Users/macbookpro/.rbenv/versions/2.7.1/include  -D_XOPEN_SOURCE -D_DARWIN_C_SOURCE -D_DARWIN_UNLIMITED_SELECT -D_REENTRANT   -O3 -ggdb3 -Wall -Wextra -Wdeprecated-declarations -Wdivision-by-zero -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wshorten-64-to-32 -Wwrite-strings -Wmissing-noreturn -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wunused-variable -Wextra-tokens  -fno-common -pipe conftest.c  -L. -L/Users/macbookpro/.rbenv/versions/2.7.1/lib -L. -L/Users/macbookpro/.rbenv/versions/2.7.1/lib  -fstack-protector-strong     -lruby.2.7   "
+checked program was:
+/* begin */
+1: #include "ruby.h"
+2: 
+3: int main(int argc, char **argv)
+4: {
+5:   return !!argv[argc];
+6: }
+/* end */
+
+"clang -o conftest -I/Users/macbookpro/.rbenv/versions/2.7.1/include/ruby-2.7.0/x86_64-darwin18 -I/Users/macbookpro/.rbenv/versions/2.7.1/include/ruby-2.7.0/ruby/backward -I/Users/macbookpro/.rbenv/versions/2.7.1/include/ruby-2.7.0 -I. -I/Users/macbookpro/.rbenv/versions/2.7.1/include  -D_XOPEN_SOURCE -D_DARWIN_C_SOURCE -D_DARWIN_UNLIMITED_SELECT -D_REENTRANT   -O3 -ggdb3 -Wall -Wextra -Wdeprecated-declarations -Wdivision-by-zero -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wshorten-64-to-32 -Wwrite-strings -Wmissing-noreturn -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wunused-variable -Wextra-tokens  -fno-common -pipe conftest.c  -L. -L/Users/macbookpro/.rbenv/versions/2.7.1/lib -L. -L/Users/macbookpro/.rbenv/versions/2.7.1/lib  -fstack-protector-strong     -lruby.2.7 -lstdc++   "
+checked program was:
+/* begin */
+ 1: #include "ruby.h"
+ 2: 
+ 3: /*top*/
+ 4: extern int t(void);
+ 5: int main(int argc, char **argv)
+ 6: {
+ 7:   if (argc > 1000000) {
+ 8:     int (* volatile tp)(void)=(int (*)(void))&t;
+ 9:     printf("%d", (*tp)());
+10:   }
+11: 
+12:   return !!argv[argc];
+13: }
+14: 
+15: int t(void) { ; return 0; }
+/* end */
+
+--------------------
+

data/vendor/bundle/ruby/2.7.0/gems/ansi-1.5.0/.index

@@ -0,0 +1,77 @@
+---
+revision: 2013
+type: ruby
+sources:
+- INDEX.yml
+authors:
+- name: Thomas Sawyer
+  email: transfire@gmail.com
+- name: Florian Frank
+organizations: []
+requirements:
+- groups:
+  - build
+  development: true
+  name: mast
+- groups:
+  - build
+  development: true
+  name: indexer
+- groups:
+  - build
+  development: true
+  name: ergo
+- groups:
+  - test
+  development: true
+  name: qed
+- groups:
+  - test
+  development: true
+  name: ae
+- groups:
+  - test
+  development: true
+  name: lemon
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/ansi
+  label: Homepage
+- type: docs
+  uri: http://rubydoc.info/gems/ansi/frames
+  label: Documentation
+- type: code
+  uri: http://github.com/rubyworks/ansi
+  label: Source Code
+- type: bugs
+  uri: http://github.com/rubyworks/ansi/issues
+  label: Issue Tracker
+- type: mail
+  uri: http://groups.google.com/group/rubyworks-mailinglist
+  label: Mailing List
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/ansi.git
+categories: []
+copyrights:
+- holder: Rubyworks
+  year: '2009'
+  license: BSD-2-Clause
+customs: []
+paths:
+  lib:
+  - lib
+name: ansi
+title: ANSI
+version: 1.5.0
+summary: ANSI at your fingertips!
+description: The ANSI project is a superlative collection of ANSI escape code related
+  libraries eabling ANSI colorization and stylization of console output. Byte for
+  byte ANSI is the best ANSI code library available for the Ruby programming language.
+orgranizations:
+- Rubyworks
+created: '2009-08-01'
+date: '2015-01-16'

data/vendor/bundle/ruby/2.7.0/gems/ansi-1.5.0/.yardopts

@@ -0,0 +1,8 @@
+--title ANSI
+--protected
+--private
+lib
+-
+QED.rdoc
+[A-Z]*.*
+

data/vendor/bundle/ruby/2.7.0/gems/ansi-1.5.0/DEMO.md

@@ -0,0 +1,451 @@
+# ANSI::Code
+
+Require the library.
+
+    require 'ansi/code'
+
+ANSI::Code can be used as a functions module.
+
+    str = ANSI::Code.red + "Hello" + ANSI::Code.blue + "World"
+    str.assert == "\e[31mHello\e[34mWorld"
+
+If a block is supplied to each method then yielded value will
+be wrapped in the ANSI code and clear code. 
+
+    str = ANSI::Code.red{ "Hello" } + ANSI::Code.blue{ "World" }
+    str.assert == "\e[31mHello\e[0m\e[34mWorld\e[0m"
+
+More conveniently the ANSI::Code module extends ANSI itself.
+
+    str = ANSI.red + "Hello" + ANSI.blue + "World"
+    str.assert == "\e[31mHello\e[34mWorld"
+
+    str = ANSI.red{ "Hello" } + ANSI.blue{ "World" }
+    str.assert == "\e[31mHello\e[0m\e[34mWorld\e[0m"
+
+In the appropriate context the ANSI::Code module can also be
+included, making its methods directly accessible.
+
+    include ANSI::Code
+
+    str = red + "Hello" + blue + "World"
+    str.assert == "\e[31mHello\e[34mWorld"
+
+    str = red{ "Hello" } + blue{ "World" }
+    str.assert == "\e[31mHello\e[0m\e[34mWorld\e[0m"
+
+Along with the single font colors, the library include background colors.
+
+    str = on_red + "Hello"
+    str.assert == "\e[41mHello"
+
+As well as combined color methods.
+
+    str = white_on_red + "Hello"
+    str.assert == "\e[37m\e[41mHello"
+
+The ANSI::Code module supports most standard ANSI codes, though
+not all platforms support every code, so YMMV.
+
+
+# String Extensions
+
+In addition the library offers an extension to String class
+called #ansi, which allows some of the ANSI::Code methods
+to be called in a more object-oriented fashion.
+
+    require 'ansi/core'
+
+    str = "Hello".ansi(:red) + "World".ansi(:blue)
+    str.assert == "\e[31mHello\e[0m\e[34mWorld\e[0m"
+
+
+# ANSI::Logger
+
+Require the ANSI::Logger library.
+
+    require 'ansi/logger'
+
+Create a new ANSI::Logger
+
+    log = ANSI::Logger.new(STDOUT)
+
+Info logging appears normal.
+
+    log.info{"Info logs are green.\n"}
+
+Warn logging appears yellow.
+
+    log.warn{"Warn logs are yellow.\n"}
+
+Debug logging appears cyan.
+
+    log.debug{"Debug logs are cyan.\n"}
+
+Error logging appears red.
+
+    log.error{"Error logs are red.\n"}
+
+Fatal logging appears bright red.
+
+    log.fatal{"Fatal logs are bold red!\n"}
+
+
+# ANSI::Progressbar
+
+Pretty progress bars are easy to construct.
+
+    require 'ansi/progressbar'
+
+    pbar = ANSI::Progressbar.new("Test Bar", 100)
+
+Running the bar simply requires calling the #inc method during
+a loop and calling #finish when done.
+
+    100.times do |i|
+      sleep 0.01
+      pbar.inc
+    end
+    pbar.finish
+
+We will use this same rountine in all the examples below, so lets
+make a quick macro for it. Notice we have to use #reset first
+before reusing the same progress bar.
+
+    def run(pbar)
+      pbar.reset
+      100.times do |i|
+        sleep 0.01
+        pbar.inc
+      end
+      pbar.finish
+      puts
+    end
+
+The progress bar can be stylized in almost any way.
+The #format setter provides control over the parts
+that appear on the line. For example, by default the
+format is:
+
+    pbar.format("%-14s %3d%% %s %s", :title, :percentage, :bar, :stat)
+
+So lets vary it up to demonstrate the case.
+
+    pbar.format("%-14s %3d%% %s %s", :title, :percentage, :stat, :bar)
+    run(pbar)
+
+The progress bar has an extra build in format intended for use with
+file downloads called #transer_mode.
+
+    pbar.transfer_mode
+    run(pbar)
+
+Calling this methods is the same as calling:
+
+    pbar.format("%-14s %3d%% %s %s",:title, :percentage, :bar, :stat_for_file_transfer)
+    run(pbar)
+
+The #style setter allows each part of the line be modified with ANSI codes. And the
+#bar_mark writer can be used to change the character used to make the bar.
+
+    pbar.standard_mode
+    pbar.style(:title => [:red], :bar=>[:blue])
+    pbar.bar_mark = "="
+    run(pbar)
+
+
+# ANSI::Mixin
+
+The ANSI::Mixin module is design for including into
+String-like classes. It will support any class that defines
+a #to_s method.
+
+    require 'ansi/mixin'
+
+In this demonstration we will simply include it in the
+core String class.
+
+    class ::String
+      include ANSI::Mixin
+    end
+
+Now all strings will have access to ANSI's style and color
+codes via simple method calls.
+
+    "roses".red.assert == "\e[31mroses\e[0m"
+
+    "violets".blue.assert == "\e[34mviolets\e[0m"
+
+    "sugar".italic.assert == "\e[3msugar\e[0m"
+
+The method can be combined, of course.
+
+    "you".italic.bold.assert == "\e[1m\e[3myou\e[0m\e[0m"
+
+The mixin also supports background methods.
+
+    "envy".on_green.assert == "\e[42menvy\e[0m"
+
+And it also supports the combined foreground-on-background 
+methods.
+
+    "b&w".white_on_black.assert == "\e[37m\e[40mb&w\e[0m"
+
+
+# ANSI::String
+
+The ANSI::String class is a very sophisticated implementation
+of Ruby's standard String class, but one that can handle
+ANSI codes seamlessly.
+
+    require 'ansi/string'
+
+    flower1 = ANSI::String.new("Roses")
+    flower2 = ANSI::String.new("Violets")
+
+Like any other string.
+
+    flower1.to_s.assert == "Roses"
+    flower2.to_s.assert == "Violets"
+
+Bet now we can add color.
+
+    flower1.red!
+    flower2.blue!
+
+    flower1.to_s.assert == "\e[31mRoses\e[0m"
+    flower2.to_s.assert == "\e[34mViolets\e[0m"
+
+Despite that the string representation now contains ANSI codes,
+we can still manipulate the string in much the same way that
+we manipulate an ordinary string.
+
+    flower1.size.assert == 5
+    flower2.size.assert == 7
+
+Like ordinary strings we can concatenate the two strings
+
+    flowers = flower1 + ' ' + flower2
+    flowers.to_s.assert == "\e[31mRoses\e[0m \e[34mViolets\e[0m"
+
+    flowers.size.assert == 13
+
+Standard case conversion such as #upcase and #downcase work.
+
+    flower1.upcase.to_s.assert == "\e[31mROSES\e[0m"
+    flower1.downcase.to_s.assert == "\e[31mroses\e[0m"
+
+Some of the most difficult methods to re-implement were the 
+substitution methods such as #sub and #gsub. They are still
+somewhat more limited than the original string methods, but
+their primary functionality should work.
+
+    flower1.gsub('s', 'z').to_s.assert == "\e[31mRozez\e[0m"
+
+There are still a number of methods that need implementation.
+ANSI::String is currently a very partial implementation. But
+as you can see from the methods it does currently support,
+is it already useful.
+
+
+# ANSI::Columns
+
+The +Columns+ class makes it easy to create nice looking text columns,
+sorted from top to bottom, right to left (as opposed to the other way
+around).
+
+    require 'ansi/columns'
+
+    list = %w{a b c d e f g h i j k l}
+
+    columns = ANSI::Columns.new(list)
+
+    columns.to_s(4)
+
+The output will be:
+
+    a d g j
+    b e h k
+    c f i l
+
+Besides an array of elements, Columns.new can take a string in which
+the elements are divided by newlines characters. The default column
+size can also be given to the initializer.
+
+    list = "a\nb\nc\nd\ne\nf\ng\nh\ni\nj\nk\nl"
+
+    columns = ANSI::Columns.new(list, :columns=>6)
+
+    columns.to_s
+
+The output will be:
+
+    a c e g i k
+    b d f h j l
+
+If the column count is +nil+, then the number of columns will be calculated
+as a best fit for the current terminal window.
+
+## Padding
+
+Columns can adjust the padding between cells.
+
+    list = %w{a b c d e f g h i j k l}
+
+    columns = ANSI::Columns.new(list, :padding=>2)
+
+    columns.to_s(4)
+
+The output will be:
+
+    a  d  g  j
+    b  e  h  k
+    c  f  i  l
+
+## Alignment
+
+Columns can also be aligned either left or right.
+
+    list = %w{xx xx xx yy y yy z zz z}
+
+    columns = ANSI::Columns.new(list, :align=>:right)
+
+    columns.to_s(3)
+
+The output will be:
+
+    xx yy  z
+    xx  y zz
+    xx yy  z
+
+## Format
+
+Lastly, columns can be augmented with ANSI codes. This is done through
+a formatting block. The block can take up to three parameters, the cell
+content, the column and row numbers, or the cell and the column and row
+numbers.
+
+    list = %w{a b c d e f g h i j k l}
+
+    columns = ANSI::Columns.new(list){ |c,r| r % 2 == 0 ? :red : :blue }
+
+    out = columns.to_s(4)
+
+    out.assert == (
+      "\e[31ma \e[0m\e[31md \e[0m\e[31mg \e[0m\e[31mj \e[0m\n" +
+      "\e[34mb \e[0m\e[34me \e[0m\e[34mh \e[0m\e[34mk \e[0m\n" +
+      "\e[31mc \e[0m\e[31mf \e[0m\e[31mi \e[0m\e[31ml \e[0m\n"
+    )
+
+
+# ANSI::Table
+
+The ANSI::Table class can be used to output tabular data with nicely
+formated ASCII cell borders.
+
+    require 'ansi/table'
+
+The constructor takes an 2-dimensional array.
+
+    data = [
+      [ 10, 20, 30 ],
+      [ 20, 10, 20 ],
+      [ 50, 40, 20 ]
+    ]
+
+    table = ANSI::Table.new(data)
+
+    table.to_s
+
+The output will be:
+
+    +----+----+----+
+    | 10 | 20 | 30 |
+    | 20 | 10 | 20 |
+    | 50 | 40 | 20 |
+    +----+----+----+
+
+
+
+# ANSI::Diff
+
+    require 'ansi/diff'
+
+    a = 'abcYefg'
+    b = 'abcXefg'
+
+    diff = ANSI::Diff.new(a,b)
+
+    diff.to_s.assert == "\e[31mabc\e[0m\e[33mYefg\e[0m\n\e[31mabc\e[0mXefg"
+
+Try another.
+
+    a = 'abc'
+    b = 'abcdef'
+
+    diff = ANSI::Diff.new(a,b)
+
+    diff.to_s.assert == "\e[31mabc\e[0m\n\e[31mabc\e[0mdef"
+
+And another.
+
+    a = 'abcXXXghi'
+    b = 'abcdefghi'
+
+    diff = ANSI::Diff.new(a,b)
+
+    diff.to_s.assert == "\e[31mabc\e[0m\e[33mXXXghi\e[0m\n\e[31mabc\e[0mdefghi"
+
+And another.
+
+    a = 'abcXXXdefghi'
+    b = 'abcdefghi'
+
+    diff = ANSI::Diff.new(a,b)
+
+    diff.to_s.assert == "\e[31mabc\e[0m\e[33mXXX\e[0m\e[35mdefghi\e[0m\n\e[31mabc\e[0m\e[35mdefghi\e[0m"
+
+Comparison that is mostly different.
+
+    a = 'abcpppz123'
+    b = 'abcxyzzz43'
+
+    diff = ANSI::Diff.new(a,b)
+
+    diff.to_s.assert == "\e[31mabc\e[0m\e[33mpppz123\e[0m\n\e[31mabc\e[0mxyzzz43"
+
+
+# ANSI::BBCode
+
+The BBCode module provides methods for converting between
+BBCodes, basic HTML and ANSI codes.
+
+    require 'ansi/bbcode'
+
+BBCodes are color and style codes in square brackets, quite
+popular with on line forums.
+
+    bbcode = "this is [COLOR=red]red[/COLOR], this is [B]bold[/B]"
+
+We can convert this to ANSI code simply enough:
+
+    ansi = ANSI::BBCode.bbcode_to_ansi(bbcode)
+
+    ansi.assert == "this is \e[0;31mred\e[0m, this is \e[1mbold\e[0m\n"
+
+In addition the BBCode module supports conversion to simple HTML.
+
+    html = ANSI::BBCode.bbcode_to_html(bbcode)
+
+    html.assert == "this is <font color=\"red\">red</font>, this is <strong>bold</strong><br />\n"
+
+
+# ANSI::Terminal
+
+We should be ables to get the terminal width via the `terminal_width` method.
+
+    width = ANSI::Terminal.terminal_width
+
+    Fixnum.assert === width
+
+