npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

parse-segment

v1.5.4

Published

string wrapper that keeps track of its original location in a file

Downloads

7

Readme

parse-segment

CircleCI Coverage Status semantic-release Commitizen friendly npm version

string wrapper that keeps track of its original location in a file

Example

import { Segment } from 'parse-segment'

const data = new Segment({
  value: `no matter how you slice
this, it still knows where
it came from
`,
  source: 'foo.txt',
})

console.log(data.substring(32, 39).trim().underlineInContext())

Output:

this, it still knows where
         ^^^^^

API

Segment

Represents a string value plus information about its location in a source file. Segment has the same methods as JS strings, but its methods instances of Segment that retain their location information:

  • charAt
  • charCodeAt
  • codePointAt
  • endsWith
  • indexOf
  • includes
  • lastIndexOf
  • localeCompare
  • match
  • search
  • slice
  • startsWith
  • substring
  • split
  • trimStart
  • trimEnd
  • trim

However, methods that change the text beyond slicing it up, like toUpperCase, replace, etc. are excluded.

new Segment(options)

options.value: string (required)

The string text

options.source: any (required)

Where the text came from, for example, a file path or URL

options.startLine: number (optional, default: 0)

The line on which the segment begins, starting with 0.

options.startCol: number (optional, default: 0)

The column on which the segment begins, starting with 0.

.value: string

The string text

.source: any

Where the text came from, for example, a file path or URL

.startLine: number

The line on which the segment begins, starting with 0.

.startCol: number

The column on which the segment begins, starting with 0.

.endLine: number

The line on which the segment ends, starting with 0.

.endCol: number

The column on which the segment ends, starting with 0.

.length: number

The length of the text

.underlineInContext(): string

Returns the lines of text on which this segment occurs, interleaved with lines containing ^^^^ underlining the portion the segment represents.

SegmentParser

A handy class for parsing text as a Segment and throwing contextual errors if necessary.

new SegmentParser(segment: Segment)

Creates a parser on segment starting at index 0.

.segment: Segment

The Segment being parsed.

.index: number

The current parse position within segment.

.skip(rx: RegExp)

Moves index past the next occurrence of rx. Returns true if anything was skipped, false otherwise.

.match(rx: RegExp, messageIfMissing: string): RegExp$matchResult & { segment: Segment }

Checks if segment has a match for rx at the current index. If so, returns it and moves index past it. If not, throws a SegmentParseError with messageIfMissing.

.nextDelimited(rx: RegExp, messageIfMissing?: string): Segment

Moves the index past the next match for rx, and returns the sub-Segment from the starting index up to the match. For example, .nextDelimited(/\r\n?|\n/mg) will return the rest of the current line and move to the next line. If messageIfMissing is given, will throw a SegmentParseError if no match for rx is found beyond the current index. Otherwise, it will return the sub-Segment from the current index all the way to the end.

.expect(str: String, messageIfMissing: string): void

Checks if segment contains str at the current index. If so, moves index past it. If not, throws a SegmentParseError with messageIfMissing.

.expectIgnoreCase(str: String, messageIfMissing: string): void

Same as .expect, but performs a case-insensitive comparison.

.currentChar(): string

Returns a string containing only the character at the current index.

.isAtEnd(): boolean

Returns true if the current index is at the end of the segment, false otherwise.

.isAtEndOfLine(): boolean

Returns true if the current index is at the end of a line, false otherwise.