RSS Parrot

Cover and modify, some tips for R package development

https://masalmon.eu/2024/09/24/cover-modify-r-packages/

Published: September 24, 2024 00:00

I’ve recently been dealing with legacy code refactoring both in theory and in practice: while I’m continuing some work on the igraph R package, I’ve started reading Working Effectively with Legacy Code by Michael Feathers, that had been in my to-read pile…

Create and use a custom roxygen2 tag

https://masalmon.eu/2024/09/03/roxygen2-custom-tag/

Published: September 3, 2024 00:00

You might know that it’s possible to extend roxygen2 to do all sorts of cool things including but not limited to: documenting your internal functions for developers only (that’s devtag by my cynkra colleague Antoine Fabri), recording your following…

Does my test really validate a bug fix? Check it with git cherry-pick

https://masalmon.eu/2024/08/29/cherrypick-test/

Published: August 29, 2024 00:00

Earlier this year I wrote a post about git worktree that allows you to load different versions of an R package at once on your computer. To keep with the “juggle between versions of a codebase with Git plant-related commands” theme, let me show you how I…

Get your codebase lint-free forever with lintr

https://masalmon.eu/2024/08/28/lintr-3-steps/

Published: August 28, 2024 00:00

Writing good code is hard. Some aspects get easier with experience – although I observe that I consistently forget some things. 🙈 Other aspects can be tackled through code review – although your reviewer’s time will be better spent on design questions than…

Extracting names of functions defined in a script with treesitter

https://masalmon.eu/2024/07/18/extract-function-names-treesitter/

Published: July 18, 2024 00:00

Coming back from a conference, we might be excited to install and try out the cool things we have heard about. I, going against the stream 🐟, decided to experiment with a tool I have not heard about last week, as I unfortunately missed Davis Vaughan’s talk…

Extracting all links from my slidedeck

https://masalmon.eu/2024/07/16/extract-links-from-md/

Published: July 16, 2024 00:00

Last week after my useR! talk, someone I had met at the R-Ladies dinner asked me for a list of all the links in my slides. I said I’d prepare it, not because I’m a nice person, but because I knew it’d be an use case where the great tinkr package would…

Hack your way to a good Git history

https://masalmon.eu/2024/06/11/rewrite-git-history/

Published: June 11, 2024 00:00

I’ve now explained on this blog why it’s important to have small, informative Git commits1 and how I’ve realized that polishing history can happen in a second phase of work in a branch. However, I’ve more or less glossed over how to craft the history in a…

Why you need small, informative Git commits

https://masalmon.eu/2024/06/03/two-phases-git-branches/

Published: June 3, 2024 00:00

“Make small Git commits with informative messages” is a piece of advice we hear a lot when learning Git. That’s why we might want to sometimes rewrite history in a branch. In this post, I’d like to underline three main (😉) reasons why you’ll be happy you,…

What I edit when refactoring a test file

https://masalmon.eu/2024/05/23/refactoring-tests/

Published: May 23, 2024 00:00

I’m currently refactoring test files in a package. Beside some automatic refactoring, I am also manually updating lines of code. Here are some tips (or pet peeves, based on how I look at it / how tired I am 😁) Prequel: please read the R packages book The…

Automate code refactoring with {xmlparsedata} and {brio}

https://masalmon.eu/2024/05/15/refactoring-xml/

Published: May 15, 2024 00:00

Once again a post praising XML. 😇 These are notes from a quite particular use case: what if you want to replace the usage of a function with another one in many scripts, without manual edits and without touching lines that do not contain a call to replace?…