Merge changes from the 3.2.1 release (#61)

#60 created the 3.2.1 release while the 4.0 release was still in progress. This pulls in the relevant changes and makes them work with the 4.0 structure. #59 was not included because the transformation logic is going to be redone in 4.0.

Author: brycekbargar

CHANGELOG.md

@@ -17,6 +17,15 @@ Please see [MIGRATING.md](./MIGRATING.md) for information on breaking changes.
 
 ### Removed
 
+## [3.2.1] - November 2025
+
+### Fixed
+
+- Endpoints which return system fields before the record list
+- Example python script
+- Columns with mixed and incompatible datatypes
+- Endless looping for calendar/calendars endpoint
+
 ## [3.2.0] - September 2025
 
 ### Added

README.md

@@ -29,8 +29,12 @@ To install LDLite or upgrade to the latest version:
 ```bash
 $ python -m pip install --upgrade ldlite
 ```
-
 (On some systems it might be `python3` rather than `python`.)
+
+If you encounter the error `ImportError: no pq wrapper available.` you can either
+* Run `python -m pip install psycopg[binary]`
+* Ensure the libpq package is installed for your operating system
+
 Check out the [migration guide](./MIGRATING.md) for more information about major version upgrades.
 
 *Optional* If you intend to use the `connect_db_postgres()` method install the binary provider:

examples/folio_demo.py

@@ -3,6 +3,8 @@
 
 import sys
 
+import httpx
+
 import ldlite
 
 # Demo sites
@@ -30,15 +32,16 @@
 )
 
 ld.connect_db(filename="ldlite.db")
-# For PostgreSQL, use connect_db_postgresql() instead of connect_db():
+# For PostgreSQL, use connect_db_postgresql() instead:
 # ld.connect_db_postgresql(dsn='dbname=ldlite host=localhost user=ldlite')
 
 queries: list[tuple[str, ...] | tuple[str, str, object, int]] = [
     ("folio_agreements.entitlement", "/erm/entitlements"),
     ("folio_agreements.erm_resource", "/erm/resource"),
     ("folio_agreements.org", "/erm/org"),
     ("folio_agreements.refdata_value", "/erm/refdata"),
-    ("folio_agreements.usage_data_provider", "/usage-data-providers"),
+    # This endpoint doesn't work in EBSCO environments
+    # ("folio_agreements.usage_data_provider", "/usage-data-providers"),
     ("folio_audit.circulation_logs", "/audit-data/circulation/logs"),
     ("folio_circulation.audit_loan", "/loan-storage/loan-history"),
     (
@@ -165,7 +168,7 @@
         "/acquisitions-units-storage/memberships",
     ),
     ("folio_orders.alert", "/orders-storage/alerts"),
-    ("folio_orders.order_invoice_relationship/orders-storage/order-invoice-relns"),
+    ("folio_orders.order_invoice_relationship", "/orders-storage/order-invoice-relns"),
     ("folio_orders.order_templates", "/orders-storage/order-templates"),
     ("folio_orders.pieces", "/orders-storage/pieces"),
     ("folio_orders.po_line", "/orders-storage/po-lines"),
@@ -176,36 +179,42 @@
     ("folio_organizations.contacts", "/organizations-storage/contacts"),
     ("folio_organizations.emails", "/organizations-storage/emails"),
     ("folio_organizations.interfaces", "/organizations-storage/interfaces"),
-    ("folio_organizations.organizations", "/organizations-storage/organizations"),
+    ("folio_organizations.organizations", "/organizations/organizations"),
     ("folio_organizations.phone_numbers", "/organizations-storage/phone-numbers"),
     ("folio_organizations.urls", "/organizations-storage/urls"),
-    ("folio_source_record.records", "/source-storage/records", {}, 2),
+    ("folio_source_record.records", "/source-storage/records", 2),
     ("folio_users.addresstype", "/addresstypes"),
     ("folio_users.departments", "/departments"),
     ("folio_users.groups", "/groups"),
     ("folio_users.proxyfor", "/proxiesfor"),
     ("folio_users.users", "/users"),
 ]
 
+errors: list[tuple[str, BaseException]] = []
 tables: list[str] = []
 for q in queries:
     try:
-        if len(q) == 4:
+        if len(q) == 3:
             tables += ld.query(
                 table=q[0],
                 path=q[1],
-                query=str(q[2]),
-                json_depth=int(q[3]),
+                json_depth=int(q[2]),
             )
         else:
-            tables += ld.query(table=q[0], path=q[1], query=str(q[2]))
-    except (ValueError, RuntimeError) as e:
-        print(
-            'folio_demo.py: error processing "' + str(q[1]) + '": ' + str(e),
-            file=sys.stderr,
-        )
+            tables += ld.query(table=q[0], path=q[1])
+    except (ValueError, RuntimeError, httpx.HTTPError) as e:
+        errors += [(q[1], e)]
 print()
 print("Tables:")
 for t in tables:
     print(t)
 print("(" + str(len(tables)) + " tables)")
+if len(errors) > 0:
+    print()
+    print("Errors:")
+    for p, e in errors:
+        print(
+            'folio_demo.py: error processing "' + p + '": ' + str(e),
+            file=sys.stderr,
+        )
+print("(" + str(len(errors)) + " errors)")