asciidoctor-bibliography 0.0.1.dev → 0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 864d555fbe79431ffb94b5124072822f100119a7
-  data.tar.gz: e6c24a670ebf6b0ee35db0abd0829a33d74b0d48
+  metadata.gz: 24be1ddb4ec69d1ffabf68e2fc7cf1c628be6130
+  data.tar.gz: b0abf289da6967d4da9e1aeb75acfadc3a4a5f24
 SHA512:
-  metadata.gz: ca771ffe5c26c93f734adf5378a952708f231206562d840719a2271f30b9cd9445b1c93e497696cb4e8688d2d05ff0f24c60a975764ddab2a6ca972f713ee049
-  data.tar.gz: 88a2f80a67c5e7fe03aeacd2a0e25c4cb8a251a2226d6be0b3cb5a57b955ea7972b7fa46337290872da18fba888071d5ca1edff08a1b413938c1a9b8f5ebb119
+  metadata.gz: a46db6e6d83b1faa86df2d69d521a7f1810e0f7bd53ee6abe339328c425aff40b7fe9f804c94fe6fb6d93a5afc19f241311e79caf333fce6fcc12cd5f4a610dc
+  data.tar.gz: dc999d205e2c1d919489ba773eb37ea42253eb4b922e40a9abca0109e76ded8e8446cfe9276959ab92c1dffd8831fb81e610fa425a5910a8f2ae1919769ec52f

data/.gitignore

@@ -42,7 +42,7 @@ build-iPhoneSimulator/
 
 # for a library or gem, you might want to ignore these files since the code is
 # intended to run in multiple environments; otherwise, check them in:
-# Gemfile.lock
+Gemfile.lock
 .ruby-version
 .ruby-gemset
 

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  -  2.4.0

data/Gemfile

@@ -1,21 +1,3 @@
 source "https://rubygems.org"
 
-git_source(:github) {|repo_name| "https://github.com/riboseinc/asciidoctor-bibliography" }
-
 gemspec
-
-# gem 'asciidoctor'
-
-# gem 'bibtex-ruby'
-# gem 'latex-decode'
-
-# gem 'byebug'
-
-# gem 'citeproc-ruby'
-# gem 'csl-styles'
-
-
-# s.add_runtime_dependency('bibliography-ruby', "~> 4")
-# s.add_runtime_dependency('citeproc-ruby')
-# s.add_runtime_dependency('csl-styles', '~> 1')
-# s.add_runtime_dependency('latex-decode', '~> 0.2')

data/README.adoc

@@ -21,25 +21,66 @@ gem "asciidoctor-bibliography"
 
 And then execute:
 
-[source,sh]
+[source,console]
 ----
 $ bundle install
 ----
 
 Or install it yourself as:
 
-[source,sh]
+[source,console]
 ----
 $ gem install asciidoctor-bibliography
 ----
 
 == Configure
 
-TODO
+In your document header, define the following below the title.
+
+----
+= Latex Macros In Bibtex Items
+:bibliography-database: first.bib
+:bibliography-database: second.bib
+:bibliography-reference-style: ieee
+----
 
 == Usage
 
-TODO
+Include asciidoctor-bibliography in your chain:
+
+[source,console]
+----
+$ asciidoctor -r asciidoctor-bibliography main.adoc
+----
+
+Add citation commands within your AsciiDoc:
+
+----
+Searching Function (see cite:guo2009[])
+----
+
+List out bibliography:
+
+----
+bibliography::[]
+----
+
+== Example
+
+----
+= Latex Macros In Bibtex Items
+:bibliography-database: reference.bib
+:bibliography-reference-style: ieee
+
+== Contents
+
+This is a paper "Validation and Verificaton of Computer Forensic Software
+tools -- Searching Function" (see cite:guo2009[]).
+
+== Bibliography
+
+bibliography::[]
+----
 
 == Development
 

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/asciidoctor-bibliography.gemspec

