tracker

5.7 KB

1. // lib/credits-helpers.hl — TMDB's credits answer read into ours (tracker.worldapi.org#28): the cast and crew entries of a
2. // details answer (`credits` of a movie, `aggregate_credits` of a series), roles, episode counts, the crew jobs we show — no table,
3. // no request. The rules are at the top of credits.hl. Mission 028: out of details.hl.
4. import { env } from 'hl:proc'
5. import { textOr, listOr } from './util.hl'
7. // how many of TMDB's cast a title keeps (see the top; TRACKER_CAST_MAX) and how many people per crew job
8. static castMax = env('TRACKER_CAST_MAX') != null ? toNumber(env('TRACKER_CAST_MAX')) : 300
9. static crewMax = 30
11. // a series' roles ([{ character, episode_count }]) as one text: "Mother / Lamia". tracker#28 (real data): TMDB's characters are
12. // themselves " / "-joined and repeat across seasons ("Data / Lore", "Data", "Yvette Picard (uncredited)") — split, " (uncredited)"
13. // dropped, each name once, at most `rolesMax` (a voice actor of The Simpsons has 30+), then " / …"
14. static rolesMax = 4
15. static rolesText = (&roles) => {
16. names = []
17. let more = false
18. for (r of listOr(roles)) {
19. let c = r != null ? textOr(r.character) : null
20. if (c != null) {
21. for (part of c.split(' / ')) {
22. let n = part.replaceAll(' (uncredited)', '').trim()
23. if (n != '' && !names.includes(n)) { if (names.length < rolesMax) { names.push(n) } else { more = true } }
24. }
25. }
26. }
27. return names.join(' / ') + (more ? ' / …' : '')
28. }
30. // a series' episodes of one person: TMDB's total_episode_count, else the sum of the roles' / jobs' counts
31. static episodesOf = (&total, &parts) => {
32. if (total != null && hlTypeName(total) == 'Number') { return total }
33. let n = 0
34. for (r of listOr(parts)) { if (r != null && r.episode_count != null && hlTypeName(r.episode_count) == 'Number') { n = n + r.episode_count } }
35. return n
36. }
37. static personOk = (&c) => { return c != null && c.id != null && hlTypeName(c.id) == 'Number' && textOr(c.name) != null && c.adult != true }
39. // TMDB's cast → [{ tmdbId, name, character, gender, episodes }], TMDB's order, at most castMax, adult people left out
40. static castOf = (&d, &movie) => {
41. src = movie ? (d.credits != null ? d.credits.cast : null) : (d.aggregate_credits != null ? d.aggregate_credits.cast : null)
42. out = []
43. for (c of listOr(src)) {
44. if (out.length < castMax && personOk(c)) {
45. let role = movie ? textOr(c.character) : rolesText(c.roles)
46. out.push({ tmdbId = c.id name = c.name character = role != null ? role : '' gender = c.gender profile = textOr(c.profile_path) episodes = movie ? null : episodesOf(c.total_episode_count, c.roles) })
47. }
48. }
49. return out
50. }
52. // a series' main cast is in at least this many episodes: half of the series' (rounded up), at most 10 (a season), at least 1
53. static mainMinOf = (&d) => {
54. n = d.number_of_episodes != null && hlTypeName(d.number_of_episodes) == 'Number' ? d.number_of_episodes : 0
55. half = (n - n % 2) / 2 + n % 2
56. if (half > 10) { return 10 }
57. return half < 1 ? 1 : half
58. }
60. // the crew jobs we show: TMDB job → ours (the page's labels: components/show.hl crewLabels)
61. static crewJobOf = (&job) => {
62. if (job == 'Director') { return 'director' }
63. if (job == 'Writer') { return 'writer' }
64. if (job == 'Screenplay') { return 'screenplay' }
65. if (job == 'Story') { return 'story' }
66. if (job == 'Original Music Composer' || job == 'Composer' || job == 'Music') { return 'composer' }
67. return null
68. }
69. static crewJobs = ['creator', 'director', 'writer', 'screenplay', 'story', 'composer']
71. // keeps a job's list ordered by episodes (most first, equal ones in TMDB's order), at most crewMax (hand-written: no sort())
72. static insertByEpisodes = (&list, &item) => {
73. out = []
74. let inserted = false
75. for (x of list) {
76. if (!inserted && item.episodes > x.episodes) { out.push(item) inserted = true }
77. if (out.length < crewMax) { out.push(x) }
78. }
79. if (!inserted && out.length < crewMax) { out.push(item) }
80. return out
81. }
83. // TMDB's crew (+ a series' created_by) → [{ tmdbId, name, job, gender, profile, episodes }], grouped by job in `crewJobs` order, one
84. // entry per person and job
85. static crewOf = (&d, &movie) => {
86. byJob = {}
87. seen = {}
88. for (j of crewJobs) { byJob[j] = [] }
89. if (!movie) {
90. for (c of listOr(d.created_by)) {
91. if (personOk(c) && seen['creator:' + c.id] != true && byJob['creator'].length < crewMax) {
92. seen['creator:' + c.id] = true
93. let l = byJob['creator']
94. l.push({ tmdbId = c.id name = c.name job = 'creator' gender = c.gender profile = textOr(c.profile_path) episodes = 0 })
95. byJob['creator'] = l
96. }
97. }
98. }
99. src = movie ? (d.credits != null ? d.credits.crew : null) : (d.aggregate_credits != null ? d.aggregate_credits.crew : null)
100. for (c of listOr(src)) {
101. if (personOk(c)) {
102. // a movie's crew entry has one `job`; a series' has `jobs` [{ job, episode_count }]
103. let jobs = movie ? [{ job = c.job episode_count = 0 }] : listOr(c.jobs)
104. for (jb of jobs) {
105. let ours = jb != null ? crewJobOf(jb.job) : null
106. if (ours != null && seen[ours + ':' + c.id] != true) {
107. seen[ours + ':' + c.id] = true
108. let n = movie ? 0 : episodesOf(jb.episode_count, null)
109. byJob[ours] = insertByEpisodes(byJob[ours], { tmdbId = c.id name = c.name job = ours gender = c.gender profile = textOr(c.profile_path) episodes = n })
110. }
111. }
112. }
113. }
114. out = []
115. for (j of crewJobs) { for (c of byJob[j]) { out.push(c) } }
116. return out
117. }
119. static crewRoleOf = (&job) => {
120. if (job == 'creator') { return 'Creator' }
121. if (job == 'director') { return 'Director' }
122. if (job == 'writer') { return 'Writer' }
123. if (job == 'screenplay') { return 'Screenplay' }
124. if (job == 'story') { return 'Story' }
125. return 'Music'
126. }
128. // the answer carries credits (a details request with `credits` / `aggregate_credits` appended)
129. static hasCredits = (&d, &movie) => { return d != null && (movie ? d.credits != null : d.aggregate_credits != null) }