tortoise-database-url 0.5.0

Make it easy to generate database url.

database-url

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='[e-mail]')
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='[e-mail]')
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