@@ -26,12 +26,15 @@ END
   spec.test_files    = `git ls-files -- {spec}/*`.split("\n")
   spec.required_ruby_version = Gem::Requirement.new(">= 2.0.0")
 
-  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_dependency "asciidoctor"
+  spec.add_dependency "citeproc-ruby"
+  spec.add_dependency "csl-styles", "~> 1"
+  spec.add_dependency "latex-decode", "~> 0.2"
+  spec.add_dependency "bibtex-ruby"
 
-  spec.add_development_dependency "asciidoctor"
-  spec.add_development_dependency "bibtex-ruby"
+  spec.add_development_dependency "bundler", "~> 1.14"
   spec.add_development_dependency "byebug"
-  spec.add_development_dependency "citeproc-ruby"
-  spec.add_development_dependency "csl-styles"
-  spec.add_development_dependency "latex-decode"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "simplecov"
 end

data/lib/asciidoctor-bibliography.rb

@@ -1,3 +1,3 @@
-require 'byebug'
+# require 'byebug' if Gem.gem("byebug")
 
 require_relative 'asciidoctor-bibliography/asciidoctor'

data/lib/asciidoctor-bibliography/asciidoctor/bibliographer_preprocessor.rb

@@ -11,15 +11,7 @@ module AsciidoctorBibliography
   module Asciidoctor
     class BibliographerPreprocessor < ::Asciidoctor::Extensions::Preprocessor
       def process document, reader
-
-        # We peek at the document attributes we need, without perturbing the parsing flow.
-        # NOTE: we're in a preprocessor and they haven't been parsed yet; doing it manually.
-        document_attributes =
-          ::Asciidoctor::Parser
-            .parse(reader, ::Asciidoctor::Document.new, header_only: true)
-            .attributes
-        # We extract only the ones we recognize.
-        document.bibliographer.options = Hash[Helpers.slice(document_attributes, 'bibliography-citation-style', 'bibliography-order', 'bibliography-reference-style', 'bibliography-database').map {|k, v| [k.sub(/^bibliography-/, ''), v] }]
+        set_bibliographer_options(document, reader)
 
         # We're handling single database/formatters; generalization will be straightforward when needed.
         document.bibliographer.database = Database.new(document.bibliographer.options['database'])
@@ -63,6 +55,18 @@ module AsciidoctorBibliography
         processed_lines.flatten!
         reader = ::Asciidoctor::Reader.new processed_lines
       end
+
+      private
+
+      def set_bibliographer_options(document, reader)
+        # We peek at the document attributes we need, without perturbing the parsing flow.
+        # NOTE: we're in a preprocessor and they haven't been parsed yet; doing it manually.
+        document_attributes =
+          ::Asciidoctor::Parser
+            .parse(reader, ::Asciidoctor::Document.new, header_only: true)
+            .attributes
+        document.bibliographer.options = Hash[Helpers.slice(document_attributes, 'bibliography-citation-style', 'bibliography-order', 'bibliography-reference-style', 'bibliography-database').map {|k, v| [k.sub(/^bibliography-/, ''), v] }]
+      end
     end
   end
 end

data/lib/asciidoctor-bibliography/citation.rb

