ascii_paint 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: 07fb319a0666e394fce07cca879a6d3c16cf81c9
+  data.tar.gz: 07e594e70ac58ebd656b72dabcbda59f2ae3e03b
+!binary "U0hBNTEy":
+  metadata.gz: 5e952740658a8fec7f020877d6d2e66e5bdf4bd5d370a2cd2ce507fa4b3f97179b093bf24894e509a2206377614a384c3488f34e4b98e866ca2a0e53fbb3eb76
+  data.tar.gz: 4bef3c9a2cc135a6646c7ce6abd52fdee20cb568828b68ffee032f6ebb6ec4b28f71af91665c81e55b7f04b3b439e2b39b8cd61a003c529a3f4b20cd34bad8a0

data/data/block_characters/0.txt

@@ -0,0 +1,5 @@
+ 000 
+0  00
+0 0 0
+00  0
+ 000 

data/data/block_characters/1.txt

@@ -0,0 +1,5 @@
+ 11  
+  1  
+  1  
+  1  
+  1  

data/data/block_characters/2.txt

@@ -0,0 +1,5 @@
+ 222 
+2   2
+   2 
+ 22  
+22222

data/data/block_characters/3.txt

@@ -0,0 +1,5 @@
+3333 
+    3
+  33 
+    3
+3333 

data/data/block_characters/4.txt

@@ -0,0 +1,5 @@
+4   4
+4   4
+44444
+    4
+    4

data/data/block_characters/5.txt

@@ -0,0 +1,5 @@
+55555
+5    
+5555 
+    5
+5555 

data/data/block_characters/6.txt

@@ -0,0 +1,5 @@
+66666
+6    
+66666
+6   6
+66666

data/data/block_characters/7.txt

@@ -0,0 +1,5 @@
+77777
+    7
+   7 
+  7  
+ 7   

data/data/block_characters/8.txt

@@ -0,0 +1,5 @@
+ 888 
+8   8
+ 888 
+8   8
+ 888 

data/data/block_characters/9.txt

@@ -0,0 +1,5 @@
+99999
+9   9
+99999
+    9
+    9

data/data/block_characters/A.txt

@@ -0,0 +1,5 @@
+AAAAA
+A   A
+AAAAA
+A   A
+A   A

data/data/block_characters/B.txt

@@ -0,0 +1,5 @@
+BBBB 
+B   B
+BBBB 
+B   B
+BBBB 

data/data/block_characters/C.txt

@@ -0,0 +1,5 @@
+ CCCC
+C    
+C    
+C    
+ CCCC

data/data/block_characters/D.txt

@@ -0,0 +1,5 @@
+DDDD 
+D   D
+D   D
+D   D
+DDDD 

data/data/block_characters/E.txt

@@ -0,0 +1,5 @@
+EEEEE
+E    
+EEEE 
+E    
+EEEEE

data/data/block_characters/F.txt

@@ -0,0 +1,5 @@
+FFFFF
+F    
+FFFF 
+F    
+F    

data/data/block_characters/G.txt

@@ -0,0 +1,5 @@
+GGGGG
+G    
+G GGG
+G   G
+GGGGG

data/data/block_characters/H.txt

@@ -0,0 +1,5 @@
+H   H
+H   H
+HHHHH
+H   H
+H   H

data/data/block_characters/I.txt

@@ -0,0 +1,5 @@
+IIIII
+  I  
+  I  
+  I  
+IIIII

data/data/block_characters/J.txt

@@ -0,0 +1,5 @@
+JJJJJ
+   J 
+   J 
+J  J 
+JJJJ 

data/data/block_characters/K.txt

@@ -0,0 +1,5 @@
+K   K
+K  K 
+KKK  
+K  K 
+K   K

data/data/block_characters/L.txt

@@ -0,0 +1,5 @@
+L    
+L    
+L    
+L    
+LLLLL

data/data/block_characters/M.txt

@@ -0,0 +1,5 @@
+MMMMM
+M M M
+M M M
+M   M
+M   M

data/data/block_characters/N.txt

@@ -0,0 +1,5 @@
+N   N
+NN  N
+N N N
+N  NN
+N   N

