index.coffee

- Jump To … +
  browser.coffee cake.coffee coffeescript.coffee command.coffee grammar.coffee helpers.coffee index.coffee lexer.coffee nodes.coffee optparse.coffee register.coffee repl.coffee rewriter.coffee scope.litcoffee sourcemap.litcoffee

- # index.coffee

- ¶

  Node.js Implementation

      CoffeeScript  = require './coffeescript'
      fs            = require 'fs'
      vm            = require 'vm'
      path          = require 'path'

      helpers       = CoffeeScript.helpers
      compile       = CoffeeScript.compile

- ¶

  Compile and execute a string of CoffeeScript (on the server), correctly setting `__filename`, `__dirname`, and relative `require()`.

      CoffeeScript.run = (code, options = {}) ->
        mainModule = require.main

- ¶

  Set the filename.

        mainModule.filename = process.argv[1] =
          if options.filename then fs.realpathSync(options.filename) else '<anonymous>'

- ¶

  Clear the module cache.

        mainModule.moduleCache and= {}

- ¶

  Assign paths for node_modules loading

        dir = if options.filename?
          path.dirname fs.realpathSync options.filename
        else
          fs.realpathSync '.'
        mainModule.paths = require('module')._nodeModulePaths dir

- ¶

  Compile.

        if not helpers.isCoffee(mainModule.filename) or require.extensions
          answer = compile code, options
          code = answer.js ? answer

        mainModule._compile code, mainModule.filename

- ¶

  Compile and evaluate a string of CoffeeScript (in a Node.js-like environment). The CoffeeScript REPL uses this to run the input.

      CoffeeScript.eval = (code, options = {}) ->
        return unless code = code.trim()
        createContext = vm.Script.createContext ? vm.createContext

        isContext = vm.isContext ? (ctx) ->
          options.sandbox instanceof createContext().constructor

        if createContext
          if options.sandbox?
            if isContext options.sandbox
              sandbox = options.sandbox
            else
              sandbox = createContext()
              sandbox[k] = v for own k, v of options.sandbox
            sandbox.global = sandbox.root = sandbox.GLOBAL = sandbox
          else
            sandbox = global
          sandbox.__filename = options.filename || 'eval'
          sandbox.__dirname  = path.dirname sandbox.__filename

- ¶

  define module/require only if they chose not to specify their own

          unless sandbox isnt global or sandbox.module or sandbox.require
            Module = require 'module'
            sandbox.module  = _module  = new Module(options.modulename || 'eval')
            sandbox.require = _require = (path) ->  Module._load path, _module, true
            _module.filename = sandbox.__filename
            for r in Object.getOwnPropertyNames require when r not in ['paths', 'arguments', 'caller']
              _require[r] = require[r]

- ¶

  use the same hack node currently uses for their own REPL

            _require.paths = _module.paths = Module._nodeModulePaths process.cwd()
            _require.resolve = (request) -> Module._resolveFilename request, _module
        o = {}
        o[k] = v for own k, v of options
        o.bare = on # ensure return value
        js = compile code, o
        if sandbox is global
          vm.runInThisContext js
        else
          vm.runInContext js, sandbox

      CoffeeScript.register = -> require './register'

- ¶

  Throw error with deprecation warning when depending upon implicit `require.extensions` registration

      if require.extensions
        for ext in CoffeeScript.FILE_EXTENSIONS then do (ext) ->
          require.extensions[ext] ?= ->
            throw new Error """
            Use CoffeeScript.register() or require the coffeescript/register module to require #{ext} files.
            """

      CoffeeScript._compileFile = (filename, sourceMap = no, inlineMap = no) ->
        raw = fs.readFileSync filename, 'utf8'

- ¶

  Strip the Unicode byte order mark, if this file begins with one.

        stripped = if raw.charCodeAt(0) is 0xFEFF then raw.substring 1 else raw

        try
          answer = compile stripped, {
            filename, sourceMap, inlineMap
            sourceFiles: [filename]
            literate: helpers.isLiterate filename
          }
        catch err

- ¶

  As the filename and code of a dynamically loaded file will be different from the original file compiled with CoffeeScript.run, add that information to error so it can be pretty-printed later.

          throw helpers.updateSyntaxError err, stripped, filename

        answer

      module.exports = CoffeeScript