django-overcomingbias-pages 0.2.2

django app web interface to Robin Hanson's content

django-overcomingbias-pages is a standalone Django app which provides a web interface to Robin Hanson’s content.

Features

The main features are:

• Scrape content from across the web (overcomingbias, YouTube, Spotify and more) via the admin site.

• Search content with django-haystack.

• Create sequences (series) of content and export them to PDF, epub, plaintext, or any other format supported by pandoc.

• Persistent user accounts.

Configuration

To configure django-overcomingbias-pages, add the following to your settings:

# settings.py

# add required apps
INSTALLED_APPS = [
  # required for admin site / user accounts
  "django.contrib.admin",
  "django.contrib.auth",
  "django.contrib.contenttypes",
  "django.contrib.sessions",
  "django.contrib.messages",
  # for collecting static files
  "django.contrib.staticfiles",
  # django-overcomingbias-api
  "ordered_model",
  "obapi",
  # haystack search
  "haystack",
  # async tasks
  "huey.contrib.djhuey",
  # django-overcomingbias-pages
  "obpages",
  # custom form rendering
  "django.forms",
]

# Use the (custom) obpages user model
AUTH_USER_MODEL = "obpages.User"

To configure search, follow the instructions on the haystack doc pages. If you don’t care about search, just add this to your settings:

# settings.py

# dummy backend for django-haystack
HAYSTACK_CONNECTIONS = {
  "default": {
    "ENGINE": "haystack.backends.simple_backend.SimpleEngine",
  },
}

django-overcomingbias-pages uses Huey to run tasks asynchronously. To enable this feature, follow the Django/Huey instructions. A minimal configuration is shown below:

# settings.py

connection_pool = ConnectionPool(host="127.0.0.1", port=6379, db=0, max_connections=100)

# See docs for full list of settings
HUEY = {
    "huey_class": "huey.PriorityRedisHuey",
    "name": PROJECT_NAME,
    "connection": {
        "connection_pool": connection_pool,
        # see redis-py for more options
        # https://redis-py.readthedocs.io/en/latest/connections.html
        "read_timeout": 0,
    },
    "consumer": {
        "workers": 4,
        "worker_type": "thread",
    },
}

(Note that this requires (1) a Redis server running on localhost:6379 and (2) installing via pip install django-overcomingbias-pages[redis].)

Optionally, you can also configure Huey as your email backend.

Bugs/Requests

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

License

Copyright (c) 2022 Christopher McDonald

Distributed under the terms of the MIT license.

All overcomingbias posts are copyright the original authors.