Y.A.N.F: Private Message XML Ticker (Changes Applied)

Changes were applied today that were announced a while back in Y.A.N.F: Private Message XML Ticker.

Due to popular demand the plans were changed slightly so that hopefully the impact on unchanged clients will be lower. The behaviour is as follows:

http://perlmonks.org/index.pl?node_id=15848

max_recs=N: Sets the maximum number of records to return. Hard limits are imposed and are subject to change.
since_id=MSG_ID: Returns nodes later than MSG_ID
prior_to=MSG_ID: Returns nodes prior to this MSG_ID
neither since_id nor prior_to arguments provided: Returns the users 20 most recent messages.
archived=TYPE: If TYPE is 'both' returns both archived and unarchived messages in one go, if omitted, false or 'no' then return only private messages. If any other true value then returns only archived.
xmlstyle=clean: If present then no newlines are added to the messages.

Records are always returned ordered by ascending message_id.

This should allow people to set up clients fairly easily. First fetch with no arguments, then for new material use since_id=MAX_ID and for older stuff use prior_to=MIN_ID. Repeat until you get no records back (or less than max_recs) then the process is finished. Older clients shouldn't break as they will still get the most recent messages, but not all of them every time.

---
demerphq

_{First they ignore you, then they laugh at you, then they fight you, then you win.

-- Gandhi}

_{• Update:

Minor fixes. Thanks castaway.}

Comment on Y.A.N.F: Private Message XML Ticker (Changes Applied)

Replies are listed 'Best First'.
Re: Y.A.N.F: Private Message XML Ticker (Changes Applied) by castaway (Parson) on Aug 02, 2004 at 16:35 UTC
Nifty stuff. demerphq! I'll sneak another announcement in here, im2s telnet interface can now get private messages, for anyone logged in using it. The feature is off per default, and can be turned on by typing '/im2 msgs on'. The first 'grab' gets the last ten unarchived messages in the users mailbox, and thereafter the newest ones (using since_id). Checks are only done every 5 mins, so its not snappy (but usable, from my POV).. Much fun! C.	[reply]
Re: Y.A.N.F: Private Message XML Ticker (Changes Applied) by atcroft (Abbot) on Aug 02, 2004 at 16:55 UTC
Okay, two questions: What is the hard limit for max_recs? Can anyone suggest what needs to be patched in FrameChat2 as a result of the changes in Private Message XML ticker behavior? Thanks in advance...	[reply]
Re^2: Y.A.N.F: Private Message XML Ticker (Changes Applied) by demerphq (Chancellor) on Aug 02, 2004 at 17:47 UTC
What is the hard limit for max_recs? Currently 100 unless no args were supplied in which case its 20. what needs to be patched in FrameChat2 Not positive what FrameChat2 does. If all it does is show the most recent N messages then its unlikely to need any changes at all. --- demerphq _{First they ignore you, then they laugh at you, then they fight you, then you win. -- Gandhi}	[reply] [d/l]