pyzotero 1.7.6__py3-none-any.whl → 1.8.0__py3-none-any.whl

pyzotero/zotero_errors.py

@@ -1,141 +1,58 @@
-"""
-zotero_errors.py
-
-Created by Stephan Hügel on 2011-03-04
-
-This file is part of Pyzotero.
-"""
-
-
-# Define some exceptions
-class PyZoteroError(Exception):
-    """Generic parent exception"""
-
-    pass
-
-
-class ParamNotPassedError(PyZoteroError):
-    """Raised if a parameter which is required isn't passed"""
-
-    pass
-
-
-class CallDoesNotExistError(PyZoteroError):
-    """Raised if the specified API call doesn't exist"""
-
-    pass
-
-
-class UnsupportedParamsError(PyZoteroError):
-    """Raised when unsupported parameters are passed"""
-
-    pass
-
-
-class UserNotAuthorisedError(PyZoteroError):
-    """Raised when the user is not allowed to retrieve the resource"""
-
-    pass
-
-
-class TooManyItemsError(PyZoteroError):
-    """Raised when too many items are passed to a Write API method"""
-
-    pass
-
-
-class MissingCredentialsError(PyZoteroError):
-    """
-    Raised when an attempt is made to create a Zotero instance
-    without providing both the user ID and the user key
-    """
-
-    pass
-
-
-class InvalidItemFieldsError(PyZoteroError):
-    """Raised when an attempt is made to create/update items w/invalid fields"""
-
-    pass
-
+"""Backwards-compatible re-exports for pyzotero.zotero_errors module.
 
-class ResourceNotFoundError(PyZoteroError):
-    """Raised when a resource (item, collection etc.) could not be found"""
+This module maintains backwards compatibility for code that imports from
+pyzotero.zotero_errors. New code should import from pyzotero.errors.
 
-    pass
+Example:
+    # Old style (still works)
+    from pyzotero import zotero_errors as ze
 
+    # New style (preferred)
+    from pyzotero import errors as ze
 
-class HTTPError(PyZoteroError):
-    """Raised for miscellaneous URLLib errors"""
-
-    pass
-
-
-class CouldNotReachURLError(PyZoteroError):
-    """Raised when we can't reach a URL"""
-
-    pass
-
-
-class ConflictError(PyZoteroError):
-    """409 - Raised when the target library is locked"""
-
-    pass
-
-
-class PreConditionFailedError(PyZoteroError):
-    """
-    412 - Raised when the provided X-Zotero-Write-Token has already been
-    submitted
-    """
-
-    pass
-
-
-class RequestEntityTooLargeError(PyZoteroError):
-    """
-    413 - The upload would exceed the storage quota of the library owner.
-    """
-
-    pass
-
-
-class PreConditionRequiredError(PyZoteroError):
-    """
-    428 - Raised when If-Match or If-None-Match was not provided.
-    """
-
-    pass
-
-
-class TooManyRequestsError(PyZoteroError):
-    """
-    429 - Raised when there are too many unfinished uploads.
-    Try again after the number of seconds specified in the Retry-After header.
-    """
-
-    pass
-
-
-class FileDoesNotExistError(PyZoteroError):
-    """
-    Raised when a file path to be attached can't be opened (or doesn't exist)
-    """
-
-    pass
-
-
-class TooManyRetriesError(PyZoteroError):
-    """
-    Raise after the backoff period for new requests exceeds 32s
-    """
-
-    pass
-
-
-class UploadError(PyZoteroError):
-    """
-    Raise if the connection drops during upload or some other non-HTTP error code is returned
-    """
+"""
 
-    pass
+# Re-export all exceptions for backwards compatibility
+from pyzotero.errors import (
+    CallDoesNotExistError,
+    ConflictError,
+    CouldNotReachURLError,
+    FileDoesNotExistError,
+    HTTPError,
+    InvalidItemFieldsError,
+    MissingCredentialsError,
+    ParamNotPassedError,
+    PreConditionFailedError,
+    PreConditionRequiredError,
+    PyZoteroError,
+    RequestEntityTooLargeError,
+    ResourceNotFoundError,
+    TooManyItemsError,
+    TooManyRequestsError,
+    TooManyRetriesError,
+    UnsupportedParamsError,
+    UploadError,
+    UserNotAuthorisedError,
+)
+
+__all__ = [
+    "CallDoesNotExistError",
+    "ConflictError",
+    "CouldNotReachURLError",
+    "FileDoesNotExistError",
+    "HTTPError",
+    "InvalidItemFieldsError",
+    "MissingCredentialsError",
+    "ParamNotPassedError",
+    "PreConditionFailedError",
+    "PreConditionRequiredError",
+    "PyZoteroError",
+    "RequestEntityTooLargeError",
+    "ResourceNotFoundError",
+    "TooManyItemsError",
+    "TooManyRequestsError",
+    "TooManyRetriesError",
+    "UnsupportedParamsError",
+    "UploadError",
+    "UserNotAuthorisedError",
+]

{pyzotero-1.7.6.dist-info → pyzotero-1.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyzotero
-Version: 1.7.6
+Version: 1.8.0
 Summary: Python wrapper for the Zotero API
 Keywords: Zotero,DH
 Author: Stephan Hügel
@@ -82,8 +82,8 @@ Description-Content-Type: text/markdown
 Then:
 
 ``` python
-from pyzotero import zotero
-zot = zotero.Zotero(library_id, library_type, api_key) # local=True for read access to local Zotero
+from pyzotero import Zotero
+zot = Zotero(library_id, library_type, api_key)  # local=True for read access to local Zotero
 items = zot.top(limit=5)
 # we've retrieved the latest five top-level items in our library
 # we can print each item's item type and ID

pyzotero-1.8.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+pyzotero/__init__.py,sha256=6k_iURpZr-9PfOr9UAs_XQLJB59yoJwTd6EKe-DNYbE,1663
+pyzotero/_client.py,sha256=edxtbyjDP6x_IBtSpc-Dhxa3wFNdeZGOq7-TTj26_Uo,51644
+pyzotero/_decorators.py,sha256=nMx3bBM8UFp5cS-c1vcm-toJ2CSDXM78coh-beWqHbA,6343
+pyzotero/_search.py,sha256=LNFbouGZ2rBF2LblFnL39998ZGXYQeqSsMArAgkhBtI,7259
+pyzotero/_upload.py,sha256=_Q3Ex7EGf6GFaxaT_Rv2UG3u9rrCJE4H-tmQUYGOr7M,9052
+pyzotero/_utils.py,sha256=c8L0WXzv0_SqDd-Pio4MCCyydq_fdhGX4UXYGNf92hA,2382
+pyzotero/cli.py,sha256=q1qo6VH_WmCmuSQFSjqa7PRhhUEwecb_hHT0oPsXRAI,28674
+pyzotero/errors.py,sha256=To9IkdcA5zGkR3Rl88kAIktGBXhrMimfZdNxkqHNZLY,5211
+pyzotero/filetransport.py,sha256=HFXfRP8haG31JIA-CmEcKE3oTzqNN04Pjn7u8KwE7u0,5498
+pyzotero/semantic_scholar.py,sha256=2_a6UyUYVBFPQKS8JgBylGksM90aVtq4V3HtpbF1OTI,12728
+pyzotero/zotero.py,sha256=8oOSlCZ4fOCVLZBbM07-oCCouI43m_bTG7oAEqAHzuM,1591
+pyzotero/zotero_errors.py,sha256=9EVkGS73SJy5VuKBGtxtQtxFqz1y-jQgYyrx9aBICvw,1475
+pyzotero-1.8.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pyzotero-1.8.0.dist-info/entry_points.txt,sha256=MzN7IMRj_oPNmDCsseYFPum3bHWE1gFxywhlbFbcn2k,48
+pyzotero-1.8.0.dist-info/METADATA,sha256=OUkZcCjw-3nQ6mzYWsN_5gHWr-dNBzSYi007h3xz4Hk,9956
+pyzotero-1.8.0.dist-info/RECORD,,

pyzotero-1.7.6.dist-info/RECORD

@@ -1,9 +0,0 @@
-pyzotero/__init__.py,sha256=5QI4Jou9L-YJAf_oN9TgRXVKgt_Unc39oADo2Ch8bLI,243
-pyzotero/cli.py,sha256=dsq4QFqs4vig7CpORQYWD96smM8Z00BbaVh8AsLjhmg,16243
-pyzotero/filetransport.py,sha256=umLik1LLmrpgaNmyjvtBoqqcaMgIq79PYsTvN5vG-gY,5530
-pyzotero/zotero.py,sha256=nUgch-YvNHiQb8qR7Pz9ntgNJv76XDcvINvCs56vvFc,76877
-pyzotero/zotero_errors.py,sha256=6obx9-pBO0z1bxt33vuzDluELvA5kSLCsfc-uGc3KNw,2660
-pyzotero-1.7.6.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-pyzotero-1.7.6.dist-info/entry_points.txt,sha256=MzN7IMRj_oPNmDCsseYFPum3bHWE1gFxywhlbFbcn2k,48
-pyzotero-1.7.6.dist-info/METADATA,sha256=oPlV0BYolZ8TXTWJjtnChKeA4Rxcf1rx2crVENVlRhY,9962
-pyzotero-1.7.6.dist-info/RECORD,,