sassc 2.0.1 → 2.1.0.pre1

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

@@ -1,67 +0,0 @@
-## Example main.c
-
-```C
-#include <stdio.h>
-#include <stdint.h>
-#include "sass/context.h"
-
-union Sass_Value* call_fn_foo(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 information about previous importer entry from the stack
-  Sass_Import_Entry import = sass_compiler_get_last_import(comp);
-  const char* prev_abs_path = sass_import_get_abs_path(import);
-  const char* prev_imp_path = sass_import_get_imp_path(import);
-  // get the cookie from function descriptor
-  void* cookie = sass_function_get_cookie(cb);
-  // we actually abuse the void* to store an "int"
-  return sass_make_number((intptr_t)cookie, "px");
-}
-
-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);
-
-  // allocate a custom function caller
-  Sass_Function_Entry fn_foo =
-    sass_make_function("foo()", call_fn_foo, (void*)42);
-
-  // create list of all custom functions
-  Sass_Function_List fn_list = sass_make_function_list(1);
-  sass_function_set_list_entry(fn_list, 0, fn_foo);
-  sass_option_set_c_functions(ctx_opt, fn_list);
-
-  // 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: foo(); }" > foo.scss
-./sample foo.scss => "foo { margin: 42px }"
-```
-

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

@@ -1,8 +0,0 @@
-```C
-// Struct to hold custom function callback
-struct Sass_Function {
-  const char*      signature;
-  Sass_Function_Fn function;
-  void*            cookie;
-};
-```

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

@@ -1,74 +0,0 @@
-Sass functions are used to define new custom functions callable by Sass code. They are also used to overload debug or error statements. You can also define a fallback function, which is called for every unknown function found in the Sass code. Functions get passed zero or more `Sass_Values` (a `Sass_List` value) and they must also return a `Sass_Value`. Return a `Sass_Error` if you want to signal an error.
-
-## Special signatures
-
-- `*` - Fallback implementation
-- `@warn` - Overload warn statements
-- `@error` - Overload error statements
-- `@debug` - Overload debug statements
-
-Note: The fallback implementation will be given the name of the called function as the first argument, before all the original function arguments. These features are pretty new and should be considered experimental.
-
-### Basic Usage
-
-```C
-#include "sass/functions.h"
-```
-
-## Sass Function API
-
-```C
-// Forward declaration
-struct Sass_Compiler;
-struct Sass_Function;
-
-// Typedef helpers for custom functions lists
-typedef struct Sass_Function (*Sass_Function_Entry);
-typedef struct Sass_Function* (*Sass_Function_List);
-// Typedef defining function signature and return type
-typedef union Sass_Value* (*Sass_Function_Fn)
-  (const union Sass_Value*, Sass_Function_Entry cb, struct Sass_Compiler* compiler);
-
-// Creators for sass function list and function descriptors
-Sass_Function_List sass_make_function_list (size_t length);
-Sass_Function_Entry sass_make_function (const char* signature, Sass_Function_Fn cb, void* cookie);
-// In case you need to free them yourself
-void sass_delete_function (Sass_Function_Entry entry);
-void sass_delete_function_list (Sass_Function_List list);
-
-// Setters and getters for callbacks on function lists
-Sass_Function_Entry sass_function_get_list_entry(Sass_Function_List list, size_t pos);
-void sass_function_set_list_entry(Sass_Function_List list, size_t pos, Sass_Function_Entry cb);
-
-// Setters to insert an entry into the import list (you may also use [] access directly)
-// Since we are dealing with pointers they should have a guaranteed and fixed size
-void sass_import_set_list_entry (Sass_Import_List list, size_t idx, Sass_Import_Entry entry);
-Sass_Import_Entry sass_import_get_list_entry (Sass_Import_List list, size_t idx);
-
-// Getters for custom function descriptors
-const char* sass_function_get_signature (Sass_Function_Entry cb);
-Sass_Function_Fn sass_function_get_function (Sass_Function_Entry cb);
-void* sass_function_get_cookie (Sass_Function_Entry cb);
-
-// Getters for callee entry
-const char* sass_callee_get_name (Sass_Callee_Entry);
-const char* sass_callee_get_path (Sass_Callee_Entry);
-size_t sass_callee_get_line (Sass_Callee_Entry);
-size_t sass_callee_get_column (Sass_Callee_Entry);
-enum Sass_Callee_Type sass_callee_get_type (Sass_Callee_Entry);
-Sass_Env_Frame sass_callee_get_env (Sass_Callee_Entry);
-
-// Getters and Setters for environments (lexical, local and global)
-union Sass_Value* sass_env_get_lexical (Sass_Env_Frame, const char*);
-void sass_env_set_lexical (Sass_Env_Frame, const char*, union Sass_Value*);
-union Sass_Value* sass_env_get_local (Sass_Env_Frame, const char*);
-void sass_env_set_local (Sass_Env_Frame, const char*, union Sass_Value*);
-union Sass_Value* sass_env_get_global (Sass_Env_Frame, const char*);
-void sass_env_set_global (Sass_Env_Frame, const char*, union Sass_Value*);
-```
-
-### More links
-
-- [Sass Function Example](api-function-example.md)
-- [Sass Function Internal](api-function-internal.md)
-

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

