bibtex-ruby 2.0.12 → 2.1.0

data/Gemfile

@@ -5,19 +5,32 @@ gemspec
 gem 'rdf', '~>0.3'
 
 group :debug do
-	gem 'debugger', :platforms => [:mri_19]
-	gem 'ruby-debug', :platforms => [:mri_18]
-	gem 'rbx-trepanning', :platforms => [:rbx]
+	gem 'debugger', :require => false, :platforms => [:mri_19]
+	gem 'ruby-debug', :require => false, :platforms => [:mri_18]
 end
 
 group :test do
-	gem 'minitest', :platforms => [:ruby_18, :jruby, :rbx]
-  gem 'mynyml-redgreen', ['~>0.7']
-  gem 'autowatchr', ['~>0.1']
+	gem 'minitest'
+	gem 'minitest-colorize'
   gem 'cucumber', ['~>1.0']
+  gem 'unicode', :platforms => [:mri, :rbx, :mswin, :mingw]
+end
+
+group :extra do
+	gem 'rb-fsevent', :require => false if RUBY_PLATFORM =~ /darwin/i
+	gem 'guard-minitest'
+	gem 'guard-cucumber'
+	gem 'redcarpet'
 end
 
 group :profile do
 	gem 'ruby-prof', ['~>0.10'], :platforms => [:mri_19, :mri_19]
 	gem 'gnuplot', ['~>2.4']
-end
+	gem 'simplecov'
+end
+
+group :development do
+  gem 'rake'
+  gem 'racc'
+  gem 'yard'	
+end

data/Gemfile.lock

@@ -1,89 +1,98 @@
 PATH
   remote: .
   specs:
-    bibtex-ruby (2.0.12)
+    bibtex-ruby (2.1.0)
       latex-decode (>= 0.0.6)
       multi_json (~> 1.3)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.2.7)
-    autowatchr (0.1.5)
-      watchr
+    addressable (2.3.2)
     builder (3.0.0)
-    coderay (1.0.5)
     columnize (0.3.6)
-    cucumber (1.1.9)
+    cucumber (1.2.1)
       builder (>= 2.1.2)
-      diff-lcs (>= 1.1.2)
-      gherkin (~> 2.9.0)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.11.0)
       json (>= 1.4.6)
-      term-ansicolor (>= 1.0.6)
-    debugger (1.0.0)
+    debugger (1.2.0)
       columnize (>= 0.3.1)
-      debugger-linecache
-      debugger-ruby_core_source
-    debugger-linecache (1.0.1)
-      debugger-ruby_core_source
-    debugger-ruby_core_source (1.0.1)
+      debugger-linecache (~> 1.1.1)
+      debugger-ruby_core_source (~> 1.1.3)
+    debugger-linecache (1.1.2)
+      debugger-ruby_core_source (>= 1.1.1)
+    debugger-ruby_core_source (1.1.3)
     diff-lcs (1.1.3)
-    gherkin (2.9.0)
+    ffi (1.1.5)
+    gherkin (2.11.2)
       json (>= 1.4.6)
-    gherkin (2.9.0-java)
-      json (>= 1.4.6)
-    gnuplot (2.4.1)
-    json (1.6.5)
-    json (1.6.5-java)
+    gnuplot (2.5.0)
+    guard (1.3.2)
+      listen (>= 0.4.2)
+      thor (>= 0.14.6)
+    guard-cucumber (1.2.0)
+      cucumber (>= 1.2.0)
+      guard (>= 1.1.0)
+    guard-minitest (0.5.0)
+      guard (>= 0.4)
+    json (1.7.5)
     latex-decode (0.0.12)
       unicode (~> 0.4)
-    latex-decode (0.0.12-java)
     linecache (0.46)
       rbx-require-relative (> 0.0.4)
-    minitest (2.11.3)
+    listen (0.4.7)
+      rb-fchange (~> 0.0.5)
+      rb-fsevent (~> 0.9.1)
+      rb-inotify (~> 0.8.8)
+    minitest (2.12.1)
+    minitest-colorize (0.0.4)
+      minitest (~> 2.0)
     multi_json (1.3.6)