data/data/block_characters/O.txt

@@ -0,0 +1,5 @@
+OOOOO
+O   O
+O   O
+O   O
+OOOOO

data/data/block_characters/P.txt

@@ -0,0 +1,5 @@
+PPPPP
+P   P
+PPPPP
+P    
+P    

data/data/block_characters/Q.txt

@@ -0,0 +1,5 @@
+QQQQ 
+Q  Q 
+Q  Q 
+QQQQ 
+  QQQ

data/data/block_characters/R.txt

@@ -0,0 +1,5 @@
+RRRR 
+R   R
+RRRR 
+R  R 
+R   R

data/data/block_characters/S.txt

@@ -0,0 +1,5 @@
+ SSSS
+S    
+ SSS 
+    S
+SSSS 

data/data/block_characters/T.txt

@@ -0,0 +1,5 @@
+TTTTT
+  T  
+  T  
+  T  
+  T  

data/data/block_characters/U.txt

@@ -0,0 +1,5 @@
+U   U
+U   U
+U   U
+U   U
+ UUU 

data/data/block_characters/V.txt

@@ -0,0 +1,5 @@
+V   V
+V   V
+V   V
+ V V 
+  V  

data/data/block_characters/W.txt

@@ -0,0 +1,5 @@
+W   W
+W   W
+W W W
+W W W
+ W W 

data/data/block_characters/X.txt

@@ -0,0 +1,5 @@
+X   X
+ X X 
+  X  
+ X X 
+X   X

data/data/block_characters/Y.txt

@@ -0,0 +1,5 @@
+Y   Y
+Y   Y
+ YYY 
+  Y  
+  Y  

data/data/block_characters/Z.txt

@@ -0,0 +1,5 @@
+ZZZZZ
+   Z 
+  Z  
+ Z   
+ZZZZZ

data/lib/ascii_paint.rb

@@ -0,0 +1,113 @@
+require 'bundler/setup'
+require 'chunky_png'
+
+module AsciiPaint
+  
+  # Exception raised when ASCII paint encounters a character without a paint
+  # color specified.
+  class CharacterNotFound < Exception; end
+
+  # Paints a PNG based on the given ASCII art.
+  #
+  # Example:
+  #     text = "
+  #     !!!!! @@@@@ $$$$$ %%%%% ^^^^^       @@@@@ $$$$$ %%%%% ^   ^ !!!!! 
+  #     !   ! @     $       %     ^         @   @ $   $   %   ^^  ^   !   
+  #     !!!!! @@@@@ $       %     ^         @@@@@ $$$$$   %   ^ ^ ^   !   
+  #     !   !     @ $       %     ^         @     $   $   %   ^  ^^   !   
+  #     !   ! @@@@@ $$$$$ %%%%% ^^^^^ !!!!! @     $   $ %%%%% ^   ^   !   
+  #     "
+  #
+  #     AsciiPaint.paint(text, 'out.png')
+  #
+  # @param  ascii_art [#to_s, Array<String>]
+  #   multiline string, string array or filename with the ASCII art to paint
+  # @param  out_filename [#to_s]
+  #   the name of the painted PNG file
+  # @param  conf [Hash<Symbol, value>]
+  #   configuration settings. Keys should be the names of attributes of
+  #   {AsciiPaint::Config}, such as +:character_height+.
+  # @return [String]
+  #   the name of the painted PNG file
+  def self.paint(ascii_art, out_filename, configuration = {})
+    global_configuration = self.config
+    local_configuration = global_configuration.dup.set_options(configuration)
+
+    ascii_array = ascii_art_to_array(ascii_art)
+    image = ascii_to_image(ascii_array, local_configuration)
+    save_image(image, out_filename, local_configuration)
+
+    if block_given?
+      begin
+        yield out_filename
+      ensure
+        FileUtils.rm(out_filename)
+      end
+
+      true
+    else
+      out_filename
+    end
+  end
+
+  private
+
+  def self.ascii_art_to_array(ascii_art)
+    return ascii_art if ascii_art.is_a? Array
+
+    ascii_art = ascii_art.to_s.split("\n")
+    if ascii_art.size == 1
+      ascii_art = File.open(ascii_art[0], 'r').to_a.map(&:chomp)
+    end
+    ascii_art
+  end
+
+  def self.ascii_to_image(ascii_array, configuration)
+    colors_grid = ascii_to_colors(ascii_array, configuration)
+    image = blank_image(ascii_array, configuration)
+    painted_image(image, colors_grid, configuration)
+  end
+  
+  def self.blank_image(lines, configuration)
+    height = lines.size
+    width = lines.map(&:size).max
+
+    width_pixels, height_pixels = configuration.characters_to_pixels(width, height)
+    png = ChunkyPNG::Image.new(width_pixels, height_pixels, configuration.color_map[' '])
+  end
+
+  def self.ascii_to_colors(strings, configuration)
+    strings.map do |line|
+      line.chars.map do |char|
+        color = configuration.color_map[char]
+        raise AsciiPaint::CharacterNotFound.new "Couldn't find a color mapping for character: #{char}" unless color
+        color
+      end
+    end
+  end
+
+  def self.painted_image(image, color_grid, configuration)
+    color_grid.each_with_index do |row, y|
+      row.each_with_index do |color, x|
+        x_pixels, y_pixels = configuration.characters_to_pixels(x, y)
+        width_pixels, height_pixels = configuration.characters_to_pixels(1, 1)
+        image.rect(x_pixels, y_pixels, x_pixels + width_pixels, y_pixels + height_pixels, configuration.border_color, color)
+      end
+    end
+
+    image
+  end
+
+  def self.save_image(image, filename, _)
+    image.save(filename, :interlace => true)
+  end
+
+  def self.root
+    Pathname.new(__FILE__).parent.parent
+  end
+end
+
+require_relative 'ascii_paint/block_character.rb'
+require_relative 'ascii_paint/block_string.rb'
+require_relative 'ascii_paint/config.rb'
+require_relative 'ascii_paint/version.rb'

