sourcemap 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b4a81026175f484ceb522205f323e81f4a70557
+  data.tar.gz: ab163856d4087ae34952f1bc5a6d543789acdfa2
+SHA512:
+  metadata.gz: 79a8c966756ef258e67acebd246ce3f10f340428785b502387161599406dc7cacb183fec9e546b59ad34b30248fa6a01371e42f1750b24500c1673ae3fad022a
+  data.tar.gz: 370b5fb6762a23d60419a38651cf6f9166a51d08b43091e57a61020821b1d52680a896a7e1e1ef4cc24f6cb15c67d7fe66a34de13c6bb4813be40a859bbc3399

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+  - 1.9.3
+  - 2.0.0
+
+notifications:
+  email: false

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Alex MacCaw, Joshua Peek
+
+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,173 @@
+# Ruby Source Maps
+
+A Ruby library to read, create and manipulate Source Maps.
+
+[Source Maps](http://www.html5rocks.com/en/tutorials/developertools/sourcemaps/) allow easy debugging and development of CoffeeScript and minifed JavaScript.
+
+# Installation
+
+    gem install sourcemap
+    # or Bundler:
+    gem 'sourcemap'
+
+# Usage
+
+## Concatenation
+
+Join multiple source maps together.
+
+``` ruby
+foo = File.read("examples/foo.js")
+bar = File.read("examples/bar.js")
+foobar = foo + bar
+
+foo_map = SourceMap::Map.from_json File.read("examples/foo.map")
+bar_map = SourceMap::Map.from_json File.read("examples/bar.map")
+foobar_map = foo_map + bar_map
+foobar_map.to_json
+```
+
+## Piping
+
+Base one source map of another.
+
+``` ruby
+cs_map = SourceMap::Map.from_json File.read("examples/index.map")
+min_map = SourceMap::Map.from_json File.read("examples/index.min.map")
+combined_map = cs_map + min_map
+combined_map.to_json
+```
+
+## Map
+
+### Map.from_json(json)
+
+Create a new `Map` instance from a JSON map string.
+
+    SourceMap::Map.from_json(%{
+      {
+        "version": 3,
+        "file": "index.js",
+        "sourceRoot": "",
+        "sources": [
+          "index.coffee"
+        ],
+        "names": [],
+        "mappings": ";AAAA;AAAA,MAAA,IAAA;;AAAA"
+      }
+    })
+
+### Map.from_hash(hash)
+
+Create a new `Map` instance from a hash.
+
+    hash = {
+      'version'   => 3,
+      'file'      => "script.min.js",
+      'lineCount' => 1,
+      'mappings'  => "AAEAA,QAASA,MAAK,EAAG,CACfC,OAAAC,IAAA,CAAY,eAAZ,CADe",
+      'sources'   => ["script.js"],
+      'names'     => ["hello", "console", "log"]
+    }
+    map = SourceMap::Map.from_hash(hash)
+
+### Map.new(mappings = [], filename = nil)
+
+Instantiate a `Map` instance, passing in an optional array of `Mapping`s and file name.
+
+    @mappings = SourceMap::Map.new([
+      SourceMap::Mapping.new('a.js', SourceMap::Offset.new(0, 0), SourceMap::Offset.new(0, 0)),
+      SourceMap::Mapping.new('b.js', SourceMap::Offset.new(1, 0), SourceMap::Offset.new(20, 0)),
+      SourceMap::Mapping.new('c.js', SourceMap::Offset.new(2, 0), SourceMap::Offset.new(30, 0))
+    ])
+
+### Map#line_count
+
+Returns the line number of the last mapping.
+
+### Map#size
+
+Returns the amount of mappings
+
+### Map#[]
+
+Lookup a mapping by integer
+
+    map = SourceMap::Map.from_json(json)
+    map[5] #=> <Mapping>
+
+### Map#each
+
+Iterate over each mapping.
+
+### Map#to_s
+
+Returns a VLQ representation of the source map.
+
+    mapping = SourceMap::Map.from_hash(hash)
+    mappings.to_s #=> "ACmBA;ACUA"
+
+### Map#sources
+
+Returns an array of the original file names referenced in each mapping.
+
+### Map#names
+
+Returns an array of 'names', which are referenced in the mappings (in case the original source file is not available).
+
+### Map#+
+
+Concatenates Maps together, so you can serve mappings from multiple sources as one combined map.
+
+    foo_map = SourceMap::Map.from_json File.read("examples/foo.map")
+    bar_map = SourceMap::Map.from_json File.read("examples/bar.map")
+    foobar_map = foo_map + bar_map
+    foobar_map.to_json
+
+### Map#|
+
+Pipes map files together, so for example you could pipe a CoffeeScript map of `index.coffee` and an uglifier map of `index.js` together. In other words, one mapping will be based of the other.
+
+    coffeescript_map = SourceMap::Map.from_json(cs_map_json)
+    uglifier_map = SourceMap::Map.from_json(min_map_json)
+
+    combined_map = coffeescript_map | uglifier_map
+
+### Map#bsearch(offset)
+
+Find the closest generated mapping to any given offset using a binary tree search.
+
+    foo_map = SourceMap::Map.from_json File.read("examples/foo.map")
+    foo_map.bsearch(SourceMap::Offset.new(1,1)) #=> <Mapping>
+
+The method will return `nil` if an offset can't be found.
+
+### Map#as_json
+
+Convert a `Map` instance back to JSON.
+
+    map = Map.new([
+      Mapping.new('a.js', Offset.new(0, 0), Offset.new(0, 0)),
+      Mapping.new('b.js', Offset.new(1, 0), Offset.new(20, 0)),
+      Mapping.new('c.js', Offset.new(2, 0), Offset.new(30, 0))
+    ])
+
+    map.to_json #=> "{...}"
+
+## Offset
+
+### Offset.new(line, column)
+
+Instantiate an `Offset`, passing in a line and column integer.
+
+### Offset#+
+
+Add two offsets together.
+
+### Offset#<=>
+
+Compare the position of two offsets, first the line than the column.
+
+## Offset#to_s
+
+Get a pretty representation of an offset.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.warning = true
+end

data/examples/bar.coffee

@@ -0,0 +1,10 @@
+# Eat lunch.
+eat food for food in ['toast', 'cheese', 'wine']
+
+# Fine five course dining.
+courses = ['greens', 'caviar', 'truffles', 'roast', 'cake']
+menu i + 1, dish for dish, i in courses
+
+# Health conscious meal.
+foods = ['broccoli', 'spinach', 'chocolate']
+eat food for food in foods when food isnt 'chocolate'

data/examples/bar.js

@@ -0,0 +1,27 @@
+// Generated by CoffeeScript 1.6.3
+(function() {
+  var courses, dish, food, foods, i, _i, _j, _k, _len, _len1, _len2, _ref;
+
+  _ref = ['toast', 'cheese', 'wine'];
+  for (_i = 0, _len = _ref.length; _i < _len; _i++) {
+    food = _ref[_i];
+    eat(food);
+  }
+
+  courses = ['greens', 'caviar', 'truffles', 'roast', 'cake'];
+
+  for (i = _j = 0, _len1 = courses.length; _j < _len1; i = ++_j) {
+    dish = courses[i];
+    menu(i + 1, dish);
+  }
+
+  foods = ['broccoli', 'spinach', 'chocolate'];
+
+  for (_k = 0, _len2 = foods.length; _k < _len2; _k++) {
+    food = foods[_k];
+    if (food !== 'chocolate') {
+      eat(food);
+    }
+  }
+
+}).call(this);

data/examples/bar.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "file": "bar.js",
+  "sourceRoot": "",
+  "sources": [
+    "bar.coffee"
+  ],
+  "names": [],
+  "mappings": ";AACA;CAAA,KAAA,6DAAA;;CAAA;CAAA,MAAA,oCAAA;qBAAA;CAAA,EAAA,CAAA;CAAA,EAAA;;CAAA,CAGA,CAAU,GAAA,CAAV,CAAU,EAAA;;AACV,CAAA,MAAA,iDAAA;uBAAA;CAAA,CAAY,CAAH,CAAT;CAAA,EAJA;;CAAA,CAOA,CAAQ,EAAR,IAAQ,CAAA,CAAA;;AACR,CAAA,MAAA,uCAAA;sBAAA;IAAgC,CAAU;CAA1C,EAAA,CAAA,EAAA;MAAA;CAAA,EARA;CAAA"
+}

