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.2.1 (2018-09-17)

Bug fixes

  • Don’t do anything during a migrate command (fixes #43).

1.2.0 (2018-09-06)

New feature

  • Events are now generated on the monitor/changes collection (#41).

1.1.1 (2018-04-17)

Internal changes

  • Get rid of six

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.2.1.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kinto_changes-1.2.1-py2.py3-none-any.whl (6.6 kB view details)

Uploaded Python 2Python 3

File details

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

File metadata

  • Download URL: kinto-changes-1.2.1.tar.gz
  • Upload date:
  • Size: 12.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.6

File hashes

Hashes for kinto-changes-1.2.1.tar.gz
Algorithm Hash digest
SHA256 b361546b3a2adaf4c7b1c856ad72f380fa4f6569876ea40470f78676abfd850f
MD5 515bfb8030c2077457fdcfbd5375d297
BLAKE2b-256 1a6b644b5adca020476104d59d4ce5eefa2b589342c260fd314e356417e95c6c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kinto_changes-1.2.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.6

File hashes

Hashes for kinto_changes-1.2.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 49f95f1e448c502d57dd94a9c3162aff055d17705b9a86fbaebda5a501ee7416
MD5 fdd909e7d54d5cd290601346a891c517
BLAKE2b-256 a435fe536f9a8d0d639d4f058e0ba912d51c59b8355e57f40a0f97068ed01fd7

See more details on using hashes here.

Supported by

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