Skip to content

Commit

Permalink
Convert README and CHANGELOG to markdown
Browse files Browse the repository at this point in the history
  • Loading branch information
MarcoGlauser committed Sep 10, 2024
1 parent 46a198f commit 6bdcf6d
Show file tree
Hide file tree
Showing 5 changed files with 117 additions and 145 deletions.
28 changes: 28 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# History

## 0.6.0 (2024-09-10)

- Add Django 5.1 compatibility

## 0.5.0 (2023-12-07)

- Add Django 5.0 compatibility
- Add Python 3.12 compatibility

## 0.4.0 (2022-12-21)

- Deprecate Django 3.1 compatibility
- Add option to not log contentful webhook invocations with the
[LOG_CONTENTFUL_WEBHOOKS]{.title-ref} setting

## 0.3.0 (2022-06-04)

- Add Django 4.0 compatibility

## 0.2.0 (2021-02-16)

- Change receiver url from hook/ to contentful-webhook/

## 0.1.0 (2021-02-15)

- First release on PyPI.
34 changes: 0 additions & 34 deletions HISTORY.rst

This file was deleted.

88 changes: 88 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
# Contentful Webhook Receiver

[![image](https://badge.fury.io/py/contentful-webhook-receiver.svg)](https://badge.fury.io/py/contentful-webhook-receiver)

[![image](https://github.com/MarcoGlauser/contentful-webhook-receiver/actions/workflows/ci.yml/badge.svg)](https://github.com/MarcoGlauser/contentful-webhook-receiver/actions/workflows/ci.yml)

[![image](https://codecov.io/gh/MarcoGlauser/contentful-webhook-receiver/branch/master/graph/badge.svg)](https://codecov.io/gh/MarcoGlauser/contentful-webhook-receiver)

A Django package to receive Webhooks from Contentful as signals

## Documentation

The full documentation is at
<https://contentful-webhook-receiver.readthedocs.io>.

## Quickstart

Install Contentful Webhook Receiver:

pip install contentful-webhook-receiver

Add it to your \`INSTALLED_APPS\`:

``` python
INSTALLED_APPS = (
...
'contentful_webhook_receiver.apps.ContentfulWebhookReceiverConfig',
...
)
```

Add Contentful Webhook Receiver\'s URL patterns:

``` python
from contentful_webhook_receiver import urls as contentful_webhook_receiver_urls


urlpatterns = [
...
path(r'^', include(contentful_webhook_receiver_urls)),
...
]
```

Listen for the Contentful Webhook Receiver signal:

``` python
@receiver(contentful_publish_entry)
def entry_published(sender, instance: WebhookInvocation, **kwargs):
print(instance.data['sys']['content_type']['id'])
```

Register a Webhook on Contentful:

The path added to the urlpatterns is [contentful-webhook/]{.title-ref}.
If you\'re adding it to the root url configuration the path will be
[https://example.com/contentful-webook/]{.title-ref}

## Features

- TODO

## Running Tests

Does the code actually work?

poetry run tox

## Development commands

poetry install --with=dev

Cutting new release \-\-\-\-\-\--

poetry version <patch|minor|major>
# Update changelog
git add CHANGELOG.md pyproject.toml contentful_webhook_receiver/__init__.py
NEW_RELEASE=$(poetry version --short)
git commit -m "Release $NEW_RELEASE"
git tag $NEW_RELEASE
git push --tags

## Credits

Tools used in rendering this package:

- [Cookiecutter](https://github.com/audreyr/cookiecutter)
- [cookiecutter-djangopackage](https://github.com/pydanny/cookiecutter-djangopackage)
110 changes: 0 additions & 110 deletions README.rst

This file was deleted.

2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ version = "0.6.0"
description = "A Django package to receive Webhooks from Contentful as signals"
authors = ["MarcoGlauser <[email protected]>"]
license = "MIT"
readme = 'README.rst'
readme = 'README.md'
repository = 'https://github.com/MarcoGlauser/contentful-webhook-receiver'

[tool.poetry.dependencies]
Expand Down

0 comments on commit 6bdcf6d

Please sign in to comment.