data/examples/foo.coffee

@@ -0,0 +1,28 @@
+# Assignment:
+number   = 42
+opposite = true
+
+# Conditions:
+number = -42 if opposite
+
+# Functions:
+square = (x) -> x * x
+
+# Arrays:
+list = [1, 2, 3, 4, 5]
+
+# Objects:
+math =
+  root:   Math.sqrt
+  square: square
+  cube:   (x) -> x * square x
+
+# Splats:
+race = (winner, runners...) ->
+  print winner, runners
+
+# Existence:
+alert "I knew it!" if elvis?
+
+# Array comprehensions:
+cubes = (math.cube num for num in list)

data/examples/foo.js

@@ -0,0 +1,48 @@
+// Generated by CoffeeScript 1.6.3
+(function() {
+  var cubes, list, math, num, number, opposite, race, square,
+    __slice = [].slice;
+
+  number = 42;
+
+  opposite = true;
+
+  if (opposite) {
+    number = -42;
+  }
+
+  square = function(x) {
+    return x * x;
+  };
+
+  list = [1, 2, 3, 4, 5];
+
+  math = {
+    root: Math.sqrt,
+    square: square,
+    cube: function(x) {
+      return x * square(x);
+    }
+  };
+
+  race = function() {
+    var runners, winner;
+    winner = arguments[0], runners = 2 <= arguments.length ? __slice.call(arguments, 1) : [];
+    return print(winner, runners);
+  };
+
+  if (typeof elvis !== "undefined" && elvis !== null) {
+    alert("I knew it!");
+  }
+
+  cubes = (function() {
+    var _i, _len, _results;
+    _results = [];
+    for (_i = 0, _len = list.length; _i < _len; _i++) {
+      num = list[_i];
+      _results.push(math.cube(num));
+    }
+    return _results;
+  })();
+
+}).call(this);

