Skip to main content

A time-saving CLI to start a new Python project with uv

Project description

Using uvtemplate

uvtemplate

Documentation CI status image uv Copier X (formerly Twitter) Follow

Usage

Two words:

uvx uvtemplate

It will guide you!

Do I Need uv?

Yes. You will need to have uv installed. Read that page or my template docs for background on why uv is such an improved package manager for Python.

What is uvtemplate?

A time-saving CLI tool to quickly start new Python projects with uv using the simple-modern-uv template and copier.

It's the tool I wish I'd had when setting up projects with uv.

uvx uvtemplate will clone a new project template and help you set up your GitHub repo. The template tiny and sets up uv, ruff linting and formatting, GitHub Actions, publishing to PyPI, type checking, and more.

What Python Project Template Does it Use?

The simple-modern-uv template. See that repo for full docs and this thread for a bit more context.

If you prefer, you can use that template directly; uvtemplate is just a CLI wrapper for the template.

If you have another copier-format template you want to use, however, you can specify it with the --template argument.

Can I Use it With an Existing Project?

Yes. Just cancel after the template is copied (skip the part that pushes to git) and you'll have a new working tree with all the uv and tooling set up. Then manually copy over all the parts you want into your existing project.

By Chance Is There a Short URL I Can Remember for This Handy Tool?

Funny you should ask!

Type git.new/uvtemplate into your browser.

Tell your friends!


This project was (of course) built using simple-modern-uv.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uvtemplate-0.1.9.tar.gz (51.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

uvtemplate-0.1.9-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file uvtemplate-0.1.9.tar.gz.

File metadata

  • Download URL: uvtemplate-0.1.9.tar.gz
  • Upload date:
  • Size: 51.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for uvtemplate-0.1.9.tar.gz
Algorithm Hash digest
SHA256 284be48d938f44710dca3ad8a93cbf17846c6cf49a44e7f092fa7747cfdea6da
MD5 19fd1719a38020eecfc91913d469aea6
BLAKE2b-256 f6f3c6c5078b8538cb6d0f7770fade02fe79b6cae2bff5b6d323ef55629d536a

See more details on using hashes here.

File details

Details for the file uvtemplate-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: uvtemplate-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 12.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for uvtemplate-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 60428e9fba71f3560a56e67cd56623018f43f5c8ac786174ec5ed8ff040c0345
MD5 3fabd3a12d642232eee3d255fe3bcfbf
BLAKE2b-256 867b63aaa0a523e79b89b3c5604342f1071a7bfb9fdc1d546bec52febbc3d698

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page