DMCAed

A command-line tool and a python library to analyze GitHub DMCA takedown notices. It downloads, parses, and indexes takedown data from the GitHub DMCA repository to allow querying which repository URL can be found in takedown requests. Please note that this only means the repository URL might have been subject to takedown requests.

Installation

DMCAed requires at least python 3.11.

pip install dmcaed

CLI

dmcaed [--verbose] [command]

Commands

• download: Download the latest DMCA notices from GitHub
• analyze: Parse downloaded notices and extract takedown data
• db: Rebuild the complete DMCA database (download + analyze)
• stats: Show statistics about the database content
• notices <url>: List takedown notices for a specific repository URL

Options

• --verbose: Enable debug logging
• -h, --help: Show help message

Library Usage

from dmcaed import DMCAed

dmca = DMCAed()
notices = dmca.notices("https://github.com/user/repo")

if notices:
    print(f"https://github.com/user/repo _might_ be subject to a takedown: {notices}")

How it works

• Download the latest DMCA notices from GitHub
• Extract repository URLs (path to files, issues, releases, etc. are truncated) mentioned in takedown notices
• Build a local SQLite database mapping repository URLs to takedown notices

Build and Release

### Prerequisites

The project uses hatch build system and dynamic CalVer versioning based on the current date.

pip install hatch hatch-calver

Git clone and install DMCAed.

git clone ssh://git@codeberg.org/canarduck/dmcaed.git
pip install -e .

Update the package and publish it on PyPI

You first need to fetch DMCAs and create/update the database.

dmcaed db

Then use hatch to update version number and build the package.

hatch version release
# use `hatch version release,fix` in case you need to fix an already released package

Build the package and publish it on PyPI.

hatch build
hatch publish --user __token__ --auth PYPI_AUTH_TOKEN