bolognese 0.2.2 → 2.7.0

data/README.md

@@ -1,3 +1,1027 @@
-# bolognese
+[![Identifier](https://img.shields.io/badge/doi-10.5438%2Fn138--z3mk-fca709.svg)](https://doi.org/10.5438/n138-z3mk)
+[![Gem Version](https://badge.fury.io/rb/bolognese.svg)](https://badge.fury.io/rb/bolognese)
+![Build Ruby Gem](https://github.com/datacite/bolognese/workflows/Build%20Ruby%20Gem/badge.svg)
+[![Code Climate](https://codeclimate.com/github/datacite/bolognese/badges/gpa.svg)](https://codeclimate.com/github/datacite/bolognese)
+[![Test Coverage](https://codeclimate.com/github/datacite/bolognese/badges/coverage.svg)](https://codeclimate.com/github/datacite/bolognese/coverage)
 
-Command-line utility for conversion of DOI metadata.
+# Bolognese: a Ruby library for conversion of DOI Metadata
+
+Ruby gem and command-line utility for conversion of DOI metadata from and to different metadata formats, including [schema.org](https://schema.org).
+
+
+## Features
+
+Bolognese reads and/or writes these metadata formats: 
+
+<table class="table table-bordered table-striped">
+  <thead>
+    <tr>
+      <th>Format</th>
+      <th>Name</th>
+      <th>Content Type</th>
+      <th>Read</th>
+      <th>Write</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><a href='https://www.crossref.org/schema/documentation/unixref1.1/unixref1.1.html'>CrossRef Unixref XML</a></td>
+      <td>crossref</td>
+      <td>application/vnd.crossref.unixref+xml</td>
+      <td>Yes</td>
+      <td>No</td>
+   </tr>
+    <tr>
+      <td><a href='https://schema.datacite.org/'>DataCite XML</a></td>
+      <td>datacite</td>
+      <td>application/vnd.datacite.datacite+xml</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://api.datacite.org/'>DataCite JSON</a></td>
+      <td>datacite_json</td>
+      <td>application/vnd.datacite.datacite+json</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='http://schema.org/'>Schema.org in JSON-LD</a></td>
+      <td>schema_org</td>
+      <td>application/vnd.schemaorg.ld+json</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='http://www.w3.org/TR/rdf-syntax-grammar/'>RDF XML</a></td>
+      <td>rdf_xml</td>
+      <td>application/rdf+xml</td>
+      <td>No</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='http://www.w3.org/TeamSubmission/turtle/'>RDF Turtle</a></td>
+      <td>turtle</td>
+      <td>text/turtle</td>
+      <td>No</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://citationstyles.org/'>Citeproc JSON</a></td>
+      <td>citeproc</td>
+      <td>application/vnd.citationstyles.csl+json</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://citationstyles.org/'>Formatted text citation</a></td>
+      <td>citation</td>
+      <td>text/x-bibliography</td>
+      <td>No</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://codemeta.github.io/'>Codemeta</a></td>
+      <td>codemeta</td>
+      <td>application/vnd.codemeta.ld+json</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://jats.nlm.nih.gov/'>JATS</a></td>
+      <td>jats</td>
+      <td>application/vnd.jats+xml</td>
+      <td>No</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://en.wikipedia.org/wiki/Comma-separated_values'>CSV</a></td>
+      <td>csv</td>
+      <td>text/csv</td>
+      <td>No</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='http://en.wikipedia.org/wiki/BibTeX'>BibTeX</a></td>
+      <td>bibtex</td>
+      <td>application/x-bibtex</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='http://en.wikipedia.org/wiki/RIS_(file_format)'>RIS</a></td>
+      <td>ris</td>
+      <td>application/x-research-info-systems</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <td><a href='https://citation.crosscite.org/'>Crosscite</a></td>
+      <td>crosscite</td>
+      <td>application/vnd.crosscite.crosscite+json</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+  </tbody>
+</table>
+
+**Crosscite** is the format used internally by bolognese.
+
+## Installation
+
+Requires Ruby 2.2 or later. Then add the following to your `Gemfile` to install the
+latest version:
+
+```ruby
+gem 'bolognese'
+```
+
+Then run `bundle install` to install into your environment.
+
+You can also install the gem system-wide in the usual way:
+
+```bash
+gem install bolognese
+```
+
+## Commands
+
+Run the `bolognese` command with either an identifier (DOI or URL) or filename:
+
+```
+bolognese https://doi.org/10.7554/elife.01567
+```
+
+```
+bolognese example.xml
+```
+
+Bolognese can read BibTeX files (file extension `.bib`), RIS files (file extension `.ris`), Crossref or DataCite XML files (file extension `.xml`), DataCite JSON files (file extension `Citeproc JSON files ().
+
+The input format (e.g. Crossref XML or BibteX) is automatically detected, but
+you can also provide the format with the `--from` or `-f` flag. The supported
+input formats are listed in the table above.
+
+The output format is determined by the `--to` or `-t` flag, and defaults to `schema_org`.
+
+Show all commands with `bolognese help`:
+
+```
+Commands:
+  bolognese                 # convert metadata
+  bolognese --version, -v   # print the version
+  bolognese help [COMMAND]  # Describe available commands or one specific command
+```
+## Errors
+
+Errors are returned to STDOUT.
+
+All DataCite XML input is validated against the corresponding schema version (kernel 2.1, 2.2, 3, or 4).
+
+## Examples
+
+Read Crossref XML:
+
+```
+bolognese https://doi.org/10.7554/elife.01567 -t crossref
+
+<?xml version="1.0" encoding="UTF-8"?>
+<doi_records>
+  <doi_record owner="10.7554" timestamp="2015-08-11 07:35:02">
+    <crossref>
+      <journal>
+        <journal_metadata language="en">
+          <full_title>eLife</full_title>
+          <issn media_type="electronic">2050-084X</issn>
+        </journal_metadata>
+        <journal_issue>
+          <publication_date media_type="online">
+            <month>02</month>
+            <day>11</day>
+            <year>2014</year>
+          </publication_date>
+          <journal_volume>
+            <volume>3</volume>
+          </journal_volume>
+        </journal_issue>
+        <journal_article publication_type="full_text">
+          <titles>
+            <title>Automated quantitative histology reveals vascular morphodynamics during Arabidopsis hypocotyl secondary growth</title>
+          </titles>
+          <contributors>
+            <person_name contributor_role="author" sequence="first">
+              <given_name>Martial</given_name>
+              <surname>Sankar</surname>
+            </person_name>
+            <person_name contributor_role="author" sequence="additional">
+              <given_name>Kaisa</given_name>
+              <surname>Nieminen</surname>
+            </person_name>
+            <person_name contributor_role="author" sequence="additional">
+              <given_name>Laura</given_name>
+              <surname>Ragni</surname>
+            </person_name>
+            <person_name contributor_role="author" sequence="additional">
+              <given_name>Ioannis</given_name>
+              <surname>Xenarios</surname>
+            </person_name>
+            <person_name contributor_role="author" sequence="additional">
+              <given_name>Christian S</given_name>
+              <surname>Hardtke</surname>
+            </person_name>
+          </contributors>
+          <publication_date media_type="online">
+            <month>02</month>
+            <day>11</day>
+            <year>2014</year>
+          </publication_date>
+          <publisher_item>
+            <identifier id_type="doi">10.7554/eLife.01567</identifier>
+          </publisher_item>
+          <crossmark>
+            <crossmark_version>1</crossmark_version>
+            <crossmark_policy>eLifesciences</crossmark_policy>
+            <crossmark_domains>
+              <crossmark_domain>
+                <domain>www.elifesciences.org</domain>
+              </crossmark_domain>
+            </crossmark_domains>
+            <crossmark_domain_exclusive>false</crossmark_domain_exclusive>
+            <custom_metadata>
+              <assertion name="received" label="Received" group_name="publication_history" group_label="Publication History" order="0">2013-09-20</assertion>
+              <assertion name="accepted" label="Accepted" group_name="publication_history" group_label="Publication History" order="1">2013-12-24</assertion>
+              <assertion name="published" label="Published" group_name="publication_history" group_label="Publication History" order="2">2014-02-11</assertion>
+              <program name="fundref">
+                <assertion name="fundgroup">
+                  <assertion name="funder_name">SystemsX</assertion>
+                </assertion>
+                <assertion name="fundgroup">
+                  <assertion name="funder_name">
+                    EMBO
+                    <assertion name="funder_identifier">http://dx.doi.org/10.13039/501100003043</assertion>
+                  </assertion>
+                </assertion>
+                <assertion name="fundgroup">
+                  <assertion name="funder_name">
+                    Swiss National Science Foundation
+                    <assertion name="funder_identifier">http://dx.doi.org/10.13039/501100001711</assertion>
+                  </assertion>
+                </assertion>
+                <assertion name="fundgroup">
+                  <assertion name="funder_name">
+                    University of Lausanne
+                    <assertion name="funder_identifier" provider="crossref">http://dx.doi.org/10.13039/501100006390</assertion>
+                  </assertion>
+                </assertion>
+              </program>
+              <program name="AccessIndicators">
+                <license_ref applies_to="vor">http://creativecommons.org/licenses/by/3.0/</license_ref>
+                <license_ref applies_to="am">http://creativecommons.org/licenses/by/3.0/</license_ref>
+                <license_ref applies_to="tdm">http://creativecommons.org/licenses/by/3.0/</license_ref>
+              </program>
+            </custom_metadata>
+          </crossmark>
+          <doi_data>
+            <doi>10.7554/eLife.01567</doi>
+            <resource>http://elifesciences.org/lookup/doi/10.7554/eLife.01567</resource>
+          </doi_data>
+          <citation_list>
+            ...
+            <citation key="22">
+              <author>Sankar</author>
+              <cYear>2014</cYear>
+              <doi>10.5061/dryad.b835k</doi>
+            </citation>
+            ...
+          </citation_list>
+          <component_list>
+           ...
+          </component_list>
+        </journal_article>
+      </journal>
+    </crossref>
+  </doi_record>
+</doi_records>
+```
+
+Convert Crossref XML to schema.org/JSON-LD:
+```
+bolognese https://doi.org/10.7554/elife.01567
+
+{
+    "@context": "http://schema.org",
+    "@type": "ScholarlyArticle",
+    "@id": "https://doi.org/10.7554/elife.01567",
+    "url": "http://elifesciences.org/lookup/doi/10.7554/eLife.01567",
+    "additionalType": "JournalArticle",
+    "name": "Automated quantitative histology reveals vascular morphodynamics during Arabidopsis hypocotyl secondary growth",
+    "author": [{
+        "@type": "Person",
+        "givenName": "Martial",
+        "familyName": "Sankar"
+    }, {
+        "@type": "Person",
+        "givenName": "Kaisa",
+        "familyName": "Nieminen"
+    }, {
+        "@type": "Person",
+        "givenName": "Laura",
+        "familyName": "Ragni"
+    }, {
+        "@type": "Person",
+        "givenName": "Ioannis",
+        "familyName": "Xenarios"
+    }, {
+        "@type": "Person",
+        "givenName": "Christian S",
+        "familyName": "Hardtke"
+    }],
+    "license": "http://creativecommons.org/licenses/by/3.0/",
+    "datePublished": "2014-02-11",
+    "dateModified": "2015-08-11T05:35:02Z",
+    "isPartOf": {
+        "@type": "Periodical",
+        "name": "eLife",
+        "issn": "2050-084X"
+    },
+    "citation": [{
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1038/nature02100",
+        "position": "1",
+        "datePublished": "2003"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1534/genetics.109.104976",
+        "position": "2",
+        "datePublished": "2009"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1034/j.1399-3054.2002.1140413.x",
+        "position": "3",
+        "datePublished": "2002"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1162/089976601750399335",
+        "position": "4",
+        "datePublished": "2001"
+    }, {
+        "@type": "CreativeWork",
+        "position": "5",
+        "datePublished": "1995"
+    }, {
+        "@type": "CreativeWork",
+        "position": "6",
+        "datePublished": "1993"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1016/j.semcdb.2009.09.009",
+        "position": "7",
+        "datePublished": "2009"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1242/dev.091314",
+        "position": "8",
+        "datePublished": "2013"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1371/journal.pgen.1002997",
+        "position": "9",
+        "datePublished": "2012"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1038/msb.2010.25",
+        "position": "10",
+        "datePublished": "2010"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1016/j.biosystems.2012.07.004",
+        "position": "11",
+        "datePublished": "2012"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1016/j.pbi.2005.11.013",
+        "position": "12",
+        "datePublished": "2006"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1105/tpc.110.076083",
+        "position": "13",
+        "datePublished": "2010"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1073/pnas.0808444105",
+        "position": "14",
+        "datePublished": "2008"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1016/0092-8674(89)90900-8",
+        "position": "15",
+        "datePublished": "1989"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1126/science.1066609",
+        "position": "16",
+        "datePublished": "2002"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1104/pp.104.040212",
+        "position": "17",
+        "datePublished": "2004"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1038/nbt1206-1565",
+        "position": "18",
+        "datePublished": "2006"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1073/pnas.77.3.1516",
+        "position": "19",
+        "datePublished": "1980"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1093/bioinformatics/btq046",
+        "position": "20",
+        "datePublished": "2010"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1105/tpc.111.084020",
+        "position": "21",
+        "datePublished": "2011"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.5061/dryad.b835k",
+        "position": "22",
+        "datePublished": "2014"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1016/j.cub.2008.02.070",
+        "position": "23",
+        "datePublished": "2008"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1111/j.1469-8137.2010.03236.x",
+        "position": "24",
+        "datePublished": "2010"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1007/s00138-011-0345-9",
+        "position": "25",
+        "datePublished": "2012"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1016/j.cell.2012.02.048",
+        "position": "26",
+        "datePublished": "2012"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1038/ncb2764",
+        "position": "27",
+        "datePublished": "2013"
+    }],
+    "funder": [{
+        "@type": "Organization",
+        "name": "SystemsX"
+    }, {
+        "@type": "Organization",
+        "@id": "https://doi.org/10.13039/501100003043",
+        "name": "EMBO"
+    }, {
+        "@type": "Organization",
+        "@id": "https://doi.org/10.13039/501100001711",
+        "name": "Swiss National Science Foundation"
+    }, {
+        "@type": "Organization",
+        "@id": "https://doi.org/10.13039/501100006390",
+        "name": "University of Lausanne"
+    }],
+    "provider": {
+        "@type": "Organization",
+        "name": "Crossref"
+    }
+}
+```
+
+Convert Crossref XML to DataCite XML:
+```
+bolognese https://doi.org/10.7554/elife.01567 -t datacite
+
+<?xml version="1.0" encoding="UTF-8"?>
+<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datacite.org/schema/kernel-4" xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4/metadata.xsd">
+  <identifier identifierType="DOI">10.7554/eLife.01567</identifier>
+  <creators>
+    <creator>
+      <creatorName>Sankar, Martial</creatorName>
+      <givenName>Martial</givenName>
+      <familyName>Sankar</familyName>
+    </creator>
+    <creator>
+      <creatorName>Nieminen, Kaisa</creatorName>
+      <givenName>Kaisa</givenName>
+      <familyName>Nieminen</familyName>
+    </creator>
+    <creator>
+      <creatorName>Ragni, Laura</creatorName>
+      <givenName>Laura</givenName>
+      <familyName>Ragni</familyName>
+    </creator>
+    <creator>
+      <creatorName>Xenarios, Ioannis</creatorName>
+      <givenName>Ioannis</givenName>
+      <familyName>Xenarios</familyName>
+    </creator>
+    <creator>
+      <creatorName>Hardtke, Christian S</creatorName>
+      <givenName>Christian S</givenName>
+      <familyName>Hardtke</familyName>
+    </creator>
+  </creators>
+  <titles>
+    <title>Automated quantitative histology reveals vascular morphodynamics during Arabidopsis hypocotyl secondary growth</title>
+  </titles>
+  <publisher>eLife</publisher>
+  <publicationYear>2014</publicationYear>
+  <resourceType resourceTypeGeneral="Text">JournalArticle</resourceType>
+  <fundingReferences>
+    <fundingReference>
+      <funderName>SystemsX</funderName>
+    </fundingReference>
+    <fundingReference>
+      <funderName>EMBO</funderName>
+      <funderIdentifier funderIdentifierType="Crossref Funder ID">https://doi.org/10.13039/501100003043</funderIdentifier>
+    </fundingReference>
+    <fundingReference>
+      <funderName>Swiss National Science Foundation</funderName>
+      <funderIdentifier funderIdentifierType="Crossref Funder ID">https://doi.org/10.13039/501100001711</funderIdentifier>
+    </fundingReference>
+    <fundingReference>
+      <funderName>University of Lausanne</funderName>
+      <funderIdentifier funderIdentifierType="Crossref Funder ID">https://doi.org/10.13039/501100006390</funderIdentifier>
+    </fundingReference>
+  </fundingReferences>
+  <dates>
+    <date dateType="Issued">2014-02-11</date>
+    <date dateType="Updated">2015-08-11T05:35:02Z</date>
+  </dates>
+  <relatedIdentifiers>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1038/nature02100</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1534/genetics.109.104976</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1034/j.1399-3054.2002.1140413.x</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1162/089976601750399335</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1016/j.semcdb.2009.09.009</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1242/dev.091314</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1371/journal.pgen.1002997</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1038/msb.2010.25</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1016/j.biosystems.2012.07.004</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1016/j.pbi.2005.11.013</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1105/tpc.110.076083</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1073/pnas.0808444105</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1016/0092-8674(89)90900-8</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1126/science.1066609</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1104/pp.104.040212</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1038/nbt1206-1565</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1073/pnas.77.3.1516</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1093/bioinformatics/btq046</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1105/tpc.111.084020</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.5061/dryad.b835k</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1016/j.cub.2008.02.070</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1111/j.1469-8137.2010.03236.x</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1007/s00138-011-0345-9</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1016/j.cell.2012.02.048</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1038/ncb2764</relatedIdentifier>
+  </relatedIdentifiers>
+  <rightsList>
+    <rights rightsURI="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 (CC-BY 3.0)</rights>
+  </rightsList>
+</resource>
+```
+Convert Crossref XML to BibTeX:
+
+```
+bolognese https://doi.org/10.7554/elife.01567 -t bibtex
+
+@article{https://doi.org/10.7554/elife.01567,
+  doi = {10.7554/eLife.01567},
+  url = {http://elifesciences.org/lookup/doi/10.7554/eLife.01567},
+  author = {Sankar, Martial and Nieminen, Kaisa and Ragni, Laura and Xenarios, Ioannis and Hardtke, Christian S},
+  title = {Automated quantitative histology reveals vascular morphodynamics during Arabidopsis hypocotyl secondary growth},
+  journal = {eLife},
+  year = {2014}
+}
+```
+
+Read DataCite XML:
+```
+bolognese 10.5061/DRYAD.8515 -t datacite
+
+<?xml version="1.0" encoding="UTF-8"?>
+<resource
+    xmlns="http://datacite.org/schema/kernel-3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:mets="http://www.loc.gov/METS/"
+    xmlns:dspace="http://www.dspace.org/xmlns/dspace/dim"
+    xmlns:dim="http://www.dspace.org/xmlns/dspace/dim"
+    xmlns:dryad="http://purl.org/dryad/terms/"
+    xsi:schemaLocation="http://datacite.org/schema/kernel-3 http://schema.datacite.org/meta/kernel-3/metadata.xsd">
+    <identifier identifierType="DOI">10.5061/DRYAD.8515</identifier>
+    <version>1</version>
+    <creators>
+        <creator>
+            <creatorName>Ollomo, Benjamin</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Durand, Patrick</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Prugnolle, Franck</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Douzery, Emmanuel J. P.</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Arnathau, Céline</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Nkoghe, Dieudonné</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Leroy, Eric</creatorName>
+        </creator>
+        <creator>
+            <creatorName>Renaud, François</creatorName>
+        </creator>
+    </creators>
+    <titles>
+        <title>Data from: A new malaria agent in African hominids.</title>
+    </titles>
+    <publisher>Dryad Digital Repository</publisher>
+    <publicationYear>2011</publicationYear>
+    <subjects>
+        <subject>Phylogeny</subject>
+        <subject>Malaria</subject>
+        <subject>Parasites</subject>
+        <subject>Taxonomy</subject>
+        <subject>Mitochondrial genome</subject>
+        <subject>Africa</subject>
+        <subject>Plasmodium</subject>
+    </subjects>
+    <resourceType resourceTypeGeneral="Dataset">DataPackage</resourceType>
+    <alternateIdentifiers>
+        <alternateIdentifier alternateIdentifierType="citation">Ollomo B, Durand P, Prugnolle F, Douzery EJP, Arnathau C, Nkoghe D, Leroy E, Renaud F (2009) A new malaria agent in African hominids. PLoS Pathogens 5(5): e1000446.</alternateIdentifier>
+    </alternateIdentifiers>
+    <relatedIdentifiers>
+        <relatedIdentifier relatedIdentifierType="DOI" relationType="HasPart">10.5061/DRYAD.8515/1</relatedIdentifier>
+        <relatedIdentifier relatedIdentifierType="DOI" relationType="HasPart">10.5061/DRYAD.8515/2</relatedIdentifier>
+        <relatedIdentifier relatedIdentifierType="DOI" relationType="IsReferencedBy">10.1371/JOURNAL.PPAT.1000446</relatedIdentifier>
+        <relatedIdentifier relatedIdentifierType="PMID" relationType="IsReferencedBy">19478877</relatedIdentifier>
+    </relatedIdentifiers>
+    <rightsList>
+        <rights rightsURI="http://creativecommons.org/publicdomain/zero/1.0/"/>
+    </rightsList>
+</resource>
+```
+
+Convert DataCite XML to schema.org/JSON-LD:
+```sh
+bolognese 10.5061/DRYAD.8515
+
+{
+    "@context": "http://schema.org",
+    "@type": "Dataset",
+    "@id": "https://doi.org/10.5061/dryad.8515",
+    "additionalType": "DataPackage",
+    "name": "Data from: A new malaria agent in African hominids.",
+    "alternateName": "Ollomo B, Durand P, Prugnolle F, Douzery EJP, Arnathau C, Nkoghe D, Leroy E, Renaud F (2009) A new malaria agent in African hominids. PLoS Pathogens 5(5): e1000446.",
+    "author": [{
+        "@type": "Person",
+        "givenName": "Benjamin",
+        "familyName": "Ollomo"
+    }, {
+        "@type": "Person",
+        "givenName": "Patrick",
+        "familyName": "Durand"
+    }, {
+        "@type": "Person",
+        "givenName": "Franck",
+        "familyName": "Prugnolle"
+    }, {
+        "@type": "Person",
+        "givenName": "Emmanuel J. P.",
+        "familyName": "Douzery"
+    }, {
+        "@type": "Person",
+        "givenName": "Céline",
+        "familyName": "Arnathau"
+    }, {
+        "@type": "Person",
+        "givenName": "Dieudonné",
+        "familyName": "Nkoghe"
+    }, {
+        "@type": "Person",
+        "givenName": "Eric",
+        "familyName": "Leroy"
+    }, {
+        "@type": "Person",
+        "givenName": "François",
+        "familyName": "Renaud"
+    }],
+    "license": "http://creativecommons.org/publicdomain/zero/1.0/",
+    "version": "1",
+    "keywords": "Phylogeny, Malaria, Parasites, Taxonomy, Mitochondrial genome, Africa, Plasmodium",
+    "datePublished": "2011",
+    "hasPart": [{
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.5061/dryad.8515/1"
+    }, {
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.5061/dryad.8515/2"
+    }],
+    "citation": [{
+        "@type": "CreativeWork",
+        "@id": "https://doi.org/10.1371/journal.ppat.1000446"
+    }],
+    "schemaVersion": "http://datacite.org/schema/kernel-3",
+    "publisher": {
+        "@type": "Organization",
+        "name": "Dryad Digital Repository"
+    },
+    "provider": {
+        "@type": "Organization",
+        "name": "DataCite"
+    }
+}
+```
+
+Convert DataCite XML to schema version 4.0:
+```
+bolognese 10.5061/DRYAD.8515 -t datacite --schema_version http://datacite.org/schema/kernel-4
+
+<?xml version="1.0" encoding="UTF-8"?>
+<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datacite.org/schema/kernel-4" xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4/metadata.xsd">
+  <identifier identifierType="DOI">10.5061/DRYAD.8515</identifier>
+  <creators>
+    <creator>
+      <creatorName>Ollomo, Benjamin</creatorName>
+      <givenName>Benjamin</givenName>
+      <familyName>Ollomo</familyName>
+    </creator>
+    <creator>
+      <creatorName>Durand, Patrick</creatorName>
+      <givenName>Patrick</givenName>
+      <familyName>Durand</familyName>
+    </creator>
+    <creator>
+      <creatorName>Prugnolle, Franck</creatorName>
+      <givenName>Franck</givenName>
+      <familyName>Prugnolle</familyName>
+    </creator>
+    <creator>
+      <creatorName>Douzery, Emmanuel J. P.</creatorName>
+      <givenName>Emmanuel J. P.</givenName>
+      <familyName>Douzery</familyName>
+    </creator>
+    <creator>
+      <creatorName>Arnathau, Céline</creatorName>
+      <givenName>Céline</givenName>
+      <familyName>Arnathau</familyName>
+    </creator>
+    <creator>
+      <creatorName>Nkoghe, Dieudonné</creatorName>
+      <givenName>Dieudonné</givenName>
+      <familyName>Nkoghe</familyName>
+    </creator>
+    <creator>
+      <creatorName>Leroy, Eric</creatorName>
+      <givenName>Eric</givenName>
+      <familyName>Leroy</familyName>
+    </creator>
+    <creator>
+      <creatorName>Renaud, François</creatorName>
+      <givenName>François</givenName>
+      <familyName>Renaud</familyName>
+    </creator>
+  </creators>
+  <titles>
+    <title>Data from: A new malaria agent in African hominids.</title>
+  </titles>
+  <publisher>Dryad Digital Repository</publisher>
+  <publicationYear>2011</publicationYear>
+  <resourceType resourceTypeGeneral="Dataset">DataPackage</resourceType>
+  <alternateIdentifiers>
+    <alternateIdentifier alternateIdentifierType="Local accession number">Ollomo B, Durand P, Prugnolle F, Douzery EJP, Arnathau C, Nkoghe D, Leroy E, Renaud F (2009) A new malaria agent in African hominids. PLoS Pathogens 5(5): e1000446.</alternateIdentifier>
+  </alternateIdentifiers>
+  <subjects>
+    <subject>Phylogeny</subject>
+    <subject>Malaria</subject>
+    <subject>Parasites</subject>
+    <subject>Taxonomy</subject>
+    <subject>Mitochondrial genome</subject>
+    <subject>Africa</subject>
+    <subject>Plasmodium</subject>
+  </subjects>
+  <dates>
+    <date dateType="Issued">2011</date>
+  </dates>
+  <relatedIdentifiers>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="HasPart">https://doi.org/10.5061/dryad.8515/1</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="HasPart">https://doi.org/10.5061/dryad.8515/2</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.1371/journal.ppat.1000446</relatedIdentifier>
+  </relatedIdentifiers>
+  <version>1</version>
+  <rightsList>
+    <rights rightsURI="http://creativecommons.org/publicdomain/zero/1.0/">Public Domain (CC0 1.0)</rights>
+  </rightsList>
+</resource>
+```
+
+
+Convert DataCite XML to Codemeta:
+
+```
+bolognese https://doi.org/10.5063/f1m61h5x -t codemeta
+
+{  
+   "@context":"https://raw.githubusercontent.com/codemeta/codemeta/master/codemeta.jsonld",
+   "@type":"SoftwareSourceCode",
+   "@id":"https://doi.org/10.5063/f1m61h5x",
+   "identifier":"https://doi.org/10.5063/f1m61h5x",
+   "title":"dataone: R interface to the DataONE network of data repositories",
+   "agents":{  
+      "@type":"Person",
+      "givenName":"Matthew B.",
+      "familyName":"Jones"
+   },
+   "datePublished":"2016",
+   "publisher":{  
+      "@type":"Organization",
+      "name":"KNB Data Repository"
+   }
+}
+```
+
+Convert DataCite XML to BibTeX:
+
+```
+bolognese 10.5061/DRYAD.8515 -t bibtex
+
+@misc{https://doi.org/10.5061/dryad.8515,
+  doi = {10.5061/DRYAD.8515},
+  author = {Ollomo, Benjamin and Durand, Patrick and Prugnolle, Franck and Douzery, Emmanuel J. P. and Arnathau, Céline and Nkoghe, Dieudonné and Leroy, Eric and Renaud, François},
+  keywords = {Phylogeny, Malaria, Parasites, Taxonomy, Mitochondrial genome, Africa, Plasmodium},
+  title = {Data from: A new malaria agent in African hominids.},
+  publisher = {Dryad Digital Repository},
+  year = {2011}
+}
+```
+
+Convert schema.org/JSON-LD to DataCite XML:
+
+```
+bolognese https://blog.datacite.org/eating-your-own-dog-food -t datacite
+
+<?xml version="1.0" encoding="UTF-8"?>
+<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datacite.org/schema/kernel-4" xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4/metadata.xsd">
+  <identifier identifierType="DOI">10.5438/4k3m-nyvg</identifier>
+  <creators>
+    <creator>
+      <creatorName>Fenner, Martin</creatorName>
+      <givenName>Martin</givenName>
+      <familyName>Fenner</familyName>
+      <nameIdentifier schemeURI="http://orcid.org/" nameIdentifierScheme="ORCID">http://orcid.org/0000-0003-1419-2405</nameIdentifier>
+    </creator>
+  </creators>
+  <titles>
+    <title>Eating your own Dog Food</title>
+  </titles>
+  <publisher>DataCite</publisher>
+  <publicationYear>2016</publicationYear>
+  <resourceType resourceTypeGeneral="Text">BlogPosting</resourceType>
+  <alternateIdentifiers>
+    <alternateIdentifier alternateIdentifierType="Local accession number">MS-49-3632-5083</alternateIdentifier>
+  </alternateIdentifiers>
+  <subjects>
+    <subject>datacite</subject>
+    <subject>doi</subject>
+    <subject>metadata</subject>
+    <subject>featured</subject>
+  </subjects>
+  <dates>
+    <date dateType="Created">2016-12-20</date>
+    <date dateType="Issued">2016-12-20</date>
+    <date dateType="Updated">2016-12-20</date>
+  </dates>
+  <relatedIdentifiers>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="IsPartOf">https://doi.org/10.5438/0000-00ss</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.5438/0012</relatedIdentifier>
+    <relatedIdentifier relatedIdentifierType="DOI" relationType="References">https://doi.org/10.5438/55e5-t5c0</relatedIdentifier>
+  </relatedIdentifiers>
+  <version>1.0</version>
+  <rightsList>
+    <rights rightsURI="https://creativecommons.org/licenses/by/4.0/"/>
+  </rightsList>
+  <descriptions>
+    <description descriptionType="Abstract">Eating your own dog food is a slang term to describe that an organization should itself use the products and services it provides. For DataCite this means that we should use DOIs with appropriate metadata and strategies for long-term preservation for...</description>
+  </descriptions>
+</resource>
+```
+
+Convert schema.org/JSON-LD to BibTeX:
+
+```
+bolognese https://blog.datacite.org/eating-your-own-dog-food -t bibtex
+
+@article{https://doi.org/10.5438/4k3m-nyvg,
+  doi = {10.5438/4k3m-nyvg},
+  url = {https://blog.datacite.org/eating-your-own-dog-food},
+  author = {Fenner, Martin},
+  keywords = {datacite, doi, metadata, featured},
+  title = {Eating your own Dog Food},
+  publisher = {DataCite},
+  year = {2016}
+}
+```
+
+Convert Codemeta to schema.org/JSON-LD:
+
+```
+bolognese https://github.com/datacite/maremma
+
+{  
+  "@context":"http://schema.org",
+  "@type":"SoftwareSourceCode",
+  "@id":"https://doi.org/10.5438/qeg0-3gm3",
+  "url":"https://github.com/datacite/maremma",
+  "name":"Maremma: a Ruby library for simplified network calls",
+  "author":{  
+    "@type":"person",
+    "@id":"http://orcid.org/0000-0003-0077-4738",
+    "name":"Martin Fenner"
+  },
+  "description":"Simplifies network calls, including json/xml parsing and error handling. Based on Faraday.",
+  "keywords":"faraday, excon, net/http",
+  "dateCreated":"2015-11-28",
+  "datePublished":"2017-02-24",
+  "dateModified":"2017-02-24",
+  "publisher":{  
+    "@type":"Organization",
+    "name":"DataCite"
+  }
+}
+```
+
+Convert Codemeta to DataCite XML:
+
+```
+bolognese https://github.com/datacite/maremma -t datacite
+
+<?xml version="1.0" encoding="UTF-8"?>
+<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datacite.org/schema/kernel-4" xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4/metadata.xsd">
+  <identifier identifierType="DOI">10.5438/qeg0-3gm3</identifier>
+  <creators>
+    <creator>
+      <creatorName>Martin Fenner</creatorName>
+      <nameIdentifier schemeURI="http://orcid.org/" nameIdentifierScheme="ORCID">http://orcid.org/0000-0003-0077-4738</nameIdentifier>
+    </creator>
+  </creators>
+  <titles>
+    <title>Maremma: a Ruby library for simplified network calls</title>
+  </titles>
+  <publisher>DataCite</publisher>
+  <publicationYear>2017</publicationYear>
+  <resourceType resourceTypeGeneral="Software">SoftwareSourceCode</resourceType>
+  <subjects>
+    <subject>faraday</subject>
+    <subject>excon</subject>
+    <subject>net/http</subject>
+  </subjects>
+  <dates>
+    <date dateType="Created">2015-11-28</date>
+    <date dateType="Issued">2017-02-24</date>
+    <date dateType="Updated">2017-02-24</date>
+  </dates>
+  <descriptions>
+    <description descriptionType="Abstract">Simplifies network calls, including json/xml parsing and error handling. Based on Faraday.</description>
+  </descriptions>
+</resource>
+```
+
+## Development
+
+We use rspec for unit testing:
+
+```
+bundle exec rspec
+```
+
+Follow along via [Github Issues](https://github.com/datacite/bolognese/issues).
+Please open an issue if conversion fails or metadata are not properly supported.
+
+### Note on Patches/Pull Requests
+
+* Fork the project
+* Write tests for your new feature or a test that reproduces a bug
+* Implement your feature or make a bug fix
+* Do not mess with Rakefile, version or history
+* Commit, push and make a pull request. Bonus points for topical branches.
+
+## License
+**bolognese** is released under the [MIT License](https://github.com/datacite/bolognese/blob/master/LICENSE.md).