data/lib/ascii_paint/block_character.rb

@@ -0,0 +1,85 @@
+module AsciiPaint
+  class BlockCharacter
+    attr_reader :ascii
+
+    # TODO: make customizable
+    UNPADDED_HEIGHT = 5
+    UNPADDED_WIDTH = 5
+    VERTICAL_PADDING = 2
+    HORIZONTAL_PADDING = 2
+
+    def initialize(character)
+      raise "Only single characters please! #{character}" unless character.size == 1
+
+      if character == "\n"
+        @newline = true
+        return
+      end
+
+      load_ascii(character)
+    end
+
+    def newline?
+      !!@newline
+    end
+
+    def to_s
+      ascii.join("\n")
+    end
+
+    def self.height
+      UNPADDED_HEIGHT + VERTICAL_PADDING
+    end
+
+    def self.width
+      UNPADDED_WIDTH + HORIZONTAL_PADDING
+    end
+
+    def self.left_padding
+      HORIZONTAL_PADDING / 2
+    end
+
+    def self.right_padding
+      (HORIZONTAL_PADDING + 1) / 2
+    end
+
+    def self.top_padding
+      VERTICAL_PADDING / 2
+    end
+
+    def self.bottom_padding
+      (VERTICAL_PADDING + 1) / 2
+    end
+
+    private
+
+    # TODO: filename escaping
+    def load_ascii(character)
+      path = block_characters_dir.join("#{character}.txt")
+      if File.exists? path
+        @ascii = File.open(path, 'r').to_a.map(&:chomp)
+        @ascii = pad_ascii(@ascii)
+      else
+        raise "Character not supported: #{character}"
+      end
+    end
+
+    def pad_ascii(ascii)
+      left = " " * self.class.left_padding
+      right = " " * self.class.right_padding
+      padded = ascii.map do |row|
+        "#{left}#{row}#{right}"
+      end
+
+      blank_row = " " * self.class.width
+      self.class.top_padding.times { padded.unshift(blank_row) }
+      self.class.bottom_padding.times { padded.push(blank_row) }
+
+      padded
+    end
+
+    def block_characters_dir
+      AsciiPaint.root.join('data', 'block_characters')
+    end
+  end
+end

data/lib/ascii_paint/block_string.rb