-    mynyml-redgreen (0.7.1)
-      term-ansicolor (>= 1.0.4)
     racc (1.4.8)
     rake (0.9.2.2)
-    rbx-linecache (1.3)
-      rbx-require-relative
+    rb-fchange (0.0.5)
+      ffi
+    rb-fsevent (0.9.1)
+    rb-inotify (0.8.8)
+      ffi (>= 0.5.0)
     rbx-require-relative (0.0.9)
-    rbx-trepanning (0.1.0)
-      coderay (>= 1.0)
-      columnize
-      rbx-linecache (~> 1.3)
-      rbx-require-relative (>= 0.0.4)
-    rdf (0.3.5.2)
+    rdf (0.3.8)
       addressable (>= 2.2.6)
-    rdoc (3.12)
-      json (~> 1.4)
+    redcarpet (2.1.1)
     ruby-debug (0.10.4)
       columnize (>= 0.1)
       ruby-debug-base (~> 0.10.4.0)
     ruby-debug-base (0.10.4)
       linecache (>= 0.3)
-    ruby-prof (0.10.8)
-    term-ansicolor (1.0.7)
-    unicode (0.4.2)
-    watchr (0.7)
+    ruby-prof (0.11.2)
+    simplecov (0.6.4)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    thor (0.16.0)
+    unicode (0.4.3)
+    yard (0.8.2.1)
 
 PLATFORMS
-  java
   ruby
 
 DEPENDENCIES
-  autowatchr (~> 0.1)
   bibtex-ruby!
   cucumber (~> 1.0)
   debugger
   gnuplot (~> 2.4)
+  guard-cucumber
+  guard-minitest
   minitest
-  mynyml-redgreen (~> 0.7)
-  racc (~> 1.4)
-  rake (~> 0.9)
-  rbx-trepanning
+  minitest-colorize
+  racc
+  rake
+  rb-fsevent
   rdf (~> 0.3)
-  rdoc (~> 3.9)
+  redcarpet
   ruby-debug
   ruby-prof (~> 0.10)
+  simplecov
+  unicode
+  yard

data/Guardfile

