Skip to content

Releases: ropensci/cffr

cffr 1.1.1

28 Aug 14:13
Compare
Choose a tag to compare
  • Adapt extraction of orcid to R > 4.4.1.

What's Changed

Full Changelog: v1.1.0...v1.1.1

cffr 1.1.0

23 Jul 12:10
Compare
Choose a tag to compare
  • Now cffr adds automatically dois to packages on CRAN (e.g.
    https://doi.org/10.32614/CRAN.package.cffr):
    • If the package has a CITATION file providing a doi, the CITATION doi
      would be used as the main CITATION.cff doi and the CRAN doi
      would be added as an identifier.
    • Otherwise, CRAN doi would be used as doi.
    • When extracting dependencies (e.g cff_create(dependencies = TRUE) and
      the package dependency is on CRAN, the CRAN doi would be used
      for the dependency in the references key.
  • Extract commit from RemoteSha.
  • Update cran_to_spdx dataset.

What's Changed

Full Changelog: v1.0.1...v1.1.0

cffr 1.0.1

09 Apr 09:18
Compare
Choose a tag to compare
  • Update cff_write() to add a new encoding argument to make it work with
    different encodings, see iconv().
  • Fix NOTEs due to empty lines in docs.

Full Changelog: v1.0.1...v1.0.1

cffr 1.0.0

12 Mar 12:38
Compare
Choose a tag to compare

This is a major release with some notable changes. The change mainly affects to non-core functions, hence the natural workflow (cff_create()cff_write()cff_validate()) shouldn't be affected.

Major changes

Classes and methods

Now cffr implements a new class system for definitions.reference, definitions.person and definitions.entity objects:

  • List of definitions.reference (e.g, references) has class cff_ref_lst, cff and individual elements (e.g preferred-citation or each
    member of references) has class cff_ref, cff.
  • List of definitions.person or definitions.entity (e.g. authors, contact) has class cff_pers_lst, cff and individual elements (e.g publisher or each member of authors) has class cff_pers, cff.

This change allow to write specific S3
Methods
and extend the capabilities of the
package.

  • New as_cff() S3 generic method (replacing as.cff()): This method coerces
    R objects to cff class format. Current methods provided are:
    • as_cff.Bibtex().
    • as_cff.bibentry(), replacing cff_parse_citation().
    • as_cff.person(), similar to as_cff_person() but only for person objects. We recommend using as_cff_person() since it can coerce also string representing authors in BibTeX markup ("{von Neumen}, James"), that can't be captured properly via methods.
  • New as_bibentry() method for a variety of classes (character, list,
    NULL and classes defined by cffr).
  • New as_cff_person() method.
  • The following base and utils methods supports now cff class:
    • as.data.frame.cff().
    • as.person(), although only for definitions.person or
      definitions.entity (e.g. authors, contacts, editors,
      publisher, etc.).
    • head.cff(), tail.cff().
    • toBibtex.cff().

API

The API has been completely reviewed to provide more clarity on functions naming and to facilitate internal maintenance. This change only affects to non-core functions. Now each function does less things but does it better. The old API has been deprecated and it would warn when used, providing advice on the replacement function.

Deprecation

  • cff_to_bibtex() and cff_extract_to_bibtex(): replaced by as_bibentry()
    S3 generic.
  • cff_parse_person() and cff_parse_person_bibtex(): replaced by
    as_cff_person() S3 generic.
  • cff_parse_citation(): replaced by as_cff() S3 generic.
  • cff_from_bibtex(): replaced by cff_read_bib() (for *.bib files) and
    cff_read_bib_text() (for character strings).
  • write_bib() and write_citation() : replaced by cff_write_bib() and
    cff_write_citation() respectively.
  • Argument path in cff() is also deprecated, use cff_read() instead.

New capabilities

  • Now reading from external files is performed exclusively by cff_read() (that is designed to fit all supported file types on a single entry point) and the new specific readers (that are used under the hood by cff_read()), namely:
    • cff_read_cff_citation(),
    • cff_read_description(),
    • cff_read_citation()
    • cff_read_bib().
  • New cff_modify() function for updating and modifying cff objects easily.

Other changes

  • Minimum R version required now is 4.0.0.
  • Update of BibTeX crosswalk (see vignette("bibtex_cff", package = "cffr")) and consequently changes in the mapping performed by as_bibtex()
    cff_parse_citation():
    • @inBook and @book gains a new value on [CFF]{.underline} when
      series is provided: [collection-type: book-series.]{.underline}
    • Can handle BibLaTeX @inBook, that differs significantly from BibTeX
      @inBook.

What's Changed

New Contributors

Full Changelog: v0.5.0...v1.0.0

cffr 0.5.0

05 May 13:04
Compare
Choose a tag to compare

Lifecycle

  • Function cff_to_bibtex() and cff_extract_to_bibtex() have been merged,
    the latter (cff_extract_to_bibtex()) is now soft-deprecated.

New features

  • New function write_citation() that can generate a inst/CITATION file from
    a cff object (#51).

Enhancements

  • Additional authors of a R package can be now included based on the role
    on the DESCRIPTION file, via the parameter authors_roles (#49).

  • New message interface based on cli
    capabilities.

  • Now the (invisible) result of cff_validate() includes the summary of
    errors (if any) as an attributes() named "error", as
    jsonvalidate::json_validate() does when verbose = TRUE:

    Be verbose? If TRUE, then an attribute "errors" will list validation
    failures as a data.frame

  • Improvements in the extraction of `date-release`.

What's Changed

Full Changelog: v0.4.1...v0.5.0

cffr 0.4.1

31 Jan 03:10
Compare
Choose a tag to compare
  • Replace crayon dependency for cli (#46).
  • Improvements on the performance of cff_validate().

What's Changed

Full Changelog: v0.4.0...v0.4.1

cffr 0.4.0

18 Nov 19:31
Compare
Choose a tag to compare
  • Fix typo (#40) by @dpprdan
  • Add new function cff_from_bibtex().
  • Consistent behavior on dependency urls when RSPM is the default repo (i.e. on GitHub Actions or RStudio Cloud).

What's Changed

New Contributors

Full Changelog: v0.3.0...v0.4.0

cffr 0.3.0

23 Sep 17:07
Compare
Choose a tag to compare
  • preferred-citation is only produced when a CITATION (R) file has been
    provided with the package (#37).
  • Improve email handling on authors.
  • Add cff_read() function. This functionality was already implemented on
    cff() but new function added in order to provide clarity.

What's Changed

Full Changelog: v0.2.3...v0.3.0

cffr 0.2.3

22 Aug 07:02
Compare
Choose a tag to compare
  • Update docs to HTML5

Full Changelog: v0.2.2...v0.2.3

cffr 0.2.2

08 Apr 14:20
Compare
Choose a tag to compare
  • cffr now uses a local copy of the schema.json for validating. (#33).

What's Changed

Full Changelog: v0.2.1...v0.2.2