ArchiveLabs / ArchiveLabs/pyopds2_openlibrary

Add belongsTo categories

Open
#93 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
1
Forks
2
Avg merge
4h 1m
Merged PRs (30d)
1

Description

On openlibrary we have collections

https://openlibrary.org/collections

These are great, and we should make sure publications have them in their belongsTo tag

```
"publications": [
{
"metadata": {
"@type": "http://schema.org/Audiobook",
"title": "Soeurs",
"language": "fr",
"identifier": "urn:isbn:9782367627168",
"modified": "2025-08-10T06:06:47.129Z",
"published": "2018-08-16T04:00:00.000Z",
"author": [
{
"name": "Bernard Minier",
"links": [
{
"type": "application/opds+json",
"href": "/v1/resources.opds2?author_keyword=Bernard+Minier"
}
]
}
],
"publisher": {
"name": "Audiolib",
"links": [
{
"type": "application/opds+json",
"href": "/v1/resources.opds2?publisher_keyword=Audiolib"
}
]
},
"description": "Mai 1993. Deux soeurs, Alice et Ambre, sont retrouvées mortes en bordure de Garonne, vêtues de robes de communiantes. Le jeune Martin Servaz, qui vient d’intégrer la PJ de Toulouse, participe à sa première enquête. Très vite, il s’intéresse à Erik Lang, célèbre auteur de romans policiers. Les jeunes femmes n’étaient-elles pas ses fans ? L’un de ses plus grands succès ne s’appelle-t-il pas La Communiante ?… L’affaire connaît un dénouement inattendu et violent, laissant Servaz rongé par le doute : dans cette enquête, estime-t-il, une pièce manque, une pièce essentielle.Février 2018. L’écrivain Erik Lang découvre sa femme assassinée… elle aussi vêtue en communiante. Vingt-cinq ans après le double crime, Martin Servaz est rattrapé par l’affaire. Le choc réveille ses premières craintes. Jusqu’à l’obsession.Une épouse, deux soeurs, trois communiantes… et si l’enquête de 1993 s’était trompée de coupable ?Peur, soumission, mensonges, manipulationLe nouveau thriller de Bernard Minier\nLa génèse de Servaz, un enquêteur pas comme les autres… Et si l’innocence cachait les pires turpitudes dues à la peur et au mensonge ? Un thriller sur le jeu du passé et de l’avenir par le nouveau roi du thriller français. Àécouter, déguster, retrouver et suivre pas à pas chez Audiolib…Émotions garanties au rythme du grave vibrato de son lecteur…Pour Servaz, le passé, en resurgissant, va se transformer en cauchemar. Un mauvais rêve écrit à l’encre noire.© XO éditions, 2018\n(C) et (P) Audiolib, 2018\nDurée : 12h58",
"belongsTo": {
"collection": "Policier, thriller"
},
"subject": [
{
"scheme": "https://www.editeur.org/151/Thema",
"code": "FH",
"name": "Thriller / suspense fiction",
"links": [
{
"type": "application/opds+json",
"href": "/v1/resources.opds2?category=FH&category_standard=thema"
}
]
}
],
"accessibility": {
"accessModeSufficient": [
"auditory"
]
}
},
```

I believe we can represent collection as a list of links, I.E.

```
"belongsTo": {
"collection": [{"name": "Policier, thriller", "href": "....", "type": "application+opds+json"}]
},
```

I'd be great to include these.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by tracing the code that builds publication metadata and currently assigns the belongsTo collection value. Update the generated publication output so collections are represented as linked entries matching the issue’s example, then verify the resulting OPDS JSON against that expected shape.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, backend
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.