pyzotero 1.6.10__tar.gz → 1.6.13__tar.gz

{pyzotero-1.6.10 → pyzotero-1.6.13}/PKG-INFO

@@ -1,48 +1,45 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: pyzotero
-Version: 1.6.10
+Version: 1.6.13
 Summary: Python wrapper for the Zotero API
+Keywords: Zotero,DH
+Author: Stephan Hügel
 Author-email: Stephan Hügel <urschrei@gmail.com>
 License: # Blue Oak Model License
-        
-        Version 1.0.0
-        
-        ## Purpose
-        
-        This license gives everyone as much permission to work with this software as possible, while protecting contributors from liability.
-        
-        ## Acceptance
-        
-        In order to receive this license, you must agree to its rules. The rules of this license are both obligations under that agreement and conditions to your license. You must not do anything with this software that triggers a rule that you cannot or will not follow.
-        
-        ## Copyright
-        
-        Each contributor licenses you to do everything with this software that would otherwise infringe that contributor's copyright in it.
-        
-        ## Notices
-        
-        You must ensure that everyone who gets a copy of any part of this software from you, with or without changes, also gets the text of this license or a link to <https://blueoakcouncil.org/license/1.0.0>.
-        
-        ## Excuse
-        
-        If anyone notifies you in writing that you have not complied with [Notices](#notices), you can keep your license by taking all practical steps to comply within 30 days after the notice. If you do not do so, your license ends immediately.
-        
-        ## Patent
-        
-        Each contributor licenses you to do everything with this software that would otherwise infringe any patent claims they can license or become able to license.
-        
-        ## Reliability
-        
-        No contributor can revoke this license.
-        
-        ## No Liability
-        
-        ***As far as the law allows, this software comes as is, without any warranty or condition, and no contributor will be liable to anyone for any damages related to this software or this license, under any kind of legal claim.***
-        
-Project-URL: Repository, https://github.com/urschrei/pyzotero
-Project-URL: Tracker, https://github.com/urschrei/pyzotero/issues
-Project-URL: documentation, https://pyzotero.readthedocs.org
-Keywords: Zotero,DH
+         
+         Version 1.0.0
+         
+         ## Purpose
+         
+         This license gives everyone as much permission to work with this software as possible, while protecting contributors from liability.
+         
+         ## Acceptance
+         
+         In order to receive this license, you must agree to its rules. The rules of this license are both obligations under that agreement and conditions to your license. You must not do anything with this software that triggers a rule that you cannot or will not follow.
+         
+         ## Copyright
+         
+         Each contributor licenses you to do everything with this software that would otherwise infringe that contributor's copyright in it.
+         
+         ## Notices
+         
+         You must ensure that everyone who gets a copy of any part of this software from you, with or without changes, also gets the text of this license or a link to <https://blueoakcouncil.org/license/1.0.0>.
+         
+         ## Excuse
+         
+         If anyone notifies you in writing that you have not complied with [Notices](#notices), you can keep your license by taking all practical steps to comply within 30 days after the notice. If you do not do so, your license ends immediately.
+         
+         ## Patent
+         
+         Each contributor licenses you to do everything with this software that would otherwise infringe any patent claims they can license or become able to license.
+         
+         ## Reliability
+         
+         No contributor can revoke this license.
+         
+         ## No Liability
+         
+         ***As far as the law allows, this software comes as is, without any warranty or condition, and no contributor will be liable to anyone for any damages related to this software or this license, under any kind of legal claim.***
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -56,22 +53,15 @@ Classifier: Intended Audience :: Education
 Classifier: License :: OSI Approved :: Blue Oak Model License (BlueOak-1.0.0)
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: feedparser>=6.0.12
+Requires-Dist: bibtexparser>=1.4.3,<2.0.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: whenever>=0.8.8
 Requires-Python: >=3.9
+Project-URL: Repository, https://github.com/urschrei/pyzotero
+Project-URL: Tracker, https://github.com/urschrei/pyzotero/issues
+Project-URL: documentation, https://pyzotero.readthedocs.org
 Description-Content-Type: text/markdown
-License-File: LICENSE.md
-License-File: AUTHORS
-Requires-Dist: feedparser>=6.0.11
-Requires-Dist: pytz
-Requires-Dist: bibtexparser
-Requires-Dist: httpx>=0.28.1
-Provides-Extra: test
-Requires-Dist: pytest>=7.4.2; extra == "test"
-Requires-Dist: httpretty; extra == "test"
-Requires-Dist: python-dateutil; extra == "test"
-Requires-Dist: ipython; extra == "test"
-Requires-Dist: pytest-asyncio; extra == "test"
-Requires-Dist: pytest-cov>=6.0.0; extra == "test"
-Dynamic: license-file
 
 [![Supported Python versions](https://img.shields.io/pypi/pyversions/Pyzotero.svg?style=flat)](https://pypi.python.org/pypi/Pyzotero/) [![Docs](https://readthedocs.org/projects/pyzotero/badge/?version=latest)](http://pyzotero.readthedocs.org/en/latest/?badge=latest) [![PyPI Version](https://img.shields.io/pypi/v/Pyzotero.svg)](https://pypi.python.org/pypi/Pyzotero) [![Anaconda-Server Badge](https://anaconda.org/conda-forge/pyzotero/badges/version.svg)](https://anaconda.org/conda-forge/pyzotero) [![Downloads](https://pepy.tech/badge/pyzotero)](https://pepy.tech/project/pyzotero)  
 
@@ -79,7 +69,7 @@ Dynamic: license-file
 
 # Quickstart
 
-1. `pip install pyzotero` **or** `conda config --add channels conda-forge && conda install pyzotero`
+1. `uv add pyzotero` **or** `pip install pyzotero` **or** `conda install conda-forge::pyzotero`
 2. You'll need the ID of the personal or group library you want to access:
     - Your **personal library ID** is available [here](https://www.zotero.org/settings/keys), in the section `Your userID for use in API calls`
     - For **group libraries**, the ID can be found by opening the group's page: `https://www.zotero.org/groups/groupname`, and hovering over the `group settings` link. The ID is the integer after `/groups/`

{pyzotero-1.6.10 → pyzotero-1.6.13}/README.md

@@ -4,7 +4,7 @@
 
 # Quickstart
 
-1. `pip install pyzotero` **or** `conda config --add channels conda-forge && conda install pyzotero`
+1. `uv add pyzotero` **or** `pip install pyzotero` **or** `conda install conda-forge::pyzotero`
 2. You'll need the ID of the personal or group library you want to access:
     - Your **personal library ID** is available [here](https://www.zotero.org/settings/keys), in the section `Your userID for use in API calls`
     - For **group libraries**, the ID can be found by opening the group's page: `https://www.zotero.org/groups/groupname`, and hovering over the `group settings` link. The ID is the integer after `/groups/`

{pyzotero-1.6.10 → pyzotero-1.6.13}/pyproject.toml

@@ -1,13 +1,14 @@
 [project]
 name = "pyzotero"
-dynamic = ["version", "readme"]
+version = "1.6.13"
 description = "Python wrapper for the Zotero API"
+readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [
-    "feedparser >= 6.0.11",
-    "pytz",
-    "bibtexparser",
+    "feedparser >= 6.0.12",
+    "bibtexparser>=1.4.3,<2.0.0",
     "httpx>=0.28.1",
+    "whenever>=0.8.8",
 ]
 authors = [{ name = "Stephan Hügel", email = "urschrei@gmail.com" }]
 license = {file = "LICENSE.md"}
@@ -32,28 +33,28 @@ Repository = "https://github.com/urschrei/pyzotero"
 Tracker = "https://github.com/urschrei/pyzotero/issues"
 documentation = "https://pyzotero.readthedocs.org"
 
-[project.optional-dependencies]
-test = [
-    "pytest >= 7.4.2",
-    "httpretty",
+[dependency-groups]
+dev = [
+    "pytest >= 8.4.2",
+    "pytz>=2025.2",
+    "httpretty >= 1.1.4",
     "python-dateutil",
     "ipython",
     "pytest-asyncio",
     "pytest-cov>=6.0.0",
+    "tzdata>=2025.2"
+]
+doc = [
+    "sphinx",
+    "sphinx-rtd-theme"
 ]
-
-[tool.setuptools.dynamic]
-readme = {file = "README.md", content-type = "text/markdown"}
 
 [build-system]
-build-backend = "setuptools.build_meta"
-requires = [
-    "setuptools >= 45",
-    "setuptools-scm[toml] >= 6.2",
-]
+requires = ["uv_build>=0.8.14,<0.9.0"]
+build-backend = "uv_build"
 
 [tool.pytest.ini_options]
-minversion = "6.2.2"
+minversion = "8.3.0"
 addopts = [
     "--import-mode=importlib", "--cov=pyzotero", "--cov-report=xml",
 ]
@@ -63,8 +64,6 @@ testpaths = [
 asyncio_mode = "strict"
 asyncio_default_fixture_loop_scope = "function"
 
-[tool.setuptools_scm]
-write_to = "src/_version.py"
 
 [tool.ruff]
 exclude = [

{pyzotero-1.6.10 → pyzotero-1.6.13}/src/pyzotero/zotero.py

@@ -7,7 +7,6 @@ __author__ = "Stephan Hügel"
 __api_version__ = "3"
 
 import copy
-import datetime
 import hashlib
 import io
 import json
@@ -33,7 +32,7 @@ from urllib.parse import (
 import bibtexparser
 import feedparser
 import httpx
-import pytz
+import whenever
 from httpx import Request
 
 import pyzotero as pz
@@ -361,6 +360,11 @@ class Zotero:
         if c := self.client:
             c.close()
 
+    @property
+    def __version__(self):
+        """Return the version of the pyzotero library"""
+        return pz.__version__
+
     def _check_for_component(self, url, component):
         """Check a url path query fragment for a specific query parameter"""
         return bool(parse_qs(url).get(component))
@@ -419,13 +423,9 @@ class Zotero:
         """
         # cache template and retrieval time for subsequent calls
         try:
-            thetime = datetime.datetime.now(datetime.UTC).replace(
-                tzinfo=pytz.timezone("GMT"),
-            )
+            thetime = whenever.ZonedDateTime.now("Europe/London").py_datetime()
         except AttributeError:
-            thetime = datetime.datetime.now(tz=datetime.timezone.utc).replace(
-                tzinfo=pytz.timezone("GMT"),
-            )
+            thetime = whenever.ZonedDateTime.now("Europe/London").py_datetime()
         self.templates[key] = {"tmplt": response.json(), "updated": thetime}
         return copy.deepcopy(response.json())
 
@@ -470,7 +470,7 @@ class Zotero:
             params = {}
         if not self.url_params:
             self.url_params = {}
-        merged_params = params | self.url_params
+        merged_params = {**params, **self.url_params}
         # our incoming url might be from the "links" dict, in which case it will contain url parameters.
         # Unfortunately, httpx doesn't like to merge query paramaters in the url string and passed params
         # so we strip the url params, combining them with our existing url_params
@@ -545,9 +545,7 @@ class Zotero:
         # If the template is more than an hour old, try a 304
         if (
             abs(
-                datetime.datetime.now(tz=datetime.timezone.utc).replace(
-                    tzinfo=pytz.timezone("GMT"),
-                )
+                whenever.ZonedDateTime.now("Europe/London").py_datetime()
                 - self.templates[template]["updated"],
             ).seconds
             > ONE_HOUR
@@ -800,7 +798,7 @@ class Zotero:
         if self.snapshot:
             self.snapshot = False
             pth += ".zip"
-        with Path.open(pth, "wb") as f:
+        with Path(pth).open("wb") as f:
             f.write(file)
 
     @retrieve
@@ -1854,7 +1852,7 @@ class Zupload:
             if Path(str(self.basedir.joinpath(templt["filename"]))).is_file():
                 try:
                     # if it is a file, try to open it, and catch the error
-                    with Path.open(str(self.basedir.joinpath(templt["filename"]))):
+                    with Path(str(self.basedir.joinpath(templt["filename"]))).open():
                         pass
                 except OSError:
                     msg = f"The file at {self.basedir.joinpath(templt['filename'])!s} couldn't be opened or found."
@@ -1914,7 +1912,7 @@ class Zupload:
         """Step 1: get upload authorisation for a file"""
         mtypes = mimetypes.guess_type(attachment)
         digest = hashlib.md5()  # noqa: S324
-        with Path.open(attachment, "rb") as att:
+        with Path(attachment).open("rb") as att:
             for chunk in iter(lambda: att.read(8192), b""):
                 digest.update(chunk)
         auth_headers = {"Content-Type": "application/x-www-form-urlencoded"}
@@ -1961,7 +1959,7 @@ class Zupload:
         upload_list = [("key", upload_dict.pop("key"))]
         for key, value in upload_dict.items():
             upload_list.append((key, value))
-        upload_list.append(("file", Path.open(attachment, "rb").read()))
+        upload_list.append(("file", Path(attachment).open("rb").read()))
         upload_pairs = tuple(upload_list)
         try:
             self.zinstance._check_backoff()

pyzotero-1.6.10/.coveragerc

@@ -1,3 +0,0 @@
-[run]
-omit = pyzotero/zotero_errors.py, pyzotero/test.py, test/test_zotero.py, dump_contributors.py, pre-deploy.py, setup.py, shell.py
-relative_files = True

pyzotero-1.6.10/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,34 +0,0 @@
----
-name: Bug report
-about: Found a bug in Pyzotero?
-title: ''
-labels: ''
-assignees: urschrei
-
----
-
-# Note
-This issue tracker is for bug reports. Please don't ask about how to use the library here – the docs are comprehensive and include examples: https://pyzotero.readthedocs.io.
-
-You can also ask questions on the forum: https://forums.zotero.org/discussions
-
-# Reporting Bugs
-If at all possible, provide a [MVCE](https://stackoverflow.com/help/minimal-reproducible-example). If this is inappropriate (e.g. it's obviously a bug), just fill in the below:
-
-Platform:  
-Python version:  
-Pyzotero version: 
-
-# Problem Description
-- What were you trying to do?
-    - What API call did it involve
-    - What error was raised?
-
-# More Details
-If possible, paste the full traceback in a code block below, and fill in the summary
-<details>
-    <summary>Traceback</summary>
-    
-    code goes here, indented with four spaces
-
-</details>

pyzotero-1.6.10/.github/ISSUE_TEMPLATE/usage_question.md

@@ -1,15 +0,0 @@
----
-name: Usage question
-about: How do I use the library and API?
-title: ''
-labels: ''
-assignees:
-
----
-
-# Note
-This issue tracker is for **bug reports**. Please don't ask about how to use the library here – the docs are comprehensive and include examples: https://pyzotero.readthedocs.io.
-
-You can also ask questions on the forum: https://forums.zotero.org/discussions
-
-A guide to the Zotero API itself is here: https://www.zotero.org/support/dev/web_api/v3/start

pyzotero-1.6.10/.github/dependabot.yml

@@ -1,16 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "pip"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-    open-pull-requests-limit: 20
-    groups:
-      # Specify a name for the group, which will be used in pull request titles
-      # and branch names
-      python-dependencies:
-        # Define patterns to include dependencies in the group (based on
-        # dependency name)
-        applies-to: version-updates # Applies the group rule to version updates
-        patterns:
-          - "*"

pyzotero-1.6.10/.github/pull_request_template.md

@@ -1,23 +0,0 @@
-<!-- Thanks for opening a PR. Please read the following:
-
-- **Base your changes on the `main` branch**
-    - If necessary, rebase against `main` before opening a pull request
-- This codebase uses Ruff. PRs that reformat code will not be accepted.
-- Ensure that all methods added have a proper docstring. **Please do not use Doctest**
-- If at all possible, don't add dependencies
-    - If it is unavoidable, you must ensure that the dependency is maintained, and supported
-    - Ensure that you add your dependency to [pyproject.toml](pyproject.toml)
-- Run the tests and ensure that they pass. If you are adding a feature **you must add tests that exercise it**
-- If your pull request is a feature **document the feature**
-- One feature per pull request
-- [squash](http://git-scm.com/book/en/Git-Tools-Rewriting-History#Squashing-Commits) your commits before opening a pull request unless it makes no sense to do so
-- If in doubt, comment your code.
-
-## License of Contributed Code
-Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed under the Blua Oak Model License 1.0, without any additional terms or conditions.  
-Please note that pull requests with licenses that are more restrictive than or otherwise incompatible with the license will not be accepted. -->
-
-Description of changes:
-Issue reference (if applicable):
-
-- [ ] I have read [the CONTRIBUTING doc](CONTRIBUTING.md)

pyzotero-1.6.10/.github/workflows/tests.yml

@@ -1,115 +0,0 @@
-name: Build wheel, release and publish on new tag
-
-on: [push, pull_request]
-
-jobs:
-  lint:
-    name: run Ruff
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        fetch-depth: 0  # Optional, use if you use setuptools_scm
-        submodules: false  # Optional, use if you have submodules
-      name: Check out repo
-    - uses: astral-sh/ruff-action@v3
-      with:
-        args: "check --verbose"
-
-  build:
-    name: Build and test
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: [3.9, 3.10.9, 3.11, 3.12, 3.13]
-
-    steps:
-    - name: check out repo
-      uses: actions/checkout@v4
-      with:
-        fetch-depth: 0  # Optional, use if you use setuptools_scm
-        submodules: false  # Optional, use if you have submodules
-
-    - name: Install uv and set the python version
-      uses: astral-sh/setup-uv@v5
-      with:
-        python-version: ${{ matrix.python-version }}
-
-    - name: Install the project and deps
-      run: uv sync --all-extras --dev
-
-    - name: Run tests
-      run: uv run pytest
-
-    - name: Build wheel
-      run: uv build --no-sources --wheel  -o dist
-
-    - uses: actions/upload-artifact@v4
-      name: Upload wheel as artifact
-      with:
-        name: wheels-${{ strategy.job-index }}
-        path: |
-          ./dist/*.whl
-
-  make_sdist:
-    name: Make SDist
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        fetch-depth: 0  # Optional, use if you use setuptools_scm
-        submodules: true  # Optional, use if you have submodules
-
-    - name: Install uv
-      uses: astral-sh/setup-uv@v5
-
-    - name: Build SDist
-      run: uv build --no-sources --sdist -o dist
-
-    - uses: actions/upload-artifact@v4
-      with:
-        path: dist/*.tar.gz
-
-  status_check:
-    name: All Checks
-    needs: [lint, build]
-    runs-on: ubuntu-latest
-    if: always()
-    steps:
-      - name: Check status
-        if: contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled')
-        run: exit 1
-
-
-  release_artifacts:
-    if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
-    name: Release repaired and tested wheels
-    needs: [status_check, make_sdist]
-    runs-on: ubuntu-latest
-    environment: release
-    permissions:
-      # IMPORTANT: this permission is mandatory for trusted publishing
-      id-token: write
-      contents: write
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Download compressed artifacts
-      id: download
-      uses: actions/download-artifact@v4
-      with:
-        path: ./artifacts
-        merge-multiple: true
-
-    - name: Create release and upload wheels
-      uses: ncipollo/release-action@v1
-      with:
-        allowUpdates: true
-        artifacts: "${{ steps.download.outputs.download-path }}/*.whl,${{ steps.download.outputs.download-path }}/*.gz,${{ steps.download.outputs.download-path }}/*.so,${{ steps.download.outputs.download-path }}/*.dylib,${{ steps.download.outputs.download-path }}/*.lib,${{ steps.download.outputs.download-path }}/*.dll"
-        token: ${{ secrets.GITHUB_TOKEN }}
-
-    - name: PyPI Publish
-      uses: pypa/gh-action-pypi-publish@release/v1
-      with:
-        packages-dir: ${{ steps.download.outputs.download-path }}

pyzotero-1.6.10/.gitignore

@@ -1,6 +0,0 @@
-**/__pycache__
-Pyzotero.egg-info
-Pyzotero.egg-info
-__pycache__
-.eggs
-src/_version.py

pyzotero-1.6.10/.readthedocs.yaml

@@ -1,26 +0,0 @@
-# .readthedocs.yaml
-# Read the Docs configuration file
-# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-# Required
-version: 2
-
-# Set the version of Python and other tools you might need
-build:
-  os: ubuntu-22.04
-  tools:
-    python: "3.11"
-
-  jobs:
-    post_create_environment:
-      - python -m pip install sphinx_rtd_theme
-
-python:
-  install:
-    - method: pip
-      path: .
-
-
-# Build documentation in the docs/ directory with Sphinx
-sphinx:
-  configuration: doc/conf.py

pyzotero-1.6.10/AUTHORS

@@ -1,2 +0,0 @@
-# This is the official list of Pyzotero authors for copyright purposes.
-Stephan Hügel (<urschrei@gmail.com>)

pyzotero-1.6.10/CITATION.cff

@@ -1,16 +0,0 @@
-cff-version: 1.1.0
-message: "If you use this software, please cite it using these metadata."
-abstract: "Pyzotero: a Python client for the Zotero API"
-authors: 
-  -
-    family-names: "Hügel"
-    given-names: Stephan
-    orcid: "https://orcid.org/0000-0003-4379-2450"
-title: "Pyzotero"
-date-released: 2019-05-18
-doi: "10.5281/zenodo.2917290"
-keywords: 
-  - zotero
-license: BlueOak-1.0.0
-repository-code: "https://github.com/urschrei/pyzotero"
-version: "1.3.15"