@@ -5,6 +5,7 @@ module AsciidoctorBibliography
   class Citation
     TEX_MACROS_NAMES = Formatters::TeX::MACROS.keys.map { |s| Regexp.escape s }.concat(['fullcite']).join('|')
     REGEXP = /\\?(#{TEX_MACROS_NAMES}):(?:(\S*?)?\[(|.*?[^\\])\])(?:\+(\S*?)?\[(|.*?[^\\])\])*/
+    REF_ATTRIBUTES = %i[chapter page section clause]
 
     # No need for a fully fledged class right now.
     Cite = Struct.new(:key, :occurrence_index, :target, :positional_attributes, :named_attributes)
@@ -33,10 +34,19 @@ module AsciidoctorBibliography
 
     def render(bibliographer)
       if macro == 'fullcite'
-        # NOTE: we reinstantiate to avoid tracking used keys.
         formatter = Formatters::CSL.new(bibliographer.options['reference-style'])
-        formatter.import bibliographer.database
+
+        # NOTE: being able to overwrite a more general family of attributes would be neat.
+        mergeable_attributes = Helpers.slice(cites.first.named_attributes || {}, *(REF_ATTRIBUTES.map(&:to_s)))
+
+        # reject empty values
+        mergeable_attributes.reject! do |key, value|
+          value.nil? || value.empty?
+        end
         # TODO: as is, cites other than the first are simply ignored.
+        database_entry = bibliographer.database.find { |e| e['id'] == cites.first.key }
+        database_entry.merge!(mergeable_attributes)
+        formatter.import([database_entry])
         '{empty}' + Helpers.html_to_asciidoc(formatter.render(:bibliography, id: cites.first.key).join)
       elsif Formatters::TeX::MACROS.keys.include? macro
         bibliographer.citation_formatter.render(self)

data/lib/asciidoctor-bibliography/formatters/tex.rb

@@ -114,23 +114,49 @@ module AsciidoctorBibliography
         [@opening_bracket, string, @closing_bracket].compact.join
       end
 
+      def find_entry(key)
+        entry = @database.find{ |h| h['id'] == key }
+        if entry.nil?
+          raise StandardError, "Can't find entry: #{key}"
+        end
+        entry
+      end
+
       def year(cite)
-        issued = @database.find{ |h| h['id'] == cite.key }['issued']['date-parts']
-        return "" if issued.nil?
-        return "" if issued.first.nil?
-        issued.first.first
+        entry = find_entry(cite.key)
+        issued = entry['issued']
+
+        if issued.nil?
+          puts "asciidoctor-bibliography: citation (#{cite.key}) has no 'issued' information"
+          return ""
+        end
+
+        date_parts = issued['date-parts']
+        return "" if date_parts.nil?
+
+        return "" if date_parts.first.nil?
+        date_parts.first.first
       end
 
       def extra(cite)
         na = cite.named_attributes
         extra = []
         return extra if na.nil?
-        # TODO: should this be configurable?
-        extra << "Chapter #{na['chapter']}" unless na['chapter'].nil?
-        extra << "Page #{na['page']}" unless na['page'].nil?
+
+        Citation::REF_ATTRIBUTES.each do |sym|
+          next if na[sym.to_s].nil?
+          extra << ref_content(sym, na[sym.to_s])
+        end
+
         extra
       end
 
+      # TODO: should this be configurable?
+      # TODO RT: Yes, and i18n!
+      def ref_content(sym, content)
+        "#{sym.to_s.capitalize} #{content}"
+      end
+
       def authors(mode, cite)
         case mode
         when :full
@@ -143,7 +169,8 @@ module AsciidoctorBibliography
       end
 
       def authors_list(cite)
-        authors = @database.find{ |h| h['id'] == cite.key }['author']
+        entry = find_entry(cite.key)
+        authors = entry['author']
         return [] if authors.nil?
         authors.map{ |h| h['family'] }.compact
       end

data/lib/asciidoctor-bibliography/helpers.rb

@@ -14,6 +14,7 @@ module AsciidoctorBibliography
         .gsub(/<\/?b>/, '*')
         .gsub(/<\/?span.*?>/, '')
         .gsub(/\{|\}/, '')
+      # TODO: bracket dropping is inappropriate here.
     end
 
     # NOTE: mostly stolen from ActiveSupport.

data/lib/asciidoctor-bibliography/index.rb

@@ -15,14 +15,24 @@ module AsciidoctorBibliography
     end
 
     def render(bibliographer)
-      lines = []
+      unsorted_lines = []
       bibliographer.occurring_keys.each_with_index do |target, index|
         line = '{empty}'
         line << "[#{index + 1}] " if bibliographer.options['citation-style'] == 'numbers'
         line << render_entry(target, bibliographer.index_formatter)
-        lines << line
+        if bibliographer.options['order'] == 'alphabetical'
+          sortable_index = first_author_family_name(target, bibliographer)
+        elsif bibliographer.options['order'] == 'appearance'
+          sortable_index = index
+        else # defaults to appearance
+          sortable_index = index
+        end
+
+        unsorted_lines << { line: line, sortable_index: sortable_index }
       end
 
+      lines = unsorted_lines.sort_by { |l| l[:sortable_index] }.map { |l| l[:line] }
+
       # Intersperse the lines with empty ones to render as paragraphs.
       lines.join("\n\n").lines.map(&:strip)
     end
@@ -38,6 +48,14 @@ module AsciidoctorBibliography
     def render_entry(target, formatter)
       "anchor:#{render_entry_id(target)}[]#{render_entry_label(target, formatter)}"
     end
+
+    private
+
+    def first_author_family_name(key, bibliographer)
+      authors = bibliographer.database.find{ |h| h['id'] == key }['author']
+      return "" if authors.nil?
+      authors.map{ |h| h['family'] }.compact.first # TODO: is the first also alphabetically the first?
+    end
   end
 end
 

data/lib/asciidoctor-bibliography/version.rb

@@ -1,3 +1,3 @@
 module AsciidoctorBibliography
-  VERSION = '0.0.1.dev'
+  VERSION = '0.1'
 end

data/samples/sample-authoryear.adoc

@@ -18,6 +18,8 @@ cite:[Anderson04, page=10, chapter=12]
 
 fullcite:[Anderson04] (fullcite, single)
 
+fullcite:[Anderson04, page=123] (fullcite, single)
+
 citet:[Anderson04] (citet, single)
 
 citet:[Lane12a]+[Lane12b] (citet, multiple)

data/samples/sample-authoryear.html

@@ -453,6 +453,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <p>Anderson, J. R., D. Bothell, M. D. Byrne, S. Douglass, C. Lebiere, and Y. L. Qin. 2004. “An Integrated Theory of the Mind.” <em>Psychological Review</em> 111 (4): 1036–60. (fullcite, single)</p>
 </div>
 <div class="paragraph">
+<p>Anderson, J. R., D. Bothell, M. D. Byrne, S. Douglass, C. Lebiere, and Y. L. Qin. 2004. “An Integrated Theory of the Mind.” <em>Psychological Review</em> 111 (4): 123. (fullcite, single)</p>
+</div>
+<div class="paragraph">
 <p><a href="#bibliography-Anderson04">Anderson et al. (2004)</a> (citet, single)</p>
 </div>
 <div class="paragraph">
@@ -543,7 +546,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2017-08-20 21:01:42 CEST
+Last updated 2017-08-22 23:24:34 CEST
 </div>
 </div>
 </body>

data/spec/helpers_spec.rb

@@ -0,0 +1,71 @@
+require 'asciidoctor-bibliography/helpers'
+
+describe AsciidoctorBibliography::Helpers do
+  describe '.slice' do
+    it 'finds one or more existing keys' do
+      expect(subject.slice({ foo: 'bar', baz: 'qux' }, :foo)).to eq({ foo: 'bar' })
+      expect(subject.slice({ foo: 'bar', baz: 'qux' }, :foo, :baz)).to eq({ foo: 'bar', baz: 'qux' })
+    end
+
+    it 'returns nil for missing keys' do
+      expect(subject.slice({}, :foo)).to eq({ foo: nil })
+      expect(subject.slice({ foo: 'bar' }, :bar)).to eq({ bar: nil })
+      expect(subject.slice({ foo: 'bar' }, :foo, :baz)).to eq({ foo: 'bar', baz: nil })
+    end
+  end
+
+  describe '.join_nonempty' do
+    it 'ignores nils' do
+      expect(subject.join_nonempty([nil], '-')).to eq('')
+      expect(subject.join_nonempty(['foo', nil], '-')).to eq('foo')
+      expect(subject.join_nonempty([nil, 'bar'], '-')).to eq('bar')
+      expect(subject.join_nonempty(['foo', nil, 'bar'], '-')).to eq('foo-bar')
+    end
+
+    it 'ignores empty strings' do
+      expect(subject.join_nonempty([''], '-')).to eq('')
+      expect(subject.join_nonempty(['foo', ''], '-')).to eq('foo')
+      expect(subject.join_nonempty(['', 'bar'], '-')).to eq('bar')
+      expect(subject.join_nonempty(['foo', '', 'bar'], '-')).to eq('foo-bar')
+    end
+  end
+
+  describe '.html_to_asciidoc' do
+    it 'converts italic' do
+      expect(subject.html_to_asciidoc('This is <i>italic</i>.')).to eq('This is _italic_.')
+    end
+
+    it 'converts bold' do
+      expect(subject.html_to_asciidoc('This is <b>bold</b>.')).to eq('This is *bold*.')
+    end
+
+    it 'drops spans' do
+      expect(subject.html_to_asciidoc('This is a <span attribute="value">span</span>.'))
+        .to eq('This is a span.')
+    end
+
+    it 'drops curly brackets' do
+      expect(subject.html_to_asciidoc('This is {bracketed}.'))
+        .to eq('This is bracketed.')
+    end
+  end
+
+  describe '.to_sentence' do
+    let(:new_options) { { words_connector:     '1',
+                          two_words_connector: '2',
+                          last_word_connector: '3' } }
+
+    it 'concatenates arbitrary arrays' do
+      expect(subject.to_sentence([])).to eq('')
+      expect(subject.to_sentence(['foo'])).to eq('foo')
+      expect(subject.to_sentence(['foo', 'bar'])).to eq('foo and bar')
+      expect(subject.to_sentence(['foo', 'bar', 'baz'])).to eq('foo, bar, and baz')
+      expect(subject.to_sentence(['foo', 'bar', 'baz', 'qux'])).to eq('foo, bar, baz, and qux')
+    end
+
+    it 'accepts custom separators' do
+      expect(subject.to_sentence(['foo', 'bar'], new_options)).to eq('foo2bar')
+      expect(subject.to_sentence(['foo', 'bar', 'baz'], new_options)).to eq('foo1bar3baz')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,107 @@
+require 'simplecov'
+SimpleCov.start do
+  add_filter "/spec/"
+end
+
+require 'asciidoctor-bibliography'
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # This allows you to limit a spec run to individual examples or groups
+  # you care about by tagging them with `:focus` metadata. When nothing
+  # is tagged with `:focus`, all examples get run. RSpec also provides
+  # aliases for `it`, `describe`, and `context` that include `:focus`
+  # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = "doc"
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

metadata

@@ -1,43 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-bibliography
 version: !ruby/object:Gem::Version
-  version: 0.0.1.dev
+  version: '0.1'
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-20 00:00:00.000000000 Z
+date: 2017-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: asciidoctor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.14'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.14'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: asciidoctor
+  name: citeproc-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: csl-styles
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: latex-decode
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: bibtex-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -45,13 +73,27 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
 - !ruby/object:Gem::Dependency
   name: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -67,7 +109,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: citeproc-ruby
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +123,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: csl-styles
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +137,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: latex-decode
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -121,10 +163,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
+- ".travis.yml"
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.adoc
+- Rakefile
 - SYNTAX.adoc
 - asciidoctor-bibliography.gemspec
 - deprecated/asciidoctor-bibliography/asciidoctor/bibliographer_postprocessor.rb
@@ -152,7 +196,6 @@ files:
 - lib/asciidoctor-bibliography/helpers.rb
 - lib/asciidoctor-bibliography/index.rb
 - lib/asciidoctor-bibliography/version.rb
-- samples/.byebug_history
 - samples/biblio.bib
 - samples/latex_macros_in_bibtex/reference.bib
 - samples/latex_macros_in_bibtex/sample.adoc
@@ -160,6 +203,8 @@ files:
 - samples/sample-authoryear.html
 - samples/sample-numbers.adoc
 - samples/sample-numbers.html
+- spec/helpers_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/riboseinc/asciidoctor-bibliography
 licenses:
 - MIT
@@ -175,9 +220,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.5.2

data/Gemfile.lock

@@ -1,41 +0,0 @@
-PATH
-  remote: .
-  specs:
-    asciidoctor-bibliography (0.0.1.dev)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    asciidoctor (1.5.6.1)
-    bibtex-ruby (4.4.4)
-      latex-decode (~> 0.0)
-    byebug (9.0.6)
-    citeproc (1.0.5)
-      namae (~> 0.8)
-    citeproc-ruby (1.1.7)
-      citeproc (>= 1.0.4, < 2.0)
-      csl (~> 1.4)
-    csl (1.4.5)
-      namae (~> 0.7)
-    csl-styles (1.0.1.8)
-      csl (~> 1.0)
-    latex-decode (0.2.2)
-      unicode (~> 0.4)
-    namae (0.11.3)
-    unicode (0.4.4.4)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  asciidoctor
-  asciidoctor-bibliography!
-  bibtex-ruby
-  bundler (~> 1.14)
-  byebug
-  citeproc-ruby
-  csl-styles
-  latex-decode
-
-BUNDLED WITH
-   1.15.3

data/samples/.byebug_history

@@ -1,245 +0,0 @@
-c
-q
-puts processed_lines
-q
-puts processed_lines
-processed_lines
-q
-puts processed_lines.lines.map(&:chomp)
-processed_lines.lines.map(&:chomp)
-processed_lines.lines
-processed_lines
-q
-Helpers.html_to_asciidoc form
-form
-q
-document.bibliographer.options
-q
-Hash[document_attributes]
-ENV
-document_attributes
-document_attributes.to_hash
-document_attributes.to_h
-document_attributes
-q
-cites.first.key
-cites.first
-cites
-q
-self.macro
-self
-q
-output
-q
-@closing_bracket
-q
-bibpunct.scan(/{.*?}/)
-bibpunct.scan(/{*.?}/)
-puts bibpunct
-          bibpunct = '{[}{\\]}{,}{n}{,}{,}'
-bibpunct.length
-          bibpunct = '{[}{]}{,}{n}{,}{,}'
-bibpunct.length
-          bibpunct = '{[}{\\]}{,}{n}{,}{,}'
-bibpunct.scan(/{*.?}/)
-          bibpunct = '{[}{\\]}{,}{n}{,}{,}'
-'\'
-          bibpunct = '{[}{\]}{,}{n}{,}{,}'
-bibpunct.scan(/{*.?}/)
-          bibpunct = '{[}{\\]}{,}{n}{,}{,}'
-bibpunct.scan(/{*.?}/)
-          bibpunct = '{[}{\]}{,}{n}{,}{,}'
-bibpunct.scan(/{*.?}/)
-bibpunct.scan(/{*.?}/).map { |s| s[1..-2] }
-@closing_bracket
-q
-@closing_bracket
-@opening_bracket
-bracket "wot asd"
-bracket "wot"
-bracket(cetera)
-label
-citation.xref(cite.key, label)
-output
-q
-y
-rend
-q
-rend
-q
-rend
-q
-rend
-q
-rend
-q
-document.bibliographer.citations.last.cites.last.occurrence_index
-document.bibliographer.citations.last.cites.last
-document.bibliographer.citations.last.cites
-document.bibliographer.citations.last
-document.bibliographer.citations
-document.bibliographer
-q
-citations.first.cites.first
-citations.first.cites.first.target = "FOO"
-citations.first.cites.first.target
-citations.first.cites.first
-citations.first.cites
-citations.first
-citations
-q
-document.bibliographer.citations.first.uuid
-document.bibliographer.citations.first
-document.bibliographer.citations
-reader.lines.join("\n").lines.map(&:chomp)
-reader.lines.join("\n").lines
-reader.lines.join("\n")
-reader.lines
-reader
-reader.lines
-reader
-q
-reader.processed_lines
-reader.lines
-reader
-processed_lines.join("\n").lines
-processed_lines.join('\n').lines
-processed_lines.join('\n')
-processed_lines.join('"\n')
-processed_lines.join
-q
-processed_lines
-q
-bibliographer.cited_keys.index(cite.key)q
-bibliographer.cited_keys.index(cite.key)
-bibliographer.cited_keys
-bibliographer
-q
-document
-cite
-q
-cite.named_attributes || {}
-cite.named_attributes
-extra(cite)
-c
-cetera
-c
-cetera
-c
-cetera
-n
-c
-[year(cite)].concat(extra(cite)).join(@years_separator + ' ')
-[year(cite)].concat(extra(cite))
-q
-extra
-extr
-q
-cite.named_attributes['page']
-cite.named_attributes
-cite
-q
-y
-cq
-c
-q
-ct.key
-ct
-q
-ct
-n
-ct
-q
-ct[:attributes][:named]['pagea']
-ct[:attributes][:named]['page']
-ct[:attributes][:named]['page]
-ct[:attributes][:named]
-ct[:named]
-ct[:named]['page']
-ct
-q
-ct[:key]
-ct.key
-ct
-cite
-ct
-q
-document.bibliographer.citations
-q
-TeXFormatter::DEFAULTS
-TeXFormatter
-q
-@opening_bracket
-bibpunct
-q
-Citation::DEFAULTS[cite.macro][:type]
-q
-Citation::DEFAULTS['citet'][:type]
-Citation::DEFAULTS['citet'][:tyep]
-Citation::DEFAULTS['citet']
-Citation::DEFAULTS[cite.macro]
-Citation::DEFAULTS[cite.macro][:type]
-q
-continue
-Citation::DEFAULTS['citet']
-Citation::DEFAULTS[:cite]
-Citation::DEFAULTS['cite']
-Citation::DEFAULTS
-Citation
-cite.macro
-cite
-q
-c
-q
-[].empty?
-[].blank?
-[].any?
-@database.find{ |h| h['id'] == ct[:key] }['issued']['date-parts'].first.first
-@database.find{ |h| h['id'] == ct[:key] }['issued']['date-parts'].first
-@database.find{ |h| h['id'] == ct[:key] }['issued']['date-parts']
-@database.find{ |h| h['id'] == ct[:key] }['issued']
-@database.find{ |h| h['id'] == ct[:key] }
-ct
-q
-continue
-c
-q
-cite
-q
-Helpers.to_sentence(authors_family_names)
-n
-Helpers.to_sentence(authors_family_names)
-q
-Helpers.to_sentence(authors_family_names)
-n
-c
-ci.key
-ci
-c
-cite.cites
-cite
-c
-@database.find{ |h| h['id'] == 'asd' }
-@database.find{ |h| h['id'] == c.key }
-@database.find{ |h| h['id'] == c.key }['author']
-q
-cite.cites.first[:key]
-cite.cites.first['key']
-cite.cites
-cite.cites.key
-cite
-@database.find { |h| h['id'] == 'Anderson04' }['author'].map { |h| h['family'] }.compact
-@database.find { |h| h['id'] == 'Anderson04' }['author'].map { |h| h['family'] }
-@database.find { |h| h['id'] == 'Anderson04' }['author']
-@database.find { |h| h['id'] == 'Anderson04' }
-self.find { |h| h['id'] == 'Anderson04' }
-@database.
-cite
-q
-c
-q
-self.find { |h| h['id'] == 'Lane12a' }
-self.find(id: 'Lane12a').first
-self.find(id: 'Lane12a')
-self.find
-self