idiouf commited on
Commit
01d169e
·
verified ·
1 Parent(s): ca05f78

Upload 33 files

Browse files
.gitattributes CHANGED
@@ -33,3 +33,8 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
 
 
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ 1-atlas-clair-EN.png filter=lfs diff=lfs merge=lfs -text
37
+ 2-atlas-sombre-FR.png filter=lfs diff=lfs merge=lfs -text
38
+ 3-vue-ensemble.png filter=lfs diff=lfs merge=lfs -text
39
+ 4-recuperation.png filter=lfs diff=lfs merge=lfs -text
40
+ 5-exemplaires-FR.png filter=lfs diff=lfs merge=lfs -text
1-atlas-clair-EN.png ADDED

Git LFS Details

  • SHA256: 11c5ff3d00be448a6a10ef5b51c061eb6b2f9d8216335a62d5e5978c7dffb3fc
  • Pointer size: 131 Bytes
  • Size of remote file: 225 kB
2-atlas-sombre-FR.png ADDED

Git LFS Details

  • SHA256: 53b29a03910ef3044f50018c15b71fa30dfd954a4660cf93d0725cf8503ed954
  • Pointer size: 131 Bytes
  • Size of remote file: 222 kB
3-vue-ensemble.png ADDED

Git LFS Details

  • SHA256: f768d8d2d4899871f4de65c0c3e44d1a60c6f95bb12e05f09b998cdbe9c31286
  • Pointer size: 131 Bytes
  • Size of remote file: 196 kB
4-recuperation.png ADDED

Git LFS Details

  • SHA256: 865a94ae1ceafdd8508bf0c5a90918107e0e25dee538737a795e0bbaa7df0011
  • Pointer size: 131 Bytes
  • Size of remote file: 171 kB
5-exemplaires-FR.png ADDED

Git LFS Details

  • SHA256: 9d6305f0139e51a39cee7e02d54a23c345fa554096ad413a79311c32a7267969
  • Pointer size: 131 Bytes
  • Size of remote file: 189 kB
README.md CHANGED
@@ -3,8 +3,8 @@ title: African Books Recovery Project
3
  emoji: 📚
4
  colorFrom: yellow
5
  colorTo: indigo
6
- sdk: docker
7
- app_port: 7860
8
  pinned: false
9
  license: cc-by-4.0
10
  tags:
@@ -30,19 +30,40 @@ family houses that nobody has surveyed. This dashboard is the first working inst
30
  that problem: it holds what has been located, and it measures how far each title still is
31
  from being a text a teacher can use.
32
 
33
- **Live:** deploy this repository to a Hugging Face Space (Docker SDK, port 7860).
34
 
35
  ## What it contains
36
 
37
  | Table | Rows | What it is |
38
  |---|---|---|
39
- | `titles` | 385 | Book records: author, title, press, place, year, language, genre, scan status, in-print status, sources, confidence |
40
- | `presses` | 112 | The publishing houses: city, country, founding and closure, ownership, key figures, series, significance |
41
- | `rights` | 8 | Copyright terms, statutes, orphan-works mechanisms and recovery implications by jurisdiction |
42
- | `digitization` | 33 | Existing digitisation initiatives, their access tiers, formats and APIs |
43
- | `holdings` | 36 | Search channels — where surviving copies may physically be, in Africa and outside it |
44
-
45
- 28 countries of publication, 27 languages, 45 titles in African languages.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
46
 
47
  ## The six recovery stages
48
 
@@ -91,38 +112,36 @@ if they are violated.
91
  and the Casa dos Estudantes do Império were African-founded and African-directed but
92
  printed in Paris and Lisbon. Excluding them would falsify the intellectual history;
93
  including them silently would falsify the geography.
94
- 6. **Derived fields are computed, never hand-entered.** Region, decade, genre grouping,
95
- recovery stage and pilot cluster all come out of the ETL and can be recomputed.
96
- 7. **Rights information is descriptive, not legal advice.**
 
 
 
 
97
 
98
  ## Repository layout
99
 
100
  Flat on purpose: every file sits in this one directory, no subfolders.
101
 
102
  ```
103
- app.py the dashboard (8 sections)
104
- catalogue.py data access and the recovery-stage model
105
- theme.py palette, Altair theme, CSS
106
- build_data.py ETL: the source JSON -> the parquet fixtures
107
- selftest.py governance checks + renders every page; the Docker build runs it
108
- Dockerfile Streamlit on port 7860; theme set via environment variables
109
- requirements.txt pinned dependencies
110
  deploy.sh push this folder to a Hugging Face Space
111
 
112
  nigeria_presses.json the sourced research records — the primary artefact
113
- nigeria_titles.json
114
- ghana_presses.json (and ghana_titles, eastafrica_*, franco_*, southern_*)
115
- rights.json copyright terms and orphan-works mechanisms by jurisdiction
116
  digitization.json existing digitisation initiatives
117
  holdings.json search channels: where surviving copies may be
 
118
 
119
- titles.parquet built fixtures, regenerated by build_data.py
120
- presses.parquet
121
- rights.parquet
122
- digitization.parquet
123
- holdings.parquet
124
- titles.csv plain-CSV mirror, usable without the app
125
- presses.csv
126
  ```
127
 
128
  Rebuild after editing any research file:
@@ -134,6 +153,12 @@ python selftest.py
134
  streamlit run app.py
135
  ```
136
 
 
 
 
 
 
 
137
  ## Sources
138
 
139
  The catalogue was assembled from library digital collections (University of Kansas Onitsha
@@ -153,7 +178,7 @@ thinnest major gap. Author dates of death are absent throughout, which is why no
153
  calculation in this dashboard is applied to a named author. Scan status is unverified for
154
  173 titles.
155
 
156
- Read a small number in this dashboard as "not yet searched" — never as "nothing there."
157
 
158
  ## Licence
159
 
 
3
  emoji: 📚
4
  colorFrom: yellow
5
  colorTo: indigo
6
+ sdk: streamlit
7
+ app_file: app.py
8
  pinned: false
9
  license: cc-by-4.0
10
  tags:
 
30
  that problem: it holds what has been located, and it measures how far each title still is
31
  from being a text a teacher can use.
32
 
33
+ Interface in English by default; a French toggle sits at the top of the page, beside a light/dark switch. Eight tabs: Overview · **Atlas** · Presses · Catalogue · Recovery · Rights · Copies · Methods.
34
 
35
  ## What it contains
36
 
37
  | Table | Rows | What it is |
38
  |---|---|---|
39
+ | `titles.csv` | 385 | Book records: author, title, press, place, year, language, genre, scan status, in-print status, sources, confidence |
40
+ | `presses.csv` | 112 | The publishing houses: city, country, founding and closure, ownership, key figures, series, significance |
41
+ | `rights.csv` | 8 | Copyright terms, statutes, orphan-works mechanisms and recovery implications by jurisdiction |
42
+ | `digitization.csv` | 33 | Existing digitisation initiatives, their access tiers, formats and APIs |
43
+ | `holdings.csv` | 36 | Search channels — where surviving copies may physically be, in Africa and outside it |
44
+ | `cities.csv` | 45 | Publishing cities with gazetteer coordinates, for the atlas dots |
45
+ | `countries.csv` | 54 | Coverage for every African country that has a polygon — **zeros included** |
46
+ | `contours_afrique.csv` | 2 947 | Country outlines as a flat vertex table (Natural Earth 1:50m) |
47
+
48
+ 28 countries of publication, 27 languages, 66 titles in African languages —
49
+ and **27 of the 54 African countries carry no record at all.**
50
+
51
+ ## The atlas
52
+
53
+ Vega-Lite can draw GeoJSON, but Streamlit re-serialises a chart's data as an
54
+ Arrow table before sending it, which destroys nested geometries and leaves the
55
+ map blank. The outlines are therefore unfolded into a flat vertex table and drawn
56
+ as filled closed lines — the same technique as the companion climate atlas.
57
+
58
+ No value is written inside a polygon: at 54 countries the labels collide. Values
59
+ are read on hover and on the ranking panel that accompanies every map. A country
60
+ with no record is grey, never interpolated from a neighbour, and every map
61
+ subtitle counts the grey ones so that *unsearched* can never be mistaken for
62
+ *empty*.
63
+
64
+ City dots come from `villes.json`, a declared gazetteer that also normalises the
65
+ spelling variants found in the sources. They place a city on a map and carry no
66
+ bibliographic weight.
67
 
68
  ## The six recovery stages
69
 
 
112
  and the Casa dos Estudantes do Império were African-founded and African-directed but
113
  printed in Paris and Lisbon. Excluding them would falsify the intellectual history;
114
  including them silently would falsify the geography.
115
+ 6. **Grey is never zero.** On every map a country with no record is grey and the
116
+ subtitle counts them. Nothing is interpolated from a neighbour.
117
+ 7. **City coordinates are a cartographic aid, not a record.** Declared in
118
+ `villes.json`, they place a dot and nothing more.
119
+ 8. **Derived fields are computed, never hand-entered.** Region, decade, genre grouping,
120
+ recovery stage, pilot cluster and city normalisation all come out of the ETL.
121
+ 9. **Rights information is descriptive, not legal advice.**
122
 
123
  ## Repository layout
124
 
125
  Flat on purpose: every file sits in this one directory, no subfolders.
126
 
127
  ```
128
+ app.py the dashboard — 8 tabs, EN/FR, light/dark, self-contained
129
+ build_data.py ETL: the sourced JSON -> the CSV tables
130
+ selftest.py 37 governance, cartography and rendering checks
131
+ requirements.txt streamlit, and nothing else
132
+ README.md this file, with the Hugging Face YAML header
 
 
133
  deploy.sh push this folder to a Hugging Face Space
134
 
135
  nigeria_presses.json the sourced research records — the primary artefact
136
+ nigeria_titles.json (and ghana_*, eastafrica_*, franco_*, southern_*)
137
+ rights.json copyright terms and orphan-works mechanisms
 
138
  digitization.json existing digitisation initiatives
139
  holdings.json search channels: where surviving copies may be
140
+ villes.json city gazetteer and spelling normalisation
141
 
142
+ titles.csv presses.csv rights.csv digitization.csv holdings.csv
143
+ cities.csv countries.csv built by build_data.py
144
+ contours_afrique.csv country outlines, flat vertex table
 
 
 
 
145
  ```
146
 
147
  Rebuild after editing any research file:
 
153
  streamlit run app.py
154
  ```
155
 
156
+ `selftest.py` is the gate. It refuses, among other things, any record without a
157
+ source, any invented year, any title claiming rights clearance, any African
158
+ country of publication without a polygon, any city without coordinates, and any
159
+ import beyond streamlit's own dependency set. It also renders the whole app in
160
+ both languages and both themes.
161
+
162
  ## Sources
163
 
