semver.scalingo.com

semver.scalingo.com is a plaintext and JSON webservice that tracks all available versions of:

• nginx
• php
• python
• ruby

It also supports Scalingo Stacks for nginx, php and composer:

• Nginx: /nginx-${stack}/versions
• PHP: /php-${stack}/versions
• Composer: /composer-${stack}/versions

It uses that version info to resolve semver range queries.

This project if a fork of github.com/heroku/semver.io.

Scalingo Semver uses a simple and short module system to pull version data from a variety of sources. Pull requests are welcome!

Usage

Command-line

curl https://semver.scalingo.com/node/stable
0.10.33

curl https://semver.scalingo.com/node/unstable
0.11.14

curl https://semver.scalingo.com/node/resolve/0.8.x
0.8.28

curl https://semver.scalingo.com/nginx/stable
1.6.2

In the browser

There are CORS-friendly HTTP endpoints for each source with the whole kit and caboodle:

• semver.scalingo.com/nginx.json
• semver.scalingo.com/php.json

The response is something like:

{
  "stable": "0.10.22",
  "unstable": "0.11.8",
  "all": [
    "0.8.6",
    "...",
    "0.11.9"
  ]
}

Ranges

semver.scalingo.com supports any range that node-semver can parse.

For example:

• /php-scalingo-22/resolve/8.4.x
• /php-scalingo-22/resolve/>=8.4.2
• /php-scalingo-22/resolve/~8.4.2
• /php-scalingo-22/resolve/>=8.2.0 <8.3

These named routes are also provided for convenience (for each source):

• /nginx/unstable
• /php-scalingo-22/versions

Links

• Original repository
• Semantic Versioning Specifications
• NPM documentation about Semantic Versioning

Development Environment

Install project dependencies

docker compose run --rm web npm install

Run the service

docker compose up