@@ -1,112 +0,0 @@
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  char* local = sass_copy_c_string("local { color: green; }");
-  char* remote = sass_copy_c_string("remote { color: red; }");
-  list[0] = sass_make_import_entry("/tmp/styles.scss", local, 0);
-  list[1] = sass_make_import_entry("http://www.example.com", remote, 0);
-  return list;
-}
-
-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);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put only the importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // 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 importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(path, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(path, 0, 0);
-  sass_import_set_error(list[0], sass_copy_c_string(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```

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

@@ -1,20 +0,0 @@
-```C
-// External import entry
-struct Sass_Import {
-  char* imp_path; // path as found in the import statement
-  char *abs_path; // path after importer has resolved it
-  char* source;
-  char* srcmap;
-  // error handling
-  char* error;
-  size_t line;
-  size_t column;
-};
-
-// Struct to hold importer callback
-struct Sass_Importer {
-  Sass_Importer_Fn importer;
-  double           priority;
-  void*            cookie;
-};
-```

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

@@ -1,86 +0,0 @@
-By using custom importers, Sass stylesheets can be implemented in any possible way, such as by being loaded via a remote server. Please note: this feature is experimental and is implemented differently than importers in Ruby Sass. Imports must be relative to the parent import context and therefore we need to pass this information to the importer callback. This is currently done by passing the complete import string/path of the previous import context.
-
-## Return Imports
-
-You actually have to return a list of imports, since some importers may want to import multiple files from one import statement (ie. a glob/star importer).  The memory you pass with source and srcmap is taken over by LibSass and freed automatically when the import is done. You are also allowed to return `0` instead of a list, which will tell LibSass to handle the import by itself (as if no custom importer was in use).
-
-```C
-Sass_Import_Entry* rv = sass_make_import_list(1);
-rv[0] = sass_make_import(rel, abs, source, srcmap);
-```
-
-Every import will then be included in LibSass. You are allowed to only return a file path without any loaded source. This way you can ie. implement rewrite rules for import paths and leave the loading part for LibSass.
-
-Please note that LibSass doesn't use the srcmap parameter yet. It has been added to not deprecate the C-API once support has been implemented. It will be used to re-map the actual sourcemap with the provided ones.
-
-### Basic Usage
-
-```C
-#include "sass/functions.h"
-```
-
-## Sass Importer API
-
-```C
-// Forward declaration
-struct Sass_Import;
-
-// Forward declaration
-struct Sass_C_Import_Descriptor;
-
-// Typedef defining the custom importer callback
-typedef struct Sass_C_Import_Descriptor (*Sass_C_Import_Callback);
-// Typedef defining the importer c function prototype
-typedef Sass_Import_Entry* (*Sass_C_Import_Fn) (const char* url, const char* prev, void* cookie);
-
-// Creators for custom importer callback (with some additional pointer)
-// The pointer is mostly used to store the callback into the actual function
-Sass_C_Import_Callback sass_make_importer (Sass_C_Import_Fn, void* cookie);
-
-// Getters for import function descriptors
-Sass_C_Import_Fn sass_import_get_function (Sass_C_Import_Callback fn);
-void* sass_import_get_cookie (Sass_C_Import_Callback fn);
-
-// Deallocator for associated memory
-void sass_delete_importer (Sass_C_Import_Callback fn);
-
-// Creator for sass custom importer return argument list
-Sass_Import_Entry* sass_make_import_list (size_t length);
-// Creator for a single import entry returned by the custom importer inside the list
-Sass_Import_Entry sass_make_import_entry (const char* path, char* source, char* srcmap);
-Sass_Import_Entry sass_make_import (const char* rel, const char* abs, char* source, char* srcmap);
-
-// set error message to abort import and to print out a message (path from existing object is used in output)
-Sass_Import_Entry sass_import_set_error(Sass_Import_Entry import, const char* message, size_t line, size_t col);
-
-// Setters to insert an entry into the import list (you may also use [] access directly)
-// Since we are dealing with pointers they should have a guaranteed and fixed size
-void sass_import_set_list_entry (Sass_Import_Entry* list, size_t idx, Sass_Import_Entry entry);
-Sass_Import_Entry sass_import_get_list_entry (Sass_Import_Entry* list, size_t idx);
-
-// Getters for import entry
-const char* sass_import_get_imp_path (Sass_Import_Entry);
-const char* sass_import_get_abs_path (Sass_Import_Entry);
-const char* sass_import_get_source (Sass_Import_Entry);
-const char* sass_import_get_srcmap (Sass_Import_Entry);
-// Explicit functions to take ownership of these items
-// The property on our struct will be reset to NULL
-char* sass_import_take_source (Sass_Import_Entry);
-char* sass_import_take_srcmap (Sass_Import_Entry);
-
-// Getters for import error entries
-size_t sass_import_get_error_line (Sass_Import_Entry);
-size_t sass_import_get_error_column (Sass_Import_Entry);
-const char* sass_import_get_error_message (Sass_Import_Entry);
-
-// Deallocator for associated memory (incl. entries)
-void sass_delete_import_list (Sass_Import_Entry*);
-// Just in case we have some stray import structs
-void sass_delete_import (Sass_Import_Entry);
-```
-
-### More links
-
-- [Sass Importer Example](api-importer-example.md)
-- [Sass Importer Internal](api-importer-internal.md)
-

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

@@ -1,55 +0,0 @@
-## Example operation.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/values.h"
-
-int main( int argc, const char* argv[] )
-{
-
-  // create two new sass values to be added
-  union Sass_Value* string = sass_make_string("String");
-  union Sass_Value* number = sass_make_number(42, "nits");
-
-  // invoke the add operation which returns a new sass value
-  union Sass_Value* total = sass_value_op(ADD, string, number);
-
-  // no further use for the two operands
-  sass_delete_value(string);
-  sass_delete_value(number);
-
-  // this works since libsass will always return a
-  // string for add operations with a string as the
-  // left hand side. But you should never rely on it!
-  puts(sass_string_get_value(total));
-
-  // invoke stringification (uncompressed with precision of 5)
-  union Sass_Value* result = sass_value_stringify(total, false, 5);
-
-  // no further use for the sum
-  sass_delete_value(total);
-
-  // print the result - you may want to make
-  // sure result is indeed a string, altough
-  // stringify guarantees to return a string
-  // if (sass_value_is_string(result)) {}
-  // really depends on your level of paranoia
-  puts(sass_string_get_value(result));
-
-  // finally free result
-  sass_delete_value(result);
-
-  // exit status
-  return 0;
-
-}
-```
-
-## Compile operation.c
-
-```bash
-gcc -c operation.c -o operation.o
-gcc -o operation operation.o -lsass
-./operation # => String42nits
-```

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

@@ -1,76 +0,0 @@
-```C
-struct Sass_Unknown {
-  enum Sass_Tag tag;
-};
-
-struct Sass_Boolean {
-  enum Sass_Tag tag;
-  bool          value;
-};
-
-struct Sass_Number {
-  enum Sass_Tag tag;
-  double        value;
-  char*         unit;
-};
-
-struct Sass_Color {
-  enum Sass_Tag tag;
-  double        r;
-  double        g;
-  double        b;
-  double        a;
-};
-
-struct Sass_String {
-  enum Sass_Tag tag;
-  char*         value;
-};
-
-struct Sass_List {
-  enum Sass_Tag       tag;
-  enum Sass_Separator separator;
-  size_t              length;
-  // null terminated "array"
-  union Sass_Value**  values;
-};
-
-struct Sass_Map {
-  enum Sass_Tag        tag;
-  size_t               length;
-  struct Sass_MapPair* pairs;
-};
-
-struct Sass_Null {
-  enum Sass_Tag tag;
-};
-
-struct Sass_Error {
-  enum Sass_Tag tag;
-  char*         message;
-};
-
-struct Sass_Warning {
-  enum Sass_Tag tag;
-  char*         message;
-};
-
-union Sass_Value {
-  struct Sass_Unknown unknown;
-  struct Sass_Boolean boolean;
-  struct Sass_Number  number;
-  struct Sass_Color   color;
-  struct Sass_String  string;
-  struct Sass_List    list;
-  struct Sass_Map     map;
-  struct Sass_Null    null;
-  struct Sass_Error   error;
-  struct Sass_Warning   warning;
-};
-
-struct Sass_MapPair {
-  union Sass_Value* key;
-  union Sass_Value* value;
-};
-```
-