164
  The catalogue was assembled from library digital collections (University of Kansas Onitsha
 
178
  calculation in this dashboard is applied to a named author. Scan status is unverified for
179
  173 titles.
180
 
181
+ Read a small number in this dashboard as "not yet searched" — never as "nothing there." **27 of the 54 African countries are grey on every map, and not one of them lacked a printing press between 1950 and 1979.**
182
 
183
  ## Licence
184
 
app.py CHANGED
The diff for this file is too large to render. See raw diff
 
build_data.py CHANGED
@@ -88,6 +88,40 @@ REGION = {
88
  "Portugal": "Diaspora (Europe)",
89
  }
90
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
91
  # Presses whose imprint sits outside the continent. Kept in the register because
92
  # they were African-founded and African-directed, but never counted as
93
  # "published in Africa" without the flag being visible.
@@ -150,8 +184,10 @@ def build_presses() -> pd.DataFrame:
150
  {
151
  "press_id": rec["press_id"],
152
  "name": clean_str(rec.get("name")),
153
- "city": clean_str(rec.get("city")),
 
154
  "country": country,
 
155
  "region": region_of(country),
156
  "research_batch": batch_label,
157
  "founded": rec.get("founded"),
@@ -208,8 +244,9 @@ def build_titles(presses: pd.DataFrame) -> pd.DataFrame:
208
  dig = rec.get("digitization") or {}
209
  dig_status = clean_str(dig.get("status")) or "unknown"
210
  year = rec.get("year")
211
- city = clean_str(rec.get("city")) or clean_str(press.get("city"))
212
  country = norm_country(press.get("country"))
 
213
  lang = clean_str(rec.get("language")) or "unknown"
214
  rows.append(
215
  {
@@ -219,7 +256,10 @@ def build_titles(presses: pd.DataFrame) -> pd.DataFrame:
219
  "press_name": clean_str(rec.get("press_name")) or clean_str(press.get("name")),
220
  "press_ownership": clean_str(press.get("ownership")) or "unknown",
221
  "city": city,
 
 
222
  "country": country,
 
223
  "region": region_of(country),
224
  "research_batch": batch_label,
225
  "year": year,
@@ -412,6 +452,55 @@ def build_rights() -> pd.DataFrame:
412
  return pd.DataFrame(rows)
413
 
414
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
415
  def build_holdings() -> pd.DataFrame:
416
  """Search channels — where surviving copies may physically be.
417
 
@@ -433,22 +522,23 @@ def main():
433
  digi = build_digitization()
434
  rights = build_rights()
435
  holdings = build_holdings()
 
 
436
 
 
 
437
  for name, df in [
438
  ("presses", presses),
439
  ("titles", titles),
440
  ("digitization", digi),
441
  ("rights", rights),
442
  ("holdings", holdings),
 
 
443
  ]:
444
- out = DATA / f"{name}.parquet"
445
- df.to_parquet(out, index=False)
446
- print(f" wrote {out.name:24s} {len(df):4d} rows {out.stat().st_size/1024:6.1f} kB")
447
-
448
- # a plain-CSV mirror so the catalogue is usable without the app
449
- titles.to_csv(DATA / "titles.csv", index=False)
450
- presses.to_csv(DATA / "presses.csv", index=False)
451
- print(f" wrote titles.csv / presses.csv (open-data mirror)")
452
 
453
  print(
454
  f"\nTotals: {len(titles)} titles · {len(presses)} presses · "
 
88
  "Portugal": "Diaspora (Europe)",
89
  }
90
 
91
+ # Country name as it appears in contours_afrique.csv (Natural Earth 1:50m).
92
+ # Only the three that differ are listed; everything else matches on its own name.
93
+ # A country with no entry and no match simply has no polygon, and the map says so
94
+ # rather than silently dropping it.
95
+ MAP_COUNTRY = {
96
+ "DR Congo": "Democratic Republic of the Congo",
97
+ "Tanzania": "United Republic of Tanzania",
98
+ "Côte d'Ivoire": "Ivory Coast",
99
+ }
100
+
101
+ # Cities: canonical name, coordinates and the spelling variants that occur in the
102
+ # research files. Loaded once here so that normalisation is a reviewable table
103
+ # rather than a regex buried in the app.
104
+ _CITIES = json.loads((RESEARCH / "villes.json").read_text(encoding="utf-8"))["cities"]
105
+ CITY_COORD = {c["city"]: (c["lat"], c["lon"], c["country"]) for c in _CITIES}
106
+ CITY_CANON = {}
107
+ for _c in _CITIES:
108
+ CITY_CANON[_c["city"].lower()] = _c["city"]
109
+ for _v in _c["variants"]:
110
+ CITY_CANON[_v.lower()] = _c["city"]
111
+
112
+
113
+ def canon_city(raw):
114
+ """Canonical city name. An unmapped spelling is returned unchanged and shows
115
+ up in selftest.py as a city with no coordinates — visible, not silently lost."""
116
+ r = (raw or "").strip()
117
+ return CITY_CANON.get(r.lower(), r)
118
+
119
+
120
+ def map_name(country):
121
+ c = norm_country(country)
122
+ return MAP_COUNTRY.get(c, c)
123
+
124
+
125
  # Presses whose imprint sits outside the continent. Kept in the register because
126
  # they were African-founded and African-directed, but never counted as
127
  # "published in Africa" without the flag being visible.
 
184
  {
185
  "press_id": rec["press_id"],
186
  "name": clean_str(rec.get("name")),
187
+ "city": canon_city(rec.get("city")),
188
+ "city_raw": clean_str(rec.get("city")),
189
  "country": country,
190
+ "map_country": map_name(country),
191
  "region": region_of(country),
192
  "research_batch": batch_label,
193
  "founded": rec.get("founded"),
 
244
  dig = rec.get("digitization") or {}
245
  dig_status = clean_str(dig.get("status")) or "unknown"
246
  year = rec.get("year")
247
+ city = canon_city(rec.get("city")) or clean_str(press.get("city"))
248
  country = norm_country(press.get("country"))
249
+ lat, lon, _ = CITY_COORD.get(city, (None, None, None))
250
  lang = clean_str(rec.get("language")) or "unknown"
251
  rows.append(
252
  {
 
256
  "press_name": clean_str(rec.get("press_name")) or clean_str(press.get("name")),
257
  "press_ownership": clean_str(press.get("ownership")) or "unknown",
258
  "city": city,
259
+ "lat": lat,
260
+ "lon": lon,
261
  "country": country,
262
+ "map_country": map_name(country),
263
  "region": region_of(country),
264
  "research_batch": batch_label,
265
  "year": year,
 
452
  return pd.DataFrame(rows)
453
 
454
 
455
+ def build_cities(titles: pd.DataFrame, presses: pd.DataFrame) -> pd.DataFrame:
456
+ """One row per publishing city, with the coordinates used to place its dot.
457
+
458
+ Cities with no gazetteer entry are kept with empty coordinates: they belong
459
+ in the counts even when they cannot be mapped, and the app names them.
460
+ """
461
+ t = titles.groupby("city").size().rename("titles")
462
+ pr = presses.groupby("city").size().rename("presses")
463
+ df = pd.concat([t, pr], axis=1).fillna(0).astype(int).reset_index()
464
+ df["lat"] = df["city"].map(lambda c: CITY_COORD.get(c, (None, None, None))[0])
465
+ df["lon"] = df["city"].map(lambda c: CITY_COORD.get(c, (None, None, None))[1])
466
+ df["country"] = df["city"].map(lambda c: CITY_COORD.get(c, (None, None, ""))[2])
467
+ df["region"] = df["country"].map(region_of)
468
+ df["on_map"] = df["lat"].notna() & (df["region"] != "Diaspora (Europe)")
469
+ unplaced = df[df["lat"].isna()]["city"].tolist()
470
+ if unplaced:
471
+ print(f" cities: {len(unplaced)} without coordinates -> {', '.join(unplaced)}")
472
+ return df.sort_values("titles", ascending=False)
473
+
474
+
475
+ def build_countries(titles: pd.DataFrame, presses: pd.DataFrame) -> pd.DataFrame:
476
+ """Coverage for every African country that has a polygon — zeros included.
477
+
478
+ The zeros are the point of this table. A country with no record is not a
479
+ country with no publishing history; it is a country nobody has searched yet,
480
+ and the map has to be able to say so.
481
+ """
482
+ contours = pd.read_csv(ROOT / "contours_afrique.csv")
483
+ names = sorted(contours["pays"].unique())
484
+ t = titles.groupby("map_country").size().rename("titles")
485
+ pr = presses.groupby("map_country").size().rename("presses")
486
+ dg = (titles[titles["stage2_preserved"]].groupby("map_country").size()
487
+ .rename("preserved"))
488
+ df = pd.DataFrame({"map_country": names}).set_index("map_country")
489
+ df = df.join(t).join(pr).join(dg).fillna(0).astype(int).reset_index()
490
+ back = {v: k for k, v in MAP_COUNTRY.items()}
491
+ df["country"] = df["map_country"].map(lambda n: back.get(n, n))
492
+ df["region"] = df["country"].map(region_of)
493
+ df["searched"] = df["titles"] > 0
494
+ # Countries the research reached that have no polygon: they must not vanish.
495
+ orphans = sorted(set(titles["map_country"]) - set(names) - {""})
496
+ if orphans:
497
+ print(f" countries: {len(orphans)} with records but no polygon -> "
498
+ f"{', '.join(orphans)} (off-continent imprints, shown as a note)")
499
+ n_zero = int((~df["searched"]).sum())
500
+ print(f" countries: {len(df)} on the map, {n_zero} with no record yet")
501
+ return df.sort_values("titles", ascending=False)
502
+
503
+
504
  def build_holdings() -> pd.DataFrame:
505
  """Search channels — where surviving copies may physically be.
506
 
 
522
  digi = build_digitization()
523
  rights = build_rights()
524
  holdings = build_holdings()
525
+ cities = build_cities(titles, presses)
526
+ countries = build_countries(titles, presses)
527
 
528
+ # CSV, not parquet: the Space then needs streamlit alone — no pyarrow, no
529
+ # binary format, and the catalogue stays readable in any spreadsheet.
530
  for name, df in [
531
  ("presses", presses),
532
  ("titles", titles),
533
  ("digitization", digi),
534
  ("rights", rights),
535
  ("holdings", holdings),
536
+ ("cities", cities),
537
+ ("countries", countries),
538
  ]:
539
+ out = DATA / f"{name}.csv"
540
+ df.to_csv(out, index=False)
541
+ print(f" wrote {out.name:22s} {len(df):4d} rows {out.stat().st_size/1024:7.1f} kB")
 
 
 
 
 
542
 
543
  print(
544
  f"\nTotals: {len(titles)} titles · {len(presses)} presses · "
cities.csv ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ city,titles,presses,lat,lon,country,region,on_map
2
+ Nairobi,50,12,-1.29,36.82,Kenya,East Africa,True
3
+ Johannesburg,40,7,-26.2,28.05,South Africa,Southern Africa,True
4
+ Accra,39,11,5.56,-0.2,Ghana,West Africa,True
5
+ Onitsha,35,12,6.14,6.79,Nigeria,West Africa,True
6
+ Ibadan,19,6,7.38,3.9,Nigeria,West Africa,True
7
+ Dar es Salaam,17,2,-6.79,39.21,Tanzania,East Africa,True
8
+ Lusaka,15,1,-15.42,28.28,Zambia,Southern Africa,True
9
+ Dakar,14,5,14.72,-17.47,Senegal,West Africa,True
10
+ Gwelo (Gweru),12,1,-19.45,29.82,Zimbabwe,Southern Africa,True
11
+ Accra-Tema,12,1,5.62,-0.11,Ghana,West Africa,True
12
+ Cape Town,9,3,-33.92,18.42,South Africa,Southern Africa,True
13
+ Pietermaritzburg,9,2,-29.6,30.38,South Africa,Southern Africa,True
14
+ Kinshasa,8,4,-4.32,15.31,DR Congo,Central Africa,True
15
+ Morija,7,1,-29.62,27.5,Lesotho,Southern Africa,True
16
+ Yaoundé,7,2,3.87,11.52,Cameroon,Central Africa,True
17
+ Freetown,7,4,8.48,-13.23,Sierra Leone,West Africa,True
18
+ Salisbury (Harare),7,2,-17.83,31.05,Zimbabwe,Southern Africa,True
19
+ Tema,7,0,5.67,-0.02,Ghana,West Africa,True
20
+ Enugu,7,3,6.44,7.5,Nigeria,West Africa,True
21
+ Paris,6,2,48.86,2.35,France,Diaspora (Europe),False
22
+ Zaria,5,2,11.07,7.72,Nigeria,West Africa,True
23
+ Aboso,5,1,5.36,-1.95,Ghana,West Africa,True
24
+ Cairo,5,2,30.04,31.24,Egypt,North Africa,True
25
+ Limbe,5,1,4.02,9.21,Cameroon,Central Africa,True
26
+ Antananarivo,4,2,-18.88,47.51,Madagascar,Indian Ocean,True
27
+ Alice,4,1,-32.79,26.83,South Africa,Southern Africa,True
28
+ Algiers,4,1,36.75,3.06,Algeria,North Africa,True
29
+ Abidjan,3,1,5.32,-4.03,Côte d'Ivoire,West Africa,True
30
+ Oniipa,3,1,-17.85,16.02,Namibia,Southern Africa,True
31
+ Lagos,3,1,6.52,3.38,Nigeria,West Africa,True
32
+ Luanda,3,1,-8.84,13.23,Angola,Southern Africa,True
33
+ Tunis,3,1,36.81,10.18,Tunisia,North Africa,True
34
+ Mogadishu,2,1,2.04,45.34,Somalia,Horn of Africa,True
35
+ Maputo,2,2,-25.97,32.57,Mozambique,Southern Africa,True
36
+ Benin City,1,1,6.34,5.63,Nigeria,West Africa,True
37
+ Bathurst (Banjul),1,1,13.45,-16.58,Gambia,West Africa,True
38
+ Addis Ababa,1,2,9.03,38.74,Ethiopia,Horn of Africa,True
39
+ Casablanca,1,1,33.57,-7.59,Morocco,North Africa,True
40
+ Gaborone,1,1,-24.65,25.91,Botswana,Southern Africa,True
41
+ Lubumbashi,1,0,-11.66,27.48,DR Congo,Central Africa,True
42
+ Monrovia,1,1,6.3,-10.8,Liberia,West Africa,True
43
+ Kampala,0,2,0.31,32.58,Uganda,East Africa,True
44
+ Khartoum,0,2,15.5,32.56,Sudan,Horn of Africa,True
45
+ Lisbon,0,1,38.72,-9.14,Portugal,Diaspora (Europe),False
46
+ Nsukka,0,1,6.86,7.4,Nigeria,West Africa,True
contours_afrique.csv ADDED
The diff for this file is too large to render. See raw diff
 
countries.csv ADDED
@@ -0,0 +1,55 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ map_country,titles,presses,preserved,country,region,searched
2
+ Nigeria,70,26,5,Nigeria,West Africa,True
3
+ Ghana,63,13,0,Ghana,West Africa,True
4
+ South Africa,62,13,1,South Africa,Southern Africa,True
5
+ Kenya,54,12,0,Kenya,East Africa,True
6
+ Zimbabwe,19,3,0,Zimbabwe,Southern Africa,True
7
+ Senegal,15,5,0,Senegal,West Africa,True
8
+ Zambia,15,1,0,Zambia,Southern Africa,True
9
+ United Republic of Tanzania,13,2,0,Tanzania,East Africa,True
10
+ Democratic Republic of the Congo,9,4,0,DR Congo,Central Africa,True
11
+ Lesotho,7,1,0,Lesotho,Southern Africa,True
12
+ Cameroon,7,2,0,Cameroon,Central Africa,True
13
+ Sierra Leone,7,4,0,Sierra Leone,West Africa,True
14
+ Malawi,5,1,0,Malawi,Southern Africa,True
15
+ Egypt,5,2,0,Egypt,North Africa,True
16
+ Algeria,4,1,0,Algeria,North Africa,True
17
+ Madagascar,4,2,0,Madagascar,Indian Ocean,True
18
+ Tunisia,3,1,0,Tunisia,North Africa,True
19
+ Namibia,3,1,0,Namibia,Southern Africa,True
20
+ Angola,3,1,0,Angola,Southern Africa,True
21
+ Mozambique,2,2,0,Mozambique,Southern Africa,True
22
+ Somalia,2,1,0,Somalia,Horn of Africa,True
23
+ Ivory Coast,2,1,0,Côte d'Ivoire,West Africa,True
24
+ Morocco,1,1,0,Morocco,North Africa,True
25
+ Liberia,1,1,0,Liberia,West Africa,True
26
+ Gambia,1,1,0,Gambia,West Africa,True
27
+ Ethiopia,1,2,0,Ethiopia,Horn of Africa,True
28
+ Botswana,1,1,1,Botswana,Southern Africa,True
29
+ Equatorial Guinea,0,0,0,Equatorial Guinea,Unrecorded,False
30
+ Eritrea,0,0,0,Eritrea,Unrecorded,False
31
+ Gabon,0,0,0,Gabon,Unrecorded,False
32
+ Cabo Verde,0,0,0,Cabo Verde,Unrecorded,False
33
+ Chad,0,0,0,Chad,Unrecorded,False
34
+ Burkina Faso,0,0,0,Burkina Faso,Unrecorded,False
35
+ Burundi,0,0,0,Burundi,Unrecorded,False
36
+ Benin,0,0,0,Benin,Unrecorded,False
37
+ Central African Republic,0,0,0,Central African Republic,Unrecorded,False
38
+ Comoros,0,0,0,Comoros,Unrecorded,False
39
+ Djibouti,0,0,0,Djibouti,Unrecorded,False
40
+ Guinea-Bissau,0,0,0,Guinea-Bissau,Unrecorded,False
41
+ Guinea,0,0,0,Guinea,Unrecorded,False
42
+ Rwanda,0,0,0,Rwanda,Unrecorded,False
43
+ Republic of the Congo,0,0,0,Republic of the Congo,Unrecorded,False
44
+ Libya,0,0,0,Libya,Unrecorded,False
45
+ Mali,0,0,0,Mali,Unrecorded,False
46
+ Niger,0,0,0,Niger,Unrecorded,False
47
+ Mauritania,0,0,0,Mauritania,Unrecorded,False
48
+ São Tomé and Principe,0,0,0,São Tomé and Principe,Unrecorded,False
49
+ Sudan,0,2,0,Sudan,Horn of Africa,False
50
+ South Sudan,0,0,0,South Sudan,Unrecorded,False
51
+ Somaliland,0,0,0,Somaliland,Unrecorded,False
52
+ Uganda,0,2,0,Uganda,East Africa,False
53
+ Togo,0,0,0,Togo,West Africa,False
54
+ Western Sahara,0,0,0,Western Sahara,Unrecorded,False
55
+ eSwatini,0,0,0,eSwatini,Unrecorded,False
deploy.sh CHANGED
@@ -1,7 +1,7 @@
1
  #!/usr/bin/env bash
2
- # Push this directory to a Hugging Face Space.
3
  #
4
- # 1. Create the Space first (Docker SDK, blank template):
5
  # https://huggingface.co/new-space
6
  # 2. export HF_TOKEN=hf_... (a token with write access)
7
  # 3. ./deploy.sh <your-username>/African-Books-Recovery-Project
@@ -24,7 +24,7 @@ from huggingface_hub import HfApi
24
 
25
  repo = os.environ["REPO"]
26
  api = HfApi(token=os.environ["HF_TOKEN"])
27
- api.create_repo(repo_id=repo, repo_type="space", space_sdk="docker", exist_ok=True)
28
  api.upload_folder(
29
  repo_id=repo,
30
  repo_type="space",
 
1
  #!/usr/bin/env bash
2
+ # Push this directory to a Hugging Face Space (Streamlit SDK, app.py).
3
  #
4
+ # 1. Create the Space first (Streamlit SDK, blank template):
5
  # https://huggingface.co/new-space
6
  # 2. export HF_TOKEN=hf_... (a token with write access)
7
  # 3. ./deploy.sh <your-username>/African-Books-Recovery-Project
 
24
 
25
  repo = os.environ["REPO"]
26
  api = HfApi(token=os.environ["HF_TOKEN"])
27
+ api.create_repo(repo_id=repo, repo_type="space", space_sdk="streamlit", exist_ok=True)
28
  api.upload_folder(
29
  repo_id=repo,
30
  repo_type="space",
digitization.csv ADDED
@@ -0,0 +1,34 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ initiative_id,name,host_institution,country,region,in_africa,scope,relevance,access,formats,api,approx_items,url,confidence,source_count,source_titles,source_urls,primary_source_url
2
+ ku-onitsha-market-literature,Onitsha Market Literature Digital Collection / Exhibit,University of Kansas Libraries (Kenneth Spencer Research Library) with KU African Digital Humanities,United States,North America,False,"Nigerian popular pamphlet literature (stories, plays, moral and advice discourses) printed by local presses in Onitsha, mostly 1960s; KU holds over 100 items and has an online exhibit presenting 21 fully digitised pamphlets with annotations.","The single most directly on-target digitisation precedent for this project: African-authored, African-printed, 1950s-1960s, commercially ephemeral, and already partly digitised with scholarly framing. Also the clearest demonstration of the gap - roughly 21 of 100+ held items are online.",open,"PDF, page images",unknown,21.0,https://exhibits.lib.ku.edu/exhibits/show/onitsha,high,3,Digitizing Onitsha Market Literature - KU African Digital Humanities | Onitsha Market Literature exhibit - KU Libraries | Onitsha Market Literature Collection - Indiana University African Studies guide,https://africandh.ku.edu/digitizing-onitsha-market-literature | https://exhibits.lib.ku.edu/exhibits/show/onitsha | https://guides.libraries.indiana.edu/africanstudies/onitsha,https://africandh.ku.edu/digitizing-onitsha-market-literature
3
+ iu-onitsha-african-ephemera,Indiana University Onitsha Market Literature / African Ephemera Collection,"Indiana University Libraries, African Studies Collection (Herman B Wells Library)",United States,North America,False,Approximately 170 Onitsha market pamphlets held as part of the African Ephemera Collection. Uncatalogued and non-circulating; a searchable index of the 170+ items exists but the pamphlets themselves are not digitised.,"Largest single US holding of Onitsha pamphlets identified in this survey and the obvious next digitisation target. Note the collection is closed to researchers 1 August 2026 - 10 January 2027 for staff research leave, which constrains near-term partnership.",restricted,index only,no,170.0,https://guides.libraries.indiana.edu/africanstudies/onitsha,high,1,Onitsha Market Literature Collection - Indiana University African Studies guide,https://guides.libraries.indiana.edu/africanstudies/onitsha,https://guides.libraries.indiana.edu/africanstudies/onitsha
4
+ dloc-uf-onitsha,Onitsha Market Literature pamphlets in the Digital Library of the Caribbean / University of Florida Digital Collections,University of Florida Libraries,United States,North America,False,"A small set of digitised Onitsha pamphlets. Indiana University's guide states dLOC holds 13 digitised pamphlets; the UF landing page fetched for this survey described the Onitsha corpus generally (small books and pamphlets written, published and sold in and around the Onitsha marketplace, late 1940s to 1968) but did not confirm item counts, formats, API or rights.","A third partial Onitsha digitisation, confirming that the corpus is scattered across at least three US repositories with no union catalogue - a concrete aggregation opportunity for this project.",unknown,unknown,unknown,13.0,https://original-ufdc.uflib.ufl.edu/onitsha,low,2,UFDC Home - Onitsha Market Literature | Onitsha Market Literature Collection - Indiana University African Studies guide (states dLOC has 13 digitised pamphlets),https://original-ufdc.uflib.ufl.edu/onitsha | https://guides.libraries.indiana.edu/africanstudies/onitsha,https://original-ufdc.uflib.ufl.edu/onitsha
5
+ northwestern-herskovits-digital,Melville J. Herskovits Library of African Studies digital collections,Northwestern University Libraries,United States,North America,False,"Fourteen named Africana digital collections delivered through Northwestern Digital Collections, including Posters from the Herskovits Library (2,500+ of 5,000+ digitised), Arabic and Ajami manuscripts from West Africa, 16th-early 20th century maps of Africa (113 items), the E.H. Duckworth photographs of Nigeria, the Humphrey Winterton collection of East African photographs 1860-1960, and an audiovisual collection.","Herskovits is the largest separate Africana collection in the United States and its digital platform is technically the most reusable one found here: public IIIF manifests, an OAI-PMH endpoint and a documented public API. Strong candidate for metadata harvesting and for hosting or mirroring recovered texts. Note the collections digitised so far are overwhelmingly visual, not monographs.",partial,"IIIF, page images",yes,,https://www.library.northwestern.edu/libraries-collections/distinctive-special-collections/herskovits-library/collection/digital-collections.html,high,2,"Digital Collections - Herskovits Library, Northwestern University Libraries | Northwestern University - IIIF guide entry",https://www.library.northwestern.edu/libraries-collections/distinctive-special-collections/herskovits-library/collection/digital-collections.html | https://iiif.io/guides/guides/digitalcollections.library.northwestern.edu/,https://www.library.northwestern.edu/libraries-collections/distinctive-special-collections/herskovits-library/collection/digital-collections.html
6
+ msu-african-ejournals,African e-Journals Project / MSU Africana digital collections,Michigan State University Libraries,United States,North America,False,"MSU's digital repository hosts an African e-Journals Project (aejp) and an Africana Studies collection. At the time of this survey (September 2026) both repository entry points returned an access-restriction notice rather than collection content, so scope, item counts, formats and rights terms could not be verified.","Historically an important precedent for digitising African-published serials with publisher permission, and MSU is a major Africana library, but the platform must be re-checked before relying on it. Treat any claim about its holdings as unverified.",unknown,unknown,unknown,,https://d.lib.msu.edu/aejp,low,2,African e-Journals Project - MSU Libraries Digital Repository (returned access-limited notice) | Africana Studies Collection - MSU Libraries Digital Repository (returned access-limited notice),https://d.lib.msu.edu/aejp | https://d.lib.msu.edu/africana,https://d.lib.msu.edu/aejp
7
+ soas-digital-collections,SOAS Digital Collections,SOAS University of London Library and Special Collections,United Kingdom,Europe,False,"Digitised material from SOAS Library (1.3 million volumes in 400 languages), Special Collections archives relating to Africa, Asia and the Middle East, manuscripts in 100+ languages, and art and objects. Africa-related digitised material identified includes maps and photographs available for download; the platform did not expose a collection-level list of Africa holdings, sizes, or IIIF/licensing terms on the pages fetched.","SOAS is one of the strongest European libraries for African-published material of the 1950s-1970s, including African-language imprints, and its Special Collections hold press and missionary archives that document African publishing houses. The digital layer is thin and undocumented, so approach SOAS as a physical-holdings and archives partner first, digitisation partner second.",partial,page images,unknown,,https://digital.soas.ac.uk/,medium,3,SOAS Digital Collections | SOAS Digital Collections - browse | Explore the Africa Collection at the SOAS Library,https://digital.soas.ac.uk/ | https://digital.soas.ac.uk/collections | https://www.soas.ac.uk/about/blogs/explore-africa-collection-soas-library,https://digital.soas.ac.uk/
8
+ eap-british-library,Endangered Archives Programme (EAP),"British Library, funded by Arcadia",United Kingdom,Global,False,"Since 2004, over 500 projects in more than 90 countries and 100+ languages and scripts, digitising rare printed sources, manuscripts, visual material and audio that is at risk. Over 16 million images and 35,000 sound tracks digitised. Copies remain with the local archival partner as well as being made available on the EAP site and discoverable via the British Library catalogue.","The most important funding route in this landscape for African-held, at-risk print material, and the only major programme whose model deposits the master copy with the African custodian rather than exporting it. Printed pamphlets and small-press imprints of the 1950s-70s are squarely within its remit. Note that EAP funds projects; it does not itself hold African books.",open,page images,unknown,,https://eap.bl.uk/,high,1,Welcome to the Endangered Archives Programme,https://eap.bl.uk/,https://eap.bl.uk/
9
+ hathitrust,HathiTrust Digital Library,HathiTrust (partnership of research libraries),United States,North America,False,"Aggregated library digitisation, including large amounts of Africana scanned from US research library shelves. Access is tiered: full view for public domain, and search-only / no-read for everything not verified as public domain.","Critical constraint to understand. HathiTrust's default rule opens works published in the US more than 95 years ago, or published elsewhere in the world more than 125 years ago. On that rule NO African book from 1950-1979 will be opened, regardless of its status under Nigerian, Kenyan or South African law. Additionally, works published outside the US before 1929 are restricted to US IP addresses because of foreign-law uncertainty. HathiTrust is therefore useful for discovery and for search-inside evidence, and rights holders can voluntarily open items via Creative Commons declarations - which is the practical lever if this project clears rights.",partial,"PDF, OCR text, page images",unknown,,https://www.hathitrust.org/the-collection/search-access/copyright-access/,high,2,Copyright & Access - HathiTrust Digital Library | Access & Use Policy - HathiTrust Digital Library,https://www.hathitrust.org/the-collection/search-access/copyright-access/ | https://www.hathitrust.org/the-collection/search-access/access-use-policy/,https://www.hathitrust.org/the-collection/search-access/copyright-access/
10
+ internet-archive,Internet Archive (including controlled digital lending),Internet Archive,United States,Global,False,"Two distinct tiers. Public domain and openly licensed items are downloadable without restriction. In-copyright scanned books are made available only through controlled digital lending: 1-hour renewable loans or 14-day loans, up to 10 books at a time, delivered via an in-browser BookReader or as LCP-encrypted PDF/EPUB, with DAISY for print-disabled users.","The most realistic short-term route to giving readers access to a still-in-copyright 1960s African title without clearing rights, but only in lending form, and the legal basis for controlled digital lending is contested in the US. For books this project clears rights to, Internet Archive is also a low-cost open hosting option with unrestricted download.",partial,"PDF, EPUB, DAISY, OCR text",unknown,,https://help.archive.org/help/borrowing-from-the-lending-library/,high,1,Borrowing from the lending library - Internet Archive Help,https://help.archive.org/help/borrowing-from-the-lending-library/,https://help.archive.org/help/borrowing-from-the-lending-library/
11
+ jstor-struggles-for-freedom,Struggles for Freedom: Southern Africa (formerly Aluka),JSTOR / ITHAKA (originating from Aluka; funded by the Mellon Foundation and Arcadia),United States,Global,False,"More than 27,000 objects and 190,000 pages documenting liberation struggles in Botswana, Mozambique, Namibia, South Africa and Zimbabwe in the 20th century. Seventy-six sub-collections contributed by southern African national archives, universities (including Oxford, Yale, Princeton) and organisations such as the Anti-Apartheid Movement Archives Committee. Material includes periodicals, pamphlets, newspapers, nationalist publications, colonial records, UN documents, correspondence, photographs, speeches and interviews.","The largest and best-documented Africa-focused mass digitisation ever attempted, and the key precedent for negotiating with dozens of African rights holders and archives at once. Also a cautionary precedent: Aluka began as a freely accessible pan-African resource and is now presented by JSTOR as a licensed collection, meaning African institutions may need a subscription to reach material their own archives supplied.",restricted,"page images, PDF",unknown,27000.0,https://about.jstor.org/products/journals-and-primary-sources/licensed-collections/struggles-for-freedom-southern-africa/,high,1,Struggles for Freedom: Southern Africa - about JSTOR,https://about.jstor.org/products/journals-and-primary-sources/licensed-collections/struggles-for-freedom-southern-africa/,https://about.jstor.org/products/journals-and-primary-sources/licensed-collections/struggles-for-freedom-southern-africa/
12
+ disa-ukzn,DISA - Digital Innovation South Africa,University of KwaZulu-Natal,South Africa,Africa,True,"DISA 1 (from 1998) digitised 45 anti-apartheid periodicals covering 1960-1994 under the title 'South Africa's Struggle for Democracy: Anti-Apartheid Periodicals'. DISA 2 broadened to 'Southern African Freedom Struggles, c.1950-1994', adding documents, interviews, articles, posters, commissions, trials and legislation.","The leading African-hosted, African-run mass digitisation project, and directly overlapping this project's 1950-1979 window. Its stated practice of expending 'care and effort' on obtaining permission to use material is one of the few documented African rights-clearance workflows. Also the upstream source of much of what later appeared in Aluka/JSTOR, so it is a route to open access for material otherwise behind a JSTOR licence.",open,"PDF, page images",unknown,,https://disa.ukzn.ac.za/,medium,1,About Us - Digital Innovation South Africa,https://disa.ukzn.ac.za/About_Us,https://disa.ukzn.ac.za/About_Us
13
+ south-african-history-online,South African History Online (SAHO),"South African History Online (independent non-profit, est. 1998, registered 2000)",South Africa,Africa,True,"Reports 30,288 archive records, 17,654 historical events, 10,765 biographies, 2,810 articles, and over 50,000 digitised documents, videos and images covering pre-colonial to contemporary South African and African history. SAHO has itself produced 31 books and 4 CDs since 2000.","The most important model in this landscape for a project that is simultaneously an archive and a curriculum builder - which is exactly this project's brief. Crucially, SAHO's content is licensed CC BY-NC-SA 4.0, making it one of the very few African digital heritage bodies with a clear, reusable, machine-readable licence. Its site is open source and on GitHub, so its stack is also a candidate model.",open,"PDF, page images, HTML text",unknown,30288.0,https://sahistory.org.za/about-us,high,1,About South African History Online (SAHO),https://sahistory.org.za/about-us,https://sahistory.org.za/about-us
14
+ ajol,African Journals OnLine (AJOL),"AJOL, a South Africa-based non-profit",South Africa,Africa,True,"The largest online collection of African-published peer-reviewed scholarly journals: over 650 journals from 37 African countries, more than 200,000 visitors and about two million article downloads a month. Launched as a pilot in 1998, relaunched in 2000 with 50 journals. More than half of the full-text articles are free to download; some journals are diamond open access, others fee-based.","The proof that an African-owned, African-hosted aggregation platform can reach global scale, and the natural partner for the scholarly-journal side of any 1950s-70s recovery. Its licensing note is a direct warning for this project: platform material is CC-BY-SA, but re-use or sharing of hosted articles is not permitted unless the individual journal's own displayed copyright or licence allows it. Per-item rights, not blanket rights.",partial,PDF,unknown,,https://www.ajol.info/index.php/ajol/about-AJOL-African-Journals-Online,high,1,About AJOL | African Journals Online,https://www.ajol.info/index.php/ajol/about-AJOL-African-Journals-Online,https://www.ajol.info/index.php/ajol/about-AJOL-African-Journals-Online
15
+ codesria-codice,CODESRIA Documentation and Information Centre (CODICE) online library,"Council for the Development of Social Science Research in Africa (CODESRIA), Dakar",Senegal,Africa,True,"An online library catalogue on the Koha platform covering books, reports, theses and dissertations, periodical articles and conference papers in the social sciences and humanities; no registration needed to search. CODESRIA also publishes downloadable documentary products (a theses and dissertations catalogue 1988-2018, CODICE Current Contents 2016-2020, acquisitions lists, thematic bibliographies) and curates a guide to 13+ open access databases.","The senior pan-African scholarly infrastructure body, based in Dakar, and a natural convening partner for francophone West African recovery. Note the emphasis is on a catalogue and bibliographies rather than a full-text digital library - it is a discovery layer, not a source of scans. Item counts and formats are not published.",partial,"catalogue records, PDF",unknown,,https://codesria.org/resources/,medium,1,Resources - CODESRIA,https://codesria.org/resources/,https://codesria.org/resources/
16
+ african-digital-heritage,African Digital Heritage,African Digital Heritage (non-profit),Kenya,Africa,True,"A Nairobi-based non-profit working across digitisation (archives, oral histories, monuments), innovation (VR, mobile applications), research on African heritage and digital technology, and capacity building. It explicitly frames its work around infrastructure inequality and around 'issues around licencing and access to data'.","The clearest African-led critical voice on how digitisation should be done, and the right partner for governance questions: who holds the scans, under what licence, and who gets to say. Valuable as an ethics and methodology partner rather than as a source of digitised books. Its critique - that digitisation is not one-size-fits-all - should shape this project's consent model with heirs and communities.",open,mixed,no,,https://africandigitalheritage.org/aboutus/,high,1,Welcome to African Digital Heritage - About us,https://africandigitalheritage.org/aboutus/,https://africandigitalheritage.org/aboutus/
17
+ africa-bibliography,"Africa Bibliography, Research and Documentation",Cambridge University Press for the International African Institute,United Kingdom,Europe,False,"An online bibliographic database adding 6,000-8,000 entries a year and including records from its whole history. Formed in 2022 by consolidating Africa Bibliography (annual since 1984) and African Research & Documentation (SCOLMA's journal, since 1973). From 2022 the bibliography is online-database only. Two volumes a year of accompanying articles on research, libraries, archives and publishing in and on Africa.","The most complete scholarly index for identifying what was actually published in and about Africa across this project's period, and its predecessor journals stretch back to 1973 and 1984. Essential for building a candidate title list. The blocker is that it is subscription-based, so bibliographic verification will need an institutional partner.",restricted,catalogue records,unknown,,https://www.cambridge.org/core/journals/africa-bibliography-research-and-documentation,high,1,"About this journal - Africa Bibliography, Research and Documentation, Cambridge Core",https://www.cambridge.org/core/journals/africa-bibliography-research-and-documentation/information/about-this-journal,https://www.cambridge.org/core/journals/africa-bibliography-research-and-documentation/information/about-this-journal
18
+ national-repository-nigeria,National Repository of Nigeria (NRN) and NLN Virtual Library Services,National Library of Nigeria,Nigeria,Africa,True,"The National Library of Nigeria's Virtual Library Services department runs the National Repository of Nigeria, described as the apex repository of the Federal Republic, holding presidential speeches, pre-colonial manuscripts and autographs, constitutional documents, oral histories, government gazettes, journal articles, maps and theses. Related services include a virtual library, an OPAC, and licensed ProQuest ebooks. Item counts, formats and access terms are not published.","The legal deposit library for Nigeria and therefore, in principle, the institution that should hold the Onitsha pamphlets and other 1950s-70s Nigerian imprints in their country of origin. It is also the correct counterparty for any national-level rights or provenance question. Current digital output appears to be governmental and archival rather than a corpus of digitised trade books, so expect a partnership, not a download.",partial,PDF,unknown,,https://nigeriareposit.nln.gov.ng/,medium,2,National Library of Nigeria - Virtual Library Services | National Repository of Nigeria,https://nln.gov.ng/department.php?dept_namelist=Virtual+Library+Services&dept_Idlist=7&dept_Codelist=98ad73008b38e03db13bc4d34b2bd09a | https://nigeriareposit.nln.gov.ng/,https://nln.gov.ng/department.php?dept_namelist=Virtual+Library+Services&dept_Idlist=7&dept_Codelist=98ad73008b38e03db13bc4d34b2bd09a
19
+ knls-kenya,Kenya National Library Service (knls) - National Library division,Kenya National Library Service,Kenya,Africa,True,"Acts as Kenya's repository for legal deposit and supports preservation, acquisition and dissemination of local content. Offers a virtual library, digitisation services, an e-resources search engine and an online catalogue. The scope of digitised Kenyan publications and the access terms are not published on the pages reviewed.","The legal deposit route to Kenyan imprints of the 1950s-70s, and the natural custodian partner in the jurisdiction with the shortest copyright term (life + 50), where many mid-century works are already public domain. Digitisation capacity is stated but unquantified, so treat as a partnership target requiring direct contact.",unknown,unknown,unknown,,https://www.knls.ac.ke/national-library/,medium,1,National Library - Kenya National Library Service,https://www.knls.ac.ke/national-library/,https://www.knls.ac.ke/national-library/
20
+ archives-du-senegal,Direction des Archives du Sénégal,Government of Senegal,Senegal,Africa,True,"Online catalogue navigation across Colonial Senegal, French West Africa and Contemporary Senegal, documentary collections by theme and figure, library resources and the Official Journal. A formal digitalisation project for the national archives was officially launched with Sénégal Numérique SA in April 2026; there is no substantial digitised collection online yet. Consultation is otherwise on site in Dakar.","Senegal is the francophone anchor for this project, and the Archives currently function as the de facto legal deposit recipient because the Bibliothèque nationale created by Loi 2002-17 has never effectively operated - deposits arrive sporadically and consist mainly of printed periodicals and books. That gap means Senegalese imprints of the 1950s-70s are poorly held nationally, and the newly launched digitalisation project is the moment to engage.",restricted,catalogue records,no,,https://archivesdusenegal.gouv.sn/,medium,2,Archives du Sénégal | Le dépôt légal et la législation sur le droit d'auteur au Sénégal,https://archivesdusenegal.gouv.sn/ | https://cpi.openum.ca/files/sites/66/Le-d%c3%a9p%c3%b4t-l%c3%a9gal-et-la-l%c3%a9gislation-sur-le-droit-d%e2%80%99auteur-au-S%c3%a9n%c3%a9gal.pdf,https://archivesdusenegal.gouv.sn/
21
+ african-books-collective,African Books Collective (ABC) and the Baobab Ebook Service,"African Books Collective, a UK-registered not-for-profit owned by its African publisher members",United Kingdom / pan-African ownership,Global,False,"Founded 1985 by a group of African publishers, trading from 1989, as an African-owned worldwide marketing and distribution outlet for scholarly, literary and children's books from Africa. Its digital library for academic institutions offers over 2,000 digitised titles from 75 independent African publishers spanning roughly 30 years, with selective titles in French, Portuguese and Swahili, MARC records with OCLC numbers discoverable via WorldCat, delivered through the Baobab Ebook Service. Institutions buy the complete library or specific collections; 50% of all book sales are remitted to the African publishers.","The single most important recirculation precedent for this project. It shows a working, African-owned model for digitising backlist, cataloguing it to library standards, and returning half of revenue to African publishers - a revenue-share template that can be adapted for heirs of authors and successor presses. It is also the obvious distribution channel for anything this project brings back into print or into ebook.",restricted,"EPUB, PDF, MARC records",no,2000.0,https://africanbookscollective.com/about/,high,2,About - African Books Collective | ABC's Digital Library for Academic Institutions,https://africanbookscollective.com/about/ | https://www.africanbookscollective.com/ebooks-detail,https://africanbookscollective.com/about/
22
+ african-writers-series-digital,Heinemann African Writers Series digitisation (Digitalback Books / Pearson),Digitalback Books in partnership with Pearson,United Kingdom,Europe,False,"An agreement announced in March 2018 to make over 300 titles from the African Writers Series available digitally to libraries and institutions worldwide. The series launched in 1962; by 2008 only around 17% of it remained in print, with secondhand copies commanding high prices.","The defining rights-recovery precedent for exactly this project's period. It demonstrates that a single corporate successor rights holder (Pearson, via Heinemann) can unlock hundreds of 1960s-70s African titles in one negotiation - and it quantifies the problem this project exists to solve: 83% of the canonical African series was out of print. Caution: the access model was not stated as open, and the series was published from London, so it does not itself satisfy this project's African-based-press criterion. Its value is as a rights-clearance template.",unknown,"EPUB, PDF",no,300.0,https://www.theafricancourier.de/heinemann-african-writers-series-goes-digital/,medium,1,Heinemann African Writers Series goes digital! - The African Courier,https://www.theafricancourier.de/heinemann-african-writers-series-goes-digital/,https://www.theafricancourier.de/heinemann-african-writers-series-goes-digital/
23
+ ascl-leiden-digital-library,African Studies Centre Leiden digital library,African Studies Centre Leiden / Leiden University,Netherlands,Europe,False,"Aggregates AfricaBib (over 240,000 Africana social science titles across seven databases), the ASCL publications repository, African newspapers 1798-1923 (60+ titles from Ghana, Kenya, Nigeria, South Africa, Uganda and elsewhere), the Rand Daily Mail 1902-1985, a licensed African Writers Series collection of 250+ volumes, a francophone literature corpus of 14,000+ texts by about 300 authors, colonial statistics 1821-1953, Black South African Magazines (50,000+ pages) and African History and Culture 1540-1921 (1,300+ books, pamphlets, almanacs, broadsides).","The best single discovery layer in Europe for this project: AfricaBib is open and is a strong candidate for bootstrapping a bibliography of African-published 1950-79 titles. But note the sharp split - bibliographies and country portals are open while the actual full-text corpora (African Writers Series, francophone literature) are licensed and restricted, which is the recurring pattern this project has to work around.",partial,"catalogue records, page images, PDF",unknown,240000.0,https://www.ascleiden.nl/content/digital-library,high,1,Digital library - African Studies Centre Leiden,https://www.ascleiden.nl/content/digital-library,https://www.ascleiden.nl/content/digital-library
24
+ bu-african-studies-openbu,Boston University African Studies Library digital collections on OpenBU,Boston University Libraries,United States,North America,False,"Open access collections on the OpenBU repository including the African Ajami Library (manuscripts in Pular, Hausa, Mandinka, Malagasy and Wolof), Foreign Service dispatches on Mozambique 1962-75, the Paula Hirsch Foster Uganda fieldwork collection 1954-58, the Emmert family slides, the Walter H. Sangree papers, and African Studies Center books and working papers. BU also maintains a curated guide to open access collections on Africa.","Fully open access, unlike most peers, and the African Ajami Library is directly relevant to recovering African-language print and manuscript traditions outside the Latin-script canon. BU's open access guide is also a useful pointer to South African archives (ANC Archives, Wits Historical Papers, SAHA, Nelson Mandela Digital Archive, OpenUCT, WIReDSpace).",open,"PDF, page images",unknown,,https://library.bu.edu/c.php?g=854616&p=6119729,high,2,"Digital Collections - BU African Studies Library: Special Collections | South Africa - Open Access Collections on Africa, Boston University",https://library.bu.edu/c.php?g=854616&p=6119729 | https://library.bu.edu/c.php?g=629303&p=4392318,https://library.bu.edu/c.php?g=854616&p=6119729
25
+ yale-african-collection,Yale University Library African Collection,Yale University Library,United States,North America,False,"A major Africana collection with material in Afrikaans, KiSwahili, Yoruba, Hausa, Wolof, Zulu and, per the library's own description, some 2,000 other languages. Accessible via Quicksearch, Borrow Direct, WorldCat and Archives at Yale. The public page reviewed does not state collection size, date coverage or specific digitisation projects.","Significant for African-language imprints of the mid-century, which are the most endangered part of this project's target corpus. Yale also contributed sub-collections to Struggles for Freedom. Treat as a physical-holdings partner: no discrete Africana digitisation programme could be verified.",unknown,unknown,unknown,,https://web.library.yale.edu/international/african-collection,low,1,Explore the African Collection - Yale University Library,https://web.library.yale.edu/international/african-collection,https://web.library.yale.edu/international/african-collection
26
+ archivi-ng,Archivi.ng,"Dust to Digital Ltd/Gte, supported by Luminate",Nigeria,Africa,True,"A Nigerian-run digital archive of thousands of digitised newspapers, magazines and transcripts. Named holdings include Nigeria Magazine (published 1936-1990), publications of the First Republic in the early 1960s, and PM News. Browsable by edition, date, publisher and topic, with search. Free membership plus paid tiers; licensing terms are not stated. A separate guide records Nigerian newspaper pages digitised for 1966-2008.","The strongest example of Nigerian-owned, Nigeria-hosted mass digitisation of mid-century print, and a direct contextual source for Onitsha-era publishing: Nigeria Magazine and 1960s periodicals are where these books were reviewed and advertised. Useful both as a partner and as an evidence base for establishing publication dates and publisher identities for orphan titles.",partial,page images,unknown,,https://archivi.ng/,high,2,"Archivi.ng | Digital Archives and Collections - African Studies, UT Austin",https://archivi.ng/ | https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913,https://archivi.ng/
27
+ digital-namibian-archive,Digital Namibian Archive,Namibia University of Science and Technology (NUST),Namibia,Africa,True,"A Greenstone-based collection of approximately 13,000 documents relating to Namibia, hosted at NUST.","An African-hosted, university-run open archive at a scale this project could realistically match, and a working example of low-cost open-source repository software (Greenstone) rather than a commercial platform. Verified only via a secondary library guide, so confirm scale and rights terms directly.",open,"PDF, page images",unknown,13000.0,http://dna.nust.na:8080/greenstone3/library/collection/dna/page/about,low,1,"Digital Archives and Collections - African Studies, UT Austin",https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913,https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913
28
+ ifra-nairobi-press-archive,IFRA Nairobi Press Archive,"Institut français de recherche en Afrique (IFRA), Nairobi",Kenya,Africa,True,"East African newspapers collected since the late 1970s, including Kenyan, Ugandan and Tanzanian material, hosted on the Nakala platform.","Contemporaneous East African press coverage is the practical way to date and attribute Kenyan and Tanzanian imprints whose publishers no longer exist, which is a prerequisite for a diligent search in any orphan-works process. Verified via a secondary library guide only.",open,page images,unknown,,https://ifrapressarch.nakalona.fr/,low,1,"Digital Archives and Collections - African Studies, UT Austin",https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913,https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913
29
+ iai-african-repositories-list,African Digital Research Repositories (directory),International African Institute,United Kingdom,Global,False,"A compiled directory of digital research repositories located within the African continent. The page returned HTTP 429 on repeated attempts during this survey, so the list contents could not be read directly; it is recorded here on the strength of the UT Austin African Studies guide's description.","If it is what it is described to be, this is the fastest route to a shortlist of African-hosted repositories and therefore to African custodians for recovered texts. Verify before relying on it.",open,directory,no,,https://www.internationalafricaninstitute.org/repositories,low,1,"Digital Archives and Collections - African Studies, UT Austin",https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913,https://guides.lib.utexas.edu/c.php?g=1324108&p=9743913
30
+ loc-african-government-web-archive,African Government Web Archive,Library of Congress,United States,North America,False,"Web archiving of key government ministries, institutions and organisations for the 51 countries of Africa south of the Sahara, from November 2014 to the present, crawled mostly quarterly. Formats include PDFs, videos and social media; content includes annual reports, development plans, economic reports, budgets and statistics, in English, French, Portuguese, Swahili, Somali, Arabic and other languages. Presented in beta with limited playback; no rights terms or API stated.","Marginal for the 1950-79 corpus itself, but the most reliable way to capture African national library, archive and copyright office web pages that are otherwise unstable - useful for evidencing what a national institution said about holdings or rights at a given date during a diligent search.",open,"PDF, web archive",unknown,,https://www.loc.gov/collections/african-government-web-archive/about-this-collection/,medium,1,"About this Collection - African Government Web Archive, Library of Congress",https://www.loc.gov/collections/african-government-web-archive/about-this-collection/,https://www.loc.gov/collections/african-government-web-archive/about-this-collection/
31
+ penguin-african-writers-series,Penguin African Writers Series,Penguin Random House,United Kingdom / United States,Global,False,"A reissue series edited by Chinua Achebe and explicitly building on the Heinemann African Writers Series, of which Achebe was the founding series editor. Titles listed are reissues of mid-century classics, predominantly Ngugi wa Thiong'o (Petals of Blood, A Grain of Wheat, Weep Not Child, The River Between, Devil on the Cross), each with a new scholarly or authorial introduction, in paperback and ebook.","The commercial reissue template: a small curated list, an authoritative series editor, and new critical apparatus added to justify the reissue. It also shows the limit of the commercial model - a handful of already-canonical authors are recovered while the wider 1950-79 African-press catalogue is not, which is precisely the gap this project addresses.",restricted,"EPUB, print",no,5.0,https://www.penguinrandomhouse.com/series/PAF/penguin-african-writers-series/,medium,1,Penguin African Writers Series - Penguin Random House,https://www.penguinrandomhouse.com/series/PAF/penguin-african-writers-series/,https://www.penguinrandomhouse.com/series/PAF/penguin-african-writers-series/
32
+ modjaji-books,Modjaji Books,Modjaji Books (independent press),South Africa,Africa,True,"An independent South African press founded in 2007 by Colleen Higgs, publishing poetry, biography and fiction by women from southern Africa, distributed internationally in print and digital through African Books Collective.","A contemporary African-based press whose route to global readers runs entirely through African Books Collective - confirming ABC as the practical distribution spine for any African-published recovery list. Founded well after this project's period, so relevant as a potential publishing partner rather than as a source of 1950-79 titles.",restricted,"print, EPUB",no,,https://www.africanbookscollective.com/publishers/modjaji-books,high,1,"Modjaji Books, South Africa - African Books Collective",https://www.africanbookscollective.com/publishers/modjaji-books,https://www.africanbookscollective.com/publishers/modjaji-books
33
+ amalion,Amalion,Amalion (independent publishing house),Senegal,Africa,True,"An independent pan-African publishing house founded in Dakar in 2009, publishing scholarly knowledge from across Africa and across linguistic boundaries - literary fiction, social sciences, development studies, biography, arts and politics - for academic and general readers. Its first title, in 2009, was a poetry collection by the Ugandan writer Mildred Kiconco Barya.","The leading francophone-anchored, cross-linguistic African press and the obvious partner for recovering Senegalese and West African francophone titles, where this project faces both a life-plus-70 term and a domaine public payant regime. Formats and distribution channels were not stated on the source consulted.",restricted,print,no,,https://en.wikipedia.org/wiki/Amalion,medium,1,Amalion - Wikipedia,https://en.wikipedia.org/wiki/Amalion,https://en.wikipedia.org/wiki/Amalion
34
+ iu-liberian-collections,Indiana University Liberian Collections,Indiana University Libraries,United States,North America,False,"Historical and ethnographic documents, newspapers, government publications, books, journals, dissertations, maps, photographs, microfilm and audiovisual material, begun informally in the early 1990s and formalised as a unit in 2002. Core components are the Svend E. Holsoe, William V. S. Tubman and Warren L. D'Azevedo collections plus a Liberian newspaper collection of some 20,000 items. Over 30,000 photographs from the 1940s onward are online, together with finding aids in Archives Online and the 'A Liberian Journey' project (nearly 600 images).","The most substantial Liberian holding outside Liberia and a rare case where an African country's mid-century print record is concentrated in one accessible US repository. Digitisation to date is photographic rather than textual, so Liberian imprints of 1950-79 remain undigitised. Same closure caveat as the Onitsha holdings: African Studies archival collections are closed 1 August 2026 - 10 January 2027.",partial,"page images, finding aids",unknown,30000.0,https://guides.libraries.indiana.edu/africanstudies/liberia,high,1,Liberian Collections - Indiana University African Studies guide,https://guides.libraries.indiana.edu/africanstudies/liberia,https://guides.libraries.indiana.edu/africanstudies/liberia
holdings.csv ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ holding_id,name,kind,location,country,city,what_it_holds,approx_items,url,provenance,confidence,notes,in_africa
2
+ natlib-nigeria,National Library of Nigeria,National library / legal deposit,Africa,Nigeria,Abuja / Lagos,Legal-deposit copies of Nigerian imprints; the Nigerian national bibliography.,,https://nln.gov.ng/,project brief,medium,"Legal deposit was patchy for the Onitsha pamphlet trade, which largely bypassed formal deposit.",True
3
+ natlib-ghana,Ghana Library Authority / national deposit collections,National library / legal deposit,Africa,Ghana,Accra,Ghanaian legal-deposit imprints; Bureau of Ghana Languages output.,,,project brief,low,Bureau of Ghana Languages material is the largest recoverable-but-uncatalogued body in Ghana.,True
4
+ natlib-kenya,Kenya National Library Service,National library / legal deposit,Africa,Kenya,Nairobi,Kenyan deposit copies; East African Publishing House and East African Literature Bureau imprints.,,https://www.knls.ac.ke/,project brief,medium,,True
5
+ natlib-senegal,Bibliothèque nationale du Sénégal,National library / legal deposit,Africa,Senegal,Dakar,Senegalese imprints; NEA and Clairafrique material.,,,project brief,low,Created in law (Loi 2002-17) but has functioned only nominally; the Senegalese deposit record is incomplete.,True
6
+ ifan,"Institut Fondamental d'Afrique Noire (IFAN), Cheikh Anta Diop University",University library,Africa,Senegal,Dakar,IFAN Mémoires and Bulletin series; West African scholarly imprints from the 1940s onward.,,,project brief,medium,,True
7
+ ibadan,"Kenneth Dike Library, University of Ibadan",University library,Africa,Nigeria,Ibadan,Africana collection; Mbari Publications; Onitsha pamphlets; Nigerian national bibliography sets.,,,project brief,medium,The Ibadan Africana collection is the single most important in-country holding for the Mbari list.,True
8
+ nsukka,"Nnamdi Azikiwe Library, University of Nigeria, Nsukka",University library,Africa,Nigeria,Nsukka,"Eastern Nigerian imprints; Nwamife, Nwankwo-Ifejika and Fourth Dimension lists; Okike archive.",,,project brief,medium,,True
9
+ legon,"Balme Library, University of Ghana, Legon",University library,Africa,Ghana,Accra,Ghana Collection; Ghana Publishing Corporation and Waterville imprints.,,,project brief,medium,,True
10
+ makerere,Makerere University Library,University library,Africa,Uganda,Kampala,"Africana collection; Transition, Penpoint and Dhana; East African imprints.",,,project brief,medium,,True
11
+ nairobi,University of Nairobi Library,University library,Africa,Kenya,Nairobi,"East African Publishing House and Literature Bureau imprints; Zuka, Busara, Ghala.",,,project brief,medium,,True
12
+ dar,University of Dar es Salaam Library,University library,Africa,Tanzania,Dar es Salaam,Tanzania Publishing House list; Swahili literature; the Dar es Salaam debate pamphlets.,,,project brief,medium,,True
13
+ yaounde,Université de Yaoundé libraries,University library,Africa,Cameroon,Yaoundé,Éditions CLE imprints; Cameroonian francophone literature.,,,project brief,low,"Éditions CLE's own archive in Yaoundé is the primary target here, not only the university.",True
14
+ fourah-bay,"Fourah Bay College Library, University of Sierra Leone",University library,Africa,Sierra Leone,Freetown,Sierra Leonean imprints; the oldest West African university collection.,,,project brief,low,Holdings suffered during the 1991–2002 civil war; condition survey needed before planning.,True
15
+ addis,Addis Ababa University Libraries (IES),University library,Africa,Ethiopia,Addis Ababa,Amharic imprints; Haile Selassie I University Press; Institute of Ethiopian Studies collection.,,,project brief,medium,,True
16
+ uct,"University of Cape Town Libraries, Special Collections",University library,Africa,South Africa,Cape Town,"Banned-books collections; Ravan, David Philip, BLAC and Spro-cas imprints.",,https://www.lib.uct.ac.za/,project brief,medium,Apartheid-era banned titles survived disproportionately in university special collections.,True
17
+ nelm,National English Literary Museum (NELM / Amazwi),Literary archive,Africa,South Africa,Makhanda,"South African literary manuscripts, little magazines and small-press imprints.",,https://www.amazwi.museum/,press register,medium,The authoritative verification point for South African title records in this catalogue.,True
18
+ mission-libraries,"Mission libraries, seminaries and former teacher-training colleges",Mission & seminary,Africa,Multiple,,"Mission-press output (Lovedale, Morija, Mambo, Oniipa, Presbyterian Book Depot) and school readers.",,,project brief,medium,Mission presses printed most surviving African-language literature of the period; their libraries are rarely catalogued online.,True
19
+ school-storerooms,School storerooms and provincial education offices,School & education system,Africa,Multiple,,"Prescribed readers, school editions and Literature Bureau titles held in bulk and then abandoned.",,,project brief,low,"Highest-volume, lowest-cost source of physical copies. Condition is usually poor; class sets mean duplicates are common.",True
20
+ retired-educators,"Retired teachers, professors, publishers and booksellers",Community & personal,Africa,Multiple,,"Personal working libraries, publishers' file copies, sales records and unsold stock.",,,project brief,low,Time-critical: this generation's libraries are being dispersed now. Prioritise oral-history capture alongside acquisition.,True
21
+ used-book-markets,"Used-book markets (Onitsha, Lagos, Ibadan, Accra, Kumasi, Nairobi, Dakar, Abidjan)",Book market,Africa,Multiple,,"Circulating secondhand stock, including pamphlets that never entered any library.",,,project brief,low,The only source for titles with no catalogue record anywhere. Requires paid local scouts and a purchase budget.,True
22
+ author-estates,Authors' families and estates,Estate & family,Africa,Multiple,,"Author file copies, typescripts, correspondence and — critically — the rights themselves.",,,project brief,medium,Serves two stages at once: copies (stage 1–2) and rights holders (stage 3–4). Start here for any title you intend to clear.,True
23
+ press-archives,Archives of former publishing houses and printing presses,Press archive,Africa,Multiple,,"Backlists, contracts, print records and unsold stock of defunct houses.",,,project brief,low,Contracts held here determine whether rights reverted to authors — the decisive document for orphan-works clearance.,True
24
+ soas,SOAS Library Special Collections — Heinemann African Writers Series archive,External repository,Outside Africa,United Kingdom,London,"Manuscripts, corrected typescripts and proofs for 71 African Writers Series titles published 1964–1986.",71.0,https://blogs.soas.ac.uk/archives/2022/10/21/black-history-month-2022-heinemann-african-writers-series/,project brief,high,Editorial correspondence here documents what was cut from African first editions when London reissued them.,False
25
+ indiana-onitsha,Indiana University — Onitsha market literature collection,External repository,Outside Africa,United States,Bloomington,More than 170 Onitsha pamphlet items.,170.0,https://libraries.indiana.edu/,project brief,high,Largely undigitised and thinly catalogued. Note: IU African Studies archival collections are closed 1 Aug 2026 – 10 Jan 2027.,False
26
+ ku-onitsha,University of Kansas — Onitsha Market Literature collection,External repository,Outside Africa,United States,Lawrence,More than 100 Onitsha pamphlets; 21 digitised and presented in an online exhibit.,100.0,https://exhibits.lib.ku.edu/exhibits/show/onitsha,project brief,high,The item-level list from this exhibit is the backbone of the Onitsha records in this catalogue.,False
27
+ ufl-dloc,University of Florida / dLOC — digital Onitsha collection,External repository,Outside Africa,United States,Gainesville,"Digitised Onitsha market pamphlets, openly accessible.",13.0,https://ufdc.ufl.edu/,project brief,medium,Small but fully open — the best template for what an African-hosted equivalent should deliver.,False
28
+ yale,Yale University Library — Nigerian marketplace pamphlets,External repository,Outside Africa,United States,New Haven,Nigerian marketplace pamphlets of the 1950s–70s; exhibited as 'Street Talk'.,,https://library.yale.edu/news/street-talk-pamphlets-nigerian-marketplace-opens-hanke-gallery-march-24,project brief,high,,False
29
+ crl,Center for Research Libraries,External repository,Outside Africa,United States,Chicago,78 catalogued locally published Nigerian pamphlets.,78.0,https://digitalcollections.crl.edu/record/944628,project brief,high,CRL lends to member institutions — a viable route to scanning access without travel.,False
30
+ northwestern,"Melville J. Herskovits Library of African Studies, Northwestern University",External repository,Outside Africa,United States,Evanston,"The largest separate Africana collection in the world; African imprints, pamphlets and ephemera.",,https://www.library.northwestern.edu/libraries-collections/herskovits-library/,project brief,high,First stop for verifying an imprint that appears nowhere else.,False
31
+ british-library,British Library,External repository,Outside Africa,United Kingdom,London,Colonial-era legal deposit from British African territories; Endangered Archives Programme outputs.,,https://www.bl.uk/,project brief,high,EAP has funded African archive digitisation and is a realistic funder for this project's preservation stage.,False
32
+ bodleian,"Bodleian Libraries, University of Oxford",External repository,Outside Africa,United Kingdom,Oxford,Commonwealth and African collections; colonial deposit imprints.,,https://www.bodleian.ox.ac.uk/,project brief,medium,,False
33
+ cambridge,Cambridge University Library,External repository,Outside Africa,United Kingdom,Cambridge,African studies collections and colonial-period deposit material.,,https://www.lib.cam.ac.uk/,project brief,medium,,False
34
+ leiden,African Studies Centre Leiden library,External repository,Outside Africa,Netherlands,Leiden,African-published scholarship and literature; strong Francophone and Lusophone holdings.,,https://www.ascleiden.nl/,project brief,medium,,False
35
+ loc,Library of Congress — African and Middle Eastern Division,External repository,Outside Africa,United States,Washington DC,Nairobi overseas office acquisitions; sub-Saharan imprints acquired from the 1960s onward.,,https://www.loc.gov/rr/amed/,project brief,high,The LC Nairobi field office bought current African imprints throughout the period — an unusually complete run.,False
36
+ bnf,Bibliothèque nationale de France,External repository,Outside Africa,France,Paris,"Présence Africaine, Éditions CLE (~393 imprints), NEA, SNED, Bobiso, Librairie Mixte and other Francophone African imprints.",,https://catalogue.bnf.fr/,press register,high,The Francophone records in this catalogue were built almost entirely from the BnF SRU API — it is the most complete single source for Francophone African imprints.,False
37
+ antiquarian,Antiquarian platforms and specialist African booksellers,Trade & market,Outside Africa,Multiple,,Circulating physical copies offered for sale; dealer descriptions transcribed from title pages.,,https://www.abebooks.com/,project brief,medium,"Dealer listings are good evidence a physical copy exists and a usable acquisition route, but they mis-key years and places — always re-verify against a library catalogue before publishing a record.",False
presses.csv CHANGED
The diff for this file is too large to render. See raw diff
 
requirements.txt CHANGED
@@ -1,4 +1 @@
1
- streamlit==1.63.0
2
- pandas==2.3.3
3
- pyarrow==22.0.0
4
- altair==6.2.2
 
1
+ streamlit
 
 
 
rights.csv ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ country,region,statute,copyright_term,term_years,anonymous_or_corporate_term,berne_member,public_domain_notes,orphan_works_mechanism,recovery_implication,confidence,source_count,source_titles,source_urls,primary_source_url
2
+ Nigeria,West Africa,"Copyright Act, 2022 (Federal Republic of Nigeria), section 19",life + 70 years,70,"Anonymous or pseudonymous works: 70 years after the year in which the work was first made available to the public (s.19(2)). Works of government and corporate bodies: 50 years after the end of the year in which the work was first made available to the public (s.19(1)(b)). Photographs, audiovisual works and sound recordings: 50 years after the end of the year first made available (s.19(1)(c)-(d)).",True,"The Berne Convention has been in force for Nigeria since 14 September 1993 per WIPO's list of contracting parties, so protection arises automatically without formality. There is no public domain register. The Nigerian Copyright Commission runs a voluntary electronic registration system (NCeRS) which records claimed ownership; it does not record expiry and cannot be used to prove a work is out of copyright. Term is calculated from the end of the calendar year, so status must be worked out author by author from the date of death.","Partial, and unusually favourable for this project. Section 32 provides compulsory licensing for literary and artistic works that have been unavailable for purchase for specified periods (3-7 years depending on subject matter), and permits reproduction where the copyright owner cannot be located after reasonable diligence and formal notice. Separately, section 25(1)(e) lets libraries copy a work where the permission of the owner cannot be obtained after reasonable effort, or where the work is not available by general trade; s.25(1)(d) permits digitisation where the work cannot reasonably be acquired in that format through general trade or from the publisher; s.25(1)(b) permits back-up and preservation copying; and s.25(2)(a) permits copies made under s.25 to be lent to users. Section 26 covers accessible-format copies including cross-border export and import. Section 88 governs collective management organisations.","The hardest term in this set combined with the most usable exceptions. A Nigerian book published in 1965 whose author died in 1975 stays in copyright until the end of 2045; if the author is still living, or died recently, the wait is longer still. Onitsha market pamphlets are the paradigm case - many carry pseudonyms, in which case the clock runs 70 years from first public availability, so a 1962 pamphlet is protected until the end of 2032. But Nigeria is also the only jurisdiction surveyed where a library route exists today: s.25(1)(d) and (e) together let a Nigerian library digitise and lend a work that is out of trade or whose owner cannot be found after reasonable effort. The practical strategy is to work through a Nigerian library or the National Library of Nigeria rather than to seek a blanket clearance, and to document the reasonable-effort search for every title. Section 32's compulsory licence is the fallback for commercial reissue.",high,4,"Copyright Act, 2022 (Nigeria), full text | What Can Libraries in Nigeria Do Under the 2022 Copyright Act? - EIFL | Berne Convention contracting parties - WIPO | Nigerian Copyright eRegistration System (NCeRS)",https://placng.org/i/wp-content/uploads/2023/04/Copyright-Act-2022.pdf | https://www.eifl.net/system/files/resources/202310/what_can_libraries_in_nigeria_do_under_2022_copyright_act.pdf | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf | http://eregistration.copyright.gov.ng/,https://placng.org/i/wp-content/uploads/2023/04/Copyright-Act-2022.pdf
3
+ Ghana,West Africa,"Copyright Act, 2005 (Act 690), sections 12, 13 and 14",life + 70 years,70,"Anonymous or pseudonymous works: 70 years from the date the work was made, first made available to the public, or first published, whichever is later (s.14). Works owned by a public corporation or other body corporate: 70 years from the date the work was made or first published, whichever is later (s.13).",True,"Berne in force for Ghana since 11 October 1991 per WIPO's list of contracting parties. No public domain register was identified. A distinct and material complication: expressions of folklore are protected in perpetuity (s.17), the rights vest in the President in trust for the people of Ghana (s.4), it is an offence to sell or distribute copies of folklore without the written permission of the National Folklore Board (s.44), and users must apply to the Board and pay prescribed fees (s.64). A 1960s Ghanaian text that transcribes, adapts or is built on oral tradition may therefore attract a permanent, separate permission requirement that does not expire with the author's copyright.","None. No orphan-works provision, compulsory licence, or unlocatable-owner mechanism appears in Act 690. The nearest analogue is s.9(7), which lets the Copyright Administrator decide whether consent should be granted where one joint author withholds it - not a general solution. Library and archive permitted uses are narrow: s.21 allows a non-profit library or archive to make single reprographic copies of a published article, other short work or short extract, in isolated cases, for a user's study, scholarship or private research, and s.21(6) makes the whole section subject to the interest of the publisher, author or relevant collective administration society. That is not a basis for whole-book digitisation.","Ghana is among the most constrained jurisdictions here. A 1968 Accra imprint by an author who died in 1980 is protected until the end of 2050, and there is no statutory route around an untraceable rights holder. Because the corporate term also runs 70 years from making or publication, a book published by a defunct Ghanaian press in 1965 with corporate ownership is still protected until the end of 2035. Practical implication: for Ghana, recovery must proceed by locating and contracting with heirs or successor entities, title by title; there is no diligent-search safe harbour to fall back on. Any title touching oral tradition needs a separate National Folklore Board clearance regardless of copyright status.",high,3,"Copyright Act, 2005 (Act 690), Ghana - full text via ARIPO | Copyright Act, 2005, Ghana - WIPO Lex record | Berne Convention contracting parties - WIPO",https://www.aripo.org/storage/resources-member-state-laws/1674643138_phpg6pgca.pdf | https://www.wipo.int/wipolex/en/legislation/details/1789 | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf,https://www.aripo.org/storage/resources-member-state-laws/1674643138_phpg6pgca.pdf
4
+ Kenya,East Africa,"Copyright Act, No. 12 of 2001 (Cap. 130, Laws of Kenya), section 23",life + 50 years,50,"Anonymous or pseudonymous works: 50 years from the end of the year of first publication, reverting to the standard author-death rule if the author's identity becomes known (s.23(3)). Government-commissioned literary, musical, dramatic or artistic works: 50 years from the end of the year of first publication (s.25(2)). No separate duration is set for works of corporate bodies as such.",True,"Berne in force for Kenya since 11 June 1993 per WIPO's list of contracting parties. Registration with the Kenya Copyright Board is expressly voluntary - 'Non registration does not deny authors any rights under the Copyright Act' - and the certificate serves as evidence of ownership in court and can be used as loan collateral. The Board maintains a database of creators and works but no public domain register was identified, so expiry must still be established from the author's date of death.","None specific to orphan works. Section 33A allows the Board to grant a licence to republish or communicate a work to the public where the copyright owner refuses to make the work available on reasonable terms, with compensation paid to the owner - a refusal-to-license mechanism, not an unlocatable-owner mechanism. Kenya is a party to the Marrakesh Treaty.","The most favourable jurisdiction in this set, and the place to start. Life + 50 means that as of 2026 any Kenyan author who died in 1975 or earlier is out of copyright, which covers a meaningful slice of the East African Publishing House and Nairobi small-press generation. For an anonymous or pseudonymous Kenyan work, 50 years from first publication puts everything published up to 1975 into the public domain on its face. Kenya is therefore the best candidate for a first tranche of genuinely unrestricted republication, and the best place to prove the project's model before tackling the life-plus-70 jurisdictions. Caution: an anonymous work's term reverts to life + 50 if the author is later identified, so a title cleared on the anonymity rule can move back into copyright if authorship is established.",high,4,"Copyright Act, No. 12 of 2001 (Cap. 130) - Kenya Law | Copyright Registration - Kenya Copyright Board | Berne Convention contracting parties - WIPO | Marrakesh Treaty status document - WIPO (MVT/A/9/1 Rev., 27 June 2024)",https://new.kenyalaw.org/akn/ke/act/2001/12/eng@2022-12-31 | https://copyright.go.ke/our-services/copyright-registration | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf | https://www.wipo.int/edocs/mdocs/govbody/en/mvt_a_9/mvt_a_9_1_rev.pdf,https://new.kenyalaw.org/akn/ke/act/2001/12/eng@2022-12-31
5
+ Tanzania,East Africa,"Copyright and Neighbouring Rights Act, 1999 (Act No. 7 of 1999, Cap. 218), section 14",life + 50 years,50,"Anonymous or pseudonymous works: 50 years from the date the work was made, first made available to the public or first published, whichever is latest (s.14(3)). Joint authorship: life of the last surviving author plus 50 years (s.14(2)). Audiovisual works: 50 years from making, availability or publication, whichever is latest (s.14(4)). Works of applied art: 25 years from making (s.14(5)). Every period runs to the end of the calendar year in which it would otherwise expire (s.14(6)). No distinct term for works owned by legal entities is set out in s.14.",True,"Berne in force for Tanzania since 25 July 1994 per WIPO's list of contracting parties. The Act protects economic and moral rights for the same period under s.14(1), which is unusual - moral rights are not perpetual here. No public domain register was identified.","None identified in the duration and related provisions reviewed. No orphan-works licence, diligent-search safe harbour or unlocatable-owner mechanism was found in the sections examined; the full Act was not read section by section, so treat this as 'none found' rather than a definitive negative. Tanzania is a party to the Marrakesh Treaty.","Alongside Kenya, one of the two shortest terms in this set, so a comparable first-tranche opportunity for Swahili-language and Dar es Salaam imprints of the 1960s and 1970s - a period when Tanzanian state and party publishing was prolific. On life + 50, any Tanzanian author who died in 1975 or earlier is out of copyright as of 2026. For an anonymous or institutionally issued 1960s pamphlet, the s.14(3) rule of 50 years from the latest of making, availability or publication clears anything published up to 1975. The absence of any orphan-works route means that for still-protected titles the only path is locating heirs.",high,4,"Copyright and Neighbouring Rights Act, 1999 (Tanzania) - full text via ARIPO | Copyright and Neighbouring Rights Act, 1999 - TanzLII | Berne Convention contracting parties - WIPO | Marrakesh Treaty status document - WIPO (MVT/A/9/1 Rev., 27 June 2024)",https://www.aripo.org/storage/resources-member-state-laws/1730130114_tz036en_1.pdf | https://tanzlii.org/akn/tz/act/1999/7/eng@2002-07-31 | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf | https://www.wipo.int/edocs/mdocs/govbody/en/mvt_a_9/mvt_a_9_1_rev.pdf,https://www.aripo.org/storage/resources-member-state-laws/1730130114_tz036en_1.pdf
6
+ South Africa,Southern Africa,"Copyright Act, 1978 (Act No. 98 of 1978, as amended up to Act No. 9 of 2002), section 3",life + 50 years,50,"Anonymous or pseudonymous works: 50 years from the date the work was made available to the public or from the author's presumed death, whichever is shorter. Cinematograph films, photographs and computer programs: 50 years from publication or being made available, whichever is longer. Sound recordings, broadcasts and published editions: 50 years from first publication or first broadcast.",True,"Berne in force for South Africa since 3 October 1928 - by a wide margin the longest membership in this set, meaning even early-20th-century South African works were protected from the outset. No public domain register was identified. South Africa is NOT listed as a Marrakesh Treaty contracting party in WIPO's status document of 27 June 2024.","None currently in force. An orphan-works licensing scheme exists only in the Copyright Amendment Bill (B13F-2017), which would insert a section 22A: an applicant must publish notice of intention in the Gazette (in English and one other official language) and in two national newspapers, then apply to the Commission with proof of publication; the Commission must be satisfied a diligent search was made across public copyright register databases, reasonably available sources of ownership information, appropriate technology and expert assistance, and any publicly accessible database; the Commission may then grant a non-exclusive licence conditional on equitable remuneration, recoverable by the owner if they later surface. The same Bill would insert s.19C (library and archive preservation, format-shifting from ageing or obsolete technologies, backup copies, secure digital supply between institutions) and s.19D (accessible formats). The Bill remains pending presidential assent amid constitutional referral proceedings. Separately, in Blind SA v President of the Republic of South Africa [2025] ZACC 9 (7 May 2025), the Constitutional Court read s.19D of the Bill into the Copyright Act as an interim measure, after the earlier interim reading-in of s.13A lapsed on 21 September 2024.","The single best jurisdiction for immediate public domain recovery. Life + 50 combined with the 1950s-70s generation means a large share of the target corpus is already free: a South African author who died in 1975 or earlier is out of copyright now. The anonymous-works rule is even more favourable than elsewhere because it takes the SHORTER of 50 years from availability or the presumed-death calculation. Two cautions. First, there is currently no orphan-works route at all, so a still-protected title with an untraceable owner is simply unusable until the Amendment Bill is enacted - and the Blind SA litigation shows how long that has taken. Second, the preservation and format-shifting exceptions libraries would need for digitisation are also still only in the Bill. So: harvest the public domain aggressively in South Africa now, and do not build a workflow that depends on s.22A until the Bill is law.",high,5,"Copyright Act, 1978 (Act No. 98 of 1978, amended up to Act No. 9 of 2002), South Africa - WIPO Lex | Copyright Amendment Bill B13F-2017 (South Africa) | Blind SA v President of the Republic of South Africa and Others (CCT 300/24) [2025] ZACC 9 (7 May 2025) | Berne Convention contracting parties - WIPO | Marrakesh Treaty status document - WIPO (MVT/A/9/1 Rev., 27 June 2024)",https://www.wipo.int/wipolex/en/legislation/details/4067 | https://static.pmg.org.za/COPYRIGHT_AMENDMENT_BILL_B13F-2017.pdf | https://www.saflii.org/za/cases/ZACC/2025/9.html | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf | https://www.wipo.int/edocs/mdocs/govbody/en/mvt_a_9/mvt_a_9_1_rev.pdf,https://www.wipo.int/wipolex/en/legislation/details/4067
7
+ Senegal,West Africa,Loi n° 2008-09 du 25 janvier 2008 sur le droit d'auteur et les droits voisins,life + 70 years,70,"Joint works: life of the last surviving author plus 70 years. Anonymous or pseudonymous works: 70 years from publication. Neighbouring rights (performers, phonogram and videogram producers, broadcasters): 50 years from the relevant event. Moral rights are perpetual. Specific article numbers for these provisions were not verified against the statute text during this survey.",True,"Berne in force for Senegal since 25 August 1962 per WIPO's list of contracting parties. Two points matter more than the term itself. First, the 2008 law raised the term from 50 to 70 years post mortem, replacing the 1973 law - so works that had entered or were approaching the public domain under the old rule need to be assessed against the transition, and this project should not assume a work is free merely because 50 years have passed. Second, Senegal operates a domaine public payant: use of public domain works and folklore is subject to royalty payments to the collective management society. A Senegalese work being out of copyright does not necessarily mean it is free to republish without payment.","None identified. No orphan-works licence or diligent-search mechanism was found in the sources consulted. Senegal is a signatory to the Marrakesh Treaty but was not listed as having ratified or acceded in WIPO's status document of 27 June 2024. A further practical obstacle: legal deposit rests on Loi 76-30 of 9 April 1976, and the Bibliothèque nationale created by Loi 2002-17 has never effectively functioned, so deposits go sporadically to the Archives du Sénégal and consist mainly of printed periodicals and books, with no coverage of the full national output.","The most difficult jurisdiction in this set for francophone recovery. A 1965 Dakar imprint by an author who died in 1978 is protected until the end of 2048. Because the national deposit system has never worked properly, the bibliographic record of what was actually published in Senegal in the 1950s-70s is itself incomplete, which makes both title identification and diligent search harder than elsewhere. And even a cleanly public domain Senegalese title may attract a domaine public payant royalty to the collecting society, so 'public domain' cannot be equated with 'free to publish'. Practical route: partner with CODESRIA and Amalion in Dakar, budget for collecting-society payments, and treat article-level verification of Loi 2008-09 as an outstanding task before publishing any Senegalese title.",medium,4,"Loi n° 2008-09 du 25 janvier 2008 sur le droit d'auteur et les droits voisins, Sénégal - WIPO Lex record | Le dépôt légal et la législation sur le droit d'auteur au Sénégal | Berne Convention contracting parties - WIPO | Marrakesh Treaty status document - WIPO (MVT/A/9/1 Rev., 27 June 2024)",https://www.wipo.int/wipolex/fr/legislation/details/5764 | https://cpi.openum.ca/files/sites/66/Le-d%c3%a9p%c3%b4t-l%c3%a9gal-et-la-l%c3%a9gislation-sur-le-droit-d%e2%80%99auteur-au-S%c3%a9n%c3%a9gal.pdf | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf | https://www.wipo.int/edocs/mdocs/govbody/en/mvt_a_9/mvt_a_9_1_rev.pdf,https://www.wipo.int/wipolex/fr/legislation/details/5764
8
+ Cameroon,Central Africa,"Law No. 2000/011 of 19 December 2000 on Copyright and Neighbouring Rights, section 37",life + 50 years,50,"Anonymous or pseudonymous works: 50 years after creation or publication, whichever is later (s.37(3)). Collective works: 50 years after creation or publication, whichever is later (s.37(2)). Audiovisual works and works of applied art: 50 years from the end of the year of publication. Neighbouring rights: 50 years from the end of the year of fixation or broadcast. Where there is more than one author, the term runs from the death of the last surviving author (s.37(1)). All terms run to the end of the calendar year.",True,"Berne membership is confirmed; the accession date is reported as 21 September 1964, and WIPO's list separately records the Paris Act as in force for Cameroon from 10 October 1974. The two figures measure different things and the exact accession date should be confirmed before it is relied on. No public domain register was identified.","None identified in the sources consulted. Cameroon acceded to the Marrakesh Treaty in 2021 and had a pre-existing exception permitting Braille reproductions for blind readers, but no general orphan-works or unlocatable-owner licence was found.","A moderately favourable jurisdiction. Life + 50 means a Cameroonian author who died in 1975 or earlier is out of copyright as of 2026, covering much of the Yaoundé and Douala publishing of the independence era. The collective-works rule matters here: a 1965 anthology or institutional publication issued by a press rather than a named author is out of copyright 50 years after the later of creation or publication, so anything of that kind from 1975 or earlier is clear on its face. With no orphan-works mechanism, still-protected titles depend on tracing heirs. Cameroon is a useful second-tier target after Kenya, Tanzania and South Africa.",medium,4,"Law No. 2000/011 of December 19, 2000, Cameroon - WIPO Lex record | Copyright rules by territory: Cameroon - Wikimedia Commons (section-level summary of Law No. 2000/011) | Copyright law of Cameroon - Wikipedia (Berne accession date) | National Implementations of the Marrakesh Treaty - Association of Research Libraries",https://www.wipo.int/wipolex/en/legislation/details/836 | https://commons.wikimedia.org/wiki/Commons:Copyright_rules_by_territory/Cameroon | https://en.wikipedia.org/wiki/Copyright_law_of_Cameroon | https://www.arl.org/national-implementations-marrakesh/,https://www.wipo.int/wipolex/en/legislation/details/836
9
+ Egypt,North Africa,"Law No. 82 of 2002 on the Protection of Intellectual Property Rights, Book Three (Copyright and Neighbouring Rights), Article 160",life + 50 years,50,"Not verified. The sources consulted describe a unified life-plus-50 term applied across work types under Law 82 of 2002 and do not set out distinct durations for anonymous or pseudonymous works, works of juridical persons, applied art or photographs. The 1954 law that Law 82 replaced had shorter terms for photographic and audiovisual works (15 years from publication); whether Law 82 retains any such distinction was not established.",True,"Berne in force for Egypt since 7 June 1977 per WIPO's list of contracting parties. Law 82 of 2002 has been amended, most recently by Law No. 178 of 2020 which amended Article 185 of Book Three; WIPO Lex carries the consolidated Arabic text but only the 2002 English version, noting that the current text in English is unavailable. Any Egyptian title should therefore be checked against the Arabic consolidated text rather than the English translation. No public domain register was identified. Egypt is NOT listed as a signatory or contracting party to the Marrakesh Treaty in WIPO's status document of 27 June 2024.",None identified in the sources consulted.,"On a life-plus-50 term an Egyptian author who died in 1975 or earlier is out of copyright as of 2026, which covers a substantial part of the Cairo publishing boom of the 1950s and 1960s - a period when Egyptian presses were among the most productive on the continent. The two cautions are documentary rather than doctrinal: the authoritative current text is Arabic-only, so English-language term calculations carry translation risk, and the absence of verified anonymous or corporate terms means institutionally published works cannot yet be assessed with confidence. Before publishing any Egyptian title, commission a check of the consolidated Arabic text of Articles 160 onward. Egypt's non-participation in Marrakesh also removes the accessible-format cross-border route available in Nigeria, Ghana, Kenya, Tanzania and Cameroon.",medium,5,"Law No. 82 of 2002 on the Protection of Intellectual Property Rights, Egypt - WIPO Lex record | Copyright law of Egypt - Wikipedia (50-year p.m.a. term, Art. 160; Berne membership 7 June 1977) | IP Country Fiche: Egypt - European Commission Intellectual Property Helpdesk | Berne Convention contracting parties - WIPO | Marrakesh Treaty status document - WIPO (MVT/A/9/1 Rev., 27 June 2024)",https://www.wipo.int/wipolex/en/legislation/details/22066 | https://en.wikipedia.org/wiki/Copyright_law_of_Egypt | https://intellectual-property-helpdesk.ec.europa.eu/document/download/c7b97359-deac-45cc-abc4-6eda5174d11a_en?filename=IP+Country+Fiche_EGYPT_.pdf | https://www.wipo.int/documents/d/treaties/docs-en-berne.pdf | https://www.wipo.int/edocs/mdocs/govbody/en/mvt_a_9/mvt_a_9_1_rev.pdf,https://www.wipo.int/wipolex/en/legislation/details/22066
selftest.py CHANGED
@@ -1,108 +1,185 @@
1
- """selftest.py — fail the build rather than ship a dashboard that lies.
2
-
3
- Checks the governance rules that matter: every record sourced, nothing invented,
4
- derived fields consistent, and every page of the app rendering without error.
5
-
6
- Run: python selftest.py
7
  """
 
 
8
 
9
- from __future__ import annotations
 
 
 
10
 
11
- import pathlib
 
 
 
 
 
12
  import sys
 
13
 
14
  import pandas as pd
15
 
16
- ROOT = pathlib.Path(__file__).parent
17
- sys.path.insert(0, str(ROOT))
18
 
19
- FAILURES: list[str] = []
20
 
 
 
 
 
 
 
21
 
22
- def check(name: str, condition: bool, detail: str = "") -> None:
23
- if condition:
24
- print(f" PASS {name}")
 
25
  else:
26
- print(f" FAIL {name} {detail}")
27
- FAILURES.append(name)
28
 
29
 
30
- def main() -> int:
31
  print("African Books Recovery Project — selftest\n")
32
 
33
- data = ROOT
34
- for f in ["titles", "presses", "digitization", "rights", "holdings"]:
35
- check(f"fixture {f}.parquet exists", (data / f"{f}.parquet").exists())
36
- if FAILURES:
37
- print("\nRun `python build_data.py` first.")
 
 
 
 
38
  return 1
39
-
40
- titles = pd.read_parquet(data / "titles.parquet")
41
- presses = pd.read_parquet(data / "presses.parquet")
42
- rights = pd.read_parquet(data / "rights.parquet")
43
- holdings = pd.read_parquet(data / "holdings.parquet")
44
-
45
- print("\nGovernance")
46
- check("every title has at least one source", (titles["source_count"] > 0).all(),
47
- f"{int((titles['source_count'] == 0).sum())} unsourced")
48
- check("every press has at least one source", (presses["source_count"] > 0).all())
49
- check("every title record has a confidence flag",
50
- titles["confidence"].isin(["high", "medium", "low"]).all())
51
- check("every press record has a confidence flag",
52
- presses["confidence"].isin(["high", "medium", "low"]).all())
53
- check("no title year was invented outside the period",
54
- titles["year"].dropna().between(1900, 1990).all(),
55
- str(sorted(set(titles["year"].dropna()) - set(range(1900, 1991)))))
56
- check("undated titles are labelled Undated, not dated by inference",
57
- (titles.loc[titles["year"].isna(), "decade"] == "Undated").all())
58
- check("press_id in titles always resolves to the register",
59
- titles["press_id"].isin(set(presses["press_id"])).all())
60
- check("press_id is unique", presses["press_id"].is_unique)
61
- check("title_id is unique", titles["title_id"].is_unique)
62
-
63
- print("\nRights safety")
64
- check("in_print and copyright status are separate fields",
65
- "in_print" in titles.columns and "stage4_cleared" in titles.columns)
66
- check("no title claims clearance", (~titles["stage4_cleared"]).all(),
67
- "a cleared title must be backed by a signed permission, not by the ETL")
68
- check("no title claims rights identified", (~titles["stage3_rights_identified"]).all())
69
- check("every rights row states a statute", (rights["statute"].str.len() > 0).all())
70
- check("every rights row has a term in years", rights["term_years"].notna().all())
71
-
72
- print("\nDerived fields")
73
- check("preserved flag matches digitization status",
74
- (titles["stage2_preserved"] == titles["digitization_status"]
75
- .isin(["full_text_open", "scanned_restricted"])).all())
76
- check("republished flag matches in_print",
77
- (titles["stage5_republished"] == titles["in_print"].eq("yes")).all())
78
- check("diaspora presses are flagged as not based in Africa",
79
- (~presses.loc[presses["ownership"] == "african-founded-diaspora-based",
80
- "based_in_africa"]).all())
81
- check("pilot clusters do not overlap",
82
- titles[titles["pilot_cluster"] != ""]["title_id"].is_unique)
83
- check("holdings carry a provenance flag",
84
- holdings["provenance"].isin(["project brief", "press register"]).all())
85
-
86
- print("\nApplication")
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
87
  try:
88
  from streamlit.testing.v1 import AppTest
89
-
90
- for page in ["Overview", "Recovery pipeline", "Press register", "Title catalogue",
91
- "Rights & copyright", "Where the copies are", "Curriculum builder",
92
- "Methods & sources"]:
93
- at = AppTest.from_file(str(ROOT / "app.py"), default_timeout=90).run()
94
- at.sidebar.radio[0].set_value(page).run()
95
- check(f"page renders: {page}", not at.exception,
96
- str(at.exception[0].message) if at.exception else "")
97
  except ImportError:
98
- print(" SKIP streamlit not installed; page-render checks skipped")
99
 
100
- print()
101
- if FAILURES:
102
- print(f"{len(FAILURES)} check(s) failed: {', '.join(FAILURES)}")
103
- return 1
104
- print("All checks passed.")
105
- return 0
106
 
107
 
108
  if __name__ == "__main__":
 
1
+ # -*- coding: utf-8 -*-
 
 
 
 
 
2
  """
3
+ selftest.py — faire echouer la construction plutot que livrer un tableau de bord
4
+ qui ment.
5
 
6
+ Ce script ne redemontre rien : il verifie que ce qui sort de build_data.py est
7
+ conforme a ce que le tableau de bord pretend afficher, et que rien n'a ete
8
+ fabrique en route. Il echoue bruyamment plutot que de laisser passer une valeur
9
+ douteuse dans une carte.
10
 
11
+ python selftest.py
12
+
13
+ Chaque controle affiche OK, ALERTE (a regarder, pas forcement une erreur) ou
14
+ ECHEC (incoherence : ne pas publier). Code de sortie non nul s'il y a un ECHEC.
15
+ """
16
+ import json
17
  import sys
18
+ from pathlib import Path
19
 
20
  import pandas as pd
21
 
22
+ ICI = Path(__file__).resolve().parent
23
+ ETATS = {"OK": 0, "ALERTE": 0, "ECHEC": 0}
24
 
 
25
 
26
+ def dire(etat, titre, detail=""):
27
+ ETATS[etat] += 1
28
+ print(f"[{etat:<7s}] {titre}")
29
+ if detail:
30
+ for l in str(detail).rstrip().split("\n"):
31
+ print(f" {l}")
32
 
33
+
34
+ def verifier(cond, titre, detail="", faible=False):
35
+ if cond:
36
+ dire("OK", titre)
37
  else:
38
+ dire("ALERTE" if faible else "ECHEC", titre, detail)
 
39
 
40
 
41
+ def main():
42
  print("African Books Recovery Project — selftest\n")
43
 
44
+ print("== 1. fichiers")
45
+ besoin = ["titles.csv", "presses.csv", "rights.csv", "digitization.csv",
46
+ "holdings.csv", "cities.csv", "countries.csv", "contours_afrique.csv",
47
+ "app.py", "build_data.py", "requirements.txt", "README.md",
48
+ "villes.json"]
49
+ manquants = [n for n in besoin if not (ICI / n).exists()]
50
+ if manquants:
51
+ dire("ECHEC", "fichiers absents", ", ".join(manquants))
52
+ print("\nLancer : python build_data.py")
53
  return 1
54
+ dire("OK", f"les {len(besoin)} fichiers attendus sont presents")
55
+ sous = [p.name for p in ICI.iterdir() if p.is_dir() and p.name != "__pycache__"]
56
+ verifier(not sous, "aucun sous-dossier — le depot reste a plat", ", ".join(sous),
57
+ faible=True)
58
+
59
+ T = pd.read_csv(ICI / "titles.csv")
60
+ P = pd.read_csv(ICI / "presses.csv")
61
+ R = pd.read_csv(ICI / "rights.csv")
62
+ H = pd.read_csv(ICI / "holdings.csv")
63
+ C = pd.read_csv(ICI / "countries.csv")
64
+ V = pd.read_csv(ICI / "cities.csv")
65
+ CT = pd.read_csv(ICI / "contours_afrique.csv")
66
+
67
+ print("\n== 2. gouvernance des donnees")
68
+ verifier((T["source_count"] > 0).all(), "chaque titre porte au moins une source",
69
+ f"{int((T['source_count'] == 0).sum())} sans source")
70
+ verifier((P["source_count"] > 0).all(), "chaque maison porte au moins une source")
71
+ verifier(T["confidence"].isin(["high", "medium", "low"]).all(),
72
+ "chaque titre porte un indice de fiabilite")
73
+ verifier(P["confidence"].isin(["high", "medium", "low"]).all(),
74
+ "chaque maison porte un indice de fiabilite")
75
+ verifier(T["year"].dropna().between(1900, 1990).all(),
76
+ "aucune annee inventee hors de la periode",
77
+ str(sorted(set(T["year"].dropna()) - set(range(1900, 1991)))))
78
+ verifier((T.loc[T["year"].isna(), "decade"] == "Undated").all(),
79
+ "les titres non dates restent non dates, jamais rattaches a une decennie")
80
+ verifier(T["press_id"].isin(set(P["press_id"])).all(),
81
+ "chaque press_id d'un titre existe au registre")
82
+ verifier(P["press_id"].is_unique, "press_id unique")
83
+ verifier(T["title_id"].is_unique, "title_id unique")
84
+
85
+ print("\n== 3. surete juridique")
86
+ verifier("in_print" in T.columns and "stage4_cleared" in T.columns,
87
+ "disponibilite et droits sont deux champs distincts")
88
+ verifier((~T["stage4_cleared"]).all(),
89
+ "aucun titre ne se declare autorise",
90
+ "une autorisation doit venir d'un accord signe, pas de l'ETL")
91
+ verifier((~T["stage3_rights_identified"]).all(),
92
+ "aucun titre ne se declare 'ayants droit identifies'")
93
+ verifier(R["statute"].astype(str).str.len().gt(0).all(),
94
+ "chaque juridiction cite son texte de loi")
95
+ verifier(R["term_years"].notna().all(), "chaque juridiction a une duree en annees")
96
+ verifier(R["term_years"].between(25, 100).all(),
97
+ "les durees de protection sont plausibles")
98
+
99
+ print("\n== 4. champs derives")
100
+ verifier((T["stage2_preserved"] == T["digitization_status"]
101
+ .isin(["full_text_open", "scanned_restricted"])).all(),
102
+ "l'indicateur 'preserve' suit l'etat de numerisation")
103
+ verifier((T["stage5_republished"] == T["in_print"].eq("yes")).all(),
104
+ "l'indicateur 'reedite' suit la disponibilite")
105
+ verifier((~P.loc[P["ownership"] == "african-founded-diaspora-based",
106
+ "based_in_africa"]).all(),
107
+ "les maisons de la diaspora sont signalees comme hors d'Afrique")
108
+ pil = T[T["pilot_cluster"].notna() & (T["pilot_cluster"] != "")]
109
+ verifier(pil["title_id"].is_unique, "les groupes du pilote ne se recouvrent pas")
110
+ verifier(H["provenance"].isin(["project brief", "press register"]).all(),
111
+ "chaque piste de recherche porte sa provenance")
112
+
113
+ print("\n== 5. cartographie")
114
+ noms_carte = set(CT["pays"])
115
+ verifier(len(noms_carte) == 54, f"{len(noms_carte)} pays ont un polygone")
116
+ hors = sorted(set(T["map_country"].dropna()) - noms_carte)
117
+ hors_afrique = {"France", "Portugal", ""}
118
+ inattendus = [h for h in hors if h not in hors_afrique]
119
+ verifier(not inattendus,
120
+ "tout pays de publication africain a un polygone",
121
+ "sans polygone : " + ", ".join(inattendus))
122
+ if set(hors) & hors_afrique:
123
+ dire("OK", "les imprimeurs hors d'Afrique sont hors carte, comme prevu : "
124
+ + ", ".join(sorted(set(hors) & hors_afrique)))
125
+ verifier(len(C) == 54, "la table de couverture couvre les 54 pays de la carte")
126
+ verifier((C["titles"] >= 0).all() and (C["searched"] == (C["titles"] > 0)).all(),
127
+ "'searched' est exactement 'au moins une notice'")
128
+ n_zero = int((~C["searched"]).sum())
129
+ if n_zero:
130
+ dire("ALERTE", f"{n_zero} pays sans aucune notice — ils seront gris sur "
131
+ "les cartes",
132
+ "C'est un resultat a afficher, pas une erreur : le tableau de bord "
133
+ "compte ces pays dans le sous-titre de chaque carte.")
134
+ sans_coord = V[V["lat"].isna()]["city"].tolist()
135
+ verifier(not sans_coord, "toutes les villes ont des coordonnees",
136
+ ", ".join(sans_coord), faible=True)
137
+ verifier(V["lat"].dropna().between(-90, 90).all()
138
+ and V["lon"].dropna().between(-180, 180).all(),
139
+ "les coordonnees de villes sont dans les bornes du globe")
140
+ sur_carte = V[V["on_map"]]
141
+ verifier(sur_carte["lat"].between(-36, 38).all()
142
+ and sur_carte["lon"].between(-25.5, 52.5).all(),
143
+ "toutes les villes portees a la carte tombent dans l'emprise")
144
+ villes_titres = set(T["city"].dropna()) - {""}
145
+ inconnues = sorted(villes_titres - set(V["city"]))
146
+ verifier(not inconnues, "chaque ville d'un titre est au repertoire",
147
+ ", ".join(inconnues))
148
+ gaz = json.loads((ICI / "villes.json").read_text(encoding="utf-8"))["cities"]
149
+ verifier(len({c["city"] for c in gaz}) == len(gaz),
150
+ "aucun doublon dans le repertoire des villes")
151
+
152
+ print("\n== 6. dependances")
153
+ src = (ICI / "app.py").read_text(encoding="utf-8")
154
+ interdits = [m for m in ["pyarrow", "geopandas", "shapely", "plotly",
155
+ "matplotlib", "requests"] if f"import {m}" in src]
156
+ verifier(not interdits,
157
+ "l'application n'importe que streamlit, pandas, numpy, altair",
158
+ "importe aussi : " + ", ".join(interdits))
159
+ req = (ICI / "requirements.txt").read_text(encoding="utf-8").split()
160
+ verifier(req == ["streamlit"],
161
+ "requirements.txt ne demande que streamlit", " ".join(req))
162
+ verifier("parquet" not in src,
163
+ "aucune lecture parquet — le Space n'a pas besoin de pyarrow")
164
+
165
+ print("\n== 7. l'application")
166
  try:
167
  from streamlit.testing.v1 import AppTest
168
+ for lang, theme in [("en", "clair"), ("fr", "sombre")]:
169
+ at = AppTest.from_file(str(ICI / "app.py"), default_timeout=180)
170
+ at.session_state["lang"] = lang
171
+ at.session_state["theme"] = theme
172
+ at.run()
173
+ verifier(not at.exception,
174
+ f"l'application s'affiche en {lang} / {theme}",
175
+ str(at.exception[0].message) if at.exception else "")
176
  except ImportError:
177
+ dire("ALERTE", "streamlit absent : rendu non teste")
178
 
179
+ print(f"\n{ETATS['OK']} OK, {ETATS['ALERTE']} alerte(s), {ETATS['ECHEC']} echec(s).")
180
+ if ETATS["ECHEC"]:
181
+ print("Ne pas publier tant qu'un ECHEC subsiste.")
182
+ return 1 if ETATS["ECHEC"] else 0
 
 
183
 
184
 
185
  if __name__ == "__main__":
titles.csv CHANGED
The diff for this file is too large to render. See raw diff
 
villes.json ADDED
@@ -0,0 +1,50 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_note": "Gazetteer of the publishing cities appearing in the catalogue. Coordinates are standard public-gazetteer positions rounded to two decimals, used ONLY to place a dot on the map; they are a cartographic aid and are not part of any bibliographic record. 'variants' lists the spellings that occur in the sourced research files, so that city normalisation is explicit and reviewable rather than hidden in a regex.",
3
+ "cities": [
4
+ {"city": "Abidjan", "country": "Côte d'Ivoire", "lat": 5.32, "lon": -4.03, "variants": []},
5
+ {"city": "Aboso", "country": "Ghana", "lat": 5.36, "lon": -1.95, "variants": []},
6
+ {"city": "Accra", "country": "Ghana", "lat": 5.56, "lon": -0.20, "variants": ["Accra (Legon)", "Accra (with a second office in Tamale)"]},
7
+ {"city": "Accra-Tema", "country": "Ghana", "lat": 5.62, "lon": -0.11, "variants": []},
8
+ {"city": "Addis Ababa", "country": "Ethiopia", "lat": 9.03, "lon": 38.74, "variants": []},
9
+ {"city": "Algiers", "country": "Algeria", "lat": 36.75, "lon": 3.06, "variants": []},
10
+ {"city": "Alice", "country": "South Africa", "lat": -32.79, "lon": 26.83, "variants": ["Alice (Dikeni), Eastern Cape"]},
11
+ {"city": "Antananarivo", "country": "Madagascar", "lat": -18.88, "lon": 47.51, "variants": ["Antananarivo (Tananarive)"]},
12
+ {"city": "Bathurst (Banjul)","country": "Gambia", "lat": 13.45, "lon": -16.58, "variants": ["Bathurst", "Bathurst (now Banjul)"]},
13
+ {"city": "Benin City", "country": "Nigeria", "lat": 6.34, "lon": 5.63, "variants": []},
14
+ {"city": "Cairo", "country": "Egypt", "lat": 30.04, "lon": 31.24, "variants": []},
15
+ {"city": "Cape Town", "country": "South Africa", "lat": -33.92, "lon": 18.42, "variants": ["Cape Town (Athlone)"]},
16
+ {"city": "Casablanca", "country": "Morocco", "lat": 33.57, "lon": -7.59, "variants": []},
17
+ {"city": "Dakar", "country": "Senegal", "lat": 14.72, "lon": -17.47, "variants": ["Dakar (head office), with branches in Abidjan and Lomé"]},
18
+ {"city": "Dar es Salaam", "country": "Tanzania", "lat": -6.79, "lon": 39.21, "variants": []},
19
+ {"city": "Enugu", "country": "Nigeria", "lat": 6.44, "lon": 7.50, "variants": []},
20
+ {"city": "Freetown", "country": "Sierra Leone", "lat": 8.48, "lon": -13.23, "variants": []},
21
+ {"city": "Gaborone", "country": "Botswana", "lat": -24.65, "lon": 25.91, "variants": []},
22
+ {"city": "Gwelo (Gweru)", "country": "Zimbabwe", "lat": -19.45, "lon": 29.82, "variants": ["Gwelo", "Gwelo (Gweru)"]},
23
+ {"city": "Ibadan", "country": "Nigeria", "lat": 7.38, "lon": 3.90, "variants": []},
24
+ {"city": "Johannesburg", "country": "South Africa", "lat": -26.20, "lon": 28.05, "variants": []},
25
+ {"city": "Kampala", "country": "Uganda", "lat": 0.31, "lon": 32.58, "variants": []},
26
+ {"city": "Khartoum", "country": "Sudan", "lat": 15.50, "lon": 32.56, "variants": []},
27
+ {"city": "Kinshasa", "country": "DR Congo", "lat": -4.32, "lon": 15.31, "variants": ["Kinshasa (also Lubumbashi)"]},
28
+ {"city": "Lagos", "country": "Nigeria", "lat": 6.52, "lon": 3.38, "variants": []},
29
+ {"city": "Limbe", "country": "Cameroon", "lat": 4.02, "lon": 9.21, "variants": []},
30
+ {"city": "Lisbon", "country": "Portugal", "lat": 38.72, "lon": -9.14, "variants": []},
31
+ {"city": "Luanda", "country": "Angola", "lat": -8.84, "lon": 13.23, "variants": []},
32
+ {"city": "Lubumbashi", "country": "DR Congo", "lat": -11.66, "lon": 27.48, "variants": []},
33
+ {"city": "Lusaka", "country": "Zambia", "lat": -15.42, "lon": 28.28, "variants": []},
34
+ {"city": "Maputo", "country": "Mozambique", "lat": -25.97, "lon": 32.57, "variants": []},
35
+ {"city": "Mogadishu", "country": "Somalia", "lat": 2.04, "lon": 45.34, "variants": []},
36
+ {"city": "Monrovia", "country": "Liberia", "lat": 6.30, "lon": -10.80, "variants": []},
37
+ {"city": "Morija", "country": "Lesotho", "lat": -29.62, "lon": 27.50, "variants": []},
38
+ {"city": "Nairobi", "country": "Kenya", "lat": -1.29, "lon": 36.82, "variants": []},
39
+ {"city": "Nsukka", "country": "Nigeria", "lat": 6.86, "lon": 7.40, "variants": []},
40
+ {"city": "Oniipa", "country": "Namibia", "lat": -17.85, "lon": 16.02, "variants": ["Oniipa, Ovamboland"]},
41
+ {"city": "Onitsha", "country": "Nigeria", "lat": 6.14, "lon": 6.79, "variants": ["Onitsha (Fegge)"]},
42
+ {"city": "Paris", "country": "France", "lat": 48.86, "lon": 2.35, "variants": ["Paris (25 bis rue des Écoles, 75005)"]},
43
+ {"city": "Pietermaritzburg", "country": "South Africa", "lat": -29.60, "lon": 30.38, "variants": []},
44
+ {"city": "Salisbury (Harare)","country": "Zimbabwe", "lat": -17.83, "lon": 31.05, "variants": ["Salisbury", "Salisbury (Harare)"]},
45
+ {"city": "Tema", "country": "Ghana", "lat": 5.67, "lon": -0.02, "variants": []},
46
+ {"city": "Tunis", "country": "Tunisia", "lat": 36.81, "lon": 10.18, "variants": []},
47
+ {"city": "Yaoundé", "country": "Cameroon", "lat": 3.87, "lon": 11.52, "variants": ["Yaounde"]},
48
+ {"city": "Zaria", "country": "Nigeria", "lat": 11.07, "lon": 7.72, "variants": []}
49
+ ]
50
+ }