summaryrefslogtreecommitdiff
path: root/atc-recentchanges.py
blob: f94f1b6c3e4ef350dad0be8a6d77ef73ff1e2ee4 (about) (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
#!/usr/bin/env -S python3
from __future__ import annotations  # PEP 585 for Python 3.7 and 3.8
import logging
import requests
import time
import typing
import urllib.parse


ATW="https://wiki.archiveteam.org/"
ATAPI = ATW + "api.php"

def get_new(newestRc: typing.Optional[tuple[str, int]]) -> tuple[list[dict], tuple[str, int]]:
	'''
	Fetches edits made after newestRc = (newestTimestamp, newestRcId), which shall both refer to the last change already known/processed.
	newestTimestamp is a timestamp in YYYY-MM-DDTHH:MM:SSZ format; newestRcId is the internal ID of the change.
	The return value are the list of changes after newestRcId in chronological order (as returned by MW), and a new (newestTimestamp, newestRcId) tuple.
	If newestRc is None, this returns an empty list of changes and the timestamp and rev ID of the most recent edit (for initialisation of a feed).
	'''

	logging.info(f'Fetching with newestRc = {newestRc!r}')
	if newestRc is None:
		newestTimestamp, newestRcId = None, None
	else:
		newestTimestamp, newestRcId = newestRc
	rcend = f'&rcend={newestTimestamp}' if newestTimestamp else ''
	r = requests.get(f'{ATAPI}?action=query&list=recentchanges&rcdir=older&format=json&rcprop=user|comment|timestamp|sizes|title|flags|ids|loginfo&continue=&rclimit=500{rcend}',
	                 timeout = 5,
	                )
	r.raise_for_status()
	o = r.json()
	if not o['query']['recentchanges']:
		return [], (newestTimestamp, newestRcId)
	rc = o['query']['recentchanges']
	changes = []
	if newestRcId is not None:
		for c in rc:
			if c['rcid'] <= newestRcId:
				break
			changes.append(c)
	return changes[::-1], (rc[0]['timestamp'], rc[0]['rcid'])


def truncate(s: str, limit: int) -> str:
	'''If s is longer than limit, split on words and return a truncated version no longer than limit.'''
	if len(s) <= limit:
		return s
	words = s.split(' ')
	trunLength = 0
	trun = []
	while words and trunLength + 1 + len(words[0]) < limit - 1:
		word = words.pop(0)
		trunLength += 1 + len(word)
		trun.append(word)
	return f'{" ".join(trun)}…'


def format_change(change: dict) -> typing.Optional[str]:
	'''Formats a change for posting to IRC. Returns None if it's an event that isn't handled and not to be reported to IRC.'''
	title = change['title']
	urlSafeTitle = urllib.parse.quote(change['title'])
	url = None
	if change['type'] == 'new':
		verb = 'created'
		url = f'{ATW}?title={urlSafeTitle}&oldid={change["revid"]}'
	elif change['type'] == 'edit':
		verb = 'edited'
		url = f'{ATW}?title={urlSafeTitle}&diff={change["revid"]}&oldid={change["old_revid"]}'
	elif change['type'] == 'log' and change['logtype'] == 'delete':
		verb = 'deleted'
		url = ''
	elif change['type'] == 'log' and change['logtype'] == 'move':
		verb = 'moved'
		title = f'{change["logparams"]["target_title"]} (from {change["title"]})'
		url = f'{ATW}?title={urllib.parse.quote(change["logparams"]["target_title"])}'
	else:
		return
	comment = change["comment"] if change["comment"] else ''
	url = f'{url}' if url else ''
	return f'AT Wiki | {title} was {verb} by {change["user"]} at {change["timestamp"]} | {comment} | {url}'


def main():
	# Get initial TS/rcid tuple
	_, newestRc = get_new(None)
	time.sleep(60)
	while True:
		try:
			changes, newestRc = get_new(newestRc)
		except Exception as e:
			logging.error('get_new failed', exc_info = e)
			time.sleep(60)
			continue
		for change in changes:
			formatted = format_change(change)
			if formatted:
				print(formatted, flush = True)
			else:
				logging.warning(f'Suppressed change because it was un- or ill-formatted: {change!r}')
		time.sleep(60)


if __name__ == '__main__':
	logging.basicConfig(
		format = '{asctime}.{msecs:03.0f}  {levelname}  {name}  {message}',
		datefmt = '%Y-%m-%d %H:%M:%S',
		style = '{',
		level = logging.INFO,
	)
	main()