guard-preserves 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.
data/Gemfile ADDED
@@ -0,0 +1,4 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in guard-preserves.gemspec
4
+ gemspec
@@ -0,0 +1,22 @@
1
+ Copyright (c) 2013 Chris Rebel
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,55 @@
1
+ # Guard::Preserves
2
+
3
+ This gem allows you to make changes to files in the preserves repository and
4
+ have those changes automatically compiled if in a coffeescript file. The
5
+ resulting files will then be copied to a directory with the same name as the
6
+ modified package located in the directory specified by the `destination`
7
+ option.
8
+
9
+ ## Installation
10
+
11
+ Add this line to your application's Gemfile:
12
+
13
+ gem 'guard-preserves'
14
+
15
+ And then execute:
16
+
17
+ $ bundle
18
+
19
+ ## Usage
20
+
21
+ The `destination` must be provided. An optional `app_root` can be set, but
22
+ defaults to the location of the Guardfile. If no watch is provided, all
23
+ `.js` and `.coffee` files in the directory will be watched.
24
+
25
+ ````ruby
26
+ guard 'preserves', destination: 'public/foo/lib' do
27
+ #optional watch('foo/src/foo.coffee')
28
+ end
29
+ ````
30
+
31
+ To start the guard run:
32
+
33
+ ````
34
+ bundle exec guard --watchdir [absolute path to directory to watch] --guardfile [absolute path to directory with guardfile]
35
+ ````
36
+
37
+ For example, given a Rails application named 'cool-stuff' in the same parent
38
+ directory as the preserves repo with the jam assets stored in
39
+ `app/assets/javascripts/lib` with a Guardfile named
40
+ `Preserves-Guardfile` that looks like
41
+
42
+ ````
43
+ guard 'preserves', destination: 'app/assets/javascripts/lib'
44
+ ````
45
+
46
+ run `bundle exec guard --watchdir ~/source/preserves --guardfile ~/source/cool-stuff/Preserves-Guardfile` to start the guard.
47
+
48
+
49
+ ## Contributing
50
+
51
+ 1. Fork it
52
+ 2. Create your feature branch (`git checkout -b my-new-feature`)
53
+ 3. Commit your changes (`git commit -am 'Add some feature'`)
54
+ 4. Push to the branch (`git push origin my-new-feature`)
55
+ 5. Create new Pull Request
@@ -0,0 +1 @@
1
+ require "bundler/gem_tasks"
@@ -0,0 +1,25 @@
1
+ # coding: utf-8
2
+ lib = File.expand_path('../lib', __FILE__)
3
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
4
+ require 'guard/preserves/version'
5
+
6
+ Gem::Specification.new do |spec|
7
+ spec.name = "guard-preserves"
8
+ spec.version = Guard::PreservesVersion::VERSION
9
+ spec.authors = ["Chris Rebel", "Colin Rymer"]
10
+ spec.email = ["chrebel@gmail.com", "colin.rymer@gmail.com"]
11
+ spec.description = %q{This gem provides a guard plug-in to watch the Preserves repo and compile/copy js files to the project it is included in.}
12
+ spec.summary = %q{Preserves compiler/copier guard plugin}
13
+ spec.homepage = ""
14
+ spec.license = "MIT"
15
+
16
+ spec.files = `git ls-files`.split($/)
17
+ spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
18
+ spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
19
+ spec.require_paths = ["lib"]
20
+
21
+ spec.add_development_dependency "bundler", "~> 1.3"
22
+ spec.add_development_dependency "rake"
23
+
24
+ spec.add_dependency 'guard'
25
+ end
@@ -0,0 +1,118 @@
1
+ require 'guard'
2
+ require 'guard/guard'
3
+ require 'json'
4
+ require 'fileutils'
5
+
6
+ module Guard
7
+ class Preserves < Guard
8
+ attr_reader :app_root, :destination
9
+ # Initializes a Guard plugin.
10
+ # Don't do any work here, especially as Guard plugins get initialized even if they are not in an active group!
11
+ #
12
+ # @param [Array<Guard::Watcher>] watchers the Guard plugin file watchers
13
+ # @param [Hash] options the custom Guard plugin options
14
+ # @option options [Symbol] group the group this Guard plugin belongs to
15
+ # @option options [Boolean] any_return allow any object to be returned from a watcher
16
+ #
17
+ def initialize(watchers = [], options = {})
18
+ @destination = options[:destination]
19
+ @app_root = options[:app_root] || File.dirname(::Guard.options[:guardfile])
20
+ watchers = [::Guard::Watcher.new(%r{^.+\.(js|coffee)$})] if watchers.empty?
21
+
22
+ super
23
+ end
24
+
25
+ # Called once when Guard starts. Please override initialize method to init stuff.
26
+ #
27
+ # @raise [:task_has_failed] when start has failed
28
+ # @return [Object] the task result
29
+ #
30
+ def start
31
+ end
32
+
33
+ # Called when `stop|quit|exit|s|q|e + enter` is pressed (when Guard quits).
34
+ #
35
+ # @raise [:task_has_failed] when stop has failed
36
+ # @return [Object] the task result
37
+ #
38
+ def stop
39
+ end
40
+
41
+ # Called when `reload|r|z + enter` is pressed.
42
+ # This method should be mainly used for "reload" (really!) actions like reloading passenger/spork/bundler/...
43
+ #
44
+ # @raise [:task_has_failed] when reload has failed
45
+ # @return [Object] the task result
46
+ #
47
+ def reload
48
+ end
49
+
50
+ # Called when just `enter` is pressed
51
+ # This method should be principally used for long action like running all specs/tests/...
52
+ #
53
+ # @raise [:task_has_failed] when run_all has failed
54
+ # @return [Object] the task result
55
+ #
56
+ def run_all
57
+ end
58
+
59
+ # Default behaviour on file(s) changes that the Guard plugin watches.
60
+ # @param [Array<String>] paths the changes files or paths
61
+ # @raise [:task_has_failed] when run_on_change has failed
62
+ # @return [Object] the task result
63
+ #
64
+ def run_on_changes(paths)
65
+ end
66
+
67
+ # Called on file(s) additions that the Guard plugin watches.
68
+ #
69
+ # @param [Array<String>] paths the changes files or paths
70
+ # @raise [:task_has_failed] when run_on_additions has failed
71
+ # @return [Object] the task result
72
+ #
73
+ def run_on_additions(paths)
74
+ end
75
+
76
+ # Called on file(s) modifications that the Guard plugin watches.
77
+ #
78
+ # @param [Array<String>] paths the changes files or paths
79
+ # @raise [:task_has_failed] when run_on_modifications has failed
80
+ # @return [Object] the task result
81
+ #
82
+ def run_on_modifications(paths)
83
+ paths.each do |path|
84
+ package = package_name(path)
85
+ compile_package package if File.extname(path) == '.coffee'
86
+ copy_package package if File.extname(path) == '.js'
87
+ end
88
+ end
89
+
90
+ # Called on file(s) removals that the Guard plugin watches.
91
+ #
92
+ # @param [Array<String>] paths the changes files or paths
93
+ # @raise [:task_has_failed] when run_on_removals has failed
94
+ # @return [Object] the task result
95
+ #
96
+ def run_on_removals(paths)
97
+ end
98
+
99
+ private
100
+ def package_name(path)
101
+ path.split('/').first
102
+ end
103
+
104
+ def compile_package(package)
105
+ ::Guard::UI.info "Compiling #{package}"
106
+ Dir.chdir package
107
+ `coffee -c --output ./ src/`
108
+ Dir.chdir '..'
109
+ end
110
+
111
+ def copy_package(package)
112
+ package_destination = File.join(app_root, destination, package)
113
+ ::Guard::UI.info "Copying #{package} to #{package_destination}"
114
+ FileUtils.mkdir_p package_destination
115
+ FileUtils.cp_r("#{package}/.", package_destination)
116
+ end
117
+ end
118
+ end
@@ -0,0 +1,5 @@
1
+ module Guard
2
+ module PreservesVersion
3
+ VERSION = "0.1.0"
4
+ end
5
+ end
metadata ADDED
@@ -0,0 +1,104 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: guard-preserves
3
+ version: !ruby/object:Gem::Version
4
+ prerelease:
5
+ version: 0.1.0
6
+ platform: ruby
7
+ authors:
8
+ - Chris Rebel
9
+ - Colin Rymer
10
+ autorequire:
11
+ bindir: bin
12
+ cert_chain: []
13
+ date: 2013-05-24 00:00:00.000000000 Z
14
+ dependencies:
15
+ - !ruby/object:Gem::Dependency
16
+ version_requirements: !ruby/object:Gem::Requirement
17
+ requirements:
18
+ - - ~>
19
+ - !ruby/object:Gem::Version
20
+ version: '1.3'
21
+ none: false
22
+ name: bundler
23
+ type: :development
24
+ prerelease: false
25
+ requirement: !ruby/object:Gem::Requirement
26
+ requirements:
27
+ - - ~>
28
+ - !ruby/object:Gem::Version
29
+ version: '1.3'
30
+ none: false
31
+ - !ruby/object:Gem::Dependency
32
+ version_requirements: !ruby/object:Gem::Requirement
33
+ requirements:
34
+ - - ! '>='
35
+ - !ruby/object:Gem::Version
36
+ version: '0'
37
+ none: false
38
+ name: rake
39
+ type: :development
40
+ prerelease: false
41
+ requirement: !ruby/object:Gem::Requirement
42
+ requirements:
43
+ - - ! '>='
44
+ - !ruby/object:Gem::Version
45
+ version: '0'
46
+ none: false
47
+ - !ruby/object:Gem::Dependency
48
+ version_requirements: !ruby/object:Gem::Requirement
49
+ requirements:
50
+ - - ! '>='
51
+ - !ruby/object:Gem::Version
52
+ version: '0'
53
+ none: false
54
+ name: guard
55
+ type: :runtime
56
+ prerelease: false
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - ! '>='
60
+ - !ruby/object:Gem::Version
61
+ version: '0'
62
+ none: false
63
+ description: This gem provides a guard plug-in to watch the Preserves repo and compile/copy
64
+ js files to the project it is included in.
65
+ email:
66
+ - chrebel@gmail.com
67
+ - colin.rymer@gmail.com
68
+ executables: []
69
+ extensions: []
70
+ extra_rdoc_files: []
71
+ files:
72
+ - Gemfile
73
+ - LICENSE.txt
74
+ - README.md
75
+ - Rakefile
76
+ - guard-preserves.gemspec
77
+ - lib/guard/preserves.rb
78
+ - lib/guard/preserves/version.rb
79
+ homepage: ''
80
+ licenses:
81
+ - MIT
82
+ post_install_message:
83
+ rdoc_options: []
84
+ require_paths:
85
+ - lib
86
+ required_ruby_version: !ruby/object:Gem::Requirement
87
+ requirements:
88
+ - - ! '>='
89
+ - !ruby/object:Gem::Version
90
+ version: '0'
91
+ none: false
92
+ required_rubygems_version: !ruby/object:Gem::Requirement
93
+ requirements:
94
+ - - ! '>='
95
+ - !ruby/object:Gem::Version
96
+ version: '0'
97
+ none: false
98
+ requirements: []
99
+ rubyforge_project:
100
+ rubygems_version: 1.8.23
101
+ signing_key:
102
+ specification_version: 3
103
+ summary: Preserves compiler/copier guard plugin
104
+ test_files: []