spectra 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ee1b6454f86dcc042a8b03acd6cf8660aa6baa86
+  data.tar.gz: 970a196f54c7562ed965fd13bf551b5eeb3f77e6
+SHA512:
+  metadata.gz: fbdcb8d68ee9cc39eee38d0df5085da70973af302e0ba8feee1e8f7ff66dde156a6b1bb9411d0b37f8d51e1f994b6c83281be83b029d6556537885ec9a0960df
+  data.tar.gz: b86738e123ee3d95ade7f5ceab28bd013bbea8a7d034b05078cdf48a41dd7658bb2bf2d8a9bebadaad5031164037055879fc8a72993a590d116144add2aa5e32

data/.gitignore

@@ -0,0 +1,27 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+
+spectrum.rb
+.ruby-version
+.ruby-gemset
+

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in spectra.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ty Cobb
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,42 @@
+Spectra
+========
+Keep app-specific colors in-sync across all your tools with a single specification!
+
+Spectra is a command-line utility and Ruby DSL that generates color palettes (.clr), Objective-C categories, and Swift extensions. Define a spectrum.rb file and then run spectra from the terminal. That's all there is to it.
+
+## Using the DSL: spectrum.rb
+
+Specifying a class/method prefix (required):
+```ruby
+prefix :spc # subsitute your desired prefix
+```
+
+Specifying output formats (optional, defaults to `:palette` and `:objc`):
+```ruby
+
+## if you don't care about options
+formats :palette, :swift
+
+## if you want to specify the output directory
+format :objc, 'path/to/categories'
+
+## if you want to customize the method/color names
+format :swift, 'path/to/extensions' do |name, prefix|
+  name.camelize(true) # SyntacticRogueRed
+end
+```
+
+Specifying colors (optional, but it's pretty pointless not to):
+```ruby
+color :red,    (components 255, 0, 130)
+color :gray,   (hex 0xEEEEEE 0.6)
+color :white,  (white 1.0)
+color :overlay (components 0.8, 0.7, 0.2, 0.75)
+
+## alternate syntax
+
+color :red,     red: 255, blue: 130
+color :gray,    hex: 0xEEEEEE, a: 0.6
+color :white,   w: 1.0
+color :overlay, r: 0.8, g: 0.7, b: 0.2, a: 0.75
+```

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/spectra

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+
+require 'spectra'
+require 'ostruct'
+require 'optparse'
+
+options = OpenStruct.new
+options.verbose = false
+
+OptionParser.new do |opts|
+  opts.banner = 'usage: spectra [-vh]'
+ 
+  opts.on('-v', '--verbose', 'Enables verbose debugging output') do |flag|
+    options.verbose = true
+  end
+
+  opts.on('-d', '--dry-run', 'Processes colors without writing anything to disk') do |flag|
+    options.dry_run = true
+  end
+  
+  opts.on('-h', '--help', 'Shows this message') do |flag|
+    puts opts; exit 
+  end
+
+end.parse!(ARGV)
+
+Spectra.generate(options)
+

data/lib/spectra/components.rb

@@ -0,0 +1,62 @@
+
+module Spectra
+  
+  module Components    
+
+    class << self
+      attr_accessor :valid
+    end
+ 
+    self.valid = [ :red, :green, :blue, :white, :alpha ]
+    
+    def self.componentize(attributes)
+      components = self.map_attributes(attributes).pick(*self.valid)
+      hex, white = attributes[:hex], components[:white]
+
+      components[:alpha] ||= 1.0
+      components.merge!(self.componentize_hex(hex)) if hex 
+      components.merge!(self.componentize_white(white)) if white
+      
+      components.each { |key, value| components[key] = self.normalize(value) }
+    end
+
+    def self.valid?(name)
+      self.valid.include?(name)
+    end
+
+    ##
+    ## Helpers
+    ##
+
+    def self.componentize_hex(value)
+      hex = value.is_a?(String) ? value.to_i : value
+      Hash.new.tap do |hash| 
+        hash[:red]   = (hex & 0xFF0000) >> 16
+        hash[:green] = (hex & 0x00FF00) >> 8
+        hash[:blue]  = (hex & 0x0000FF)
+      end
+    end
+
+    def self.componentize_white(value)
+      { red: value, green: value, blue: value }
+    end
+
+    ##
+    ## Helpers
+    ##
+
+    def self.normalize(number)
+      number = number / 255.0 if number.is_a?(Fixnum)
+      raise "component #{number} is not in a legible format" unless number.is_a?(Float)
+      number.limit(0.0..1.0) 
+    end
+   
+    def self.map_attributes(attributes)
+      key_map = { r: :red, g: :green, b: :blue, w: :white, a: :alpha }
+      return Hash[attributes.map { |key, value| [ key_map[key] || key, value ] }] 
+    end
+
+  end
+
+end
+

data/lib/spectra/dsl.rb

@@ -0,0 +1,52 @@
+
+require 'spectra/components'
+require 'spectra/serializer'
+
+module Spectra
+
+  module DSL
+    def prefix(prefix)
+      self._prefix = prefix 
+    end
+  
+    def formats(*types) 
+      types.each { |type| format(type) }
+    end
+
+    def format(type, path = nil, &renamer)
+      self.serializers ||= []
+      
+      serializers = Serializer.from_type(type, {
+        path: path,
+        template: { type: type, renamer: renamer }  
+      })
+      self.serializers.concat(serializers)
+      
+      serializers.each { |serializer| Spectra.logger.debug "dsl add: #{serializer}" }
+    end
+     
+    def color(name, attributes)
+      self.colors ||= []
+      
+      color = Color.new(name, Components.componentize(attributes))
+      self.colors << color
+
+      Spectra.logger.debug "dsl add: #{color}"
+    end
+
+    def components(*components)
+      components.hash_from(:red, :green, :blue, :alpha)
+    end
+
+    def hex(*components)
+      components.hash_from(:hex, :alpha)
+    end
+
+    def white(*components)
+      components.hash_from(:white, :alpha)
+    end
+     
+  end 
+
+end
+

data/lib/spectra/extensions.rb

@@ -0,0 +1,47 @@
+
+class Array
+  
+  def hash_from(*keys)
+    Hash[ keys.first(self.length).zip(self) ]
+  end
+
+end
+
+class Hash
+
+  def pick(*keys)
+    self.select { |key, value| keys.include?(key) }
+  end
+
+  def deep_merge(hash)
+    worker = proc do |key, source, update|
+      if source.is_a?(Hash) && update.is_a?(Hash)
+        source.merge(update, &worker)
+      else
+        update
+      end
+    end
+
+    self.merge(hash, &worker)
+  end
+
+end
+
+class Numeric
+  
+  def limit(range)
+    self > range.max ? range.max : self < range.min ? range.min : self
+  end 
+
+end
+
+class Symbol 
+  
+  def camelize(pascal)
+    self.to_s.split('_').map.with_index do |component, index| 
+      !pascal && index == 0 ? component : component.capitalize 
+    end.join('') 
+  end
+
+end
+

data/lib/spectra/logger.rb

@@ -0,0 +1,12 @@
+
+require 'logger'
+
+class SpectraLogger < Logger
+  
+  def terminate(message)
+    self.fatal(message)
+    exit
+  end
+
+end
+

data/lib/spectra/models.rb

@@ -0,0 +1,57 @@
+
+require 'spectra/extensions'
+require 'spectra/components'
+require 'spectra/dsl'
+
+module Spectra
+
+  class Root
+    
+    attr_accessor :_prefix
+    attr_accessor :colors, :serializers
+
+    include DSL
+
+    def generate(definition) 
+      self.instance_eval(definition)
+      self.formats(:palette, :objc) unless self.serializers
+
+      self.serializers.each do |serializer|
+        serializer.serialize({
+          colors: self.colors,
+          prefix: self._prefix,  
+        })
+      end
+    end 
+
+  end
+
+  class Color
+    
+    attr_accessor :name, :components
+   
+    def initialize(name, components)
+      self.name = name
+      self.components = components
+    end 
+
+    def respond_to?(name)
+      super || Components.valid?(name)
+    end
+
+    def method_missing(name)
+      Components.valid?(name) ? self.components[name] : super
+    end
+
+    ##
+    ## Debugging
+    ##
+
+    def to_s
+      "<color: #{name} colors: #{components.values_at(:red, :green, :blue, :alpha).map{|v| v.is_a?(String) ? v : '%.2f' % (v || 0.0) }}>" 
+    end
+
+  end
+
+end
+

data/lib/spectra/serializer.rb

@@ -0,0 +1,60 @@
+
+require 'spectra/extensions'
+require 'spectra/templates/factory'
+
+module Spectra
+
+  class Serializer
+
+    attr_accessor :template, :path
+
+    def initialize(attributes)
+      self.path     = attributes[:path]
+      self.template = Template.from_attributes(attributes[:template])
+    end
+
+    def serialize(attributes)
+      text = self.template.render(attributes)
+      path = self.resource_path(attributes)
+
+      Spectra.logger.debug "#{Spectra.options.dry_run ? 'would write' : 'writing'} to: #{path}" 
+
+      if Spectra.options.dry_run
+        Spectra.logger.debug "\n#{text}"
+      else
+        File.open(path, 'w+') { |file| file.write(text) }
+      end
+    end
+
+    def resource_path(attributes)
+      resource_path = self.path || self.template.path
+      resource_path << '/' unless resource_path.end_with?('/')
+      resource_path + self.template.filename
+    end
+
+    ##
+    ## Factory
+    ##
+
+    def self.from_type(type, attributes)
+      case type.intern
+        when :palette, :swift
+          [ Serializer.new(attributes) ]
+        when :objc
+          [ Serializer.new(attributes.deep_merge(template: { is_header: true })), Serializer.new(attributes) ]
+        else raise "Specfied an invalid serializer type: #{type}"
+      end
+    end
+
+    ##
+    ## Debugging
+    ##
+
+    def to_s
+      "<serializer => #{self.path || './'}, #{self.template}>"
+    end
+
+  end
+
+end
+

data/lib/spectra/templates/factory.rb

@@ -0,0 +1,23 @@
+
+require 'spectra/templates/palette'
+require 'spectra/templates/objc_category'
+require 'spectra/templates/swift_extension'
+
+module Spectra
+
+  class Template
+
+    def self.from_attributes(attributes)
+      case attributes[:type].intern
+        when :palette
+          Palette.new(attributes)
+        when :objc    
+          ObjcCategory.new(attributes)
+        when :swift   
+          SwiftExtension.new(attributes)
+      end
+    end
+
+  end
+
+end

data/lib/spectra/templates/objc_category.mustache

@@ -0,0 +1,22 @@
+//
+// UIColor+{{class_prefix}}Color.{{file_extension}} 
+// This file is generated by Spectra, so don't expect to make any persistent changes
+//
+
+@{{file_keyword}} UIColor ({{class_prefix}}Color)
+
+{{#colors}}
++ (UIColor *){{name}}{{#is_header}};{{/is_header}}
+{{^is_header}}
+{
+  {{#white}}
+    return [UIColor colorWithWhite:{{white}} alpha:{{alpha}}];
+  {{/white}}
+  {{^white}}
+    return [UIColor colorWithRed:{{red}} green:{{green}} blue:{{blue}} alpha:{{alpha}}];
+  {{/white}}
+}
+
+{{/is_header}}
+{{/colors}}{{whitespace}}@end
+

data/lib/spectra/templates/objc_category.rb

@@ -0,0 +1,58 @@
+
+require 'spectra/templates/template'
+
+module Spectra
+
+  class ObjcCategory < Template
+    
+    attr_accessor :is_header
+
+    def initialize(attributes)
+      super 
+      self.is_header = attributes[:is_header]
+    end
+
+    ##
+    ## Templating
+    ##
+
+    def class_prefix
+      self.prefix.upcase
+    end
+
+    def file_keyword
+      self.is_header ? "interface" : "implementation"
+    end
+
+    def file_extension
+      self.is_header ? 'h' : 'm'
+    end
+
+    def whitespace
+      self.is_header ? "\n" : ''
+    end
+
+    ##
+    ## Formatting
+    ##
+
+    def format_color_value(value)
+      '%.2f' % (value || 0.0) + 'f' 
+    end
+
+    def renamer
+      @renamer ||= lambda { |name, prefix| "#{prefix}_#{name.camelize(false)}Color" }
+    end
+    
+    ##
+    ## Pathing Hooks
+    ##
+
+    def filename
+      "UIColor+#{self.class_prefix}Color.#{self.file_extension}"
+    end
+  
+  end
+
+end
+

data/lib/spectra/templates/palette.mustache

@@ -0,0 +1,4 @@
+11
+{{#colors}}
+0 {{red}} {{green}} {{blue}} {{alpha}} {{name}}
+{{/colors}}

data/lib/spectra/templates/palette.rb

@@ -0,0 +1,27 @@
+
+require 'spectra/templates/template'
+
+module Spectra
+
+  class Palette < Template
+
+    def renamer
+      @renamer ||= lambda { |name, prefix| name.camelize(true) }
+    end
+
+    ##
+    ## Pathing 
+    ##
+    
+    def path
+      "#{Dir.home}/Library/Colors/"
+    end
+
+    def filename
+      "#{self.prefix}-palette.clr"
+    end
+
+  end 
+
+end
+

data/lib/spectra/templates/swift_extension.mustache

@@ -0,0 +1,21 @@
+//
+// Colors.swift
+// This file is generated by Spectra, so don't expect to make any persistent changes
+//
+
+import UIKit
+
+extension UIColor {
+  
+{{#colors}}
+    class func {{name}}() -> UIColor {
+    {{#white}}
+        return UIColor(white: {{white}}, alpha: {{alpha}})
+    {{/white}}
+    {{^white}}
+        return UIColor(red: {{red}}, green: {{green}}, blue: {{blue}}, alpha: {{alpha}})
+    {{/white}}
+    }
+
+{{/colors}}}
+

data/lib/spectra/templates/swift_extension.rb

@@ -0,0 +1,23 @@
+
+require 'spectra/templates/template'
+
+module Spectra
+
+  class SwiftExtension < Template
+    
+    def renamer
+      @renamer ||= lambda { |name, prefix| name.camelize(true) } 
+    end 
+
+    ##
+    ## Pathing
+    ##
+
+    def filename
+      return 'Colors.swift' 
+    end
+
+  end
+
+end
+

data/lib/spectra/templates/template.rb

@@ -0,0 +1,73 @@
+
+require 'mustache'
+
+module Spectra
+
+  class Template < Mustache
+   
+    attr_accessor :renamer, :colors, :prefix
+    
+    def initialize(attributes)
+      self.renamer = attributes[:renamer] 
+    end 
+
+    ##
+    ## Mustache
+    ##
+
+    self.path = 'lib/spectra/templates'
+     
+    def self.template_name
+       super.split('/').last
+    end 
+    
+    ##
+    ## Rendering 
+    ## 
+
+    def render(attributes)
+      self.prefix = attributes[:prefix]
+      self.colors = parse_colors(attributes[:colors])
+      super() # offload to Mustache
+    end
+
+    def parse_colors(colors)
+      colors.map { |color| self.parse_color(color) }
+    end
+
+    def parse_color(color)
+      copy = color.clone  
+      copy.name = self.format_color_name(color)
+      copy.components = color.components.map do |key, value| 
+        [ key, self.format_color_value(value) ] 
+      end.to_h
+      copy
+    end
+
+    def format_color_name(color)
+      self.renamer.call(color.name, self.prefix)
+    end
+
+    def format_color_value(value)
+      '%.2f' % (value || 0.0)
+    end
+    
+    ##
+    ## Pathing
+    ##
+
+    def path 
+      './'
+    end
+
+    ##
+    ## Debugging
+    ##
+
+    def to_s 
+      "<template: #{self.class.name} renamer: #{@renamer}>"
+    end
+    
+  end
+
+end

data/lib/spectra/version.rb

@@ -0,0 +1,3 @@
+module Spectra
+  VERSION = '0.1.1'
+end

data/lib/spectra.rb

@@ -0,0 +1,31 @@
+
+require 'spectra/version'
+require 'spectra/logger'
+require 'spectra/models'
+
+module Spectra
+  
+  class << self
+    attr_accessor :logger, :options 
+  end 
+ 
+  def self.generate(options)
+    self.options = options
+    logger.level = options.verbose ? Logger::DEBUG : Logger::INFO
+
+    begin
+      definition = IO.read('spectrum.rb')
+    rescue Exception => execption
+      logger.terminate "Failed to read spectrum.rb file: #{execption}" 
+    end 
+
+    spectra = Root.new
+    spectra.generate(definition)
+  end 
+
+  def self.logger
+    @logger ||= SpectraLogger.new(STDOUT) 
+  end
+
+end
+

data/spectra.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'spectra/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'spectra'
+  gem.version       = Spectra::VERSION
+  gem.authors       = ['Ty Cobb']
+  gem.email         = ['ty.cobb.m@gmail.com']
+  gem.summary       = %q{DSL for synchronizng color palettes, Objective-C categories, and Swift extensions}
+  gem.description   = %q{DSL for synchronzing color palettes, Objective-C categories, and Swift extensions}
+  gem.homepage      = 'https://github.com/derkis/Spectrum'
+  gem.license       = 'MIT'
+
+  gem.files         = `git ls-files -z`.split("\x0")
+  gem.executables   = ['spectra']
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_development_dependency 'bundler', '~> 1.6'
+  gem.add_development_dependency 'rake'
+
+  gem.add_runtime_dependency 'mustache', '~> 0.99.6'
+end
+

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: spectra
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Ty Cobb
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.99.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.99.6
+description: DSL for synchronzing color palettes, Objective-C categories, and Swift
+  extensions
+email:
+- ty.cobb.m@gmail.com
+executables:
+- spectra
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/spectra
+- lib/spectra.rb
+- lib/spectra/components.rb
+- lib/spectra/dsl.rb
+- lib/spectra/extensions.rb
+- lib/spectra/logger.rb
+- lib/spectra/models.rb
+- lib/spectra/serializer.rb
+- lib/spectra/templates/factory.rb
+- lib/spectra/templates/objc_category.mustache
+- lib/spectra/templates/objc_category.rb
+- lib/spectra/templates/palette.mustache
+- lib/spectra/templates/palette.rb
+- lib/spectra/templates/swift_extension.mustache
+- lib/spectra/templates/swift_extension.rb
+- lib/spectra/templates/template.rb
+- lib/spectra/version.rb
+- spectra.gemspec
+homepage: https://github.com/derkis/Spectrum
+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.2.2
+signing_key: 
+specification_version: 4
+summary: DSL for synchronizng color palettes, Objective-C categories, and Swift extensions
+test_files: []