klipp 0.2.2.4 → 0.2.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0ba63b780cdd76dfb3697cc312f59e0dbfc925a5
-  data.tar.gz: 346dab90c394a08965a510681a584159b1b0a525
+  metadata.gz: ae3eafef7a7bbb434e6cd73d7f6fcca43823f4c2
+  data.tar.gz: d0ebae062629adecd570b294cc8f7e73d334438d
 SHA512:
-  metadata.gz: 9e7e421fc095fea7d3af5ee20b93d47071810d60f4f4c3be4f4faad3a1cba2155b765f6d3d29a1a929c1d0a44650529c0c66cc6efadcae361f82ac99b8bfb6b9
-  data.tar.gz: d6b0222b565eb32e101f6b7b29578d5fce70defe3702ac009d7e6881e4acff286decf5eff1174a46322fdf803bbd1df36b2643386764183e9368d9902eea3632
+  metadata.gz: 7c7a927987f1ab4836396b9dc80ffe702d6a0a0df0686a81f553a0a02dcb2c52cbc2f7b72989e1192f3b4fd47d35cea4baad6e80c8f5942ed2d0334a07b17dd7
+  data.tar.gz: 2af864cf90e910e66869f84c74573297e24612e77b5ca088aaedb28452826db61313d0cd43aa2af2e18b96857b7bca3acc42560c15b83216da160ca1a887c10d

data/README.md

@@ -1,35 +1,56 @@
 # Klipp [![Build Status](https://travis-ci.org/epologee/klipp.png)](https://travis-ci.org/epologee/klipp) [![Coverage Status](https://coveralls.io/repos/epologee/klipp/badge.png)](https://coveralls.io/r/epologee/klipp)
 ## Code templates for the rest of us.
 
-Klipp is a ruby gem with a command line interface for creating new programming projects from existing templates. It was originally designed to create Xcode projects. However, there are no Apple or Xcode specific features in Klipp, so you can use it for pretty much any textfile-and-directory-based template.
 
-When compared to Xcode's plist-based templating system, Klipp takes an existing Xcode project and creates a new project by copying and modifying an existing template project by your own specifications.
+Klipp is a Ruby gem that you can use to replicate folder structures, while doing extensive search-and-replace operations on filenames, directory names and file contents.
+
+I developed Klipp as an alternative to the templating system of Apple's Xcode, to use while developing iOS projects. However, there are no Apple or Xcode specific features in Klipp, so you can use it for pretty much any textfile-and-directory-based template.
 
 ## Installation
 
 Install Klipp with RubyGems:
 
     $ gem install klipp
-
-Execute and read the usage instructions:
+    
+Then run Klipp from the command line and read the instructions:
 
     $ klipp
+    
+## Templates a.k.a. Specs
+
+When you execute `klipp` the first time, it will create a `.klipp` folder in your home directory, where it will search for template directories. Each template has one `.klippspec` file. Upon first use however, you will not have any specs. For starters you might try my personal specs by executing:
+
+    $ git clone https://github.com/epologee/klipp-specs.git ~/.klipp/epologee
+    
+After that, you can call `klipp template list` to see the specs it includes.
+
+## Inspiration
+
+I've borrowed some of the terminology of Klipp from the RubyGem and CocoaPods community, which is why you see things like this:
+
++ `.klippspec` files defining the structure of a template (compare to `.gemspec` and `.podspec`)
++ `Klippfile` files used to setup a new project from an existing template (compare to `Gemfile` and `Podfile`)
++ The `~/.klipp` folder containing your templates (compare to `~/.cocoapods`)
+
+## Usage
+
+You use klipp from the terminal, as a command line tool. For example, if you have a template setup in the `~/.klipp/` folder called `iPhoneProject`, you can call commands like:
+
++ `klipp template list` to list your templates
++ `klipp create iPhoneProject` interactively prompts you to enter the values required for the template. This works well with very small templates, like creating a new class.
++ `klipp prepare iPhoneProject` to create a new `Klippfile` for the `iPhoneProject` template. You edit the Klippfiles by hand to supply it with strings, numbers and booleans. This is easier for templates with more required values.
++ `klipp create` to create a new project from a `Klippfile`, relative to your current directory.
++ `klipp create -f` to re-create the project, overwriting the existing one.
 
-## CLI under construction ...
+You can always just start by running `klipp` and have the terminal tell you what commands to add to get your desired result.
 
-Klipp is still in the early development stage. When 0.1 ships, the CLI will feature:
+## Contribute
 
