from optional_django.staticfiles import find

# Will resolve to an absolute path, if Django is configured and can find the file.
# Otherwise, None is returned
find('relative/path/to/file.txt')

# Will return the path provided, if it exists.
# Otherwise, None is returned
find('/absolute/path/to/file.txt')

from optional_django import six

# optional_django has vendored a version of `six` to remove
# a dependency on `django.utils.six`

# A boolean indicating if a module `django` can be found on the PYTHONPATH
# and it appears to resemble django's API
from optional_django.env import DJANGO_INSTALLED

# A boolean indicating that django appears to be configured
from optional_django.env import DJANGO_CONFIGURED

# if DJANGO_CONFIGURED is True, DJANGO_SETTINGS is django.conf.settings
# else, None
from optional_django.env import DJANGO_SETTINGS

# if DJANGO_CONFIGURED is True, JSONEncoder is django.core.serializers.json.DjangoJSONEncoder
# else, JSONEncoder is json.JSONEncoder
from optional_django.serializers import JSONEncoder

from optional_django import conf

class Conf(conf.Conf):
    FOO = 'BAR'
    BAR = [1,2,3]
    WOZ = 4

settings = Conf()

print(settings.WOZ)  # 4, or the value of django.conf.settings.SOME_APP['WOZ']

# Raises an error
settings.WOZ = 5

# Use `configure` instead
settings.configure(
    FOO='some value',
    WOZ=5
)

print(settings.FOO)  # 'some value'
print(settings.BAR)  # [1, 2, 3]
print(settings.WOZ)  # 5

# Configure can only be called once, this raises an error
settings.configure(WOZ=10)