root/ubuntu-based-kiosk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

library: reading levels (manual + CSV import), library CSV export, AR BookFind link with copy-title

Browse Source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013wi3ZSot4XbUViwRFgLpRf
This commit is contained in:
Claude
2026-11-07 00:35:19 +00:00
parent 7f230c8e73
commit 3d02d28a8c
4 changed files with 170 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
library/quickadd/__pycache__/app.cpython-313.pyc
BIN
View File
Binary file not shown.
library/quickadd/app.py
+122 -4
View File
@@ -1161,7 +1161,8 @@ def op_more(biblio_id):
b = koha("GET", "/biblios/%d" % biblio_id)
isbn = re.sub(r"[^0-9Xx]", "", (b.get("isbn") or "").split(" ")[0].split("|")[0])
title = (b.get("title") or "").rstrip(" /:")
out = {"links": [], "description": "", "subjects": [], "first_published": ""}
out = {"links": [], "description": "", "subjects": [], "first_published": "", "isbn": isbn,
"ar": _ar_load().get(_isbn13(isbn) or "", {})}
q = urllib.parse.quote(title + " " + (b.get("author") or ""))
if isbn:
out["links"] = [
@@ -1211,6 +1212,117 @@ def op_more(biblio_id):
return dict(out, **data)
# ------------------------------------------------ reading levels (AR) and CSV in/out
# AR BookFind has no public feed and its terms forbid automated access, so reading levels are kept
# here instead: typed in on the book page, or imported from a CSV you made yourself. Keyed by ISBN-13.
AR_FILE = os.path.join(DATA_DIR, "reading-levels.json")
def _isbn13(raw):
c = clean_code(raw)
if not c:
return None
return isbn10_to_13(c) if len(c) == 10 else c
def _ar_load():
try:
return json.load(open(AR_FILE))
except (OSError, ValueError):
return {}
def _ar_save(d):
tmp = AR_FILE + ".tmp"
with open(tmp, "w") as f:
json.dump(d, f)
os.replace(tmp, AR_FILE)
def _num(v, maxlen=8):
v = str(v or "").strip()[:maxlen]
return v if re.fullmatch(r"[0-9]{0,4}(\.[0-9]{1,2})?", v) else None
def op_ar_set(payload):
key = _isbn13(payload.get("isbn"))
level, points, quiz = _num(payload.get("level")), _num(payload.get("points")), re.sub(r"[^0-9]", "", str(payload.get("quiz") or ""))[:8]
if not key or level is None or points is None:
return 400, {"status": "invalid", "message": "Level and points are numbers like 4.5 and 6."}
with LOCK:
d = _ar_load()
if level or points or quiz:
d[key] = {"level": level, "points": points, "quiz": quiz}
else:
d.pop(key, None)
_ar_save(d)
return 200, {"status": "saved"}
def op_ar_import(payload):
"""CSV with a header row; needs an isbn column and any of level, points, quiz."""
import csv, io
text = str(payload.get("csv") or "")[:2_000_000]
rows = list(csv.reader(io.StringIO(text)))
if len(rows) < 2:
return 400, {"status": "invalid", "message": "That file has no rows."}
head = [re.sub(r"[^a-z0-9]", "", h.lower()) for h in rows[0]]
def col(*names):
for n in names:
if n in head:
return head.index(n)
return None
ci, cl, cp, cq = col("isbn", "isbn13"), col("level", "arlevel", "bl", "booklevel"), col("points", "arpoints", "pts"), col("quiz", "quizno", "quiznumber")
if ci is None or (cl is None and cp is None and cq is None):
return 400, {"status": "invalid", "message": "Need a header row with an isbn column and at least one of: level, points, quiz."}
done = skipped = 0
with LOCK:
d = _ar_load()
for r in rows[1:]:
get = lambda i: r[i] if i is not None and i < len(r) else ""
key = _isbn13(get(ci))
lv, pt = _num(get(cl)), _num(get(cp))
if not key or lv is None or pt is None:
skipped += 1
continue
old = d.get(key, {})
d[key] = {"level": lv or old.get("level", ""), "points": pt or old.get("points", ""),
"quiz": re.sub(r"[^0-9]", "", get(cq))[:8] or old.get("quiz", "")}
done += 1
_ar_save(d)
return 200, {"status": "imported", "count": done, "skipped": skipped}
def export_csv():
"""One row per copy: what you have, where it is, and any reading level on file."""
import csv, io
where = {l["value"]: l["label"] for l in get_locations()}
colls = {c["value"]: c["label"] for c in get_collections()}
ar = _ar_load()
out = io.StringIO()
w = csv.writer(out)
w.writerow(["title", "author", "isbn", "year", "barcode", "call number", "shelf", "collection", "status", "ar level", "ar points", "ar quiz"])
page = 1
while True:
books = koha("GET", "/biblios", query={"_per_page": "200", "_page": str(page), "_order_by": "title"}) or []
if not books:
break
ids = [b["biblio_id"] for b in books]
items = koha("GET", "/items", query={"q": json.dumps({"biblio_id": ids}), "_per_page": "2000"}) or []
for b in books:
isbn = b.get("isbn") or ""
a = ar.get(_isbn13(isbn) or "", {})
mine = [i for i in items if i["biblio_id"] == b["biblio_id"]] or [{}]
for i in mine:
w.writerow([(b.get("title") or "").rstrip(" /:"), b.get("author") or "", isbn, b.get("copyright_date") or "",
i.get("external_id") or "", i.get("callnumber") or "", where.get(i.get("location"), ""),
colls.get(i.get("collection_code"), ""), item_status(i) if i else "", a.get("level", ""), a.get("points", ""), a.get("quiz", "")])
if len(books) < 200:
break
page += 1
return out.getvalue().encode("utf-8-sig")
# ------------------------------------------------------------ photo scanning
MAX_IMAGE = 12 * 1024 * 1024
ZBAR_TIMEOUT = 20
@@ -1368,7 +1480,7 @@ class Handler(BaseHTTPRequestHandler):
if self.path == "/healthz":
return self._send(200, b"ok", "text/plain")
path = self.path.split("?")[0]
if not self._guard(need_admin=path not in ("/", "/api/state", "/api/search", "/api/library") and not path.startswith("/api/book/")):
if not self._guard(need_admin=path not in ("/", "/api/state", "/api/search", "/api/library") and not path.startswith(("/api/book/", "/api/more/"))):
return
if path == "/":
return self._send(200, INDEX, "text/html; charset=utf-8")
@@ -1395,6 +1507,12 @@ class Handler(BaseHTTPRequestHandler):
except KohaError as e:
return self._send(404 if e.status == 404 else 502, {"status": "error", "message":
"Koha is not answering yet - try again in a minute." if e.status == 503 else "Failed: %s" % e.body[:120]})
if path == "/api/export.csv":
try:
body = export_csv()
except KohaError:
return self._send(502, {"status": "error"})
return self._send(200, body, "text/csv; charset=utf-8", {"Content-Disposition": 'attachment; filename="library.csv"'})
if path == "/api/qr":
try:
svg = qr_svg((urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query).get("t") or [""])[0])
@@ -1446,7 +1564,7 @@ class Handler(BaseHTTPRequestHandler):
return self._send(415, {"status": "error", "message": "Please send a JPEG or PNG photo."})
return self._send(200, {"status": "ok", "codes": codes})
length = int(self.headers.get("Content-Length", "0"))
if length > 20000:
if length > (2_200_000 if self.path == "/api/ar/import" else 20000):
return self._send(413, {"error": "too large"})
payload = json.loads(self.rfile.read(length) or b"{}")
ops = {"/api/add": op_add, "/api/manual": op_manual, "/api/undo": op_undo,
@@ -1454,7 +1572,7 @@ class Handler(BaseHTTPRequestHandler):
"/api/barcodes/reserve": op_reserve, "/api/barcodes/assign": op_assign,
"/api/item/update": op_item_update, "/api/item/delete": op_item_delete,
"/api/item/copy": op_item_copy, "/api/book/delete": op_book_delete,
"/api/value/add": op_value_add, "/api/checkout": op_checkout, "/api/return": op_return, "/api/renew": op_renew, "/api/patron/add": op_patron_add}
"/api/value/add": op_value_add, "/api/ar/set": op_ar_set, "/api/ar/import": op_ar_import, "/api/checkout": op_checkout, "/api/return": op_return, "/api/renew": op_renew, "/api/patron/add": op_patron_add}
fn = ops.get(self.path)
if not fn:
return self._send(404, {"error": "not found"})
library/quickadd/index.html
+39 -1
View File
@@ -170,6 +170,16 @@
<div id="libstatus" class="small" aria-live="polite"></div>
<div class="grid" id="grid"></div>
<div class="actions"><button type="button" id="more" hidden>Show more</button></div>
<details class="settings" id="csvtools">
<summary>Export / import</summary>
<div class="tool"><strong>Export your books</strong>
<div class="small">A spreadsheet (CSV) with one row per copy: title, author, ISBN, barcode, shelf, collection, status and any reading level on file.</div>
<div class="actions"><a href="api/export.csv" download><button type="button">Download library.csv</button></a></div></div>
<div class="tool"><strong>Import reading levels</strong>
<div class="small">A CSV with a header row and columns <code>isbn</code>, <code>level</code>, <code>points</code> (and optionally <code>quiz</code>). Existing levels for the same ISBN are updated.</div>
<div class="actions"><input type="file" id="arfile" accept=".csv,text/csv"><button type="button" id="arimport">Import</button></div>
<div id="arresult" class="small" aria-live="polite"></div></div>
</details>
</section>
<section id="view-lend" hidden>
@@ -639,6 +649,11 @@
$('libstatus').textContent = shown ? shown + (r.more ? '+' : '') + (shown === 1 ? ' book' : ' books') + (f.q || f.shelf || f.collection || f.type || f.status ? ' match' : '') :
(f.q || f.shelf || f.collection || f.type || f.status ? 'No books match.' : (viewer ? 'Nothing here yet.' : 'Nothing here yet - open Add books and scan an ISBN.'));
}
$('arimport').onclick = async () => {
const f = $('arfile').files[0]; if (!f) { $('arresult').textContent = 'Choose a CSV file first.'; return; }
const r = await api('/api/ar/import', { csv: await f.text() });
$('arresult').textContent = r.status === 'imported' ? 'Imported ' + r.count + ' reading level' + (r.count === 1 ? '' : 's') + (r.skipped ? ' (' + r.skipped + ' rows skipped: no valid ISBN or level)' : '') + '.' : (r.message || 'Import failed.');
};
$('more').onclick = () => { libPage += 1; loadLibrary(false); };
$('findform').onsubmit = ev => { ev.preventDefault(); loadLibrary(true); };
for (const id of ['f-shelf', 'f-coll', 'f-type', 'f-status', 'f-sort']) $(id).onchange = () => loadLibrary(true);
@@ -698,6 +713,28 @@
return sel;
}
// Reading level (AR): typed in here or imported from a CSV. AR BookFind itself is only a link: it has no
// public feed and its terms forbid automated look-ups.
function arBox(b, m) {
const ar = m.ar || {};
const f = (ph, v, w) => el('input', { type: 'text', placeholder: ph, value: v || '', 'aria-label': ph, inputMode: 'decimal', style: 'width:' + w + 'em;font:inherit;padding:6px 8px;border:1px solid var(--line);border-radius:8px;background:var(--card);color:var(--ink)' });
const lvl = f('Level', ar.level, 5), pts = f('Points', ar.points, 5), quiz = f('Quiz no.', ar.quiz, 7);
const wrap = el('div', { className: 'small', style: 'margin-top:10px;border-top:1px solid var(--line);padding-top:8px' });
const copy = el('button', { type: 'button' }, 'Copy title');
copy.onclick = async () => { try { await navigator.clipboard.writeText(b.title); copy.textContent = 'Copied ✓'; } catch (e) { copy.textContent = 'Copy failed'; } setTimeout(() => copy.textContent = 'Copy title', 1500); };
const open = el('a', { href: 'https://www.arbookfind.com/', target: '_blank', rel: 'noopener noreferrer' }, 'Open AR BookFind');
if (viewer) { wrap.append(el('strong', {}, 'Reading level: '), ar.level ? 'AR ' + ar.level + (ar.points ? ', ' + ar.points + ' points' : '') : 'not recorded'); return wrap; }
const save = el('button', { type: 'button', className: 'primary' }, 'Save');
const msg = el('span', {});
save.onclick = async () => {
const r = await api('/api/ar/set', { isbn: m.isbn, level: lvl.value, points: pts.value, quiz: quiz.value });
msg.textContent = r.status === 'saved' ? ' Saved ✓' : ' ' + (r.message || 'Could not save.');
};
wrap.append(el('strong', {}, 'Reading level (AR): '), lvl, ' ', pts, ' ', quiz, ' ', save, msg,
el('div', { style: 'margin-top:6px' }, open, ' (a new tab: search for the title there, then type what it shows) ', copy));
return wrap;
}
function fillMore(box, b, m) {
const parts = [];
if (m.description && !b.summary) parts.push(el('p', {}, m.description), el('div', { className: 'small' }, 'Description from Open Library.'));
@@ -706,7 +743,7 @@
const row = el('div', { className: 'small', style: 'margin-top:8px' }, 'Look it up: ');
(m.links || []).forEach((l, i) => { if (i) row.append(' · '); row.append(el('a', { href: l.url, target: '_blank', rel: 'noopener noreferrer' }, l.label)); });
parts.push(row);
if ((m.links || []).some(l => l.note)) parts.push(el('div', { className: 'small' }, 'AR BookFind has no public feed and its terms forbid automated look-ups, so open it and search for "' + b.title + '" yourself.'));
if ((m.links || []).some(l => l.note)) parts.push(arBox(b, m));
box.replaceChildren(...parts);
}
@@ -940,6 +977,7 @@
const tab = { library: 'library', book: 'library', add: 'add', lend: 'lend', people: 'people', card: 'people', cards: 'people' }[view];
for (const t of ['library', 'add', 'lend', 'people']) $('tab-' + t).classList.toggle('on', t === tab);
for (const t of ['add', 'lend', 'people']) $('tab-' + t).hidden = viewer;
$('csvtools').hidden = viewer;
const names = { library: 'Library', book: 'Library', add: 'Add books', lend: 'Lend / return', people: 'People', card: 'Library card', cards: 'Library cards' };
$('title').textContent = names[view]; document.title = names[view];
if (view === 'book') loadBook(m[1]);