Skip to content

Commit

Permalink
doc: update doc
Browse files Browse the repository at this point in the history
  • Loading branch information
mutantsan committed Oct 21, 2024
1 parent c6def82 commit 23cdfc7
Showing 1 changed file with 3 additions and 100 deletions.
103 changes: 3 additions & 100 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,72 +1,8 @@
[![Tests](https://github.com//ckanext-event-audit/workflows/Tests/badge.svg?branch=main)](https://github.com//ckanext-event-audit/actions)
[![Tests](https://github.com/DataShades/ckanext-event-audit/actions/workflows/test.yml/badge.svg)](https://github.com/DataShades/ckanext-event-audit/actions/workflows/test.yml)

# ckanext-event-audit

**TODO:** Put a description of your extension here: What does it do? What features does it have? Consider including some screenshots or embedding a video!


## Requirements

**TODO:** For example, you might want to mention here which versions of CKAN this
extension works with.

If your extension works across different versions you can add the following table:

Compatibility with core CKAN versions:

| CKAN version | Compatible? |
| --------------- | ------------- |
| 2.6 and earlier | not tested |
| 2.7 | not tested |
| 2.8 | not tested |
| 2.9 | not tested |

Suggested values:

* "yes"
* "not tested" - I can't think of a reason why it wouldn't work
* "not yet" - there is an intention to get it working
* "no"


## Installation

**TODO:** Add any additional install steps to the list below.
For example installing any non-Python dependencies or adding any required
config settings.

To install ckanext-event-audit:

1. Activate your CKAN virtual environment, for example:

. /usr/lib/ckan/default/bin/activate

2. Clone the source and install it on the virtualenv

git clone https://github.com//ckanext-event-audit.git
cd ckanext-event-audit
pip install -e .
pip install -r requirements.txt

3. Add `event-audit` to the `ckan.plugins` setting in your CKAN
config file (by default the config file is located at
`/etc/ckan/default/ckan.ini`).

4. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:

sudo service apache2 reload


## Config settings

None at present

**TODO:** Document any optional config settings here. For example:

# The minimum number of hours to wait before re-checking a resource
# (optional, default: 24).
ckanext.event_audit.some_setting = some_default_value

This extension will capture and retain a comprehensive record of all changes within a CKAN app.

## Developer installation

Expand All @@ -75,7 +11,7 @@ do:

git clone https://github.com//ckanext-event-audit.git
cd ckanext-event-audit
python setup.py develop
pip install -e .
pip install -r dev-requirements.txt


Expand All @@ -85,39 +21,6 @@ To run the tests, do:

pytest --ckan-ini=test.ini


## Releasing a new version of ckanext-event-audit

If ckanext-event-audit should be available on PyPI you can follow these steps to publish a new version:

1. Update the version number in the `setup.py` file. See [PEP 440](http://legacy.python.org/dev/peps/pep-0440/#public-version-identifiers) for how to choose version numbers.

2. Make sure you have the latest version of necessary packages:

pip install --upgrade setuptools wheel twine

3. Create a source and binary distributions of the new version:

python setup.py sdist bdist_wheel && twine check dist/*

Fix any errors you get.

4. Upload the source distribution to PyPI:

twine upload dist/*

5. Commit any outstanding changes:

git commit -a
git push

6. Tag the new release of the project on GitHub with the version number from
the `setup.py` file. For example if the version number in `setup.py` is
0.0.1 then do:

git tag 0.0.1
git push --tags

## License

[AGPL](https://www.gnu.org/licenses/agpl-3.0.en.html)

0 comments on commit 23cdfc7

Please sign in to comment.