Add some numerics comments.

diff --git a/ircplom/client.py b/ircplom/client.py
index 49ed26463edf8ba6b57509bbf8ca00f759afb091..77dedef4c49201b1aca111481ecadfa3eebb5cde 100644 (file)
--- a/ircplom/client.py
+++ b/ircplom/client.py
@@ -42,19 +42,19 @@ _EXPECTATIONS: list[_MsgParseExpectation] = []
 # these we ignore except for confirming/collecting the nickname
 _EXPECTATIONS += [
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '001',
+                         '001',  # RPL_WELCOME
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '002',
+                         '002',  # RPL_YOURHOST
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '003',
+                         '003',  # RPL_CREATED
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '004',
+                         '004',  # RPL_MYINFO
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY,
                           _MsgTok.ANY,
@@ -62,38 +62,38 @@ _EXPECTATIONS += [
                           _MsgTok.ANY,
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '250',
+                         '250',  # RPL_STATSDLINE / RPL_STATSCONN
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '251',
+                         '251',  # RPL_LUSERCLIENT
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '252',
+                         '252',  # RPL_LUSEROP
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY,
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '253',
+                         '253',  # RPL_LUSERUNKNOWN
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY,
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '254',
+                         '254',  # RPL_LUSERCHANNELS
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY,
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '255',
+                         '255',  # RPL_LUSERME
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '265',
+                         '265',  # RPL_LOCALUSERS
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY)),
     _MsgParseExpectation(_MsgTok.SERVER,
-                         '265',
+                         '265',  # RPL_GLOBALUSERS
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.ANY,
                           _MsgTok.ANY,
@@ -120,7 +120,7 @@ _EXPECTATIONS += [
                          '005',  # RPL_ISUPPORT
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           (_MsgTok.ANY, ':isupports'),
-                          _MsgTok.ANY),
+                          _MsgTok.ANY),  # comment
                          idx_into_list=1),
     _MsgParseExpectation(_MsgTok.SERVER,
                          '372',  # RPL_MOTD
@@ -129,12 +129,12 @@ _EXPECTATIONS += [
     _MsgParseExpectation(_MsgTok.SERVER,
                          '376',  # RPL_ENDOFMOTD
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation(_MsgTok.SERVER,
                          '396',  # RPL_VISIBLEHOST
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           (_MsgTok.SERVER, 'set_db_attr:client_host'),
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
 ]
 
 # SASL
@@ -145,7 +145,7 @@ _EXPECTATIONS += [
                           (_MsgTok.NICK_USER_HOST,
                            'set_db_attr:_nick_user_host'),
                           (_MsgTok.ANY, 'set_db_attr:sasl_account'),
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation(_MsgTok.SERVER,
                          '903',  # RPL_SASLSUCCESS
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
@@ -244,17 +244,17 @@ _EXPECTATIONS += [
                          '432',  # ERR_ERRONEOUSNICKNAME
                          ('*',
                           _MsgTok.NICKNAME,
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation(_MsgTok.SERVER,
                          '432',  # ERR_ERRONEOUSNICKNAME
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           _MsgTok.NICKNAME,
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation(_MsgTok.SERVER,
                          '433',  # ERR_NICKNAMEINUSE
                          (_MsgTok.NICKNAME,
                           (_MsgTok.NICKNAME, ':used'),
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation((_MsgTok.NICK_USER_HOST, ':named'),
                          'NICK',
                          ((_MsgTok.NICKNAME, ':nickname'),)),
@@ -272,7 +272,7 @@ _EXPECTATIONS += [
                          '366',  # RPL_ENDOFNAMES
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           (_MsgTok.CHANNEL, ':channel'),
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation((_MsgTok.NICK_USER_HOST, ':joiner'),
                          'JOIN',
                          ((_MsgTok.CHANNEL, ':channel'),)),
@@ -287,7 +287,7 @@ _EXPECTATIONS += [
                          '401',  # ERR_NOSUCKNICK
                          ((_MsgTok.NICKNAME, 'set_db_attr:nickname'),
                           (_MsgTok.NICKNAME, ':target'),
-                          _MsgTok.ANY)),
+                          _MsgTok.ANY)),  # comment
     _MsgParseExpectation(_MsgTok.SERVER,
                          'NOTICE',
                          ('*',