@@ -0,0 +1,49 @@
+module AsciiPaint
+  class BlockString
+    attr_reader :block_characters
+
+    def initialize(string)
+      @block_characters = string.chars.map { |char| BlockCharacter.new(char) }
+    end
+
+    def each_row
+      return to_enum(:each_row) unless block_given?
+
+      rows =
+        block_characters.chunk do |block_char|
+          if block_char.newline?
+            nil
+          else
+            :not_newline
+          end
+        end.map do |symbol, row|
+          row
+        end
+
+      rows.each do |row|
+        yield row
+      end
+    end
+
+    def to_a
+      each_row.flat_map do |block_row|
+        (0...BlockCharacter.height).map do |h|
+          block_row.inject('') do |string_row, block_char|
+            string_row + block_char.ascii[h]
+          end
+        end
+      end
+    end
+  end
+end
+
+module AsciiPaint
+  # TODO: support filename arguments
+  # TODO: write tests
+  # TODO: write docs
+  def self.block_paint(block_string, out_filename, conf = {}, &block)
+    block_string = block_string.join("\n") if block_string.respond_to? :join
+    ascii_art = BlockString.new(block_string).to_a
+    paint(ascii_art, out_filename, conf, &block)
+  end
+end

data/lib/ascii_paint/config.rb

