This is NewsFilter.m in view mode; [Download] [Up]
/* NewsFilter.m -- News filtering and description services for DL indexing of usenet news articles. The following two services are implemented. [1] NewsDescribe Service: Describes news articles based currently on Subject:, From:, and Date: lines. This can be modified quite easily. Some effort has been made to extract full name of the poster from the From: line. This description service is advertised via the following specification in ~/Library/Services/NewsIndexing.service/services (or /LocalLibrary...) file. Filter: NewsDescribe Port: IXNEWSFILTER Send Type: NXTypedFileContentsPboardType:news Return Type: IXFileDescriptionPboardType Executable: NewsFilter.daemon [2] NewsFilter Service: Filters junk out of news articles, so junk will not be indexed. "Junk" currently is defined as: Path: line. Nntp-posting-host: line. Lines including and after "-- NewsGrazer, a NeXTstep(tm) ....." Ohter UUENCODE'ed stuff. This filtering service is advertised via the following specification in ~/Library/Services/NewsIndexing.service/services (or /LocalLibrary...) file. Filter: NewsFilter Port: IXNEWSFILTER Send Type: NXTypedFileContentsPboardType:news Return Type: NXAsciiPboardType Executable: NewsFilter.daemon Advantage of this service daemon scheme over the Unix stdio filter (invoked via NXUNIXSTDIO port) is that the daemon based filter is invoked only once per DL indexing session, unlike stdio filter which is invoked for every article indexed. Daemons can keep running indefinitely, but this one quits after some duration of inactivity. No Copyright is claimed. This program is hereby released into the public domain. Benoät GrangÝ [ben@fizz.fdn.org] distributed a similar daemon free of charge, but no source code was included in the distribution. This version has been developed from scratch by myself. Izumi Ohzawa, izumi@pinoko.berkeley.edu. ------- TO DO ---------------------------------------------------------------- [1] Making things configurable, e.g., what goes into the description line in what order, and what kind of lines to filter out in -NewsFilter:... method. These specs can be stored in a file in ~/Library/Services/NewsIndexing.service directory (or /LocalLibrary..) This path should be in argv[0] in main() because that is where the executable lives too. I probably won't get around to doing this myself, or doing much enhancements. ------- Revision History ----------------------------------------------------- 94-01-23 Version 0.9 of NewsDescribe. Izumi Ohzawa, izumi@pinoko.berkeley.edu Version 0.91, 0.92. 94-01-29 Version 0.93. Izumi. Renamed to NewsFilter. Now filters out junk from news articles via new filter service: NewsFilter to skip Path: and Nntp-posting-host: etc. and NewsGrazer's and other uuencoded junk. ------------------------------------------------------------------------------- */ #import <appkit/appkit.h> #import <indexing/indexing.h> #import <stdio.h> #import <stdlib.h> #import <strings.h> #import <time.h> // Uncomment the following during debugging. See Console output. // #define MYDEBUG 1 static char *version = "[V0.93, Izumi Ohzawa, izumi@pinoko.berkeley.edu]"; // Timeout stuff static float timeoutvalue = 600.0; // wait this long before quitting. static float interval = 30.0; // timeout check interval static time_t timelast; // last time (in seconds) that this service is called. // String buffers. static char linebuf[8192]; static char subject[512]; static char poster[128]; static char date[128]; static char strbuf1[1024]; static char *reset1 = "reset1"; static char *reset2 = "reset2"; // The following must match the spec in "services" file. char *InPBType = "NXTypedFileContentsPboardType:news"; @interface Provider:Object { DPSTimedEntry timer; } - init; - step; - NewsDescribe:(id)pbid userData:(const char *)udata error:(char **)errmsg; - NewsFilter:(id)pbid userData:(const char *)udata error:(char **)errmsg; @end @implementation Provider // Returns a line in outbuf upto '\n' from inbuf, keeps current position. // Similar to fgets(), except it will read from another multi-line string. // If no more lines, returns NULL. // BUGS: must reset inbuf to something else before use. // char *sgets(char *outbuf, char *inbuf) { static char *lastinbuf=NULL; static char *cptr; static char *endbuf; // points to NULL char at the end of str. if(lastinbuf != inbuf) { // input string changed, so update current positions. cptr = inbuf; lastinbuf = inbuf; endbuf = inbuf + strlen(inbuf); } if(cptr == NULL || cptr >= endbuf) { // Reached end of inbuf. return(NULL); } else { // return next line. sscanf(cptr, "%[^\n]", outbuf); // no '\n' in outbuf strcat(outbuf, "\n"); // add '\n' at the end cptr = index(cptr, '\n'); // position cptr on next '\n'. if(cptr != NULL) cptr++; // point to the next line. return(outbuf); } } void runOneStep(DPSTimedEntry timedEntry, double timeNow, void *TEobject) { [(id)TEobject step]; } - init { time(&timelast); // initialize no-work timer. timer = DPSAddTimedEntry(interval, &runOneStep, self, NX_RUNMODALTHRESHOLD); [super init]; return self; } - step { time_t timenow; time(&timenow); if( (timenow - timelast) >= timeoutvalue) { DPSRemoveTimedEntry (timer); fprintf(stderr, "NewsFilter: No requests received for %.1f seconds. Quitting: %s", timeoutvalue, ctime(&timenow)); _exit(2); } return self; } // Key words for news description extraction. static char *desckwords[] = { "Subject:", "From:", "Lines:", "Date:" "" }; #define NDESCKEY 4 /* # of names in *desckwords[] */ // The main work-horse method to extract description line based on // Subject:, From:, and Date: lines from data passed via pasteboard. // - NewsDescribe:(id)pbid userData:(const char *)udata error:(char **)errmsg { char *newsdata; int length; int prmnumber, i, plen; int Done, subjectDone, posterDone, dateDone; char *ptr; time(&timelast); // refresh the no-work timer. if([pbid findAvailableTypeFrom:&InPBType num:1]) { // We have correct PB type. [pbid readType:InPBType data:&newsdata length:&length]; if(newsdata && length) { // PB has some actual data in it. // Some initializations. subject[0] = '\0'; // clear strings poster[0] = '\0'; date[0] = '\0'; sgets(linebuf, reset1); // need to reset this function... Done = subjectDone = posterDone = dateDone = 0; linebuf[0] = '\0'; // Read one line at a time get necessary info. while( (sgets(linebuf, newsdata) != NULL) && !Done ) { if(strlen(linebuf) <= 1) { Done = 1; break; } strbuf1[0] = '\0'; sscanf(linebuf, "%s", strbuf1); /* first word */ prmnumber = -1; for(i=0; i<NDESCKEY; i++) { if( strcasecmp( strbuf1, desckwords[i]) == 0 ) { prmnumber = i; break; } } /* --- lookup in *desckwords[] done ----- */ if( prmnumber != -1 ) { switch(prmnumber) { case 0: /* Subject: */ sscanf(linebuf, "%*s %[^\n]", subject); subjectDone = 1; break; case 1: /* From: */ if((ptr = index(linebuf, (int)'(')) != NULL) { /* From: eht@cs.cmu.edu (Eric Thayer) */ ptr++; sscanf(ptr, "%[^)]", poster); } else if((ptr = index(linebuf, (int)'<')) != NULL) { /* From: Daniel Stefan Decasper <dsdecasp@iiic.ethz.ch> */ sscanf(linebuf, "%*s %[^<]", poster); plen = strlen(poster); if(poster[plen-1] == ' ') poster[plen-1] = '\0'; } else { /* From: kent@infoserv.com */ sscanf(linebuf, "%*s %s", poster); } posterDone = 1; break; case 2: /* Lines: */ /* It turns out the I can't rely on Lines: to find * the end of header section. Lines: does not come * last in the header as I initially assumed. Now, * look for the first blank line instead. */ // Done = 1; break; case 3: /* Date: */ sscanf(linebuf, "%*s %[^\n]", date); dateDone = 1; break; default: /* should not happen */ break; } /* end of switch() */ } /* end if( prmnumber != -1 ) */ // Check for Done flags if(subjectDone && posterDone && dateDone) Done = 1; } /* end of while( (sgets .. )) loop */ sprintf(linebuf, "%s -- (%s), %s\n", subject, poster, date); // Send the description back on pasteboard. [pbid declareTypes:&IXFileDescriptionPboardType num:1 owner:self]; [pbid writeType:IXFileDescriptionPboardType data:linebuf length:strlen(linebuf)]; #ifdef MYDEBUG fprintf(stderr, "%s", linebuf); #endif } /* end if(newsdata && length) */ else *errmsg = "No actual data found on pasteboard."; [pbid deallocatePasteboardData:newsdata length:length]; } /* end if(types[i]) */ else *errmsg = "No good PBoard type."; return self; } // These skip and done words are hard coded as below currently. // Ideally, these should be modifiable via a word list file included in // ~/Library/Services/NewsIndexing.service directory (or /LocalLibrary...) // Path to this directory should be obtainable via argv[0] in main(). // I am not going to do this, so if there are any takers, please! // // Line skip words that cause entire line to be filtered out. static char *lskipwords[] = { "Path:", "Nntp-Posting-Host:", "" }; #define NLSKIP 2 /* # of names in *lskipwords[] */ // Perhaps, I should combine these into a paird struct of string and number. // Done strings that will flush the rest of the article from this line on. static char *donestring[] = { "-- NewsGrazer, a NeXTstep(tm)", "" }; // Length of each of donestring above static int donecount[] = { 29, 0 }; #define NDONE 1 /* # of names in *donestring[] */ // News article filter service method that removes junk (see top of this file) // from article text before it is passed to indexing scanner. // DigitalLibrarian calles this method with full article content on the // pasteboard of type "NXTypedFileContentsPboardType:news". // This method is called before the description filter service // -NewsDescribe:..... method is called. // - NewsFilter:(id)pbid userData:(const char *)udata error:(char **)errmsg { NXStream *outStream; char *outBuffer; int outLen, dummy; char *newsdata; int length; int prmnumber, i; int Done; time(&timelast); // refresh the no-work timer. if([pbid findAvailableTypeFrom:&InPBType num:1]) { // We have correct PB type. [pbid readType:InPBType data:&newsdata length:&length]; if(newsdata && length) { // PB has some actual data in it. // Some initializations. outStream = NXOpenMemory(NULL, 0, NX_WRITEONLY); // create memory stream sgets(linebuf, reset2); // need to reset this function... Done = 0; linebuf[0] = '\0'; // Read one line at a time get necessary info. while( (sgets(linebuf, newsdata) != NULL) && !Done ) { // First, see if we want to skip this line. strbuf1[0] = '\0'; sscanf(linebuf, "%s", strbuf1); /* first word */ if( (strlen(strbuf1) == 61) && (strbuf1[0] == 'M')) { #ifdef MYDEBUG // Debug: print 'u' for each line of uuencoded junk removed. fputc('u', stderr); #endif continue; /* one word of 61 chars must be uuencoded stuff */ } prmnumber = -1; for(i=0; i<NLSKIP; i++) { if( strcasecmp(strbuf1, lskipwords[i]) == 0 ) { prmnumber = i; // Match found break; } } if(prmnumber != -1) { #ifdef MYDEBUG fprintf(stderr," Skip line: %s", linebuf); #endif continue; // There was a match. Try next line } // Now, check if we want to kill the rest of article prmnumber = -1; for(i=0; i<NDONE; i++) { if( strncasecmp( linebuf, donestring[i], donecount[i]) == 0 ) { prmnumber = i; break; } } if(prmnumber != -1) { // There was a match to donstring[]. #ifdef MYDEBUG fprintf(stderr," Kill to EOF: %s", linebuf); #endif Done = 1; // Raise DONE flag to kill article to EOF. continue; // go to top to get kicked out of while(.. && !Done).. } // We want this line. So write to stream. NXPrintf(outStream, "%s", linebuf); } /* end of while( (sgets .. )) loop */ NXFlush(outStream); NXGetMemoryBuffer(outStream, &outBuffer, &outLen, &dummy); // Send the description back on pasteboard. [pbid declareTypes:&NXAsciiPboardType num:1 owner:self]; [pbid writeType:NXAsciiPboardType data:outBuffer length:outLen]; NXCloseMemory(outStream, NX_FREEBUFFER); } /* end if(newsdata && length) */ else *errmsg = "No actual data found on pasteboard."; [pbid deallocatePasteboardData:newsdata length:length]; } /* end if(types[i]) */ else *errmsg = "No good PBoard type."; return self; } @end int main(int argc, char *argv[]) { id lid; #ifdef MYDEBUG int i; #endif time(&timelast); fprintf(stderr, "NewsFilter.deamon for DLibrarian indexing started: %s %s\n", ctime(&timelast), version); #ifdef MYDEBUG for(i=0; i<argc; i++) fprintf(stderr, "argv[%d]: %s\n", i, argv[i]); #endif lid = [[Listener alloc] init]; [lid setServicesDelegate:[[Provider alloc] init]]; if([lid checkInAs:"IXNEWSFILTER"]) _exit(1); // uh-oh! [lid addPort]; [Listener run]; return 0; }
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.