database-url

Python Versions Mypy coverage

Toolkit for TortoiseORM to generate database url from Django DATABASES item format.

Installation

pip install tortoise-database-url

Or by uv/pdm:

uv add tortoise-database-url
pdm add tortoise-database-url

Usage

DbUrl

from tortoise_database_url import DbUrl

db_url = DbUrl.mysql("my_db", user="root", password="Me@example.com")
print(db_url)
# mysql://root:Me%40example.com@127.0.0.1:3306/my_db

generate

import tortoise_database_url

db_url = tortoise_database_url.generate(
    "my_db", engine="mysql", user="root", password="Me@example.com"
)
print(db_url)
# mysql://root:Me%40example.com@127.0.0.1:3306/my_db

db_url = tortoise_database_url.generate("db_name", engine="postgres")
print(db_url)
# postgres://postgres:postgres@127.0.0.1:5432/db_name

from_django_item

import pathlib
import tortoise_database_url

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": pathlib.Path("/tmp") / "db.sqlite3",
    },
}

db_url = tortoise_database_url.from_django_item(DATABASES["default"])
print(db_url)
# sqlte:///tmp/db.sqlite3

See more at: https://github.com/waketzheng/database-url/blob/main/tests/test_main.py https://tortoise.github.io/databases.html?h=database

Metadata

Release files for tortoise-database-url 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tortoise-database-url 0.8.0
File	Size	Uploaded
tortoise_database_url-0.8.0.tar.gz	7.6 kB	Sep 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for tortoise-database-url 0.8.0
File	Interpreter	ABI	Platform	Reset
tortoise_database_url-0.8.0-py3-none-any.whl 5.4 kB Sep 26, 2026	Python 3	none	any	Details

Total release size: 13.1 kB

Release files / tortoise_database_url-0.8.0.tar.gz

Download URL	tortoise_database_url-0.8.0.tar.gz
Size	7.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`47e7fb1c4817ee46e4c621413121e73894748307a4fb2413d52c4e9f2d0773c6`
BLAKE2b-256 checksum How to use checksums	`f22048aeffe185478fb38139bd291370b6998b12307da6aafebd916754e51074`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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}`

Release files / tortoise_database_url-0.8.0-py3-none-any.whl

Download URL	tortoise_database_url-0.8.0-py3-none-any.whl
Size	5.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f19223138a6bfc5d9c78be8cb5f04908a21e99f48419cd7e39a72d93efde56e7`
BLAKE2b-256 checksum How to use checksums	`bb89173939f356885df0f1716e68ca26d58315b12731a53dda6ce6c0245c28a7`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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}`