@@ -0,0 +1,197 @@
+# An instance of class +AsciiPaint::Config+ is used to set global configuration
+# options for ASCII paint. Pass a block to {AsciiPaint.config} to access this
+# object.
+
+module AsciiPaint
+  class Config
+
+    TRANSPARENT = ChunkyPNG::Color::TRANSPARENT
+    SPECIAL_SYMBOL_MAP = {
+      transparent: TRANSPARENT
+    }
+    private_constant :TRANSPARENT, :SPECIAL_SYMBOL_MAP 
+
+    # The horizontal size in pixels of the rectangle that replaces a single
+    # character during painting.
+    attr_accessor :character_width
+
+    # The vertical size in pixels of the rectangle that replaces a single
+    # character during painting.
+    attr_accessor :character_height
+
+    attr_accessor :color_map
+
+    def initialize(settings = {})
+      reset!
+      set_options(settings)
+    end
+
+    class << self
+      alias_method :default, :new
+    end
+
+    # Merge new mappings into the color map.
+    #
+    # The color map specifies which color paints over each character. For example,
+    #     config.color_map = { 'a' => :blue }
+    # tells ASCII paint to replace the character 'a' with the color blue.
+    #
+    # @param  hash [Hash<String, Symbol>]
+    #   the new mappings to be merged into the color map.
+    # @return [void]
+    def color_map=(hash)
+      replace_special_symbols!(hash)
+      @color_map = color_map.merge(hash)
+    end
+
+    # Set the color to paint over characters whose color hasn't been defined by
+    # the color map.
+    #
+    # @param default_color [Symbol]
+    #   the default color to replace characters without a specified color.
+    # @return [void]
+    def color_for_undefined_character=(default_color)
+      color_map.default = replacement_for_special_symbol(default_color)
+    end
+
+    def characters_to_pixels(x, y)
+      [x * character_width, y * character_height]
+    end
+
+    # Set configuration options using a hash instead of using method calls. For
+    # example,
+    #     config.set_options({character_width: 10})
+    # is equivalent to
+    #     config.character_width = 10
+    #
+    # @param  options [Hash<Symbol, value>]
+    #   settings mapping from attribute name to value.
+    # @return self
+    def set_options(options)
+      options.each do |key, value|
+        mutator_name = "#{key}="
+        self.send(mutator_name, value)
+      end
+      self
+    end
+
+    def border_color
+      TRANSPARENT
+    end
+
+    def reset!
+      @character_height = Default::CHARACTER_HEIGHT
+      @character_width = Default::CHARACTER_WIDTH
+      @color_map =
+        begin
+          map = Default::COLOR_MAP.dup
+          map.default = Default::COLOR_FOR_UNDEFINED_CHARACTER
+          replace_special_symbols!(map)
+          map
+        end
+    end
+
+    private
+
+    def replace_special_symbols!(hash)
+      hash.each do |char, color_sym|
+        hash[char] = replacement_for_special_symbol(color_sym)
+      end
+    end
+
+    def replacement_for_special_symbol(symbol)
+      SPECIAL_SYMBOL_MAP[symbol] || symbol
+    end
+
+    public
+
+    # Default values for configuration settings.
+    module Default
+      private
+
+      def self.rainbow_mapping(characters)
+        # Thanks jbum (http://krazydad.com/tutorials/makecolors.php)
+        hash = {}
+        period = Math::PI * 2
+        frequency = period / characters.count
+        characters.each_with_index do |char, index|
+          r = Math.cos(frequency * index + 0) * 127 + 128;
+          g = Math.cos(frequency * index + period / 3) * 127 + 128;
+          b = Math.cos(frequency * index + period * 2 / 3) * 127 + 128;
+          color = ChunkyPNG::Color.rgb(r.to_i, g.to_i, b.to_i)
+          hash[char] = color
+        end
+        hash
+      end
+
+      public
+
+      CHARACTER_HEIGHT = 16
+      CHARACTER_WIDTH = 8
+      COLOR_FOR_UNDEFINED_CHARACTER = :black
+      COLOR_MAP =
+        begin
+          map = {
+            ' ' => :transparent,
+
+            '!' => :red,
+            '@' => :orange,
+            '#' => :yellow,
+            '$' => :green,
+            '%' => :blue,
+            '^' => :purple,
+
+            '_' => :white,
+            '~' => :black,
+
+            '<' => :lightgrey,
+            '>' => :grey,
+            '?' => :darkgrey,
+            ',' => :lightslategrey,
+            '.' => :slategrey,
+            '/' => :darkslategrey,
+            '\\' => :dimgrey,
+
+            ':' => :chocolate,
+            ';' => :blanchedalmond,
+            '\'' => :coral,
+            '"' => :deepskyblue,
+            '{' => :indigo,
+            '}' => :ivory,
+            '[' => :khaki,
+            ']' => :lavender,
+            '|' => :hotpink,
+            '&' => :darksalmon,
+            '*' => :lime,
+            '(' => :lightyellow,
+            ')' => :honeydew,
+            '-' => :azure,
+            '+' => :crimson,
+            '=' => :antiquewhite,
+            '`' => :cornsilk
+          }
+
+          letters = ('a'..'z').zip('A'..'Z').flatten  # ['a', 'A', 'b', 'B', ...]
+          map.merge! rainbow_mapping(letters)
+
+          numbers = ('0'..'9')
+          map.merge! rainbow_mapping(numbers)
+
+          map
+        end
+    end
+
+  end
+end
+
+module AsciiPaint
+  # Passes an instance of {AsciiPaint::Config} to the given block. Used to set
+  # global configuration.
+  #
+  # @return [Config] the global configuration
+  def self.config
+    @configuration ||= Config.default
+    yield(@configuration) if block_given?
+    @configuration
+  end
+end

data/lib/ascii_paint/version.rb

@@ -0,0 +1,3 @@
+module AsciiPaint
+  VERSION = '0.2.1'
+end

data/spec/ascii_paint_spec.rb

