Skip to main content

Django Human.json

This package implements the human.json protocol. The current supported protocol version is 0.1.1. Django admin is setup to create vouchers.

Setup

dj_human_json can be installed via PyPI or you can simply copy the dj_human_json directory in this repository into your Django project.

pip install django-human-json

Once you added dj_human_json to your INSTALLED_APPS, you need to add one new variable to your settings.py with the canonical URL you want to claim ownership for. Port, protocol and subdomain must be an exact match.

DJ_HUMAN_JSON_URL = "https://www.screamingatmyscreen.com"  # replace with your own domain!

Include the dj_human_json view in your projects urls.py. The path does not matter.

from django.contrib import admin
from django.urls import path

from dj_human_json.views import human_json

urlpatterns = [
    path("admin/", admin.site.urls),
    path("human.json", human_json, name="human.json"),
]

Last step is advertising human.json via link in the head section of your HTML template.

<html lang="en">

<head>
    <link rel="human-json" href="/human.json" />
</head>

You likely want to use the URL template tag and not be lazy as I am in this example.

Vouching for sites

Go to Djangos admin interface and create a new entry in the Vouch table or create vouches via shell.

Vouch.objects.create(url="https://www.screamingatmyscreen.com")

CI status

The public repository shows the CI as waiting which is a result of the repository being a push mirror and the actual CI running on our internal Forgejo instance. Releases are tested, pinky promise.

Release files for django-human-json 0.1.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 django-human-json 0.1.0
File Size Uploaded
django_human_json-0.1.0.tar.gz 3.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-human-json 0.1.0
File Interpreter ABI Platform
django_human_json-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size:8.4 kB

Release files / django_human_json-0.1.0.tar.gz

Download URL django_human_json-0.1.0.tar.gz
Size 3.1 kB
Tags Source
SHA-256 checksum
How to use checksums
3e51d5bf6400f9275668d0f6b1c1280f7d9667d4453a63c96d925ec6900ae292
BLAKE2b-256 checksum
How to use checksums
3f94b10dabd8a99cdd9d364c4f95300e003589bcba7b3fb43c072a4b67cd2735
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / django_human_json-0.1.0-py3-none-any.whl

Download URL django_human_json-0.1.0-py3-none-any.whl
Size 5.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c7fa0f8e613bcd26645ead9c424ad101904d48446e9b8d9469a9ac9a633132fc
BLAKE2b-256 checksum
How to use checksums
5c0c1d1b28ce73a8da945b0bb1b34b5b790d531f0987ba7d8ab733348598e4ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page