Nobody Publish Monsters

    TypeScript icon, indicating that this package has built-in type declarations

    1.4.9 • Public • Published


    Iterative file and text processing.


    npm i glob-reader


    This package is pure ESM, please read the esm-package.

    import { readGlobSync } from 'glob-reader'
    const files = readGlobSync('./src/**/*.md')
    for (const file of files) {
      // processing file here (i.e. transforms markdown to html)
      // rename file
      file.rename({ extname: '.html', dirname: './dist' })
      // writes .html file to ./dist directory

    See the File section for more information.



    readGlob(patterns, options?): AsyncGenerator<File>

    Asynchronously expands glob patterns for iterative file and text processing.

    import { readGlob } from 'glob-reader'
    import { transform } from '@swc/core'
    const files = readGlob('./src/**/*.{ts,tsx}', 'utf8')
    for await (const file of files) {
      // transform ts/tsx to js using `swc`
      const { code } = await transform(file.value)
      file.value = code
      file.rename({ extname: '.js', dirname: './dist' })
      // writes .js file to ./dist directory
      await file.write()


    Name Type
    patterns string | readonly string[]
    options? BufferEncoding | Options




    readGlobSync(patterns, options?): Generator<File>

    Expands glob patterns for iterative file and text processing.

    import { readGlob } from 'glob-reader'
    import sass from 'sass'
    const files = readGlobSync('./src/**/*.scss')
    for (const file of files) {
      // compile scss to css
      const { css, sourceMap } = sass.compileString(file.toString(), {
        sourceMap: true,
        style: 'expanded'
      // NOTE: We doesn't automatically add a `sourceMappingURL` comment to the `file.value`.
      // It's up to setters to do that, since setters have full knowledge of where the `file.value`
      // and the `` will exist in relation to one another and how they'll be served.
      file.value = `${css}\n//# sourceMappingURL=${file.path}.map\n` = sourceMap
      file.rename({ extname: '.css', dirname: './dist' })
      // writes .css and file to ./dist directory


    Name Type
    patterns string | readonly string[]
    options? BufferEncoding | Options



    Options: Properties


    Optional cwd: string

    Base of path.

    default process.cwd()


    Optional concurrency: number

    Specifies the maximum number of concurrent requests from a reader to read directories.

    The higher the number, the higher the performance and load on the file system. If you want to read in quiet mode, set the value to a comfortable number or 1.

    default os.cpu().length


    Optional caseSensitiveMatch: boolean

    Enables a case-sensitive mode for matching files.

    default true


    Optional ignore: string[]

    An array of glob patterns to exclude matches.

    default []


    Optional encoding: BufferEncoding

    The buffer encoding to use when reading files.

    default Buffer


    Optional stripMatter: boolean

    If true, it will removes the YAML front matter from the file.value.

    default false


    Optional fsStats: boolean

    If true, the file will provides information about the fs.Stats.

    default false


    Optional dry: boolean

    If true, it will not read the file contents and stat, also it will prevent write and delete method.

    default false


    Virtual file object.

    const analyze = readGlob('./src/', { dry: true })
    for await (const file of analyze) {
      // raw value
      file.value // => Buffer|string|null
      // encoded value
      file.toString() // => empty string due to `dry: true` option.
      // the byte length of file
      file.bytes // => 0 due to `dry: true` option.
      // human readable byte length of file
      file.size // => '0B'
      // base of path
      file.cwd // => process.cwd() value
      // path of file, can be set using file `path` or file `URL`
      file.path // => './src/'
      // current name (including extension) of file
      file.basename // => ''
      // name (without extension) of file
      file.stem // => 'foo'
      // extension (with dot) of file
      file.extname // => '.md'
      // path to parent directory of file
      file.dirname // => './src'
      // renames and mutates the file internally.
      file.rename({ extname: '.html', dirname: './dist' })
      // list of file-paths the file moved between
      file.history // => ['./src/', './dist/foo.html']
      // place to store custom information. // => { matter: {}, stat: {} } // => empty data stat due to `dry: true` option.
      // add custom data to file. = 'bar' // => { matter: {}, stat: {}, foo: 'bar' }
      // diagnostics storage
      file.messages // => []
      // associates an informational message with the file'some information')
      // associates a message with the file
      file.message('`gloob` is misspelt; did you mean `glob`?', {
        line: 2,
        column: 4
      // writes to ./dist/foo.html
      await file.write()
      // removes ./dist/foo.html
      await file.remove()
      // writes to ./dist/foo.html synchronously
      // removes ./dist/foo.html synchronously
      // prints diagnostics to console
      // src/
      //   1:1  info     some message
      //   2:4  warning  `gloob` is misspelt; did you mean `glob`?
      // 2 messages (⚠ 1 warning)

    Read more information about the file below.


    Enable/disable dry run for specific file.

    const analyze = readGlob('./src/*')
    // writes all files to ./dist directory except for
    for await (const file of analyze) {
      // prevent `foo` file from being written but keep processing
      if ('foo')) {
        file.dry = true
      // processing file here...
      file.rename({ extname: '.html', dirname: './dist' })
      await file.write()


    Tests if file passes the given check.

    // file.path = './src/''.md') // => true'*.md') // => false'**/*.md') // => true'**/*.{md,html}') // => true'**/*.{mdx,jsx}') // => false{ stem: 'foo' }) // => true{ stem: { suffix: 'oo' } }) // => true{ stem: 'bar' }) // => false

    file#fail(reason[, position][, origin])

    Associates a fatal message with the file, then immediately throws it. Note: fatal errors mean a file is no longer processable.

    // use try/catch to handle fatal errors
    try { ReferenceError('foo is not defined'))
    } catch {}
    console.log(file.reporter({ defaultName: 'Oh snap!' }))
    // Oh snap!
    //  1:1  error  ReferenceError: foo is not defined
    //  at foo.js:1:1
    //  at ...


    Returns diagnostic information about the file.

    reporter `Options` interface
       * Label to use for file without `file.path`. If no `file.path` and no
       * `defaultName` is given, `no name` will show up in the report.
      defaultName?: string
       * Output long form descriptions of messages, if applicable.
       * @default false
      verbose?: boolean
       * Do not output anything for a file which has no warnings or errors.
       * The default behavior is to show a success message.
       * @default false
      quiet?: boolean
       * Only output messages with fatal error. Also sets `quiet` to `true`.
       * @default false
      silent?: boolean
       * Whether to use color. The default behavior is the check if color is
       * supported.
      color?: boolean


    Running glob-reader...
    readGlob x 2,034 ops/sec ±3.28% (75 runs sampled)
    readGlobSync x 6,599 ops/sec ±2.48% (79 runs sampled)
    Fastest: readGlobSync


    We 💛  issues.

    When committing, please conform to the semantic-release commit standards. Please install commitizen and the adapter globally, if you have not already.

    npm i -g commitizen cz-conventional-changelog

    Now you can use git cz or just cz instead of git commit when committing. You can also use git-cz, which is an alias for cz.

    git add . && git cz

    Thank you

    A project by Stilearning © 2022.


    npm i glob-reader

    DownloadsWeekly Downloads






    Unpacked Size

    38.1 kB

    Total Files


    Last publish


    • bent10