Metadata-Version: 2.4
Name: unname
Version: 0.3.1
Summary: A simple CLI for anonymizing Python codebases for blind review.
Author: RyotaUshio
Author-email: RyotaUshio <ushio@ms.k.u-tokyo.ac.jp>
License-Expression: MIT
License-File: LICENSE
Requires-Dist: tomlkit>=0.13.3
Requires-Python: >=3.13
Project-URL: Repository, https://github.com/RyotaUshio/unname.git
Description-Content-Type: text/markdown

# 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](https://docs.astral.sh/uv/concepts/projects/workspaces), it anonymizes all workspace members.

## Prerequisite

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

## Usage

Using [uv](https://docs.astral.sh/uv):

```sh
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

```md
# 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

```md
# My Awesome Project

Code for the paper "My Awesome Method."

## Install

...
```
