Class: Sass::Embedded

Inherits:
Object
  • Object
show all
Defined in:
lib/sass/embedded.rb,
lib/sass/embedded/host.rb,
lib/sass/embedded/varint.rb,
lib/sass/embedded/version.rb,
lib/sass/embedded/protofier.rb,
lib/sass/embedded/connection.rb,
lib/sass/embedded/dispatcher.rb,
lib/sass/embedded/structifier.rb,
lib/sass/embedded/host/logger_registry.rb,
lib/sass/embedded/host/value_protofier.rb,
lib/sass/embedded/resilient_dispatcher.rb,
lib/sass/embedded/host/function_registry.rb,
lib/sass/embedded/host/importer_registry.rb

Overview

The Embedded host for using dart-sass. Each instance creates its own communication Dispatcher with a dedicated compiler process.

Examples:

embedded = Sass::Embedded.new
result = embedded.compile_string('h1 { font-size: 40px; }')
result = embedded.compile('style.scss')
embedded.close

Constant Summary collapse

VERSION = 
'1.66.1'

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Embedded 



91
92
93
 
# File 'lib/sass/embedded.rb', line 91

def initialize
  @dispatcher = ResilientDispatcher.new
end

Instance Method Details

#close ⇒ Object 



242
243
244
 
# File 'lib/sass/embedded.rb', line 242

def close
  @dispatcher.close
end

#closed? ⇒ Boolean 



246
247
248
 
# File 'lib/sass/embedded.rb', line 246

def closed?
  @dispatcher.closed?
end

#compile(path, load_paths: [], charset: true, source_map: false, source_map_include_sources: false, style: :expanded, functions: {}, importers: [], alert_ascii: false, alert_color: nil, logger: nil, quiet_deps: false, verbose: false) ⇒ CompileResult

Compiles the Sass file at path to CSS.

Raises:

See Also:



123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
 
# File 'lib/sass/embedded.rb', line 123

def compile(path,
            load_paths: [],

            charset: true,
            source_map: false,
            source_map_include_sources: false,
            style: :expanded,

            functions: {},
            importers: [],

            alert_ascii: false,
            alert_color: nil,
            logger: nil,
            quiet_deps: false,
            verbose: false)
  raise ArgumentError, 'path must be set' if path.nil?

  Host.new(@dispatcher).compile_request(
    path: path,
    source: nil,
    importer: nil,
    load_paths: load_paths,
    syntax: nil,
    url: nil,
    charset: charset,
    source_map: source_map,
    source_map_include_sources: source_map_include_sources,
    style: style,
    functions: functions,
    importers: importers,
    alert_color: alert_color,
    alert_ascii: alert_ascii,
    logger: logger,
    quiet_deps: quiet_deps,
    verbose: verbose
  )
end

#compile_string(source, importer: nil, load_paths: [], syntax: :scss, url: nil, charset: true, source_map: false, source_map_include_sources: false, style: :expanded, functions: {}, importers: [], alert_ascii: false, alert_color: nil, logger: nil, quiet_deps: false, verbose: false) ⇒ CompileResult

Compiles a stylesheet whose contents is source to CSS.

Raises:

See Also:



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
 
# File 'lib/sass/embedded.rb', line 194

def compile_string(source,
                   importer: nil,
                   load_paths: [],
                   syntax: :scss,
                   url: nil,

                   charset: true,
                   source_map: false,
                   source_map_include_sources: false,
                   style: :expanded,

                   functions: {},
                   importers: [],

                   alert_ascii: false,
                   alert_color: nil,
                   logger: nil,
                   quiet_deps: false,
                   verbose: false)
  raise ArgumentError, 'source must be set' if source.nil?

  Host.new(@dispatcher).compile_request(
    path: nil,
    source: source,
    importer: importer,
    load_paths: load_paths,
    syntax: syntax,
    url: url,
    charset: charset,
    source_map: source_map,
    source_map_include_sources: source_map_include_sources,
    style: style,
    functions: functions,
    importers: importers,
    alert_color: alert_color,
    alert_ascii: alert_ascii,
    logger: logger,
    quiet_deps: quiet_deps,
    verbose: verbose
  )
end

#info ⇒ String

Returns Information about the Sass implementation.

See Also:



238
239
240
 
# File 'lib/sass/embedded.rb', line 238

def info
  @info ||= Host.new(@dispatcher).version_request
end