data/examples/foo.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "file": "foo.js",
+  "sourceRoot": "",
+  "sources": [
+    "foo.coffee"
+  ],
+  "names": [],
+  "mappings": ";AACA;CAAA,KAAA,gDAAA;KAAA,aAAA;;CAAA,CAAA,CAAW,GAAX;;CAAA,CACA,CAAW,CADX,IACA;;CAGA,CAAA,EAAgB,IAAhB;AAAU,CAAV,CAAA,CAAS,CAAT,EAAA;IAJA;;CAAA,CAOA,CAAS,GAAT,GAAU;CAAM,EAAI,QAAJ;CAPhB,EAOS;;CAPT,CAUA,CAAO,CAAP;;CAVA,CAaA,CACE,CADF;CACE,CAAQ,EAAR;CAAA,CACQ,EAAR,EAAA;CADA,CAEQ,CAAA,CAAR,KAAS;CAAM,EAAI,GAAA,OAAJ;CAFf,IAEQ;CAhBV,GAAA;;CAAA,CAmBA,CAAO,CAAP,KAAO;CACL,OAAA,OAAA;CAAA,CADc,EAAR,mDACN;CAAM,CAAQ,GAAd,CAAA,CAAA,IAAA;CApBF,EAmBO;;CAIP,CAAA,EAAsB,0CAAtB;CAAA,GAAA,CAAA,OAAA;IAvBA;;CAAA,CA0BA,GAAA;;AAAS,CAAA;UAAA,iCAAA;sBAAA;CAAA,EAAA,CAAI;CAAJ;;CA1BT;CAAA"
+}

data/examples/foo.min.js

@@ -0,0 +1,2 @@
+!function(){var cubes,list,math,num,number,opposite,race,square,__slice=[].slice;number=42;opposite=true;if(opposite){number=-42}square=function(x){return x*x};list=[1,2,3,4,5];math={root:Math.sqrt,square:square,cube:function(x){return x*square(x)}};race=function(){var runners,winner;winner=arguments[0],runners=2<=arguments.length?__slice.call(arguments,1):[];return print(winner,runners)};if(typeof elvis!=="undefined"&&elvis!==null){alert("I knew it!")}cubes=function(){var _i,_len,_results;_results=[];for(_i=0,_len=list.length;_i<_len;_i++){num=list[_i];_results.push(math.cube(num))}return _results}()}.call(this);
+//@ sourceMappingURL=foo.min.map

data/examples/foo.min.map

@@ -0,0 +1 @@
+{"version":3,"sources":["foo.js"],"names":["cubes","list","math","num","number","opposite","race","square","__slice","slice","x","root","Math","sqrt","cube","runners","winner","arguments","length","call","print","elvis","alert","_i","_len","_results","push","this"],"mappings":"CACA,WACE,GAAIA,OAAOC,KAAMC,KAAMC,IAAKC,OAAQC,SAAUC,KAAMC,OAClDC,WAAaC,KAEfL,QAAS,EAETC,UAAW,IAEX,IAAIA,SAAU,CACZD,QAAU,GAGZG,OAAS,SAASG,GAChB,MAAOA,GAAIA,EAGbT,OAAQ,EAAG,EAAG,EAAG,EAAG,EAEpBC,OACES,KAAMC,KAAKC,KACXN,OAAQA,OACRO,KAAM,SAASJ,GACb,MAAOA,GAAIH,OAAOG,IAItBJ,MAAO,WACL,GAAIS,SAASC,MACbA,QAASC,UAAU,GAAIF,QAAU,GAAKE,UAAUC,OAASV,QAAQW,KAAKF,UAAW,KACjF,OAAOG,OAAMJ,OAAQD,SAGvB,UAAWM,SAAU,aAAeA,QAAU,KAAM,CAClDC,MAAM,cAGRtB,MAAQ,WACN,GAAIuB,IAAIC,KAAMC,QACdA,YACA,KAAKF,GAAK,EAAGC,KAAOvB,KAAKiB,OAAQK,GAAKC,KAAMD,KAAM,CAChDpB,IAAMF,KAAKsB,GACXE,UAASC,KAAKxB,KAAKY,KAAKX,MAE1B,MAAOsB,cAGRN,KAAKQ"}

data/examples/foobar.html

@@ -0,0 +1,6 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <script type="text/javascript" src="foobar.js"></script>
+</head>
+</html>

data/examples/foobar.js

@@ -0,0 +1,77 @@
+// Generated by CoffeeScript 1.6.3
+(function() {
+  var cubes, list, math, num, number, opposite, race, square,
+    __slice = [].slice;
+
+  number = 42;
+
+  opposite = true;
+
+  if (opposite) {
+    number = -42;
+  }
+
+  square = function(x) {
+    return x * x;
+  };
+
+  list = [1, 2, 3, 4, 5];
+
+  math = {
+    root: Math.sqrt,
+    square: square,
+    cube: function(x) {
+      return x * square(x);
+    }
+  };
+
+  race = function() {
+    var runners, winner;
+    winner = arguments[0], runners = 2 <= arguments.length ? __slice.call(arguments, 1) : [];
+    return print(winner, runners);
+  };
+
+  if (typeof elvis !== "undefined" && elvis !== null) {
+    alert("I knew it!");
+  }
+
+  cubes = (function() {
+    var _i, _len, _results;
+    _results = [];
+    for (_i = 0, _len = list.length; _i < _len; _i++) {
+      num = list[_i];
+      _results.push(math.cube(num));
+    }
+    return _results;
+  })();
+
+}).call(this);
+// Generated by CoffeeScript 1.6.3
+(function() {
+  var courses, dish, food, foods, i, _i, _j, _k, _len, _len1, _len2, _ref;
+
+  _ref = ['toast', 'cheese', 'wine'];
+  for (_i = 0, _len = _ref.length; _i < _len; _i++) {
+    food = _ref[_i];
+    eat(food);
+  }
+
+  courses = ['greens', 'caviar', 'truffles', 'roast', 'cake'];
+
+  for (i = _j = 0, _len1 = courses.length; _j < _len1; i = ++_j) {
+    dish = courses[i];
+    menu(i + 1, dish);
+  }
+
+  foods = ['broccoli', 'spinach', 'chocolate'];
+
+  for (_k = 0, _len2 = foods.length; _k < _len2; _k++) {
+    food = foods[_k];
+    if (food !== 'chocolate') {
+      eat(food);
+    }
+  }
+
+}).call(this);
+
+//@ sourceMappingURL=foobar.map