Skip to content

Feature request: use_just() to add a minimal justfile for project tasks #2223

@Yousa-Mirage

Description

@Yousa-Mirage

Hi, I’d like to ask whether a small helper like use_just() would be considered in scope for usethis.

The idea would be simple: create a minimal justfile in the project root, similar to how use_make() creates a Makefile.

Motivation

just is a command runner that is increasingly used as a lightweight, cross-platform way to define common project tasks such as:

  • running tests
  • rendering documentation
  • formatting code
  • checking packages
  • building site or pkgdown output

Compared with Makefile, a justfile can be easier to read and adopt for users who are not already familiar with make, especially on Windows or in mixed OS teams.

Since usethis already provides helpers for setting up common project/developer infrastructure, a use_just() helper seems like a natural extension for teams and package authors who prefer just as their task runner. For those users, a use_just() helper could provide a convenient way to initialize a justfile with a very small starter template.

Possible scope

I imagine use_just() as a deliberately small feature:

  • create a justfile in the project root if it does not already exist
  • add a minimal template
  • avoid enforcing a large or opinionated set of recipes

For example, the generated initial template could be as small as:

default:
    @just --list

so that users can extend it themselves.

Question

Would a helper like this be considered a good fit for usethis?

If this seems potentially in scope, I’d be happy to draft a PR.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions