A django package to store/process zotero items
Project description
=============================
acdh-django-zotero
=============================
.. image:: https://badge.fury.io/py/acdh-django-zotero.svg
:target: https://badge.fury.io/py/acdh-django-zotero
A django package to store/process zotero items
Documentation
-------------
Quickstart
----------
Install acdh-django-zotero::
pip install acdh-django-zotero
Add it to your `INSTALLED_APPS`:
.. code-block:: python
INSTALLED_APPS = (
...
'bib',
...
)
Add following Zotero settings to you settings-file:
.. code-block:: python
Z_ID = "{a valid zotero API user ID}"
Z_LIBRARY_TYPE = 'group' # or 'user'
Z_API_KEY = "{a valid Zotero API user key}"
See [pyzotero](http://pyzotero.readthedocs.io/en/latest/) for more information
Add acdh-django-zotero's URL patterns:
.. code-block:: python
from rest_framework import routers
...
from bib import urls as bib_urls
from bib.api_views import ZotItemViewSet
...
...
router = routers.DefaultRouter()
router.register(r'zotitems', ZotItemViewSet)
...
urlpatterns = [
...
url(r'^bib/', include('bib.urls', namespace='bib')),
...
]
And run `python manage.py migrate`
Features
--------
* `bib` app registers a `ZotItem? class which stores (some) information taken from a full zotero item entry. It provides then autocomplete functions for those ZotItem objects.
* The app also provides `management` commands to import items from a zotero library as well as to update existing items.
`python manage.py bib_import --limit=15` # imports the top 15 items
`python manage.py bib_import --since=100` # imports all items from library version 100
`python manage.py bib_import` # import everything
`python manage.py bib_update` # imports all items with a higher version number then the highest version number of the items stored in your db.
* The latter function can also be triggered through the front end by browsing to `{root}/bib/synczotero`
Build and publish
-----
.. code-block:: console
python setup.py sdist bdist_wheel
twine upload dist/*
Credits
-------
Tools used in rendering this package:
* Cookiecutter_
* `cookiecutter-djangopackage`_
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cookiecutter-djangopackage`: https://github.com/pydanny/cookiecutter-djangopackage
History
-------
0.1.0 (2018-07-05)
++++++++++++++++++
* First release on PyPI.
acdh-django-zotero
=============================
.. image:: https://badge.fury.io/py/acdh-django-zotero.svg
:target: https://badge.fury.io/py/acdh-django-zotero
A django package to store/process zotero items
Documentation
-------------
Quickstart
----------
Install acdh-django-zotero::
pip install acdh-django-zotero
Add it to your `INSTALLED_APPS`:
.. code-block:: python
INSTALLED_APPS = (
...
'bib',
...
)
Add following Zotero settings to you settings-file:
.. code-block:: python
Z_ID = "{a valid zotero API user ID}"
Z_LIBRARY_TYPE = 'group' # or 'user'
Z_API_KEY = "{a valid Zotero API user key}"
See [pyzotero](http://pyzotero.readthedocs.io/en/latest/) for more information
Add acdh-django-zotero's URL patterns:
.. code-block:: python
from rest_framework import routers
...
from bib import urls as bib_urls
from bib.api_views import ZotItemViewSet
...
...
router = routers.DefaultRouter()
router.register(r'zotitems', ZotItemViewSet)
...
urlpatterns = [
...
url(r'^bib/', include('bib.urls', namespace='bib')),
...
]
And run `python manage.py migrate`
Features
--------
* `bib` app registers a `ZotItem? class which stores (some) information taken from a full zotero item entry. It provides then autocomplete functions for those ZotItem objects.
* The app also provides `management` commands to import items from a zotero library as well as to update existing items.
`python manage.py bib_import --limit=15` # imports the top 15 items
`python manage.py bib_import --since=100` # imports all items from library version 100
`python manage.py bib_import` # import everything
`python manage.py bib_update` # imports all items with a higher version number then the highest version number of the items stored in your db.
* The latter function can also be triggered through the front end by browsing to `{root}/bib/synczotero`
Build and publish
-----
.. code-block:: console
python setup.py sdist bdist_wheel
twine upload dist/*
Credits
-------
Tools used in rendering this package:
* Cookiecutter_
* `cookiecutter-djangopackage`_
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cookiecutter-djangopackage`: https://github.com/pydanny/cookiecutter-djangopackage
History
-------
0.1.0 (2018-07-05)
++++++++++++++++++
* First release on PyPI.
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
acdh-django-zotero-0.1.2.tar.gz
(12.2 kB
view hashes)
Built Distribution
Close
Hashes for acdh_django_zotero-0.1.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ca088459e9307e06e761196fae9daed34c567b34333af06e6928635569f07e0b |
|
MD5 | caae549870cebb4702eff50b2fb0b80d |
|
BLAKE2b-256 | 87f347b526ca6d9694bb964fa00875cfd531881ac056b9b05ead80ecf81be808 |