-* `klipp repo add <repo-name> [<repo-url>]` - git init [or clone] template repositories in the `~/.klipp` directory
-* `klipp template spec <template-name>` - creates a new template specificiation called `<template-name>.klippspec`, for you to configure your template's properties.
-* `klipp template push <repo-name>` - push a new template to one of your template repositories.
-* `klipp template list [<repo-name>]` - list all available templates on your machine [per repository]
-* `klipp prepare <template-name>` - prepare the creation of files from a new template, by authoring a `Klippfile`
-* `klipp create [<template-name>]` - create files based on the prepared `Klippfile` [or interactively from the terminal].
+The gem in its current state is very usable. It's got decent rspec coverage (96%+) and I personally use the publicly available gem build for all my templating needs. There are however areas in which I would love the project to evolve more:
 
-## Contributing
++ Better terminal output during the creation process.
++ The ability to update an existing `Klippfile` when the corresponding `project.klippspec` is updated underneath.
++ Better feedback when something is missing, like token values or terminal commands.
++ A setup to share your templates, like the specs from CocoaPods and RubyGems projects.
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+So if you're willing to help, feel free to fork and send those pull requests!

data/lib/klipp/version.rb

@@ -1,3 +1,3 @@
 module Klipp
-  VERSION = "0.2.2.4"
+  VERSION = "0.2.2.5"
 end

data/lib/template/token.rb

@@ -9,13 +9,12 @@ class String
 end
 
 module Template
-
   class Token
     attr_accessor :hidden, :value, :default_value, :type, :bool_strings
     attr_accessor :comment, :validation, :validation_hint
 
     def initialize(value = nil, hidden = false)
-      self.value = value if value
+      self.value = value unless value.nil?
       @hidden = hidden
     end
 
@@ -30,6 +29,7 @@ module Template
     end
 
     def value
+      return false if @value === false
       @value || self.default_value
     end
 
@@ -59,31 +59,29 @@ module Template
 
     def validation_hint
       case
-        when self.type == :string then
-          @validation_hint || (validation ? "Match /#{validation.to_s}/ (no custom validation_hint given)." : "Text required")
-        when self.type == :bool then
-          "Boolean value, either 'true' or 'false' (but without the apostrophes)"
+      when self.type == :string then
+        @validation_hint || (validation ? "Match /#{validation.to_s}/ (no custom validation_hint given)." : "Text required")
+      when self.type == :bool then
+        "Boolean value, either 'true' or 'false' (but without the apostrophes)"
       end
     end
 
     def validate?(value)
       case
-        when self.type == :string then
-          value.is_a?(String) && (validation.nil? || validation.match(value))
-        when self.type == :bool then
-          value.is_a?(TrueClass) or value.is_a?(FalseClass)
+      when self.type == :string then
+        value.is_a?(String) && (validation.nil? || validation.match(value))
+      when self.type == :bool then
+        value.is_a?(TrueClass) or value.is_a?(FalseClass)
       end
     end
 
     def to_s
       case
-        when self.type == :bool then
-          bool_strings[value ? 1 : 0]
-        else
-          value
+      when self.type == :bool then
+        bool_strings[value ? 1 : 0]
+      else
+        value
       end
     end
-
   end
-
 end

data/spec/template/token_spec.rb

@@ -1,7 +1,6 @@
 require 'spec_helper'
 
 describe Template::Token do
-
   before do
     @token = Template::Token.new
   end
@@ -15,7 +14,6 @@ describe Template::Token do
   end
 
   context 'with type string' do
-
     it 'has a hidden property' do
       @token.hidden = true
       @token.hidden.should eq true
@@ -48,13 +46,12 @@ describe Template::Token do
     it 'invalidates booleans assigned' do
       expect { @token.value = true }.to raise_error RuntimeError
     end
-
   end
 
   context 'with type bool' do
-
     before do
       @token.type = :bool
+      @token.default_value = true
     end
 
     it 'accepts boolean values' do
@@ -94,7 +91,5 @@ describe Template::Token do
     it 'invalidates other strings' do
       expect { @token.value = 'ja' }.to raise_error RuntimeError
     end
-
   end
-
-end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: klipp
 version: !ruby/object:Gem::Version
-  version: 0.2.2.4
+  version: 0.2.2.5
 platform: ruby
 authors:
 - Eric-Paul Lecluse
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-14 00:00:00.000000000 Z
+date: 2014-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -211,7 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Klipp is a command line gem for creating new (Xcode) projects from existing
@@ -262,4 +262,3 @@ test_files:
 - spec/template/spec_spec.rb
 - spec/template/token_spec.rb
 - spec/template_spec.rb
-has_rdoc: