Package detail

gatsby-core-utils

gatsbyjs2.3mMIT4.15.0

A collection of gatsby utils used in different gatsby packages

gatsby, gatsby-core-utils

readme

`gatsby-core-utils`

Utilities used in multiple Gatsby packages.

Usage

npm install gatsby-core-utils

createContentDigest

Encrypts an input using md5 hash of hexadecimal digest.

const { createContentDigest } = require("gatsby-core-utils")

const options = {
  key: "value",
  foo: "bar",
}

const digest = createContentDigest(options)
// ...

cpuCoreCount

Calculate the number of CPU cores on the current machine

This function can be controlled by an env variable GATSBY_CPU_COUNT setting the first argument to true.

value	description
\| Counts amount of real cores by running a shell command
`logical_cores`	`require("os").cpus()` to count all virtual cores
any number	Sets cpu count to that specific number

const { cpuCoreCount } = require("gatsby-core-utils")

const coreCount = cpuCoreCount(false)
// ...

const { cpuCoreCount } = require("gatsby-core-utils")
process.env.GATSBY_CPU_COUNT = "logical_cores"

const coreCount = cpuCoreCount()
// ...

joinPath

A utility that joins paths with a / on windows and unix-type platforms. This can also be used for URL concatenation.

const { joinPath } = require("gatsby-core-utils")

const BASEPATH = "/mybase/"
const pathname = "./gatsby/is/awesome"
const url = joinPath(BASEPATH, pathname)
// ...

isCI

A utility that enhances isCI from 'ci-info` with support for Vercel and Heroku detection

const { isCI } = require("gatsby-core-utils")

if (isCI()) {
  // execute CI-specific code
}
// ...

getCIName

A utility that returns the name of the current CI environment if available, null otherwise

const { getCIName } = require("gatsby-core-utils")

const CI_NAME = getCIName()
console.log({ CI_NAME })
// {CI_NAME: null}, or
// {CI_NAME: "Vercel"}
// ...

createRequireFromPath

A cross-version polyfill for Node's Module.createRequire.

const { createRequireFromPath } = require("gatsby-core-utils")

const requireUtil = createRequireFromPath("../src/utils/")

// Require `../src/utils/some-tool`
requireUtil("./some-tool")
// ...

Mutex

When working inside workers or async operations you want some kind of concurrency control that a specific work load can only concurrent one at a time. This is what a Mutex does.

By implementing the following code, the code is only executed one at a time and the other threads/async workloads are awaited until the current one is done. This is handy when writing to the same file to disk.

const { createMutex } = require("gatsby-core-utils/mutex")

const mutex = createMutex("my-custom-mutex-key")
await mutex.acquire()

await fs.writeFile("pathToFile", "my custom content")

await mutex.release()

Hashing

Parts of hash-wasm are re-exported from gatsby-core-utils or used in custom functions. When working on hashing where you'd normally use crypto from Node.js, you can use these functions instead. They especially show their advantage on large inputs so don't feel obliged to always use them. Refer to hash-wasm's documentation for more details on usage for the re-exported functions.

const { md5File, md5, createMD5, sha256, sha1 } = require("gatsby-core-utils")

// For md5, createMD5, sha256, sha1 refer to hash-wasm
await md5(`some-string`)

// md5File gives you the MD5 hex hash for a given filepath
await md5File(`package.json`)

changelog

Changelog: `gatsby-core-utils`

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

Package detail

readme

gatsby-core-utils

Usage

createContentDigest

cpuCoreCount

joinPath

isCI

getCIName

createRequireFromPath

Mutex

Hashing

changelog

Changelog: gatsby-core-utils

4.14.0 (2024-11-06)

Bug Fixes

4.13.1 (2024-01-23)

4.13.0 (2023-12-18)

Bug Fixes

4.12.1 (2023-10-26)

Bug Fixes

4.12.0 (2023-08-24)

Bug Fixes

Chores

4.11.0 (2023-06-15)

Bug Fixes

Chores

4.10.0 (2023-05-16)

4.9.0 (2023-04-18)

Bug Fixes

Chores

4.8.0 (2023-03-21)

4.7.0 (2023-02-21)

4.6.0 (2023-02-07)

Bug Fixes

Chores

4.5.0 (2023-01-24)

Features

Chores

4.4.0 (2023-01-10)

Chores

Other Changes

4.3.1 (2022-12-14)

Other Changes

4.3.0 (2022-12-13)

Bug Fixes

Chores

4.2.0 (2022-11-25)

4.1.0 (2022-11-22)

Bug Fixes

4.0.0 (2022-11-08)

Bug Fixes

Chores

3.24.0 (2022-09-27)

Bug Fixes

3.23.0 (2022-09-13)

3.22.0 (2022-08-30)

3.21.0 (2022-08-16)

Chores

Other Changes

3.20.0 (2022-08-02)

Chores

3.19.0 (2022-07-19)

Bug Fixes

3.18.1 (2022-07-12)

Bug Fixes

3.18.0 (2022-07-05)

Bug Fixes

3.17.0 (2022-06-21)

Chores

3.16.0 (2022-06-07)

Features

Chores

3.15.0 (2022-05-24)

Chores

3.14.0 (2022-05-10)

Bug Fixes

Chores

3.13.0 (2022-04-26)

3.12.1 (2022-04-13)

`gatsby-core-utils`

Changelog: `gatsby-core-utils`