django-overcomingbias-api

django-overcomingbias-api is a standalone Django app which lets you create and manage an API to (some of) Robin Hanson’s content.

It scrapes the overcomingbias blog (and other sites) and presents the data in a structured form via a REST API. (I may add a GraphQL API later, too.)

Basic Usage

A graphical user interface is provided through the Django admin site.

To initialise a database of all overcomingbias posts, use the “pull” button:

Create and update overcomingbias posts from the admin site

Add new posts with “pull”, and update modified posts with “sync”. (You can also add content from YouTube and Spotify.)

Categorise content according to the “ideas” and “topics” it contains, or by generic “tags”. Use the admin site and custom Admin Actions to manage content.

Link the app in your URL config to access the REST API:

# urls.py

urlpatterns = [
    ...
    path("", include("obapi.urls")),
    ...
]

You should then be able to access the automatic API documentation at URL /api/docs.

Alternatively, provide your own views for each post:

# urls.py
from django.urls import path, register_converter
from obapi.converters import OBPostNameConverter
from myapp.views import ob_detail_view

register_converter(OBPostNameConverter, "ob_name")
urlpatterns = [
    ...
    path(
        "content/overcomingbias/<ob_name:item_id>",
        ob_detail_view, # custom view
        name="obcontentitem_detail",
    ),
    ...
]

Features

Currently, content can be scraped from the following sources:

The overcomingbias blog (added automatically)
Robin Hanson’s home page
YouTube videos (add videos manually using their URLs)
Spotify podcast episodes (add episodes manually using their URLs)

Documentation

Read the full documentation here, including the Installation and Getting Started Guide.

Bugs/Requests

Please use the GitHub issue tracker to submit bugs or request features.

Changelog

See the Changelog for a list of fixes and enhancements at each version.

License

Distributed under the terms of the MIT license.

All overcomingbias posts are copyright the original authors.

Release files for django-overcomingbias-api 0.6.3

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-overcomingbias-api 0.6.3
File	Size	Uploaded
django_overcomingbias_api-0.6.3.tar.gz	292.0 kB	Feb 6, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-overcomingbias-api 0.6.3
File	Interpreter	ABI	Platform	Reset
django_overcomingbias_api-0.6.3-py3-none-any.whl 41.6 kB Feb 6, 2023	Python 3	none	any	Details

Total release size: 333.5 kB

Release files / django_overcomingbias_api-0.6.3.tar.gz

Download URL	django_overcomingbias_api-0.6.3.tar.gz
Size	292.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`e5a81aef5362fa8a248e3d536750d5b6e8b2ff494aff3245e0ce9779b1d36b4c`
BLAKE2b-256 checksum How to use checksums	`0c4e8e4947df854bc3e8d7be18a2fdc5999abfbc6c0ab858402fa0dfc8b5cc07`
Upload date	Feb 6, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.11.1`

Release files / django_overcomingbias_api-0.6.3-py3-none-any.whl

Download URL	django_overcomingbias_api-0.6.3-py3-none-any.whl
Size	41.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`00ac709ed1fb3e17e80c833bc5c8111f685844d3e97d0615911f55a57d9a2c8a`
BLAKE2b-256 checksum How to use checksums	`a1feb22466aa4019d8972cbe021bc3b823e4ff59b6ea7bd0a03fb76249f0a35b`
Upload date	Feb 6, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.11.1`