sassc 1.8.0.pre2 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7688cb93e1b52db87dd774ad57c34f10f594f071
-  data.tar.gz: 7b8fc86040b72d293bbe66d5392b8fc7ddcd79dd
+  metadata.gz: f13097a5a3ad307a313cbe5e042460b96cc56d02
+  data.tar.gz: 5ebc6f97d3066bfecd7c8334a2e1b1b6d51e90d0
 SHA512:
-  metadata.gz: 225f336033d4610df894d5de42d1bc68060ded47992640a3bcc02f40c06b71c2f7ea7cecd228aed2aa37df85bdea38aa17d973667974debe49ecdb8ddd8dfa6b
-  data.tar.gz: ce344d166275054a5fc9f30037446ab114643a0c3af8c6e1052767c8fb7633ab6ab969a7bead718b24168b8ac138639b856cf2f612230802473bc30425b1ed8f
+  metadata.gz: de32bd0766e935adce472e86769b7a8c71aae7e5ed81af6a810d8cd3dcbc08df44b2e4db4e8bca01e45a179a4f203f0c0fa7622e5dab307d36e1fcd21606a130
+  data.tar.gz: fbc161e22ee1159e5b118687199bc6289b0b8eb1e981e807eb576e4ce1d571cf4f39751d6cb3be0cc02652272e192c87434ac21f19f7cd515b37b9b89b379f1b

data/README.md

