This repository collects the UCL ARC recommendations for a research software
project in Python. It contains a template for new Python packages and a
website documenting our recommendations. We've turned on
discussions for this
repo, and we welcome questions there or in the #helpme channel on the
UCL research programming hub Slack.
🍪 Our template is a cookiecutter template which automatically creates new Python packages with our recommended tooling set up and ready to go.
Note
If you're making a package within a community that has an existing
package template (e.g., scikit-hep),
we recommend using their template instead of this one.
Some quick instructions for using our template are below. We also have a tutorial that has been presented in a couple of workshops aimed at researchers at UCL.
If you have uv installed, you can use our template with the following one-liner:
uvx cookiecutter gh:ucl-arc/python-tooling --checkout latestAlternatively you can install cookiecutter (following the recommended instructions). Do this if you don't use uv, or if you're likely to want to use cookiecutter again.
Then you'll need to run cookiecutter with our template:
cookiecutter gh:ucl-arc/python-tooling --checkout latestWhen cookiecutter runs, it will ask you a series of questions to configure your project. Type the answer or hit return without typing anything to use the default option (shown in parenthesis). At the end, it will print some more follow-up information in the terminal for things like creating a remote repository and making a website for your package.
It will have created a directory for your project.
You can see the structure with the tree command.
In our example we've called our project example-research-software-project:
ls -ltr | tail -n1 # Shows the last directory that was created
tree example-research-software-projectTo work on your project, initialise a git repository and install your new package editable mode.
You probably want to do this in a virtual environment.
The comments show how to do this in uv with uv venv:
cd example-research-software-project
git init
# uv venv
# source .venv/bin/activate
uv pip install -e ".[dev]"