@@ -0,0 +1,20 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'cucumber' do
+  watch(%r{^features/.+\.feature$})
+  watch(%r{^features/support/.+$})          { 'features' }
+  watch(%r{^features/step_definitions/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'features' }
+end
+
+guard 'minitest' do
+  # with Minitest::Unit
+  watch(%r|^test/(.*)\/?test_(.*)\.rb|)
+  watch(%r|^lib/(.*)([^/]+)\.rb|)     { |m| "test/#{m[1]}test_#{m[2]}.rb" }
+  watch(%r|^test/helper\.rb|)    { 'test' }
+
+  # with Minitest::Spec
+  # watch(%r|^spec/(.*)_spec\.rb|)
+  # watch(%r|^lib/(.*)([^/]+)\.rb|)     { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  # watch(%r|^spec/spec_helper\.rb|)    { "spec" }
+end

data/History.txt

@@ -1,6 +1,9 @@
-2.0.11 / 2012-05-23
-===================
+2.1.0 / 2012-08-31
+==================
 
+* Improved query support
+* Use Travis-CI
+* Updated dependencies
 * Bug fixes and 1.8 compatibility (@RubenVerborgh)
 
 2.0.11 / 2012-05-23

data/Manifest

@@ -1,11 +1,11 @@
 Gemfile
 Gemfile.lock
+Guardfile
 History.txt
 LICENSE
 Manifest
 README.md
 Rakefile
-auto.watchr
 bibtex-ruby.gemspec
 examples
 examples/bib2html.rb

data/README.md

@@ -1,15 +1,15 @@
 BibTeX-Ruby
 ===========
+[![Build Status](https://secure.travis-ci.org/inukshuk/bibtex-ruby.png?branch=master)](http://travis-ci.org/inukshuk/bibtex-ruby)
 
 BibTeX-Ruby is the Rubyist's swiss-army-knife for all things BibTeX. It
-includes a parser for all common BibTeX objects (@string, @preamble,
-@comment and regular entries) and a sophisticated name parser that
-tokenizes correctly formatted names; BibTeX-Ruby recognizes BibTeX string
-replacements, joins values containing multiple strings or variables,
-supports cross-references, and decodes common LaTeX formatting
-instructions to unicode; if you are in a hurry, it also allows for easy
-export/conversion to formats such as YAML, JSON, CiteProc/CSL, and
-XML (BibTeXML).
+includes a parser for all common BibTeX objects (@string, @preamble, @comment
+and regular entries) and a sophisticated name parser that tokenizes correctly
+formatted names; BibTeX-Ruby recognizes BibTeX string replacements, joins
+values containing multiple strings or variables, supports cross-references,
+and decodes common LaTeX formatting instructions to unicode; if you are in a
+hurry, it also allows for easy export/conversion to formats such as YAML,
+JSON, CiteProc/CSL, XML (BibTeXML), and RDF (experimental).
 
 For a list of projects using BibTeX-Ruby, take a look at the
 [project wiki](https://github.com/inukshuk/bibtex-ruby/wiki/Projects-Using-BibTeX-Ruby).
@@ -17,7 +17,6 @@ For a list of projects using BibTeX-Ruby, take a look at the
 
 Quickstart
 ----------
-
 Install and load BibTeX-Ruby in an IRB session:
 
     $ [sudo] gem install bibtex-ruby
@@ -96,10 +95,8 @@ Save a bibliography to a file:
     #=> saves the bibliography in a new file
 
 
-
 Compatibility
 -------------
-
 The BibTeX-Ruby gem has been developed and tested on Ruby 1.8 and 1.9; it has
 been confirmed to work with JRuby, Rubinius, and REE, however, there have
 been repeated [issues](https://github.com/inukshuk/bibtex-ruby/issues)
@@ -107,18 +104,17 @@ been repeated [issues](https://github.com/inukshuk/bibtex-ruby/issues)
 implementation.
 
 
-
 Documentation
 -------------
-
 It is very easy to use BibTeX-Ruby. You can use the top level utility methods
-**BibTeX.open** and **BibTeX.parse** to open a '.bib' file or to parse a string
-containing BibTeX contents. By default, BibTeX-Ruby will discard all text outside
-of regular BibTeX elements; however, if you wish to include everything, simply add
-`:include => [:meta_content]` to your invocation of **BibTeX.open** or **BibTeX.parse**.
+**BibTeX.open** and **BibTeX.parse** to open a '.bib' file or to parse a
+string containing BibTeX contents. By default, BibTeX-Ruby will discard all
+text outside of regular BibTeX elements; however, if you wish to include
+everything, simply add `:include => [:meta_content]` to your invocation of
+**BibTeX.open** or **BibTeX.parse**.
 
-Once BibTeX-Ruby has parsed your '.bib' file, you can easily access individual entries.
-For example, if you set up your bibliography as follows:
+Once BibTeX-Ruby has parsed your '.bib' file, you can easily access individual
+entries. For example, if you set up your bibliography as follows:
 
     b = BibTeX.parse <<-END
     @book{pickaxe,
@@ -130,20 +126,23 @@ For example, if you set up your bibliography as follows:
       year = {2009}
     }
     END
-    
-You could easily access it, using the entry's key, 'pickaxe', like so: `b[:pickaxe]`;
-you also have easy access to individual fields, for example: `b[:pickaxe][:author]`.
-Alternatively, BibTeX-Ruby accepts ghost methods to conveniently access an entry's fields,
-similar to **ActiveRecord::Base**. Therefore, it is equally possible to access the
-'author' field above as `b[:pickaxe].author`.
 
-BibTeX-Ruby wraps all values of fields in an entry are wrapped in Value objects.
-This is necessary to transparently handle different types of values (e.g., strings,
-dates, names etc.). These Value objects are designed to be hardly discernible
-from regular Ruby strings, however, if you ever run into a problem with a field's
-value, simply convert it to a string by calling the `#to_s` method.
+You could easily access it, using the entry's key, 'pickaxe', like so:
+`b[:pickaxe]`; you also have easy access to individual fields, for example:
+`b[:pickaxe][:author]`. Alternatively, BibTeX-Ruby accepts ghost methods to
+conveniently access an entry's fields, similar to **ActiveRecord::Base**.
+Therefore, it is equally possible to access the 'author' field above as
+`b[:pickaxe].author`.
+
+BibTeX-Ruby wraps all values of fields in an entry are wrapped in Value
+objects. This is necessary to transparently handle different types of values
+(e.g., strings, dates, names etc.). These Value objects are designed to be
+hardly discernible from regular Ruby strings, however, if you ever run into a
+problem with a field's value, simply convert it to a string by calling the
+`#to_s` method.
 
-Instead of parsing strings you can also create BibTeX elements directly in Ruby:
+Instead of parsing strings you can also create BibTeX elements directly in
+Ruby:
 
     > bib = BibTeX::Bibliography.new
     
@@ -173,10 +172,11 @@ Or programmatically:
 
 ### Cross References
 
-From version 2.0, BibTeX-Ruby correctly resolves entry cross-references, which
-are commonly used for entries with type `inbook`, `incollection`, and
-`inproceedings`. When an entry has a valid citation key in the field `crossref`,
-BibTeX-Ruby will return any fields inherited from the parent entry:
+From version 2.0, BibTeX-Ruby correctly resolves entry cross-references,
+which are commonly used for entries with type `inbook`, `incollection`,
+and `inproceedings`. When an entry has a valid citation key in the field
+`crossref`, BibTeX-Ruby will return any fields inherited from the parent
+entry:
 
     > b = BibTeX.parse <<-END
     @inbook{fraassen_1989b,
@@ -298,12 +298,12 @@ A shorthand version for replacing all strings in a given bibliography is the
 
 ### Names
 
-Since version 1.3, BibTeX-Ruby features a name parser. You can use the top-level
-`BibTeX.names` utility to quickly parse individual name values. Alternatively,
-you can call `Bibliography.parse_names` to convert all name fields contained
-in the bibliography. When parsing BibTeX files, BibTeX-Ruby will automatically
-convert names; if you do not want the names to be parsed you can set the
-`:parse_names` parser option to false.
+Since version 1.3, BibTeX-Ruby features a name parser. You can use the
+top-level `BibTeX.names` utility to quickly parse individual name values.
+Alternatively, you can call `Bibliography.parse_names` to convert all name
+fields contained in the bibliography. When parsing BibTeX files, BibTeX-Ruby
+will automatically convert names; if you do not want the names to be parsed
+you can set the `:parse_names` parser option to false.
 
 Note that the string replacement and concatenation features described above
 are not supported for name objects; therefore, BibTeX-Ruby tries to replace
@@ -391,20 +391,20 @@ by passing the `:filter` option:
 Furthermore, BibTeX-Ruby allows you to export your bibliography for processing
 by other tools. Currently supported formats include YAML, JSON, and XML.
 
-Of course, you can also export your bibliography back to BibTeX; if you include
-`:meta_content', your export should be identical to the original '.bib' file,
-except for whitespace, blank lines and letter case (BibTeX-Ruby will downcase
-all keys).
+Of course, you can also export your bibliography back to BibTeX; if you
+include `:meta_content', your export should be identical to the original
+'.bib' file, except for whitespace, blank lines and letter case (BibTeX-Ruby
+will downcase all keys).
 
-In order to export your bibliography use **#to\_s**, **#to\_yaml**, **#to\_json**, or
-**#to\_xml**, respectively. For example, the following line constitutes a simple
-BibTeX to YAML converter:
+In order to export your bibliography use **#to\_s**, **#to\_yaml**,
+**#to\_json**, or **#to\_xml**, respectively. For example, the following line
+constitutes a simple BibTeX to YAML converter:
 
     >> BibTeX.open('example.bib').to_yaml
 
 Starting with version 2.0, BibTeX-Ruby's `#to_xml` exports your bibliography
 to the [BibTeXML](http//bibtexml.sf.net/) format. By passing the option
-`:extended => true` you can make use of the BibTeXML's extended  format which
+`:extended => true` you can make use of the BibTeXML's extended format which
 will return individual person elements and name tokens (provided you have
 successfully parsed the names of your bibliography).
 
@@ -448,21 +448,20 @@ and writes the following XML to standard out:
       </bibtex:entry>
     </bibtex:file>
 
-Look at the 'examples' directory for more elaborate examples of a BibTeX to YAML
-and a BibTeX to HTML converter using **#to_citeproc** to format a bibliography
-using [CSL](http://citationstyles.org/).
+Look at the 'examples' directory for more elaborate examples of a BibTeX to
+YAML and a BibTeX to HTML converter using **#to_citeproc** to format a
+bibliography using [CSL](http://citationstyles.org/).
 
 BibTeX-Ruby offers an API which lets you manipulate BibTeX objects (string
 replacement, name parsing etc.); however, sometimes you just want quick access
 to your bibliography's contents. In these cases the **to_hash** method is
-useful (use **to_a** if you are only interested in the bibliography's contents):
-it converts all objects into simple Ruby hashes made up of symbols
+useful (use **to_a** if you are only interested in the bibliography's
+contents): it converts all objects into simple Ruby hashes made up of symbols
 and strings. Furthermore, often you would like to control what sort of quotes
-are used in an export;
-therefore, all conversion methods accept an options hash which lets you define
-what quotes to use (note that BibTeX-Ruby will always use regular double
-quotes if a value consists of more than one token, because these tokens will
-be concatenated using BibTeX's '#' operator).
+are used in an export; therefore, all conversion methods accept an options
+hash which lets you define what quotes to use (note that BibTeX-Ruby will
+always use regular double quotes if a value consists of more than one token,
+because these tokens will be concatenated using BibTeX's '#' operator).
 
     >> BibTeX.parse(<<-END).to_a # implies: :quotes => ['{','}']
     @book{pickaxe,
@@ -496,7 +495,6 @@ quotes; therefore you can simply add the :quotes option with an empty string:
 
 The Parser
 ----------
-
 The BibTeX-Ruby parser is generated using the awesome
 [racc](http://i.loveruby.net/en/projects/racc/) parser generator. You can take
 look at the LALR grammar in the file
@@ -508,7 +506,6 @@ For more information about the BibTeX format and the parser's idiosyncrasies
 
 Contributing
 ------------
-
 The BibTeX-Ruby source code is
 [hosted on GitHub](http://github.com/inukshuk/bibtex-ruby/).
 You can check out a copy of the latest code using Git:
@@ -532,12 +529,11 @@ the bibtex-ruby directory):
 
     $ [sudo] gem install bundler
     $ [sudo] bundle install
-    $ bundle exec cucumber
-    $ bundle exec rake test
+    $ bundle exec rake
 
 To execute the test suite continuously while you're working run:
 
-    $ bundle exec watchr auto.watchr
+    $ bundle exec guard
 
 
 
@@ -546,9 +542,8 @@ Credits
 
 Copyright 2011-2012 [Sylvester Keil](http://sylvester.keil.or.at/).
 
-See the [contributor page on GitHub](https://github.com/inukshuk/bibtex-ruby/contributors)
-for a list of all the awesome developers who have made BibTeX-Ruby
-possible.
+Kudos to all [contributors](https://github.com/inukshuk/bibtex-ruby/contributors)
+who have made BibTeX-Ruby possible.
 
-This software is distributed under the terms and conditions of the GNU GPL. See
-LICENSE for details.
+This software is distributed under the terms and conditions of the GNU GPL.
+See LICENSE for details.