@@ -0,0 +1,108 @@
+require 'ascii_paint'
+require 'pry'
+
+describe AsciiPaint do
+
+  let(:input_filename) { Helpers.fixtures_directory.join('ascii.txt') }
+
+  before(:each) do
+    Helpers.cd_work_directory
+  end
+
+  after(:each) do
+    Helpers.rm_rf_work_directory
+    AsciiPaint.config.reset!
+  end
+
+  it "does math good" do
+    (1 + 1).should eq(2)
+  end
+
+  it "writes a file" do
+    AsciiPaint.paint("ASCII\npaint", OUTPUT_FILENAME)
+    File.should be_a_file OUTPUT_FILENAME
+  end
+
+  it "paints the correct dimensions" do
+    AsciiPaint.paint("ASCII\npaint", OUTPUT_FILENAME, character_width: 10, character_height: 10)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 10)
+    result.width.should eq(5 * 10)
+  end
+
+  it "paints the correct colors" do
+    AsciiPaint.paint("ASCII\npaint", OUTPUT_FILENAME, character_width: 10, color_map: {'S' => :blue})
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    color = result.get_pixel(15, 0)
+    red = ChunkyPNG::Color.r(color)
+    green = ChunkyPNG::Color.g(color)
+    blue = ChunkyPNG::Color.b(color)
+    [red, green, blue].should eq([0, 0, 255])
+  end
+
+  it "accepts a multiline string input" do
+    multiline_string = "ASCII\npaint"
+    AsciiPaint.paint(multiline_string, OUTPUT_FILENAME, character_width: 10, character_height: 10)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 10)
+    result.width.should eq(5 * 10)
+  end
+
+  it "accepts a string array input" do
+    string_array = ["ASCII", "paint"]
+    AsciiPaint.paint(string_array, OUTPUT_FILENAME, character_width: 10, character_height: 10)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 10)
+    result.width.should eq(5 * 10)
+  end
+
+  it "accepts a filename input" do
+    AsciiPaint.paint(input_filename, OUTPUT_FILENAME, character_width: 10, character_height: 10)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 10)
+    result.width.should eq(5 * 10)
+  end
+
+  it "obeys AsciiPaint.config configuration" do
+    AsciiPaint.config do |config|
+      config.character_height = 100
+    end
+
+    AsciiPaint.paint(input_filename, OUTPUT_FILENAME)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 100)
+  end
+
+  it "obeys per-method-call configuration" do
+    AsciiPaint.paint("ASCII\npaint", OUTPUT_FILENAME, character_width: 10, character_height: 10)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 10)
+    result.width.should eq(5 * 10)
+  end
+
+  it "overrides global config with local config" do
+    AsciiPaint.config do |config|
+      config.character_height = 100
+    end
+
+    AsciiPaint.paint(input_filename, OUTPUT_FILENAME, character_height: 77)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(2 * 77)
+  end
+
+  it "paints transparent paint" do
+    AsciiPaint.paint("ASCII\npaint", OUTPUT_FILENAME, character_width: 10, color_map: {'S' => :transparent})
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    color = result.get_pixel(15, 0)
+    alpha = ChunkyPNG::Color.a(color)
+    alpha.should eq(0)
+  end
+
+  it "deletes temporary files" do
+    AsciiPaint.paint("ASCII\npaint", OUTPUT_FILENAME) do |f|
+      File.should be_a_file OUTPUT_FILENAME
+    end
+
+    File.should_not be_a_file OUTPUT_FILENAME
+  end
+end

data/spec/block_string_spec.rb

@@ -0,0 +1,75 @@
+require 'ascii_paint'
+require 'pry'
+
+describe AsciiPaint::BlockString do
+
+  before(:each) do
+    Helpers.cd_work_directory
+  end
+
+  after(:each) do
+    Helpers.rm_rf_work_directory
+    AsciiPaint.config.reset!
+  end
+
+  it "writes a file" do
+    AsciiPaint.block_paint("ASCII", OUTPUT_FILENAME)
+    File.should be_a_file OUTPUT_FILENAME
+  end
+
+  it "obeys local configuration" do
+    AsciiPaint.block_paint("ASCII", OUTPUT_FILENAME, character_height: 100)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(100 * AsciiPaint::BlockCharacter.height)
+  end
+
+  it "obeys global configuration" do
+    AsciiPaint.config do |config|
+      config.character_height = 100
+    end
+
+    AsciiPaint.block_paint("ASCII", OUTPUT_FILENAME)
+    result = ChunkyPNG::Image.from_file(OUTPUT_FILENAME)
+    result.height.should eq(100 * AsciiPaint::BlockCharacter.height)
+  end
+
+  it "deletes temporary files" do
+    AsciiPaint.block_paint("ASCII\npaint", OUTPUT_FILENAME) do |f|
+      File.should be_a_file OUTPUT_FILENAME
+    end
+
+    File.should_not be_a_file OUTPUT_FILENAME
+  end
+
+  context "data directory" do
+    it "has character files of the correct width" do
+      Helpers.each_block_character_path do |path|
+        File.open(path, 'r') do |file|
+          file.each_line do |line|
+            line.chomp.size.should eq(AsciiPaint::BlockCharacter::UNPADDED_WIDTH), file.path
+          end
+        end
+      end
+    end
+
+    it "has character files of the correct height" do
+      Helpers.each_block_character_path do |path|
+        File.open(path, 'r') do |file|
+          file.each_line.count.should eq(AsciiPaint::BlockCharacter::UNPADDED_HEIGHT), file.path
+        end
+      end
+    end
+
+    it "has character files for all alphanumeric characters" do
+      desired_characters = ('A'..'Z').to_a + ('0'..'9').to_a
+      found_characters = []
+
+      Helpers.each_block_character_path do |path|
+        character = path.to_s.match(/\/(.)\.txt/)[1]
+        found_characters << character
+      end
+
+      found_characters.should =~ desired_characters
+    end
+  end
+end

