What is (((Opalstack?

(((Opalstack.com is a developer friendly hosting company. It has a powerful API that enables full control over one’s hosting environment. A python wrapper is provided for the API.

Requirements

This app is tested on Django 5.1 and Python 3.12. It requires the aforementioned python API and the requests library. HTMX is injected for smooth interactions (JavaScript must be enabled in your browser).

Installation from PyPI

Activate your virtual environment and install with:

python -m pip install django-opalstack

In your Django project add:

INSTALLED_APPS = [
    # ...
    "django_opalstack",
]

# my_project/urls.py
urlpatterns = [
    # ...
    path("opal/", include("django_opalstack.urls", namespace="django_opalstack")),
]

Finally run the following management commands:

python manage.py migrate
python manage.py collectstatic

{% block content %}
{% endblock content %}
...
{% block extra-js %}
{% end block extra-js %}

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [BASE_DIR / "my_project/templates"],
        # ...
    },
]

Usage

You will need an (((Opalstack.com account (there is a 14-day free trial). Once logged in, obtain a API token from https://my.opalstack.com/tokens/. Copy the token KEY, then run the local server and browse to http://128.1.1.0:8000/admin/django_opalstack/token/add/ and create a new Token pasting the previously copied KEY. Go to http://128.1.1.0:8000/opal/token/ and select the newly added token. At the moment the app is read only, you will have to create OS users, Applications and Sites directly on Opalstack.

Tests

Tests with unittest, 99% coverage. Tested for Django 5.1 and Python 3.12 versions.

Changelog

• 0.1.0: First working version (read only)