find-versions

What is find-versions?

The find-versions npm package is designed to extract version numbers from strings. It is useful for parsing and identifying version numbers in various formats from text, allowing developers to easily extract and manipulate version information programmatically.

What are find-versions's main functionalities?

Extracting version numbers from strings

This feature allows you to extract version numbers from a given string. The function returns an array of version numbers found within the string. It's particularly useful for parsing logs, documents, or any text content that may contain version numbers.

"const findVersions = require('find-versions');\nconsole.log(findVersions('unicorn v1.2.3')); //=> ['1.2.3']"

Extracting version numbers with options

This feature extends the basic functionality by allowing you to specify options for the extraction process. For example, setting the 'loose' option to true enables the function to match version numbers that don't strictly follow semantic versioning.

"const findVersions = require('find-versions');\nconsole.log(findVersions('cat 1.2.3 and dog 4.5.6', {loose: true})); //=> ['1.2.3', '4.5.6']"

Other packages similar to find-versions

semver

The semver package is a module for semantic versioning. It provides utilities for parsing and comparing semantic versions. While it focuses on semantic versioning, find-versions is more general-purpose, extracting version numbers from strings regardless of their format.

validate-version

validate-version is a package that allows you to check if a string is a valid semantic version. Unlike find-versions, which extracts version numbers from arbitrary text, validate-version focuses on validating the format of version strings.

README

find-versions

Find semver versions in a string: unicorn 1.0.0 → 1.0.0

Install

$ npm install --save find-versions

Usage

var findVersions = require('find-versions');

findVersions('unicorn 1.0.0 rainbow v2.3.4+build.1');
//=> ['1.0.0', '2.3.4+build.1']

findVersions('cp (GNU coreutils) 8.22', {loose: true});
//=> ['8.22.0']

API

findVersions(input, options)

input

Required
Type: string

options.loose

Type: boolean
Default: false

Also match non-semver versions like 1.88.
They're coerced into semver compliant versions.

CLI

$ npm install --global find-versions

$ find-versions --help

  Usage
    $ find-versions <string> [--first] [--loose]
    $ echo <string> | find-versions

  Example
    $ find-versions 'unicorns v1.2.3'
    1.2.3

    $ curl --version | find-versions --first
    7.30.0

  Options
    --first  Return the first match
    --loose  Match non-semver versions like 1.88

License

MIT © Sindre Sorhus