data/spec/fixtures/ascii.txt

@@ -0,0 +1,2 @@
+ASCII
+paint

data/spec/spec_helper.rb

@@ -0,0 +1,54 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+require 'ascii_paint'
+
+OUTPUT_FILENAME = 'painted.png'
+
+module Helpers
+  def self.cd_work_directory
+    create_work_directory
+    Dir.chdir(Helpers.work_directory)
+  end
+
+  def self.rm_rf_work_directory
+    Dir.chdir(work_directory.parent)
+    FileUtils.rm_rf(Helpers.work_directory)
+  end
+
+  def self.create_work_directory
+    FileUtils.mkdir_p(work_directory)
+  end
+
+  def self.work_directory
+    AsciiPaint.root.join('tmp', 'spec')
+  end
+
+  def self.fixtures_directory
+    AsciiPaint.root.join('spec', 'fixtures')
+  end
+
+  # TODO: split into separate helper
+  def self.each_block_character_path
+    block_characters_dir = AsciiPaint.root.join('data', 'block_characters')
+    block_characters_dir.each_child(false) do |path|
+      full_path = block_characters_dir.join(path)
+      yield full_path
+    end
+  end
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: ascii_paint
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Nate Sullivan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Convert ASCII art to PNGs in pure Ruby.
+email: nathanielsullivan00+ascii_paint@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ascii_paint/block_character.rb
+- lib/ascii_paint/block_string.rb
+- lib/ascii_paint/config.rb
+- lib/ascii_paint/version.rb
+- lib/ascii_paint.rb
+- data/block_characters/0.txt
+- data/block_characters/1.txt
+- data/block_characters/2.txt
+- data/block_characters/3.txt
+- data/block_characters/4.txt
+- data/block_characters/5.txt
+- data/block_characters/6.txt
+- data/block_characters/7.txt
+- data/block_characters/8.txt
+- data/block_characters/9.txt
+- data/block_characters/A.txt
+- data/block_characters/B.txt
+- data/block_characters/C.txt
+- data/block_characters/D.txt
+- data/block_characters/E.txt
+- data/block_characters/F.txt
+- data/block_characters/G.txt
+- data/block_characters/H.txt
+- data/block_characters/I.txt
+- data/block_characters/J.txt
+- data/block_characters/K.txt
+- data/block_characters/L.txt
+- data/block_characters/M.txt
+- data/block_characters/N.txt
+- data/block_characters/O.txt
+- data/block_characters/P.txt
+- data/block_characters/Q.txt
+- data/block_characters/R.txt
+- data/block_characters/S.txt
+- data/block_characters/T.txt
+- data/block_characters/U.txt
+- data/block_characters/V.txt
+- data/block_characters/W.txt
+- data/block_characters/X.txt
+- data/block_characters/Y.txt
+- data/block_characters/Z.txt
+- spec/ascii_paint_spec.rb
+- spec/block_string_spec.rb
+- spec/fixtures/ascii.txt
+- spec/spec_helper.rb
+homepage: https://github.com/nate00/ascii_paint
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Paint in ASCII!
+test_files:
+- spec/ascii_paint_spec.rb
+- spec/block_string_spec.rb
+- spec/fixtures/ascii.txt
+- spec/spec_helper.rb
+has_rdoc: