unname 0.3.0

A simple CLI for anonymizing Python codebases for blind review.

unname

A simple CLI for anonymizing Python codebases for blind review.

It anonymizes pyproject.toml and README.md in your project (see below for details). If your project is a uv workspace, it anonymizes all workspace members.

Prerequisite

Your project must be a git repository since unname internally uses git ls-files to filter out .gitignored files.

Usage

Using uv:

uvx unname -o <OUTPUT_DIRECTORY>

This will create an anonymized copy of your project in <OUTPUT_DIRECTORY>.

You can also run grep -r "Your Name" <OUTPUT_DIRECTORY> to verify your name is not accidentally left in the git repository.

What it does

1. Make a copy of your project

First of all, unname will create a copy of your project in the directory specified by the -o or --output option.

unname only copies git-tracked files so that you don't have to manually filter out irrelevant files such as .venv from your code submission.

Furthermore, you can provide a list of file paths or glob patterns to exclude from output by the --exclude option. By default, license files (LICEN[CS]E, LICEN[CS]E.*) are excluded.

2. pyproject.toml anonymization

project.authors, project.maintainers and project.urls fields will be removed (if they exist).

3. README.md anonymization

The content between <!-- begin-unname --> and <!-- end-unname --> will be removed. For example:

Input

# My Awesome Project

Code for the paper "My Awesome Method."

<!-- begin-unname -->
- Authors: Alice & Bob
- arXiv link: https://arxiv.org/abs/1234.56789
<!-- end-unname -->

## Install

...

Output

# My Awesome Project

Code for the paper "My Awesome Method."

## Install

...