less_assets 0.1.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011-2012 Michael Kessler <michi@netzpiraten.ch>
+
+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,194 @@
+# Less Assets [![Build Status](https://secure.travis-ci.org/netzpirat/less_assets.png)](http://travis-ci.org/netzpirat/less_assets)
+
+[Less](http://lesscss.org/) JavaScript Style Templates (JSST) in the Rails asset pipeline or as Tilt template.
+It's like a JavaScript template, but for generating dynamic CSS styles instead of HTML.
+
+If you just want to render your Less stylesheets in the Rails backend and deliver the CSS through the asset pipeline,
+have a look at [Less Rails](https://github.com/metaskills/less-rails).
+
+Tested on MRI Ruby 1.8.7, 1.9.2, 1.9.3, REE and the latest version of JRuby.
+
+## Installation
+
+The simplest way to install Less Assets is to use [Bundler](http://gembundler.com/).
+Add `less_assets` to your `Gemfile`:
+
+```ruby
+group :assets do
+  gem 'less_assets'
+end
+```
+
+And require the `less` and `less_assets` in your `app/assets/javascripts/application.js.coffee`:
+
+```coffeescript
+#= require less
+#= require less_assets
+```
+
+This provides the less.js parser to parse your stylesheets in the browser and the LessAssets renderer for adding the
+variables at render time.
+
+Please have a look at the [CHANGELOG](https://github.com/netzpirat/less_assets/blob/master/CHANGELOG.md) when
+upgrading to a newer Less Assets version.
+
+## Usage
+
+You can place all your Less templates in the `app/assets/javascripts/styles` directory and include them from your
+`app/assets/javascripts/application.js.coffee`:
+
+```coffeescript
+#= require_tree ./styles
+```
+
+Because Less Assets provides a default template name filter, the `styles/`, `stylesheet/` and `templates/` prefix will
+be automatically removed.
+
+## Configuration
+
+Sprockets will cache your templates after compiling and will only recompile them when the content of the template has
+changed, thus if you change to your configuration, the new settings will not be applied to templates already compiled.
+You can clear the Sprockets cache with:
+
+```Bash
+rake assets:clean
+```
+
+### Template namespace
+
+By default all Less templates are registered under the `JSST` namespace, which stands for JavaScript style template.
+If you prefer another namespace, you can set it in an initializer:
+
+```ruby
+LessAssets::LessTemplate.namespace = `window.Styles`
+```
+
+### Template name
+
+The name under which the template can be addressed in the namespace depends not only from the filename, but also on
+the directory name by default.
+
+The following examples assumes a configured namespace `window.JSST` and the asset template directory
+`app/assets/javascripts/styles`:
+
+* `app/assets/javascripts/styles/document.lesst` will become `JSST['document']`
+* `app/assets/javascripts/styles/editor/zone.lesst` will become `JSST['editor/zone']`
+* `app/assets/javascripts/styles/shared/general/headers.lesst` will become `JSST['shared/general/headers']`
+
+#### Template name filter
+
+If you wish to put the templates in a different location, you may want to modify `name_filter` in an initializer.
+
+```ruby
+LessAssets::LessTemplate.name_filter = lambda { |n| n.sub /^(templates|styles|stylesheets)\//, '' }
+```
+
+By default, `name_filter` strips the leading `templates/`, `stylesheets/` and `styles/` directory off of the name.
+
+## Render
+
+When you have a template `app/assets/javascripts/style/header.lesst` with the given content:
+
+```scss
+.header (@r) {
+    padding: @r * 2;
+    border-radius: @r;
+}
+
+.header (@r) when (@r > 10) {
+    margin-top: 3 * @r;
+}
+
+#header {
+    .header(@radius);
+}
+```
+
+You can render the style template and pass the variables to be used:
+
+```javascript
+JSST['header']({ radius: '10px' })
+```
+
+which will return in the following CSS
+
+```CSS
+#header {
+  margin: 20px;
+  border-radius: 10px;
+}
+```
+
+whereas rendering
+
+```javascript
+JSST['header']({ radius: '20px' })
+```
+
+will result in
+
+```CSS
+#header {
+  padding: 40px;
+  border-radius: 20px;
+  margin-top: 60px;
+}
+```
+
+It's up to you to apply the generated CSS to a style element, Less Assets doesn't provide any helper methods yet.
+
+## Author
+
+Developed by Michael Kessler, sponsored by [mksoft.ch](https://mksoft.ch).
+
+If you like Less Assets, you can watch the repository at [GitHub](https://github.com/netzpirat/less_assets) and
+follow [@netzpirat](https://twitter.com/#!/netzpirat) on Twitter for project updates.
+
+## Development
+
+* Issues and feature request hosted at [GitHub Issues](https://github.com/netzpirat/less_assets/issues).
+* Documentation hosted at [RubyDoc](http://rubydoc.info/github/netzpirat/less_assets/master/frames).
+* Source hosted at [GitHub](https://github.com/netzpirat/less_assets).
+
+Pull requests are very welcome! Please try to follow these simple rules if applicable:
+
+* Please create a topic branch for every separate change you make.
+* Make sure your patches are well tested. All specs must pass.
+* Update the [Yard](http://yardoc.org/) documentation.
+* Update the README.
+* Update the CHANGELOG for noteworthy changes.
+* Please **do not change** the version number.
+
+## Contributors
+
+See the [CHANGELOG](https://github.com/netzpirat/less_assets/blob/master/CHANGELOG.md) and the GitHub list of
+[contributors](https://github.com/netzpirat/less_assets/contributors).
+
+## Acknowledgement
+
+* [Alexis Sellier](http://twitter.com/cloudhead) for creating Less, the dynamic stylesheet language.
+
+## License
+
+(The MIT License)
+
+Copyright (c) 2012 Michael Kessler
+
+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/lib/less_assets/engine.rb

@@ -0,0 +1,21 @@
+# coding: UTF-8
+
+module LessAssets
+
+  # Hook the less template into a Rails app.
+  #
+  class Engine < Rails::Engine
+
+    config.less_assets = ActiveSupport::OrderedOptions.new
+
+    # Initialize Haml Coffee Assets after Sprockets
+    #
+    initializer 'sprockets.lessassets', :group => :all, :after => 'sprockets.environment' do |app|
+      next unless app.assets
+
+      # Register tilt template
+      app.assets.register_engine '.lesst', LessTemplate
+    end
+
+  end
+end

data/lib/less_assets/less_template.rb

@@ -0,0 +1,67 @@
+# coding: UTF-8
+
+require 'tilt'
+
+module LessAssets
+
+  # Less template implementation for Tilt.
+  #
+  class LessTemplate < Tilt::Template
+
+    class << self
+      # A proc that is called to modify the template name used as the
+      # JST key. The proc is passed the name as an argument and should
+      # return the modified name (or unmodified) name.
+      attr_accessor :name_filter
+
+      # The JavaScript Style template namespace
+      attr_accessor :namespace
+    end
+
+    # By default the namespace is JSST (JavaScript Style template)
+    self.namespace = 'window.JSST'
+
+    # By default, remove any leading `templates/`, `styles/` and `stylesheets/` in the name
+    self.name_filter = lambda { |n| n.sub /^(templates|styles|stylesheets)\//, '' }
+
+    # The default mime type of the tilt template
+    self.default_mime_type = 'application/javascript'
+
+    # Test if the compiler is initialized.
+    #
+    # @return [Boolean] the initialization status
+    #
+    def self.engine_initialized?
+      true
+    end
+
+    # Initialize the template engine.
+    #
+    def initialize_engine
+    end
+
+    # Prepare the template
+    #
+    def prepare
+    end
+
+    # Generates the Less template wrapped in a JavaScript template
+    #
+    # @param [String] name the template name
+    # @return [String] the less JavaScript template
+    #
+    def evaluate(scope, locals = { }, &block)
+      name = scope.logical_path
+      name = self.class.name_filter.call(name) if self.class.name_filter
+
+      <<-JST
+(function() {
+  #{ self.class.namespace } || (#{ self.class.namespace } = {});
+  #{ self.class.namespace }['#{ name }'] = function(v) { return LessAssets.render(\"#{ data.gsub(/\n/, "\\n") }\", v); };
+}).call(this);
+      JST
+    end
+
+  end
+end
+

data/lib/less_assets/version.rb

@@ -0,0 +1,5 @@
+# coding: UTF-8
+
+module LessAssets
+  VERSION = '0.1.0' unless defined?(LessAssets::VERSION)
+end

data/lib/less_assets.rb

@@ -0,0 +1,18 @@
+# coding: UTF-8
+
+require 'pathname'
+
+require 'tilt'
+require 'sprockets'
+
+require 'less_assets/version'
+require 'less_assets/less_template'
+
+if defined?(Rails)
+  require 'rails'
+  require 'less_assets/engine'
+else
+  require 'sprockets'
+  require 'sprockets/engines'
+  Sprockets.register_engine '.lesst', LessAssets::LessTemplate
+end

data/lib/tasks/less_assets.tasks

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :less_assets do
+#   # Task goes here
+# end