@@ -6,7 +6,7 @@ This gem combines the speed of `libsass`, the [Sass C implementation](https://gi
 
 ### libsass Version
 
-[3.3.0-beta3](https://github.com/sass/libsass/releases/tag/3.3.0-beta3)
+[3.3.0](https://github.com/sass/libsass/releases/tag/3.3.0)
 
 ## Usage
 
@@ -25,7 +25,11 @@ and [awesome contributors](https://github.com/bolandrm/sassc-ruby/graphs/contrib
 
 ## Changelog
 
-- **1.8.0-beta1**
+- **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.

data/ext/libsass/contrib/plugin.cpp

@@ -10,8 +10,11 @@ extern "C" const char* ADDCALL libsass_get_version() {
   return libsass_version();
 }
 
-union Sass_Value* custom_function(const union Sass_Value* s_args, Sass_Function_Entry cb, struct Sass_Options* opts)
+union Sass_Value* custom_function(const union Sass_Value* s_args, Sass_Function_Entry cb, struct Sass_Compiler* comp)
 {
+  // get context/option struct associated with this compiler
+  struct Sass_Context* ctx = sass_compiler_get_context(comp);
+  struct Sass_Options* opts = sass_compiler_get_options(comp);
   // get the cookie from function descriptor
   void* cookie = sass_function_get_cookie(cb);
   // we actually abuse the void* to store an "int"

data/ext/libsass/docs/README.md

@@ -0,0 +1,20 @@
+Welcome to the LibSass wiki!
+
+## First Off
+LibSass is just a library. To run the code locally (i.e. to compile your stylesheets), you need an implementer. SassC (get it?) is an implementer written in C. There are a number of other implementations of LibSass - for example Node. We encourage you to write your own port - the whole point of LibSass is that we want to bring Sass to many other languages, not just Ruby!
+
+We're working hard on moving to full parity with Ruby Sass... learn more at the [The-LibSass-Compatibility-Plan](compatibility-plan.md)!
+
+### Implementing LibSass
+
+If you're interested in implementing LibSass in your own project see the [API Documentation](api-doc.md) which now includes implementing
+your own [Sass functions](api-function.md).  You may wish to [look at other implementations](implementations.md) for your language of choice.
+Or make your own!
+
+### Contributing to LibSass
+
+|   Issue Tracker   |            Issue Triage          |     Community Guidelines    |
+|-------------------|----------------------------------|-----------------------------|
+| We're always needing help, so check out our issue tracker, help some people out, and read our article on [Contributing](contributing.md)! It's got all the details on what to do! | To help understand the process of triaging bugs, have a look at our [Issue-Triage](triage.md) document. | Oh, and don't forget we always follow [[Sass Community Guidelines|http://sass-lang.com/community-guidelines]]. Be nice and everyone else will be nice too! |
+
+Please refer to the steps on [Building LibSass](build.md)

data/ext/libsass/docs/api-context-example.md

@@ -0,0 +1,45 @@
+## Example main.c
+
+```C
+#include <stdio.h>
+#include "sass_context.h"
+
+int main( int argc, const char* argv[] )
+{
+
+  // get the input file from first argument or use default
+  const char* input = argc > 1 ? argv[1] : "styles.scss";
+
+  // create the file context and get all related structs
+  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
+  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
+  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
+
+  // configure some options ...
+  sass_option_set_precision(ctx_opt, 10);
+
+  // context is set up, call the compile step now
+  int status = sass_compile_file_context(file_ctx);
+
+  // print the result or the error to the stdout
+  if (status == 0) puts(sass_context_get_output_string(ctx));
+  else puts(sass_context_get_error_message(ctx));
+
+  // release allocated memory
+  sass_delete_file_context(file_ctx);
+
+  // exit status
+  return status;
+
+}
+```
+
+### Compile main.c
+
+```bash
+gcc -c main.c -o main.o
+gcc -o sample main.o -lsass
+echo "foo { margin: 21px * 2; }" > foo.scss
+./sample foo.scss => "foo { margin: 42px }"
+```
+

data/ext/libsass/docs/api-context-internal.md

@@ -0,0 +1,152 @@
+```C
+// Input behaviours
+enum Sass_Input_Style {
+  SASS_CONTEXT_NULL,
+  SASS_CONTEXT_FILE,
+  SASS_CONTEXT_DATA,
+  SASS_CONTEXT_FOLDER
+};
+
+// simple linked list
+struct string_list {
+  string_list* next;
+  char* string;
+};
+
+// sass config options structure
+struct Sass_Options {
+
+  // Precision for fractional numbers
+  int precision;
+
+  // Output style for the generated css code
+  // A value from above SASS_STYLE_* constants
+  enum Sass_Output_Style output_style;
+
+  // Emit comments in the generated CSS indicating
+  // the corresponding source line.
+  bool source_comments;
+
+  // embed sourceMappingUrl as data uri
+  bool source_map_embed;
+
+  // embed include contents in maps
+  bool source_map_contents;
+
+  // Disable sourceMappingUrl in css output
+  bool omit_source_map_url;
+
+  // Treat source_string as sass (as opposed to scss)
+  bool is_indented_syntax_src;
+
+  // The input path is used for source map
+  // generation. It can be used to define
+  // something with string compilation or to
+  // overload the input file path. It is
+  // set to "stdin" for data contexts and
+  // to the input file on file contexts.
+  char* input_path;
+
+  // The output path is used for source map
+  // generation. LibSass will not write to
+  // this file, it is just used to create
+  // information in source-maps etc.
+  char* output_path;
+
+  // String to be used for indentation
+  const char* indent;
+  // String to be used to for line feeds
+  const char* linefeed;
+
+  // Colon-separated list of paths
+  // Semicolon-separated on Windows
+  // Note: It may be better to use
+  // array interface instead
+  char* include_path;
+  char* plugin_path;
+
+  // Include paths (linked string list)
+  struct string_list* include_paths;
+  // Plugin paths (linked string list)
+  struct string_list* plugin_paths;
+
+  // Path to source map file
+  // Enables source map generation
+  // Used to create sourceMappingUrl
+  char* source_map_file;
+
+  // Directly inserted in source maps
+  char* source_map_root;
+
+  // Custom functions that can be called from sccs code
+  Sass_C_Function_List c_functions;
+
+  // Callback to overload imports
+  Sass_C_Import_Callback importer;
+
+};
+
+// base for all contexts
+struct Sass_Context : Sass_Options
+{
+
+  // store context type info
+  enum Sass_Input_Style type;
+
+  // generated output data
+  char* output_string;
+
+  // generated source map json
+  char* source_map_string;
+
+  // error status
+  int error_status;
+  char* error_json;
+  char* error_text;
+  char* error_message;
+  // error position
+  char* error_file;
+  size_t error_line;
+  size_t error_column;
+
+  // report imported files
+  char** included_files;
+
+};
+
+// struct for file compilation
+struct Sass_File_Context : Sass_Context {
+
+  // no additional fields required
+  // input_path is already on options
+
+};
+
+// struct for data compilation
+struct Sass_Data_Context : Sass_Context {
+
+  // provided source string
+  char* source_string;
+
+};
+
+// Compiler states
+enum Sass_Compiler_State {
+  SASS_COMPILER_CREATED,
+  SASS_COMPILER_PARSED,
+  SASS_COMPILER_EXECUTED
+};
+
+// link c and cpp context
+struct Sass_Compiler {
+  // progress status
+  Sass_Compiler_State state;
+  // original c context
+  Sass_Context* c_ctx;
+  // Sass::Context
+  void* cpp_ctx;
+  // Sass::Block
+  void* root;
+};
+```
+

data/ext/libsass/docs/api-context.md

@@ -0,0 +1,268 @@
+Sass Contexts come in two flavors:
+
+- `Sass_File_Context`
+- `Sass_Data_Context`
+
+### Basic Usage
+
+```C
+#include "sass_context.h"
+```
+
+***Sass_Options***
+
+```C
+// Precision for fractional numbers
+int precision;
+```
+```C
+// Output style for the generated css code
+// A value from above SASS_STYLE_* constants
+int output_style;
+```
+```C
+// Emit comments in the generated CSS indicating
+// the corresponding source line.
+bool source_comments;
+```
+```C
+// embed sourceMappingUrl as data uri
+bool source_map_embed;
+```
+```C
+// embed include contents in maps
+bool source_map_contents;
+```
+```C
+// Disable sourceMappingUrl in css output
+bool omit_source_map_url;
+```
+```C
+// Treat source_string as sass (as opposed to scss)
+bool is_indented_syntax_src;
+```
+```C
+// The input path is used for source map
+// generating. It can be used to define
+// something with string compilation or to
+// overload the input file path. It is
+// set to "stdin" for data contexts and
+// to the input file on file contexts.
+char* input_path;
+```
+```C
+// The output path is used for source map
+// generating. LibSass will not write to
+// this file, it is just used to create
+// information in source-maps etc.
+char* output_path;
+```
+```C
+// String to be used for indentation
+const char* indent;
+```
+```C
+// String to be used to for line feeds
+const char* linefeed;
+```
+```C
+// Colon-separated list of paths
+// Semicolon-separated on Windows
+char* include_path;
+char* plugin_path;
+```
+```C
+// Additional include paths
+// Must be null delimited
+char** include_paths;
+char** plugin_paths;
+```
+```C
+// Path to source map file
+// Enables the source map generating
+// Used to create sourceMappingUrl
+char* source_map_file;
+```
+```C
+// Directly inserted in source maps
+char* source_map_root;
+```
+```C
+// Custom functions that can be called from sccs code
+Sass_C_Function_List c_functions;
+```
+```C
+// Callback to overload imports
+Sass_C_Import_Callback importer;
+```
+
+***Sass_Context***
+
+```C
+// store context type info
+enum Sass_Input_Style type;
+````
+```C
+// generated output data
+char* output_string;
+```
+```C
+// generated source map json
+char* source_map_string;
+```
+```C
+// error status
+int error_status;
+char* error_json;
+char* error_text;
+char* error_message;
+// error position
+char* error_file;
+size_t error_line;
+size_t error_column;
+```
+```C
+// report imported files
+char** included_files;
+```
+
+***Sass_File_Context***
+
+```C
+// no additional fields required
+// input_path is already on options
+```
+
+***Sass_Data_Context***
+
+```C
+// provided source string
+char* source_string;
+```
+
+### Sass Context API
+
+```C
+// Forward declaration
+struct Sass_Compiler;
+
+// Forward declaration
+struct Sass_Options;
+struct Sass_Context; // : Sass_Options
+struct Sass_File_Context; // : Sass_Context
+struct Sass_Data_Context; // : Sass_Context
+
+// Create and initialize an option struct
+struct Sass_Options* sass_make_options (void);
+// Create and initialize a specific context
+struct Sass_File_Context* sass_make_file_context (const char* input_path);
+struct Sass_Data_Context* sass_make_data_context (char* source_string);
+
+// Call the compilation step for the specific context
+int sass_compile_file_context (struct Sass_File_Context* ctx);
+int sass_compile_data_context (struct Sass_Data_Context* ctx);
+
+// Create a sass compiler instance for more control
+struct Sass_Compiler* sass_make_file_compiler (struct Sass_File_Context* file_ctx);
+struct Sass_Compiler* sass_make_data_compiler (struct Sass_Data_Context* data_ctx);
+
+// Execute the different compilation steps individually
+// Usefull if you only want to query the included files
+int sass_compiler_parse(struct Sass_Compiler* compiler);
+int sass_compiler_execute(struct Sass_Compiler* compiler);
+
+// Release all memory allocated with the compiler
+// This does _not_ include any contexts or options
+void sass_delete_compiler(struct Sass_Compiler* compiler);
+
+// Release all memory allocated and also ourself
+void sass_delete_file_context (struct Sass_File_Context* ctx);
+void sass_delete_data_context (struct Sass_Data_Context* ctx);
+
+// Getters for Context from specific implementation
+struct Sass_Context* sass_file_context_get_context (struct Sass_File_Context* file_ctx);
+struct Sass_Context* sass_data_context_get_context (struct Sass_Data_Context* data_ctx);
+
+// Getters for Context_Options from Sass_Context
+struct Sass_Options* sass_context_get_options (struct Sass_Context* ctx);
+struct Sass_Options* sass_file_context_get_options (struct Sass_File_Context* file_ctx);
+struct Sass_Options* sass_data_context_get_options (struct Sass_Data_Context* data_ctx);
+void sass_file_context_set_options (struct Sass_File_Context* file_ctx, struct Sass_Options* opt);
+void sass_data_context_set_options (struct Sass_Data_Context* data_ctx, struct Sass_Options* opt);
+
+// Getters for Sass_Context values
+const char* sass_context_get_output_string (struct Sass_Context* ctx);
+int sass_context_get_error_status (struct Sass_Context* ctx);
+const char* sass_context_get_error_json (struct Sass_Context* ctx);
+const char* sass_context_get_error_text (struct Sass_Context* ctx);
+const char* sass_context_get_error_message (struct Sass_Context* ctx);
+const char* sass_context_get_error_file (struct Sass_Context* ctx);
+size_t sass_context_get_error_line (struct Sass_Context* ctx);
+size_t sass_context_get_error_column (struct Sass_Context* ctx);
+const char* sass_context_get_source_map_string (struct Sass_Context* ctx);
+char** sass_context_get_included_files (struct Sass_Context* ctx);
+
+// Take ownership of memory (value on context is set to 0)
+char* sass_context_take_error_json (struct Sass_Context* ctx);
+char* sass_context_take_error_text (struct Sass_Context* ctx);
+char* sass_context_take_error_message (struct Sass_Context* ctx);
+char* sass_context_take_error_file (struct Sass_Context* ctx);
+char* sass_context_take_output_string (struct Sass_Context* ctx);
+char* sass_context_take_source_map_string (struct Sass_Context* ctx);
+
+// Push function for plugin/include paths (no manipulation support for now)
+void sass_option_push_plugin_path (struct Sass_Options* options, const char* path);
+void sass_option_push_include_path (struct Sass_Options* options, const char* path);
+```
+
+### Sass Options API
+
+```C
+// Getters for Context_Option values
+int sass_option_get_precision (struct Sass_Options* options);
+enum Sass_Output_Style sass_option_get_output_style (struct Sass_Options* options);
+bool sass_option_get_source_comments (struct Sass_Options* options);
+bool sass_option_get_source_map_embed (struct Sass_Options* options);
+bool sass_option_get_source_map_contents (struct Sass_Options* options);
+bool sass_option_get_omit_source_map_url (struct Sass_Options* options);
+bool sass_option_get_is_indented_syntax_src (struct Sass_Options* options);
+const char* sass_option_get_indent (struct Sass_Options* options);
+const char* sass_option_get_linefeed (struct Sass_Options* options);
+const char* sass_option_get_input_path (struct Sass_Options* options);
+const char* sass_option_get_output_path (struct Sass_Options* options);
+const char* sass_option_get_plugin_path (struct Sass_Options* options);
+const char* sass_option_get_include_path (struct Sass_Options* options);
+const char* sass_option_get_source_map_file (struct Sass_Options* options);
+const char* sass_option_get_source_map_root (struct Sass_Options* options);
+Sass_C_Function_List sass_option_get_c_functions (struct Sass_Options* options);
+Sass_C_Import_Callback sass_option_get_importer (struct Sass_Options* options);
+
+// Setters for Context_Option values
+void sass_option_set_precision (struct Sass_Options* options, int precision);
+void sass_option_set_output_style (struct Sass_Options* options, enum Sass_Output_Style output_style);
+void sass_option_set_source_comments (struct Sass_Options* options, bool source_comments);
+void sass_option_set_source_map_embed (struct Sass_Options* options, bool source_map_embed);
+void sass_option_set_source_map_contents (struct Sass_Options* options, bool source_map_contents);
+void sass_option_set_omit_source_map_url (struct Sass_Options* options, bool omit_source_map_url);
+void sass_option_set_is_indented_syntax_src (struct Sass_Options* options, bool is_indented_syntax_src);
+void sass_option_set_indent (struct Sass_Options* options, const char* indent);
+void sass_option_set_linefeed (struct Sass_Options* options, const char* linefeed);
+void sass_option_set_input_path (struct Sass_Options* options, const char* input_path);
+void sass_option_set_output_path (struct Sass_Options* options, const char* output_path);
+void sass_option_set_plugin_path (struct Sass_Options* options, const char* plugin_path);
+void sass_option_set_include_path (struct Sass_Options* options, const char* include_path);
+void sass_option_set_source_map_file (struct Sass_Options* options, const char* source_map_file);
+void sass_option_set_source_map_root (struct Sass_Options* options, const char* source_map_root);
+void sass_option_set_c_functions (struct Sass_Options* options, Sass_C_Function_List c_functions);
+void sass_option_set_importer (struct Sass_Options* options, Sass_C_Import_Callback importer);
+
+// Push function for paths (no manipulation support for now)
+void sass_option_push_plugin_path (struct Sass_Options* options, const char* path);
+void sass_option_push_include_path (struct Sass_Options* options, const char* path);
+```
+
+### More links
+
+- [Sass Context Example](api-context-example.md)
+- [Sass Context Internal](api-context-internal.md)
+