From f70e2b3d3f6f79d0f2833b27e6d5154a7f815e16 Mon Sep 17 00:00:00 2001 From: Jan-Jelle Kester Date: Wed, 7 Oct 2015 22:49:32 +0200 Subject: [PATCH 1/2] Bump version number --- docs/source/conf.py | 2 +- docs/source/installation.rst | 6 +++--- setup.py | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index a421494d..664a0c81 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -62,7 +62,7 @@ # The short X.Y version. version = '0.3' # The full version, including alpha/beta/rc tags. -release = '0.3.1' +release = '0.3.2' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/docs/source/installation.rst b/docs/source/installation.rst index 67d4c388..9f59dfa9 100644 --- a/docs/source/installation.rst +++ b/docs/source/installation.rst @@ -12,10 +12,10 @@ The repository can be found at https://github.com/jjkester/django-auditlog/. **Requirements** - Python 2.7 or 3.4 -- Django 1.7 or 1.8 +- Django 1.7 or higher -Auditlog is currently tested with Python 2.7 and 3.4 and Django 1.7 and 1.8. The test report can be found at -https://travis-ci.org/jjkester/django-auditlog. +Auditlog is currently tested with Python 2.7 and 3.4 and Django 1.7, 1.8 and 1.9a1. The most up-to-date test report can +be found at https://travis-ci.org/jjkester/django-auditlog. Adding Auditlog to your Django application ------------------------------------------ diff --git a/setup.py b/setup.py index 2f235701..5124464b 100644 --- a/setup.py +++ b/setup.py @@ -2,7 +2,7 @@ setup( name='django-auditlog', - version='0.3.1', + version='0.3.2', packages=['auditlog', 'auditlog.migrations'], package_dir={'': 'src'}, url='https://github.com/jjkester/django-auditlog', From 2140cb03e911a9dd11027499e340d094d5525824 Mon Sep 17 00:00:00 2001 From: Jan-Jelle Kester Date: Mon, 19 Oct 2015 16:09:01 +0200 Subject: [PATCH 2/2] Update docs, readme --- README.md | 8 +++----- docs/source/index.rst | 15 ++++++++------- docs/source/installation.rst | 9 +++++---- 3 files changed, 16 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 45d00898..1afdf62e 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,3 @@ -*Since my time is very, very limited at the moment and my personal need for the functionality provided by django-auditlog has gone development might be very slow. However, I am happy to look at pull requests for issues. If you like to be a permanent contributor, please contact me (janjelle [at] jjkester [dot] nl).* - django-auditlog =============== @@ -9,14 +7,14 @@ django-auditlog ```django-auditlog``` (Auditlog) is a reusable app for Django that makes logging object changes a breeze. Auditlog tries to use as much as Python and Django’s built in functionality to keep the list of dependencies as short as possible. Also, Auditlog aims to be fast and simple to use. -Auditlog is created out of the need for a simple Django app that logs changes to models, including the user that changed the models (later referred to as actor). Existing solutions seemed to offer a type of version control, which was not needed and would cause too much overhead. +Auditlog is created out of the need for a simple Django app that logs changes to models along with the user who made the changes (later referred to as actor). Existing solutions seemed to offer a type of version control, which was found excessive and expensive in terms of database storage and performance. -The core idea of Auditlog is similar to the log from Django’s admin. Unlike the log from Django’s admin (django.contrib.admin) Auditlog is much more flexible and also saves a summary of the changes in JSON format, so changes can be tracked easily. +The core idea of Auditlog is similar to the log from Django’s admin. Unlike the log from Django’s admin (```django.contrib.admin```) Auditlog is much more flexible. Also, Auditlog saves a summary of the changes in JSON format, so changes can be tracked easily. Documentation ------------- -The documentation for ``django-auditlog`` can be found on http://django-auditlog.readthedocs.org. +The documentation for ```django-auditlog``` can be found on http://django-auditlog.readthedocs.org. The source files are available in the ```docs``` folder. License ------- diff --git a/docs/source/index.rst b/docs/source/index.rst index ea61b6cc..9afcb5e2 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -5,9 +5,9 @@ django-auditlog (Auditlog) is a reusable app for Django that makes logging objec use as much as Python and Django's built in functionality to keep the list of dependencies as short as possible. Also, Auditlog aims to be fast and simple to use. -Auditlog is created out of the need for a simple Django app that logs changes to models, including the user that changed -the models (later referred to as actor). Existing solutions seemed to offer a type of version control, which was not -needed and would cause too much overhead. +Auditlog is created out of the need for a simple Django app that logs changes to models along with the user who made the +changes (later referred to as actor). Existing solutions seemed to offer a type of version control, which was found +excessive and expensive in terms of database storage and performance. The core idea of Auditlog is similar to the log from Django's admin. However, Auditlog is much more flexible than the log from Django's admin app (:py:mod:`django.contrib.admin`). Also, Auditlog saves a summary of the changes in JSON @@ -28,11 +28,12 @@ Contribute to Auditlog ---------------------- .. note:: - Due to multiple reasons the development of Auditlog is not a priority. Therefore progress might be very slow. - However, community involvement in the form of pull requests is very much appreciated. If you like to take Auditlog to - the next level and be a permanent contributor, please contact the author (janjelle@jjkester.nl). + Due to multiple reasons the development of Auditlog is not a priority for me at this moment. Therefore progress might + be slow. This does not mean that this project is abandoned! Community involvement in the form of pull requests is + very much appreciated. Also, if you like to take Auditlog to the next level and be a permanent contributor, please + contact the author. Contact information can be found via GitHub. -If you found an issue with Auditlog or want to improve the code, please submit an issue and/or pull request via GitHub. +If you discovered a bug or want to improve the code, please submit an issue and/or pull request via GitHub. Before submitting a new issue, please make sure there is no issue submitted that involves the same problem. | GitHub repository: https://github.com/jjkester/django-auditlog diff --git a/docs/source/installation.rst b/docs/source/installation.rst index 9f59dfa9..ae9cc575 100644 --- a/docs/source/installation.rst +++ b/docs/source/installation.rst @@ -11,11 +11,11 @@ The repository can be found at https://github.com/jjkester/django-auditlog/. **Requirements** -- Python 2.7 or 3.4 +- Python 2.7, 3.4 or higher - Django 1.7 or higher -Auditlog is currently tested with Python 2.7 and 3.4 and Django 1.7, 1.8 and 1.9a1. The most up-to-date test report can -be found at https://travis-ci.org/jjkester/django-auditlog. +Auditlog is currently tested with Python 2.7 and 3.4 and Django 1.7, 1.8 and 1.9. The latest test report can be found +at https://travis-ci.org/jjkester/django-auditlog. Adding Auditlog to your Django application ------------------------------------------ @@ -24,4 +24,5 @@ To use Auditlog in your application, just add ``'auditlog'`` to your project's ` ``manage.py migrate`` to create/upgrade the necessary database structure. If you want Auditlog to automatically set the actor for log entries you also need to enable the middleware by adding -``'auditlog.middleware.AuditlogMiddleware'`` to your ``MIDDLEWARE_CLASSES`` setting. +``'auditlog.middleware.AuditlogMiddleware'`` to your ``MIDDLEWARE_CLASSES`` setting. Please check :doc:`usage` for more +information.