Skip to content

Latest commit

 

History

History
158 lines (99 loc) · 5.19 KB

readme.md

File metadata and controls

158 lines (99 loc) · 5.19 KB

#simple-doc

##creating a simple readme from inline documentation

###test/function-proto.js

###test/functions.js

###test/proto.js

  • Parser - A class for parsing sococo log files and emitting structured data
##Parser • [top](#top)

Location: test/function-proto.js

A class for parsing sococo log files and emitting structured data

This conforms to the node Stream base class, and can be chained together with other stream filters using the .pipe() method. This class expects data to be in line format rather than chunks of data coming directly from the file. You can use readFile to pass in a file directly, and it will convert into buffered lines for you.

var p = new Parser();
p.on('data', function(data){
    console.log(data);
});
p.on('end', function(){
    console.log('parsing complete');
});
p.readFile('test-log.txt');
###[Parser](#test/function-proto.js/Parser)#readFile(file)

Helper method for reading a file into the log parser directly.

Assumes first line of the file is going to be a header, so skips it for parsing. Buffers input until newline, then feeds each line into the parser. When its finished, it emits an end event. Because parsing is synchronous, you can depend on parsing being complete.

###[Parser](#test/function-proto.js/Parser)#write(line)

Write log file lines to be parsed

Conforming to the stream api, mostly so you can parse together data transform streams. This stream expects lines in string format.

###[Parser](#test/function-proto.js/Parser)#parseTransportData(line)

Parse sococo transport data out of a log line

We have a header on log messages that conforms roughly to a {{name:value;name:value}} format. This method parses that data off raw log message and returns a javascript object. ##Parser • top

Location: test/proto.js

A class for parsing sococo log files and emitting structured data

This conforms to the node Stream base class, and can be chained together with other stream filters using the .pipe() method. This class expects data to be in line format rather than chunks of data coming directly from the file. You can use readFile to pass in a file directly, and it will convert into buffered lines for you.

var p = new Parser();
p.on('data', function(data){
    console.log(data);
});
p.on('end', function(){
    console.log('parsing complete');
});
p.readFile('test-log.txt');
###[Parser](#test/proto.js/Parser)#readFile(file)

Helper method for reading a file into the log parser directly.

Assumes first line of the file is going to be a header, so skips it for parsing. Buffers input until newline, then feeds each line into the parser. When its finished, it emits an end event. Because parsing is synchronous, you can depend on parsing being complete.

###[Parser](#test/proto.js/Parser)#write(line)

Write log file lines to be parsed

Conforming to the stream api, mostly so you can parse together data transform streams. This stream expects lines in string format.

###[Parser](#test/proto.js/Parser)#parseTransportData(line)

Parse sococo transport data out of a log line

We have a header on log messages that conforms roughly to a {{name:value;name:value}} format. This method parses that data off raw log message and returns a javascript object. ###ATestFunction2(stuff, things) • top

Location: test/function-proto.js

A test function summary for a second function

With a full summary

ATestFunction2(stuff, things);
###functions.js(stuff, things) • [top](#top)

Location: test/functions.js

A test function summary

With a full summary

ATestFunction(stuff, things);
###ATestFunction2(stuff, things) • [top](#top)

Location: test/functions.js

A test function summary for a second function

With a full summary

ATestFunction2(stuff, things);