Recent Releases of cffr
cffr - cffr 1.2.0
- New parameter
r_citationincff_write(). When it is set toTRUEa R citation file (inst/CITATION) would be generated/updated with the information of the generatedCITATION.cfffile. No backup copy would be created, for more control usecff_write_citation()(#79). -
repository-codenow also recognizes Codeberg as a valid repository (#88). -
repository-coderecognizes repositories regardless of casing. It is still advised to use lower caps as a good practice for R developers.
What's Changed
- Bump dieghernan/cran-status-check from 1 to 2 by @dependabot in https://github.com/ropensci/cffr/pull/85
- Add option for auto creation of inst/CITATION by @dieghernan in https://github.com/ropensci/cffr/pull/84
Full Changelog: https://github.com/ropensci/cffr/compare/v1.1.1...v1.2.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 1 year ago
cffr - cffr 1.1.1
- Adapt extraction of orcid to R > 4.4.1.
What's Changed
- Adapt to changes in person (R 4.5.0) by @dieghernan in https://github.com/ropensci/cffr/pull/80
Full Changelog: https://github.com/ropensci/cffr/compare/v1.1.0...v1.1.1
Scientific Software - Peer-reviewed
- R
Published by dieghernan almost 2 years ago
cffr - cffr 1.1.0
- Now cffr adds automatically dois to packages on CRAN (e.g.
https://doi.org/10.32614/CRAN.package.cffr):
- If the package has a
CITATIONfile providing a doi, theCITATIONdoi would be used as the mainCITATION.cffdoiand the CRAN doi would be added as anidentifier. - 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 thereferenceskey.
- If the package has a
- Extract
commitfromRemoteSha. - Update
cran_to_spdxdataset.
What's Changed
- Extract commit info by @dieghernan in https://github.com/ropensci/cffr/pull/72
- Fix action for testing cffr in ~2500 packages by @dieghernan in https://github.com/ropensci/cffr/pull/73
- Recognize CRAN DOI by @dieghernan in https://github.com/ropensci/cffr/pull/75
Full Changelog: https://github.com/ropensci/cffr/compare/v1.0.1...v1.1.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan almost 2 years ago
cffr - cffr 1.0.1
- Update
cff_write()to add a newencodingargument to make it work with different encodings, seeiconv(). - Fix NOTEs due to empty lines in docs.
Full Changelog: https://github.com/ropensci/cffr/compare/v1.0.1...v1.0.1
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 2 years ago
cffr - cffr 1.0.0
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 classcff_ref_lst, cffand individual elements (e.gpreferred-citationor each member ofreferences) has classcff_ref, cff. - List of
definitions.personordefinitions.entity(e.g.authors,contact) has classcff_pers_lst, cffand individual elements (e.gpublisheror each member ofauthors) has classcff_pers, cff.
This change allow to write specific S3 Methods and extend the capabilities of the package.
- New
as_cff()S3 generic method (replacingas.cff()): This method coerces R objects tocffclass format. Current methods provided are:-
as_cff.Bibtex(). -
as_cff.bibentry(), replacing cffparsecitation(). -
as_cff.person(), similar toas_cff_person()but only forpersonobjects. We recommend usingas_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,NULLand classes defined by cffr). - New
as_cff_person()method. - The following base and utils methods supports now
cffclass:-
as.data.frame.cff(). -
as.person(), although only fordefinitions.personordefinitions.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()andcff_extract_to_bibtex(): replaced byas_bibentry()S3 generic. -
cff_parse_person()andcff_parse_person_bibtex(): replaced byas_cff_person()S3 generic. -
cff_parse_citation(): replaced byas_cff()S3 generic. -
cff_from_bibtex(): replaced bycff_read_bib()(for*.bibfiles) andcff_read_bib_text()(for character strings). -
write_bib()andwrite_citation(): replaced bycff_write_bib()andcff_write_citation()respectively. - Argument
pathincff()is also deprecated, usecff_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 bycff_read()), namely:-
cff_read_cff_citation(), -
cff_read_description(), -
cff_read_citation() -
cff_read_bib().
-
- New
cff_modify()function for updating and modifyingcffobjects 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 byas_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
- Update lint.yaml by @dieghernan in https://github.com/ropensci/cffr/pull/57
- Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/ropensci/cffr/pull/59
- Bump github/codeql-action from 2 to 3 by @dependabot in https://github.com/ropensci/cffr/pull/60
- Bump actions/upload-artifact from 3 to 4 by @dependabot in https://github.com/ropensci/cffr/pull/61
- Overhaul of cff-bibtex conversion system by @dieghernan in https://github.com/ropensci/cffr/pull/63
- New API by @dieghernan in https://github.com/ropensci/cffr/pull/65
- Refactor internal code by @dieghernan in https://github.com/ropensci/cffr/pull/67
- Doc review by @dieghernan in https://github.com/ropensci/cffr/pull/68
New Contributors
- @dependabot made their first contribution in https://github.com/ropensci/cffr/pull/59
Full Changelog: https://github.com/ropensci/cffr/compare/v0.5.0...v1.0.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 2 years ago
cffr - cffr 0.5.0
Lifecycle
- Function
cff_to_bibtex()andcff_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 acffobject (#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 anattributes()named"error", asjsonvalidate::json_validate()does whenverbose = TRUE:Be verbose? If
TRUE, then an attribute"errors"will list validation failures as a data.frameImprovements in the extraction of
`date-release`.
What's Changed
- Allow to add more authors by role by @dieghernan in https://github.com/ropensci/cffr/pull/50
- Improve testing by @dieghernan in https://github.com/ropensci/cffr/pull/52
- Improve documentation by @dieghernan in https://github.com/ropensci/cffr/pull/53
- Improve tests and messages by @dieghernan in https://github.com/ropensci/cffr/pull/54
- Add write_citation function by @dieghernan in https://github.com/ropensci/cffr/pull/55
Full Changelog: https://github.com/ropensci/cffr/compare/v0.4.1...v0.5.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan about 3 years ago
cffr - cffr 0.4.1
- Replace crayon dependency for cli (#46).
- Improvements on the performance of
cff_validate().
What's Changed
- Update badge by @dieghernan in https://github.com/ropensci/cffr/pull/45
- Migrate to cli from crayon by @dieghernan in https://github.com/ropensci/cffr/pull/47
Full Changelog: https://github.com/ropensci/cffr/compare/v0.4.0...v0.4.1
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 3 years ago
cffr - cffr 0.4.0
- 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
- typo by @dpprdan in https://github.com/ropensci/cffr/pull/40
- Add cfffrombibtex() by @dieghernan in https://github.com/ropensci/cffr/pull/41
New Contributors
- @dpprdan made their first contribution in https://github.com/ropensci/cffr/pull/40
Full Changelog: https://github.com/ropensci/cffr/compare/v0.3.0...v0.4.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 3 years ago
cffr - cffr 0.3.0
-
preferred-citationis 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 oncff()but new function added in order to provide clarity.
What's Changed
- Improve preferred-citation handling by @dieghernan in https://github.com/ropensci/cffr/pull/38
Full Changelog: https://github.com/ropensci/cffr/compare/v0.2.3...v0.3.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan almost 4 years ago
cffr - cffr 0.2.3
- Update docs to HTML5
Full Changelog: https://github.com/ropensci/cffr/compare/v0.2.2...v0.2.3
Scientific Software - Peer-reviewed
- R
Published by dieghernan almost 4 years ago
cffr - cffr 0.2.2
- cffr now uses a local copy of the schema.json for validating. (#33).
What's Changed
- Validate against a local copy by @dieghernan in https://github.com/ropensci/cffr/pull/34
Full Changelog: https://github.com/ropensci/cffr/compare/v0.2.1...v0.2.2
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 4 years ago
cffr - cffr 0.2.1
GitHub Action now runs only on
masterormainbranch.Better handling of references
Full Changelog: https://github.com/ropensci/cffr/compare/v0.2.0...v0.2.1
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 4 years ago
cffr - cffr 0.2.0
Now cffr extracts also information of the package dependencies and adds the main citation of the dependencies to the
referencesfield, usingcitation(auto = TRUE).- New
dependenciesparameter oncff_create()andcff_write().
- New
Other improvements on
cff_parse_citation():-
cff_parse_citation()extracts more information of authors, based on the fields provided on the DESCRIPTION file. -
cff_parse_citation()does a better job extracting information frombibentry()/BibTeX and mapping it topreferred-citation/referencesfields of CFF.
-
Add new functions for working with git pre-commit hooks
:
-
cff_git_hook_install() -
cff_git_hook_remove()
-
New BibTeX functions:
-
cff_extract_to_bibtex() -
cff_to_bibtex() -
cff_parse_person_bibtex() -
write_bib()
-
Add a new dependency:
lifecycle.
What's Changed
- Rebase hook by @dieghernan in https://github.com/ropensci/cffr/pull/23
- Add a git hook by @dieghernan in https://github.com/ropensci/cffr/pull/24
- Add capacities for creating bibtex files by @dieghernan in https://github.com/ropensci/cffr/pull/26
- Improve bibtex conversion by @dieghernan in https://github.com/ropensci/cffr/pull/27
- New vignette by @dieghernan in https://github.com/ropensci/cffr/pull/28
Full Changelog: https://github.com/ropensci/cffr/compare/v0.1.1...v0.2.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 4 years ago
cffr - cffr 0.1.1
- Accepted on JOSS
- Include
pagesoncff_parse_citation(). - New
gh_keywordsparameter oncff_create()/cff_write(). IfTRUE, it would include GitHub repo topics as keywords.
What's Changed
- Add support for
pagesby @dieghernan in https://github.com/ropensci/cffr/pull/16 - Add JOSS by @dieghernan in https://github.com/ropensci/cffr/pull/17
- Add remote keyword for GH repos by @dieghernan in https://github.com/ropensci/cffr/pull/18
- Add vignette paper by @dieghernan in https://github.com/ropensci/cffr/pull/19
- Add JOSS paper vignette by @dieghernan in https://github.com/ropensci/cffr/pull/20
Full Changelog: https://github.com/ropensci/cffr/compare/v0.1.0...v0.1.1
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 4 years ago
cffr - cffr 0.1.0
- First CRAN release
What's Changed
- Update DOI and docs by @dieghernan in https://github.com/ropensci/cffr/pull/15
Full Changelog: https://github.com/ropensci/cffr/compare/v0.0.2...v0.1.0
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 4 years ago
cffr - cffr 0.0.2
-
cffris part now of rOpenSci. - Update on docs and README.
- Add fuzzy match on
keysparameter. - New dataset:
cran_to_spdx. - Add DOI https://doi.org/10.5281/zenodo.5509766
- Citation of installed packages extracted using
citation(). - Auto-generating
preferred-citationkey from DESCRIPTION. - Rename
cff_schema_definitions_reference()tocff_schema_definitions_refs(). - "repository" key is supported.
- Added vignette:
vignette("crosswalk", package = "cffr"). - Add support to Bioconductor packages.
- New function:
cff_gha_update().
What's Changed
- [ImgBot] Optimize images by @imgbot in https://github.com/ropensci/cffr/pull/6
- Improve logo by @dieghernan in https://github.com/ropensci/cffr/pull/9
- [ImgBot] Optimize images by @imgbot in https://github.com/ropensci/cffr/pull/11
- ropensci review: address feedback by @dieghernan in https://github.com/ropensci/cffr/pull/10
- Address feedback from @sckott by @dieghernan in https://github.com/ropensci/cffr/pull/12
- Update links and gh actions by @dieghernan in https://github.com/ropensci/cffr/pull/13
New Contributors
- @dieghernan made their first contribution in https://github.com/ropensci/cffr/pull/9
Full Changelog: https://github.com/ropensci/cffr/compare/v0.0.1...v0.0.2
Scientific Software - Peer-reviewed
- R
Published by dieghernan over 4 years ago
cffr - cffr 0.0.1
- First stable release
Scientific Software - Peer-reviewed
- R
Published by dieghernan almost 5 years ago