pizzazz 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,17 @@
1
+ *.gem
2
+ *.rbc
3
+ .bundle
4
+ .config
5
+ .yardoc
6
+ Gemfile.lock
7
+ InstalledFiles
8
+ _yardoc
9
+ coverage
10
+ doc/
11
+ lib/bundler/man
12
+ pkg
13
+ rdoc
14
+ spec/reports
15
+ test/tmp
16
+ test/version_tmp
17
+ tmp
data/Gemfile ADDED
@@ -0,0 +1,8 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in pizzazz.gemspec
4
+ gemspec
5
+
6
+ gem 'rake'
7
+ gem 'minitest'
8
+ gem 'minitest-wscolor'
data/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ Copyright (c) 2012 Sam Soffes
2
+
3
+ MIT License
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ "Software"), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env rake
2
+ require 'bundler/gem_tasks'
3
+ require 'rake/testtask'
4
+
5
+ Rake::TestTask.new(:test) do |t|
6
+ t.libs << 'test'
7
+ t.pattern = 'test/**/*_test.rb'
8
+ end
9
+ task default: :test
@@ -0,0 +1,79 @@
1
+ # Pizzazz
2
+
3
+ Pizzazz is a simple pure Ruby implementation of code coloring, but just for JSON. Basically, if you have a ruby object and want to show it converted to JSON and add HTML around it so you can color it.
4
+
5
+ ## Usage
6
+
7
+ Pizzazzifing an object is simple:
8
+
9
+ ``` ruby
10
+ object = { name: 'Sam Soffes', website: 'http://samsoff.es' }
11
+ Pizzazz.ify(object)
12
+ #=> "{\n <span class=\"string\">\"name\"</span>: <span class=\"string\">\"Sam Soffes\"</span>,\n <span class=\"string\">\"website\"</span>: <span class=\"string\">\"http://samsoff.es\"</span>\n}"
13
+ ```
14
+
15
+ You can optionally limit arrays as well:
16
+
17
+ ``` ruby
18
+ Pizzazz.ify(all_of_the_things, limit: 1)
19
+ ```
20
+
21
+ This will add an ellipses after the first element.
22
+
23
+ ### HTML
24
+
25
+ Spans are added around various elements. Here's the classes:
26
+
27
+ * `string`
28
+ * `constant` (for `true` or `false`
29
+ * `null`
30
+ * `number`
31
+
32
+ Everything else is left alone. It is recommended to wrap the output like this:
33
+
34
+ ``` html
35
+ <pre><%= Pizzazz.ify(object).html_safe %></pre>
36
+ ```
37
+
38
+ Here's my stylesheet if you're interested:
39
+
40
+ ``` css
41
+ pre {
42
+ border-radius: 5px;
43
+ background: #f7f7f7;
44
+ padding: 0.5em;
45
+ margin-bottom: 2em;
46
+ border: 1px solid #ddd;
47
+ }
48
+
49
+ .string {
50
+ color: #ee6132;
51
+ }
52
+
53
+ .null, .number, .constant {
54
+ color: #8e75c3;
55
+ }
56
+
57
+ .comment {
58
+ color: #999;
59
+ font-style: italic;
60
+ }
61
+ ```
62
+
63
+ ## Installation
64
+
65
+ Add this line to your application's Gemfile:
66
+
67
+ ``` ruby
68
+ gem 'pizzazz'
69
+ ```
70
+
71
+ And then execute:
72
+
73
+ $ bundle
74
+
75
+ Or install it yourself as:
76
+
77
+ $ gem install pizzazz
78
+
79
+ Simple as that. Enjoy.
@@ -0,0 +1,11 @@
1
+ require 'pizzazz/colorer'
2
+ require 'pizzazz/version'
3
+
4
+ module Pizzazz
5
+ TAB_SIZE = 2
6
+
7
+ def self.ify(object, options = nil)
8
+ p = Pizzazz::Colorer.new(object, options)
9
+ p.ify
10
+ end
11
+ end
@@ -0,0 +1,71 @@
1
+ # encoding: UTF-8
2
+ require 'erb'
3
+
4
+ class Pizzazz::Colorer
5
+ def initialize(object, options = nil)
6
+ options ||= {}
7
+ @object = object
8
+ @indent = 0
9
+ @limit = (options[:limit] or 0)
10
+ end
11
+
12
+ def ify
13
+ node(@object, @limit)
14
+ end
15
+
16
+ private
17
+
18
+ def tab
19
+ " " * @indent * Pizzazz::TAB_SIZE
20
+ end
21
+
22
+ def node(object, limit = 0)
23
+ case object
24
+ when String
25
+ %Q{<span class="string">"#{::ERB::Util.h(object)}"</span>}
26
+ when Time
27
+ %Q{<span class="string">#{object.to_json}</span>}
28
+ when TrueClass
29
+ %Q{<span class="constant">true</span>}
30
+ when FalseClass
31
+ %Q{<span class="constant">false</span>}
32
+ when NilClass
33
+ %Q{<span class="null">null</span>}
34
+ when Numeric
35
+ %Q{<span class="number">#{object}</span>}
36
+ when Hash
37
+ s = "{\n"
38
+ @indent += 1
39
+ rows = []
40
+ object.keys.collect(&:to_s).sort.each do |key|
41
+ value = (object[key] != nil ? object[key] : object[key.to_sym])
42
+ rows << %Q{#{tab}<span class="string">"#{key}"</span>: #{node(value)}}
43
+ end
44
+ s << rows.join(",\n") + "\n"
45
+ @indent -= 1
46
+ s << "#{tab}}"
47
+ s
48
+ when Array
49
+ if object.length == 0
50
+ "[]"
51
+ else
52
+ s = "[\n"
53
+ @indent += 1
54
+ rows = []
55
+ array = @limit > 0 ? object[0...limit] : object
56
+ array.each do |value|
57
+ rows << tab + node(value)
58
+ end
59
+
60
+ if limit > 0 and object.length > limit
61
+ rows << tab + (object[0].is_a?(Hash) ? '{ … }' : '…')
62
+ end
63
+
64
+ s << rows.join(",\n") + "\n"
65
+ @indent -= 1
66
+ s << "#{tab}]"
67
+ s
68
+ end
69
+ end
70
+ end
71
+ end
@@ -0,0 +1,3 @@
1
+ module Pizzazz
2
+ VERSION = '0.1.0'
3
+ end
@@ -0,0 +1,17 @@
1
+ # encoding: UTF-8
2
+ require File.expand_path('../lib/pizzazz/version', __FILE__)
3
+
4
+ Gem::Specification.new do |gem|
5
+ gem.authors = ['Sam Soffes']
6
+ gem.email = ['sam@samsoff.es']
7
+ gem.description = %q{Add some pizzazz to your documentation}
8
+ gem.summary = %q{A simple gem to code color documentation}
9
+ gem.homepage = 'http://github.com/samsoffes/pizzazz'
10
+
11
+ gem.files = `git ls-files`.split($\)
12
+ gem.executables = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
13
+ gem.test_files = gem.files.grep(%r{^(test|spec|features)/})
14
+ gem.name = 'pizzazz'
15
+ gem.require_paths = ['lib']
16
+ gem.version = Pizzazz::VERSION
17
+ end
@@ -0,0 +1,6 @@
1
+ require 'rubygems'
2
+ gem 'minitest'
3
+ require 'minitest/wscolor'
4
+ require 'minitest/autorun'
5
+
6
+ require 'pizzazz'
@@ -0,0 +1,9 @@
1
+ require 'test_helper'
2
+
3
+ class TestColorer < MiniTest::Unit::TestCase
4
+ def test_that_it_colors_hashes
5
+ assert_equal Pizzazz.ify({foo: 'bar'}), %Q{{\n <span class="string">"foo"</span>: <span class="string">"bar"</span>\n}}
6
+ end
7
+
8
+ # These need to be expanded
9
+ end
metadata ADDED
@@ -0,0 +1,64 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: pizzazz
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ prerelease:
6
+ platform: ruby
7
+ authors:
8
+ - Sam Soffes
9
+ autorequire:
10
+ bindir: bin
11
+ cert_chain: []
12
+ date: 2012-07-10 00:00:00.000000000 Z
13
+ dependencies: []
14
+ description: Add some pizzazz to your documentation
15
+ email:
16
+ - sam@samsoff.es
17
+ executables: []
18
+ extensions: []
19
+ extra_rdoc_files: []
20
+ files:
21
+ - .gitignore
22
+ - Gemfile
23
+ - LICENSE
24
+ - Rakefile
25
+ - Readme.markdown
26
+ - lib/pizzazz.rb
27
+ - lib/pizzazz/colorer.rb
28
+ - lib/pizzazz/version.rb
29
+ - pizzazz.gemspec
30
+ - test/test_helper.rb
31
+ - test/units/colorer_test.rb
32
+ homepage: http://github.com/samsoffes/pizzazz
33
+ licenses: []
34
+ post_install_message:
35
+ rdoc_options: []
36
+ require_paths:
37
+ - lib
38
+ required_ruby_version: !ruby/object:Gem::Requirement
39
+ none: false
40
+ requirements:
41
+ - - ! '>='
42
+ - !ruby/object:Gem::Version
43
+ version: '0'
44
+ segments:
45
+ - 0
46
+ hash: -3216687736282638724
47
+ required_rubygems_version: !ruby/object:Gem::Requirement
48
+ none: false
49
+ requirements:
50
+ - - ! '>='
51
+ - !ruby/object:Gem::Version
52
+ version: '0'
53
+ segments:
54
+ - 0
55
+ hash: -3216687736282638724
56
+ requirements: []
57
+ rubyforge_project:
58
+ rubygems_version: 1.8.23
59
+ signing_key:
60
+ specification_version: 3
61
+ summary: A simple gem to code color documentation
62
+ test_files:
63
+ - test/test_helper.rb
64
+ - test/units/colorer_test.rb