sassc 2.1.0.pre1-x86-mingw32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 137213d24e1402de715a72abda7db4d4bfa62edba1103693a7440ec35c92ac1a
+  data.tar.gz: 1cde21c700a2ed23cb1980b9a4776ae55f35b333e626a1105747261a674af58a
+SHA512:
+  metadata.gz: 7aae31a1033573b0f6b80e090543bc175a659954ade524e0e2b062304062601a8e733aefed306facb9fd628e9f18ee15cd3c0409b98042b7ec7ef8efd02b27eb
+  data.tar.gz: 783cef16f7dcd949c6dfe0f2fecaa0f318b4dfd94622d2b5ba9a5f090ed369e0e995608e460758fdb984f637d089f9c646817f322495345518b28dceff85ee08

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/.rvmrc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+*.gem
+mkmf.log
+vendor/bundle

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "ext/libsass"]
+	path = ext/libsass
+	url = https://github.com/sass/libsass.git

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+
+bundler_args: "--binstubs --standalone --without documentation --path ../bundle"
+script: "bundle exec rake test"
+rvm:
+  - 2.3.8
+  - 2.4.5
+  - 2.5.3
+  - 2.6.1
+notifications:
+  email: false

data/CHANGELOG.md

@@ -0,0 +1,66 @@
+- **2.1.0.pre1**
+  - [Update Libsass to 3.6.0](https://github.com/sass/sassc-ruby/pull/96/files)
+  - [Support old Ruby versions](https://github.com/sass/sassc-ruby/pull/117/files)
+- **2.0.1**
+  - [Relax FFI dependency](https://github.com/sass/sassc-ruby/pull/102)
+- **2.0.0**
+  - [Remove dependency on Ruby Sass](https://github.com/sass/sassc-ruby/pull/85)
+  - [frozen_string_literal all files](https://github.com/sass/sassc-ruby/pull/85)
+- **1.12.1**
+  - [Downgrade to libsass 3.5.2 to fix css imports](https://github.com/sass/sassc-ruby/pull/81)
+- **1.12.0**
+  - [Update Libsass to 3.5.4](https://github.com/sass/sassc-ruby/pull/78)
+  - [bundler is a development dependency](https://github.com/sass/sassc-ruby/pull/51)
+- **1.11.4**
+  - Fix `Value::List` related issue with sass 3.5.0
+- **1.11.3**
+  - [Require Sass::Deprecation module](https://github.com/sass/sassc-ruby/pull/68)
+- **1.11.2**
+  - [Update to libsass 3.4.3](https://github.com/sass/sassc-ruby/pull/65)
+- **1.11.1**
+  - [Update to libsass 3.4.1](https://github.com/sass/sassc-ruby/pull/61)
+- **1.11.0**
+  - [Add support for lists in functions](https://github.com/sass/sassc-ruby/pull/55)
+  - [Update to libsass 3.4.0](https://github.com/sass/sassc-ruby/pull/57)
+- **1.10.1**
+  - [Add sourcemap getter](https://github.com/sass/sassc-ruby/pull/48)
+- **1.10.0**
+  - [Improved error messages](https://github.com/sass/sassc-ruby/pull/34)
+  - Update to Libsass 3.3.6
+- **1.9.0**
+  - Support boolean script support
+- **1.8.5**
+  - Update to Libsass 3.3.4
+- **1.8.4**
+  - Update to Libsass 3.3.3
+- **1.8.3**
+  - [Passing empty string into engine does not raise error](https://github.com/sass/sassc-ruby/pull/31)
+- **1.8.2**
+  - Update to Libsass 3.3.2
+- **1.8.1**
+  - Update to Libsass 3.3.1
+- **1.8.0**
+  - Update to Libsass 3.3.0
+- **1.8.0.pre2**
+  - Fix bug with looking up gem_path
+- **1.8.0.pre1**
+  - [Update to Libsass 3.3.0-beta3](https://github.com/sass/sassc-ruby/pull/20)
+- **1.7.1**
+  - Some updates to `Engine` API.
+- **1.7.0**
+  - [Support Precision](https://github.com/sass/sassc-ruby/pull/19)
+- **1.6.0**
+  - [Support Sass Color types](https://github.com/bolandrm/sassc-ruby/pull/14)
+  - [Support quoted strings](https://github.com/bolandrm/sassc-ruby/pull/13)
+  - [Improve custom function error handling](https://github.com/bolandrm/sassc-ruby/pull/15)
+- **1.5.1**
+  - 2nd attempt at fixing compilation bug (issue [#12](https://github.com/bolandrm/sassc-ruby/issues/12))
+- **1.5.0**
+  - Add support for inline source maps
+  - Fix compilation bug (issue [#12](https://github.com/bolandrm/sassc-ruby/issues/12))
+- **1.4.0**
+  - Add support for line number comments
+- **1.3.0**
+  - Support Sass color custom function arguments
+  - Adds error handling for exceptions in custom functions
+  - Custom functions may have optional/default arguments

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+Sass is more than a technology; Sass is driven by the community of individuals
+that power its development and use every day. As a community, we want to embrace
+the very differences that have made our collaboration so powerful, and work
+together to provide the best environment for learning, growing, and sharing of
+ideas. It is imperative that we keep Sass a fun, welcoming, challenging, and
+fair place to play.
+
+[The full community guidelines can be found on the Sass website.][link]
+
+[link]: https://sass-lang.com/community-guidelines

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) Ryan Boland & Contributors
+
+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,68 @@
+# SassC [![Build Status](https://travis-ci.org/sass/sassc-ruby.svg?branch=master)](https://travis-ci.org/sass/sassc-ruby) [![Gem Version](https://badge.fury.io/rb/sassc.svg)](http://badge.fury.io/rb/sassc)
+
+Use `libsass` with Ruby!
+
+This gem combines the speed of `libsass`, the [Sass C implementation](https://github.com/sass/libsass), with the ease of use of the original [Ruby Sass](https://github.com/sass/ruby-sass) library.
+
+### libsass Version
+
+[3.6.0](https://github.com/sass/libsass/releases/3.6.0)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'sassc'
+```
+
+And then execute:
+
+```bash
+bundle
+```
+
+Or install it yourself as:
+
+```bash
+gem install sassc
+```
+
+## Usage
+
+This library utilizes `libsass` to allow you to compile SCSS or SASS syntax
+to CSS.  To compile, use a `SassC::Engine`, e.g.:
+
+```ruby
+SassC::Engine.new(sass, style: :compressed).render
+```
+
+**Note**:  If you want to use this library with Rails/Sprockets, check out
+[sassc-rails](https://github.com/bolandrm/sassc-rails).
+
+Additionally, you can use `SassC::Sass2Scss` to convert Sass syntax to Scss syntax.
+
+## Credits
+
+This gem is maintained by [Ryan Boland](https://ryanboland.com)
+and [awesome contributors](https://github.com/bolandrm/sassc-ruby/graphs/contributors).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## Contributing
+
+### Project Setup
+
+1. Clone repo
+1. Install dependencies - `bundle install`
+1. Run the tests - `bundle exec rake test`
+
+### Code Changes
+
+1. Fork it ( https://github.com/sass/sassc-ruby/fork )
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Commit your changes (`git commit -am 'Add some feature'`) - try to include tests
+1. Push to the branch (`git push origin my-new-feature`)
+1. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,30 @@
+require 'bundler/gem_tasks'
+
+task default: :test
+
+require 'rake/extensiontask'
+gem_spec = Gem::Specification.load("sassc.gemspec")
+Rake::ExtensionTask.new('libsass', gem_spec) do |ext|
+  ext.name = 'libsass'
+  ext.ext_dir = 'ext'
+  ext.lib_dir = 'lib/sassc'
+  ext.cross_compile = true
+  ext.cross_platform = %w[x86-mingw32 x64-mingw32 x86-linux x86_64-linux]
+  ext.cross_compiling do |spec|
+    spec.files.reject! { |path| File.fnmatch?('ext/*', path) }
+  end
+end
+
+desc 'Compile all native gems via rake-compiler-dock (Docker)'
+task 'gem:native' do
+  require 'rake_compiler_dock'
+  RakeCompilerDock.sh "bundle && gem i rake --no-document && "\
+                      "rake cross native gem MAKE='nice make -j`nproc`' "\
+                      "RUBY_CC_VERSION=2.6.0:2.5.0:2.4.0:2.3.0"
+end
+
+desc "Run all tests"
+task test: 'compile:libsass' do
+  $LOAD_PATH.unshift('lib', 'test')
+  Dir.glob('./test/**/*_test.rb') { |f| require f }
+end

data/lib/sassc/dependency.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SassC
+  class Dependency
+    attr_reader :filename
+    attr_reader :options
+
+    def initialize(filename)
+      @filename = filename
+      @options = { filename: @filename }
+    end
+
+    def self.from_filenames(filenames)
+      filenames.map { |f| new(f) }
+    end
+  end
+end

data/lib/sassc/engine.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require_relative "error"
+
+module SassC
+  class Engine
+    OUTPUT_STYLES = %i[
+      sass_style_nested
+      sass_style_expanded
+      sass_style_compact
+      sass_style_compressed
+    ]
+
+    attr_reader :template, :options
+
+    def initialize(template, options = {})
+      @template = template
+      @options = options
+    end
+
+    def render
+      return @template.dup if @template.empty?
+
+      data_context = Native.make_data_context(@template)
+      context = Native.data_context_get_context(data_context)
+      native_options = Native.context_get_options(context)
+
+      Native.option_set_is_indented_syntax_src(native_options, true) if sass?
+      Native.option_set_input_path(native_options, filename) if filename
+      Native.option_set_precision(native_options, precision) if precision
+      Native.option_set_include_path(native_options, load_paths)
+      Native.option_set_output_style(native_options, output_style_enum)
+      Native.option_set_source_comments(native_options, true) if line_comments?
+      Native.option_set_source_map_file(native_options, source_map_file) if source_map_file
+      Native.option_set_source_map_embed(native_options, true) if source_map_embed?
+      Native.option_set_source_map_contents(native_options, true) if source_map_contents?
+      Native.option_set_omit_source_map_url(native_options, true) if omit_source_map_url?
+
+      import_handler.setup(native_options)
+      functions_handler.setup(native_options)
+
+      status = Native.compile_data_context(data_context)
+
+      if status != 0
+        message = Native.context_get_error_message(context)
+        filename = Native.context_get_error_file(context)
+        line = Native.context_get_error_line(context)
+
+        raise SyntaxError.new(message, filename: filename, line: line)
+      end
+
+      css = Native.context_get_output_string(context)
+
+      @dependencies = Native.context_get_included_files(context)
+      @source_map   = Native.context_get_source_map_string(context)
+
+      Native.delete_data_context(data_context)
+
+      css.force_encoding(@template.encoding)
+
+      return css unless quiet?
+    end
+
+    def dependencies
+      raise NotRenderedError unless @dependencies
+      Dependency.from_filenames(@dependencies)
+    end
+
+    def source_map
+      raise NotRenderedError unless @source_map
+      @source_map
+    end
+
+    def filename
+      @options[:filename]
+    end
+
+    private
+
+    def quiet?
+      @options[:quiet]
+    end
+
+    def precision
+      @options[:precision]
+    end
+
+    def sass?
+      @options[:syntax] && @options[:syntax].to_sym == :sass
+    end
+
+    def line_comments?
+      @options[:line_comments]
+    end
+
+    def source_map_embed?
+      @options[:source_map_embed]
+    end
+
+    def source_map_contents?
+      @options[:source_map_contents]
+    end
+
+    def omit_source_map_url?
+      @options[:omit_source_map_url]
+    end
+
+    def source_map_file
+      @options[:source_map_file]
+    end
+
+    def import_handler
+      @import_handler ||= ImportHandler.new(@options)
+    end
+
+    def functions_handler
+      @functions_handler = FunctionsHandler.new(@options)
+    end
+
+    def output_style_enum
+      @output_style_enum ||= Native::SassOutputStyle[output_style]
+    end
+
+    def output_style
+      @output_style ||= begin
+        style = @options.fetch(:style, :sass_style_nested).to_s
+        style = "sass_style_#{style}" unless style.include?("sass_style_")
+        style = style.to_sym
+        raise InvalidStyleError unless Native::SassOutputStyle.symbols.include?(style)
+        style
+      end
+    end
+
+    def load_paths
+      paths = (@options[:load_paths] || []) + SassC.load_paths
+      paths.join(File::PATH_SEPARATOR) unless paths.empty?
+    end
+  end
+end

data/lib/sassc/error.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module SassC
+
+  class BaseError < StandardError; end
+  class NotRenderedError < BaseError; end
+  class InvalidStyleError < BaseError; end
+  class UnsupportedValue < BaseError; end
+
+  # When dealing with SyntaxErrors,
+  # it's important to provide filename and line number information.
+  # This will be used in various error reports to users, including backtraces.
+
+  class SyntaxError < BaseError
+
+    def initialize(message, filename: nil, line: nil)
+      @filename = filename
+      @line = line
+      super(message)
+    end
+
+    def backtrace
+      return nil if super.nil?
+      sass_backtrace + super
+    end
+
+    # The backtrace of the error within Sass files.
+    def sass_backtrace
+      return [] unless @filename && @line
+      ["#{@filename}:#{@line}"]
+    end
+
+  end
+
+end

data/lib/sassc/functions_handler.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module SassC
+  class FunctionsHandler
+    def initialize(options)
+      @options = options
+    end
+
+    def setup(native_options)
+      @callbacks = {}
+      @function_names = {}
+
+      list = Native.make_function_list(Script.custom_functions.count)
+
+      functions = FunctionWrapper.extend(Script::Functions)
+      functions.options = @options
+
+      Script.custom_functions.each_with_index do |custom_function, i|
+        @callbacks[custom_function] = FFI::Function.new(:pointer, [:pointer, :pointer]) do |native_argument_list, cookie|
+          begin
+            function_arguments = arguments_from_native_list(native_argument_list)
+            result = functions.send(custom_function, *function_arguments)
+            to_native_value(result)
+          rescue StandardError => exception
+            # This rescues any exceptions that occur either in value conversion
+            # or during the execution of a custom function.
+            error(exception.message)
+          end
+        end
+
+        @function_names[custom_function] = Script.formatted_function_name(custom_function)
+
+        callback = Native.make_function(
+          @function_names[custom_function],
+          @callbacks[custom_function],
+          nil
+        )
+
+        Native::function_set_list_entry(list, i, callback)
+      end
+
+      Native::option_set_c_functions(native_options, list)
+    end
+
+    private
+
+    def arguments_from_native_list(native_argument_list)
+      native_argument_list_length = Native.list_get_length(native_argument_list)
+
+      (0...native_argument_list_length).map do |i|
+        native_value = Native.list_get_value(native_argument_list, i)
+        Script::ValueConversion.from_native(native_value, @options)
+      end.compact
+    end
+
+    def to_native_value(sass_value)
+      # if the custom function returns nil, we provide a "default" return
+      # value of an empty string
+      sass_value ||= SassC::Script::Value::String.new("")
+      sass_value.options = @options
+      Script::ValueConversion.to_native(sass_value)
+    end
+
+    def error(message)
+      $stderr.puts "[SassC::FunctionsHandler] #{message}"
+      Native.make_error(message)
+    end
+
+    class FunctionWrapper
+      class << self
+        attr_accessor :options
+      end
+    end
+  end
+end

data/lib/sassc/import_handler.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module SassC
+  class ImportHandler
+    def initialize(options)
+      @importer = if options[:importer]
+        options[:importer].new(options)
+      else
+        nil
+      end
+    end
+
+    def setup(native_options)
+      return unless @importer
+
+      importer_callback = Native.make_importer(import_function, nil)
+
+      list = Native.make_function_list(1)
+      Native::function_set_list_entry(list, 0, importer_callback)
+
+      Native.option_set_c_importers(native_options, list)
+    end
+
+    private
+
+    def import_function
+      @import_function ||= FFI::Function.new(:pointer, [:string, :pointer, :pointer]) do |path, importer_entry, compiler|
+        last_import = Native::compiler_get_last_import(compiler)
+        parent_path = Native::import_get_abs_path(last_import)
+
+        imports = [*@importer.imports(path, parent_path)]
+        imports_to_native(imports)
+      end
+    end
+
+    def imports_to_native(imports)
+      import_list = Native.make_import_list(imports.size)
+
+      imports.each_with_index do |import, i|
+        source = import.source ? Native.native_string(import.source) : nil
+        source_map_path = nil
+
+        entry = Native.make_import_entry(import.path, source, source_map_path)
+        Native.import_set_list_entry(import_list, i, entry)
+      end
+
+      import_list
+    end
+  end
+end

data/lib/sassc/importer.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module SassC
+  class Importer
+    attr_reader :options
+
+    def initialize(options)
+      @options = options
+    end
+
+    def imports(path, parent_path)
+      # A custom importer must override this method.
+      # Custom importer may return an Import, or an array of Imports.
+      raise NotImplementedError
+    end
+
+    class Import
+      attr_accessor :path, :source, :source_map_path
+
+      def initialize(path, source: nil, source_map_path: nil)
+        @path = path
+        @source = source
+        @source_map_path = source_map_path
+      end
+
+      def to_s
+        "Import: #{path} #{source} #{source_map_path}"
+      end
+    end
+  end
+end

data/lib/sassc/native/lib_c.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    module LibC
+      extend FFI::Library
+      ffi_lib FFI::Library::LIBC
+
+      # memory allocators
+      attach_function :malloc, [:size_t], :pointer
+      # attach_function :calloc, [:size_t], :pointer
+      # attach_function :valloc, [:size_t], :pointer
+      # attach_function :realloc, [:pointer, :size_t], :pointer
+      # attach_function :free, [:pointer], :void
+
+      # memory movers
+      # attach_function :memcpy, [:pointer, :pointer, :size_t], :pointer
+      # attach_function :bcopy, [:pointer, :pointer, :size_t], :void
+    end
+  end
+end