Add support for DATABASE_URL

[girardinsamuel]

Fix #307.

Here is a proposal for supporting DATABASE_URL:

Import the helper

from masoniteorm.config import db_url

This helper will return a full config dict that you can directly use in DATABASES config:

DATABASES = {
    "default": "mysql",
    "mysql": db_url(),
}

Here as no url string is given it will automatically use DATABASE_URL env (as often exposed by PaaS service: Heroku...)

You want to use an other env variable ? No problem:

DATABASES = {
    "default": "mysql",
    "mysql": db_url(os.getenv("DB_URL")),
}

Of course you can specify an url directly:

DATABASES = {
    "default": "mysql",
    "mysql": db_url("mysql://root:@localhost:3306/orm"),
}

...and you can specify additional parameters:

DATABASES = {
    "default": "mysql",
    "mysql": db_url("mysql://root:@localhost:3306/orm", log_queries=True, prefix="", options={}),
}

...or you can just merge it with some other options (not related to the url):

DATABASES = {
    "default": "mysql",
    "mysql": {
        **db_url("mysql://root:@localhost:3306/orm"),
        "prefix": "",
        "options": {},
        log_queries=True
     }
}

It support all drivers.

For SQLite it's:

db_url("sqlite://orm.sqlite3")

🎉 🚀

If it's okay, then I could add some unit tests.

[josephmancuso]

We could probably check for a couple of string here. Maybe also just :memory: too

[josephmancuso]

Nobody is going to remember this string without referring to the docs

[girardinsamuel]

Yeah we could check just :memory:. What do you mean by couple of strings lol ?

[josephmancuso]

if url in ("sqlite://:memory:", ":memory:")

I am also assuming that sqlite://:memory: is the officially supported string. I just want to be able to remember a string and I'm not going to remember sqlite://:memory: lol

[josephmancuso]

I'll forget one of the 3 : and pull my hair out why its not working

[girardinsamuel]

Oh okay got it. Actually you can already go the simple waysqlite:// but I can add sqlite://memory also.

[girardinsamuel]

Now you can use those for SQLite in memory:

db_url("sqlite://")
db_url("sqlite://memory")
db_url("sqlite://:memory:")  # the official one

And for a SQLite classic db file:

db_url("sqlite://orm.sqlite3")

[josephmancuso]

Looks great! Great implementation

[girardinsamuel]

Looks great! Great implementation

Unit tests have been added ✅ !