# setuptools_scm

**Repository Path**: mirrors_pypa/setuptools_scm

## Basic Information

- **Project Name**: setuptools_scm
- **Description**: the blessed package to manage your versions by scm tags
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# setuptools-scm Monorepo

This is the monorepo for the setuptools-scm ecosystem, containing two main projects:

## Projects

### [setuptools-scm](./setuptools-scm/)

The main package that extracts Python package versions from Git or Mercurial metadata and provides setuptools integration.

**[Read setuptools-scm documentation →](./setuptools-scm/README.md)**

### [vcs-versioning](./vcs-versioning/)

Core VCS versioning functionality extracted as a standalone library that can be used independently of setuptools.

**[Read vcs-versioning documentation →](./vcs-versioning/README.md)**

## Development

This workspace uses [uv](https://github.com/astral-sh/uv) for dependency management.

### Setup

```bash
# Install all packages with all dependency groups (tests, docs, etc.)
uv sync --all-packages --all-groups
```

### Running Tests

```bash
# Run all tests
uv run pytest -n12

# Run tests for setuptools-scm only
uv run pytest setuptools-scm/testing_scm -n12

# Run tests for vcs-versioning only
uv run pytest vcs-versioning/testing_vcs -n12
```

### Building Documentation

Documentation is shared across projects:

```bash
uv run mkdocs serve
```

## Links

- **Documentation**: https://setuptools-scm.readthedocs.io/
- **Repository**: https://github.com/pypa/setuptools-scm/
- **Issues**: https://github.com/pypa/setuptools-scm/issues

## License

Both projects are distributed under the terms of the MIT license.