Skip to main content

Plug Kinto notifications to a collection endpoint.

Project description

https://img.shields.io/travis/Kinto/kinto-changes.svg https://img.shields.io/pypi/v/kinto-changes.svg https://coveralls.io/repos/Kinto/kinto-changes/badge.svg?branch=master

kinto-changes shows the list of collection timestamps, allowing to poll changes on several collections with one HTTP request.

Install

pip install kinto-changes

Setup

In the Kinto settings:

kinto.includes = kinto_changes

# List of buckets/collections to show:
kinto.changes.resources = /buckets/settings
                          /buckets/blocklists/collections/certificates

The list of timestamps is available at GET /v1/buckets/monitor/collections/changes/records.

Advanced options

The changes entries will have a host attribute, that can be used to distinguish changes from several Kinto instances.

kinto.changes.http_host = website.domain.tld

By default, it will rely on the global setting kinto.http_host.

Changelog

1.1.0 (2017-11-16)

Breaking changes

  • Upgrade to Kinto 7

Bug fixes

  • Disable reify to always get the most accurate timestamp. (#36)

1.0.0 (2017-02-14)

Bug fixes

  • Accessing the monitoring collection when no changes occured don’t fail anymore (fixes #23)

  • The timestamps shown in the monitoring endpoint are now exactly equal (never superior anymore) to the timestamps of the monitored collections.

Breaking changes

  • The change endpoint location is now hard-coded (/buckets/monitor/collections/changes/records) and cannot be configured.

  • The permissions principals cannot be specified anymore. The change endpoint is now always public.

  • The monitor bucket and changes collection are not required anymore and are not created anymore.

  • POST and DELETE are not supported on the changes endpoint anymore.

  • Individual entries (eg. /buckets/monitor/collections/changes/records/{id}) cannot be accessed anymore.

  • The listener was dropped. Configuration must be changed:

Before:

kinto.event_listeners = changes
kinto.event_listeners.changes.use = kinto_changes.listener
kinto.event_listeners.changes.http_host = website.domain.tld
kinto.event_listeners.changes.collections = /buckets/settings
                                            /buckets/blocklists/collections/certificates

Now:

kinto.changes.http_host = website.domain.tld
kinto.changes.resources = /buckets/settings
                          /buckets/blocklists/collections/certificates

0.5.0 (2017-01-16)

  • Do not force the timestamp of monitored entries (#27)

0.4.0 (2016-11-07)

  • Add the plugin version in the capability (#20)

  • Add collections in the capability (#18)

  • Add a specific setting to override global http_host value (#24)

0.3.0 (2016-05-19)

  • Update to kinto.core for compatibility with Kinto 3.0. This release is no longer compatible with Kinto < 3.0, please upgrade!

0.2.0 (2016-04-25)

  • Addition of the changes capability

0.1.0 (2015-12-22)

  • Initial code.

  • Bucket and collection name configuration.

  • Changes read permissions configuration.

  • Selection of buckets and collections to follow configuration.

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

kinto-changes-1.1.0.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

kinto_changes-1.1.0-py2.py3-none-any.whl (7.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file kinto-changes-1.1.0.tar.gz.

File metadata

File hashes

Hashes for kinto-changes-1.1.0.tar.gz
Algorithm Hash digest
SHA256 9ce9bb47fbf0f9a3b6669d60a8d0bd4a4cfcfd34e75f6bf01003226d69fb5dc8
MD5 717654bbe50c478440cc914508384cc4
BLAKE2b-256 2a64be5fcd9201082bab596f203e323e9f27231da25b9a30475199db2cbc374f

See more details on using hashes here.

Provenance

File details

Details for the file kinto_changes-1.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for kinto_changes-1.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a45672c54f29fd958e30ca0fe803a88574c1a239c70c4ce27894de6392a01466
MD5 e0a4528243475bf53904f9c828523e1c
BLAKE2b-256 cf9fdb1cd8c0e9fc80aeb3eb3266c936218098e790d1a278e66dee98fbfb5903

See more details on using hashes here.

Provenance

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