sass-rails-source-maps 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f706dfb8e9a356d401dd3d627b4721b8a8c19e83
+  data.tar.gz: b6792c5c269756253d40cfab42bada190b95a7a0
+SHA512:
+  metadata.gz: a7b84358e016bd36ec55cc45cb36c08c4fe960428c49a1d848ab887265d8c7c9fde3c7397e0e87d18906317eda7b105756a1b04e084973ef533d86b5961c52c5
+  data.tar.gz: 3d238763943cd487a425ef0667f0591e8447956af89839a0dfdc3351b6334ef2b457c54073e37a404410e3dd92763f9611e2d529580125e966aa8d7f95a15735

data/.gitignore

@@ -0,0 +1,18 @@
+.DS_Store
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Vojtech Hyza
+
+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.markdown

@@ -0,0 +1,55 @@
+# Sass Rails Source Maps
+
+This gem allows you to see your Rails 4 `.scss` source files in Google Chrome inspector, which can be useful for debugging.
+
+`debug_info` option available in stable [sass](http://sass-lang.com/) gem is no longer working in Google Chrome, because Chrome now supports Source Map [v3](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k) only.
+
+## Installation
+
+Add this to your application's Gemfile :
+
+````ruby
+group :development do
+  gem 'sass-rails-source-maps'
+end
+````
+
+And then execute:
+
+    $ bundle update sass
+
+to use `sass` gem with Source Maps v3 support, which is currently pre-release version.
+
+After that, run:
+
+    $ rm -rf tmp/cache/assets
+    $ rm -rf public/assets
+
+to make Rails regenerate assets. After assets regeneration, `assets/source_maps` containing `sass` source maps is created in `public` directory.
+
+## Usage
+
+To see something like this ![screenshot](https://www.evernote.com/shard/s36/sh/d0c3c46e-d9e7-47d0-b23b-118ca1c77add/d2268cefa01e273ecfda4aba600c8640/res/c14f6a6d-c418-4bdd-80c2-5025dc035221/skitch.png?resizeSmall&width=832) you need to enable source maps in Google Chrome.
+
+To enable source maps open Chrome inspector go to [chrome://flags/#enable-devtools-experiments](chrome://flags/#enable-devtools-experiments) and `Enable Developer Tools experiments`. Then restart Google Chrome.
+
+After restart, go to inspector `experimental` settings and enable `Sass stylesheet debugging` and finally in general settings check `Enable source maps`.
+
+![experimental settings](https://www.evernote.com/shard/s36/sh/323d6df5-e5a5-467d-89bb-2e933800292a/aba9bcbf79b533e3ab625e9dc8961f61/res/f90634d7-2267-4a53-8a84-0e4baafd56d4/skitch.png?resizeSmall&width=832)
+
+![general settings](https://www.evernote.com/shard/s36/sh/7fc204d3-b0b2-47a7-9df9-d2d03f08fb2c/46dab5f794b32ede79b9c482b21ca9fa/res/bc1ba16c-e08f-41b4-9417-23c1384b89d9/skitch.png?resizeSmall&width=832)
+
+Enabling source maps may vary in different Chrome versions. For more info please see [Working with CSS Preprocessors](https://developers.google.com/chrome-developer-tools/docs/css-preprocessors); part _Using Sass with CSS source maps_.
+
+## Notes
+* This gem is Rails 4 compatible only
+* If you wan't to see `coffeescript` files in Google Chrome inspector you can use [coffee-rails-source-maps](https://github.com/markbates/coffee-rails-source-maps) gem.
+
+
+## Contributing
+
+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

data/Rakefile

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

data/lib/sass-rails-source-maps.rb

@@ -0,0 +1,19 @@
+require 'sprockets'
+require 'fileutils'
+require 'sass-rails-source-maps/version'
+require 'sass-rails-source-maps/sass_importer'
+require 'sass-rails-source-maps/sass_template'
+
+module SassRailsSourceMaps
+
+  SOURCE_MAPS_DIRECTORY = "assets/source_maps"
+
+end
+
+Sprockets::ScssTemplate.class_eval do
+  include SassRailsSourceMaps::SassTemplate
+end
+
+Sprockets::SassTemplate.class_eval do
+  include SassRailsSourceMaps::SassTemplate
+end

data/lib/sass-rails-source-maps/sass_importer.rb

@@ -0,0 +1,9 @@
+module SassRailsSourceMaps
+  class SassImporter < Sprockets::SassImporter
+
+    def public_url(uri)
+      "/#{SOURCE_MAPS_DIRECTORY}/#{File.basename(uri)}"
+    end
+
+  end
+end

data/lib/sass-rails-source-maps/sass_template.rb

@@ -0,0 +1,50 @@
+module SassRailsSourceMaps
+  module SassTemplate
+
+    def write_output(text, destination)
+      FileUtils.mkdir_p(Rails.root.join("public", SassRailsSourceMaps::SOURCE_MAPS_DIRECTORY))
+      File.open(destination, 'wb') { |file| file.write(text) }
+    end
+
+    def copy_dependencies(files)
+      files.each do |file|
+        FileUtils.cp(file, Rails.root.join("public", SassRailsSourceMaps::SOURCE_MAPS_DIRECTORY, File.basename(file)))
+      end
+    end
+
+    def evaluate(context, locals, &block)
+      cache_store = Sprockets::SassCacheStore.new(context.environment)
+
+      options = {
+        sourcemap_filename:  ::Sass::Util::sourcemap_name(basename),
+        filename:            eval_file,
+        line:                line,
+        syntax:              syntax,
+        cache_store:         cache_store,
+        cache:               ::Rails.application.config.assets.debug,
+        line_numbers:        ::Rails.application.config.sass.line_numbers,
+        line_comments:       ::Rails.application.config.sass.line_comments,
+        importer:            SassImporter.new(context, context.pathname),
+        load_paths:          context.environment.paths.map { |path| SassImporter.new(context, path) },
+        sprockets:           {
+          context:     context,
+          environment: context.environment
+        }
+      }
+
+      result, mapping = ::Sass::Engine.new(data, options).render_with_sourcemap("/#{SOURCE_MAPS_DIRECTORY}/#{options[:sourcemap_filename]}")
+
+      write_output(data, ::Rails.root.join("public", SOURCE_MAPS_DIRECTORY, basename).to_s)
+      write_output(mapping.to_json(
+                    css_path:       basename.gsub(".#{syntax.to_s}", ""),
+                    sourcemap_path: ::Rails.root.join("public", SOURCE_MAPS_DIRECTORY, options[:sourcemap_filename])) + "\n",
+                   ::Rails.root.join("public", SOURCE_MAPS_DIRECTORY, options[:sourcemap_filename]).to_s)
+      copy_dependencies(context._dependency_paths)
+
+      result
+      rescue ::Sass::SyntaxError => e
+        context.__LINE__ = e.sass_backtrace.first[:line]
+        raise e
+    end
+  end
+end

data/lib/sass-rails-source-maps/version.rb

@@ -0,0 +1,3 @@
+module SassRailsSourceMaps
+  VERSION = "0.0.1"
+end

data/sass-rails-source-maps.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sass-rails-source-maps/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "sass-rails-source-maps"
+  gem.version       = SassRailsSourceMaps::VERSION
+  gem.authors       = ["Vojtech Hyza"]
+  gem.email         = ["vhyza@vhyza.eu"]
+  gem.description   = %q{Rails gem for generating sass source maps}
+  gem.summary       = %q{Rails gem for generating sass source maps}
+  gem.homepage      = "http://github.com/vhyza/sass-rails-source-maps"
+  gem.license       = "MIT"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "rails"
+  gem.add_dependency "sprockets", ">= 2.3.0"
+  gem.add_dependency "sass",      ">= 3.3.0.alpha.88"
+
+  gem.add_development_dependency "bundler", "~> 1.3"
+  gem.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: sass-rails-source-maps
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Vojtech Hyza
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sprockets
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.3.0.alpha.88
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.3.0.alpha.88
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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'
+description: Rails gem for generating sass source maps
+email:
+- vhyza@vhyza.eu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- lib/sass-rails-source-maps.rb
+- lib/sass-rails-source-maps/sass_importer.rb
+- lib/sass-rails-source-maps/sass_template.rb
+- lib/sass-rails-source-maps/version.rb
+- sass-rails-source-maps.gemspec
+homepage: http://github.com/vhyza/sass-rails-source-maps
+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: Rails gem for generating sass source maps
+test_files: []