Security News
Combatting Alert Fatigue by Prioritizing Malicious Intent
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
intertext-splitlines
Advanced tools
Table of Contents generated with DocToc
InterText SplitLines facilitates splitting and assembling buffers into neat, decoded lines of text.
In case you have one or more buffers with textual content, the simplest way to use InterText SplitLines
is to use the splitlines()
method which will return a list of strings, each representing one line:
# For demonstration, let's assemble a number of buffers with lines
# randomly spread all over the place:
buffers = [
"helo"
" there!\nHere "
"come\na few lines\n"
"of text that are\nquite unevenly "
"spread over several\n"
"buffers.", ]
buffers = ( Buffer.from d for d in buffers )
# Now that we have a number of buffers, let's split them into text lines:
SL = require 'intertext-splitlines'
lines = SL.splitlines buffers
# lines = SL.splitlines buffers... # can call with list or spread out, as seen fit
# lines = SL.splitlines buffer_1, buffer_2, buffer_3
# lines now contains:
[ 'helo there!',
'Here come',
'a few lines',
'of text that are',
'quite unevenly spread over several',
'buffers.', ]
Observe that newline characters will be removed from the output so there's no way to determine whether the last line did or did not end with a newline; this should be the desired result most of the time. In the event that a trailing newline should be detectable, pass in an explicit setting:
lines = SL.splitlines { skip_empty_last: false, }, buffers
data
event),
call SL.walk_lines ctx, buffer
with that data; this returns an iterator over the decoded complete lines
in the buffer, if anySL.flush ctx
to receive another iterator over the last line, if anyIn JavaScript:
// for each buffer received, do:
for ( line of SL.walk_lines( ctx, buffer ) )
{ do_something_with( line ) };
// after the last buffer has been received, do:
for ( line of SL.flush( ctx ) )
{ do_something_with( line ) };
In CoffeeScript:
# for each buffer received, do:
for line from SL.walk_lines ctx, buffer
do_something_with line
# after the last buffer has been received, do:
for line from SL.flush ctx
do_something_with line
?splitter <nonempty ( text | buffer )> = '\n'
—the sequence of characters that mark linebreaks?decode <boolean> = true
—whether or not to decode buffers as UTF-8. NOTE to be replaced by
encoding
.?skip_empty_last <boolean> = true
—whether to emit an emtpy string as last item when the source ended
in splitter
.?keep_newlines <boolean> = false
—whether to return strings or buffers that end in whatever
splitter
is set to. That is abc/def
with settings { splitter: '/', keep_newlines: false, }
would
split into [ 'abc', 'def', ]
, wheras with { keep_newlines: true, }
, the result would be [ 'abc/', 'def', ]
find_first_match()
, replace by buffer.indexOf()
implement splitlines()
implement setting skip_empty_last
publish v1.1.0
fix treatment of last line when emitting buffers
publish v1.1.1
keep_newlines
encoding
FAQs
split streaming buffers into neat, decoded lines of text
We found that intertext-splitlines demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.