Skip to main content

A Datasette plugin for commenting on tables, rows, and values

Project description

datasette-comments

PyPI Changelog Tests License

A Datasette plugin for commenting on tables, rows, and values. Work in progress, not ready yet!

Installation

Install this plugin in the same environment as Datasette.

datasette install datasette-comments

Usage

Once installed, users with the datasette-comments-access will be able to view and add comments on rows within their Datasette instance.

Plugin hooks

This plugin provies the following plugin hook which can be used to customize its behavior:

datasette_comments_users(datasette)

This hook should return a list of dictionaries, each representing a user that should be made available to the plugin. Each dictionary should have the following keys:

  • id: A unique ID of the user, same as the actor ID.
  • username: A unique string that is used in searches and @ mentions.
  • name: A string of the user's natural name.
  • profile_photo_url: Optional URL to the user's profile pic.
  • email: Optional email used for gravatar profile photo, if enabled.

The plugin hook can return a list, or it can return an awaitable function that returns a list.

Development

To set up this plugin locally, first checkout the code. Then create a new virtual environment:

cd datasette-comments
python3 -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

And for the JavaScript dependencies (needed to run a JavaScript build):

npm install

To run the tests:

pytest

To rebuild the minified JavaScript after making a change to a .ts or .tsx file:

just js

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

datasette-comments-0.1.0.tar.gz (47.6 kB view details)

Uploaded Source

Built Distribution

datasette_comments-0.1.0-py3-none-any.whl (53.8 kB view details)

Uploaded Python 3

File details

Details for the file datasette-comments-0.1.0.tar.gz.

File metadata

  • Download URL: datasette-comments-0.1.0.tar.gz
  • Upload date:
  • Size: 47.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for datasette-comments-0.1.0.tar.gz
Algorithm Hash digest
SHA256 5b29abdb2bb9b115fae4f68c0d84560213ba63682dc6711fc571a86b0ee9cbfb
MD5 61bbd08da649849c768cffa6fa6de641
BLAKE2b-256 b3f54cbf49ac7556f4b0590f77edcf273cd36de45ae1231157ceddea2fe23644

See more details on using hashes here.

File details

Details for the file datasette_comments-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for datasette_comments-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d740f93c66dd50c3b6e1bf5bc3ae1518dea1f4a57a1c780ff669bf5e328b9da5
MD5 db7a91d1524ea1490076b97ddc3fd73f
BLAKE2b-256 e74ed6163b8d5918fbd98286260efbfc09ac02b44b6313570a4d113b783ef489

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page