pgxn_meta 0.7.0

The PGXN distribution metadata specification
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://pgxn.org/meta/v2/artifacts.schema.json",
  "title": "Artifacts",
  "description": "*Artifacts* describes non-PGXN links and checksums for downloading the distribution in one or more formats, including source code, binaries, system packages, etc. Consumers **MAY** use this information to determine the best option for installing an extension on a particular system. Useful for projects that publish their own binaries, such as in GitHub releases.",
  "type": "array",
  "minItems": 1,
  "items": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "The URL to download the artifact."
      },
      "type": {
        "type": "string",
        "minLength": 2,
        "pattern": "^[a-z0-9]{2,}$",
        "description": "The type of artifact. **MUST** be a single lowercase word describing the artifact, such as none of `binary`, `source`, `rpm`, `homebrew`, etc."
      },
      "platform": {
        "$ref": "platform.schema.json",
        "description": "Identifies the platform the artifact was built for. **RECOMMENDED** for packages compiled for a specific platform, such as a C extension compiled for `linux-arm64`."
      },
      "sha512": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{128}$",
        "description": "The SHA-512 checksum for the artifact in hex format."
      }
    },
    "required": ["url", "type", "sha512"],
    "patternProperties": { "^[xX]_.": { "description": "Custom key" } },
    "additionalProperties": false
  },
  "examples": [
    [
      {
        "type": "source",
        "url": "https://github.com/theory/pg-pair/releases/download/v1.1.0/pair-1.1.0.zip",
        "sha512": "55570a7de3f0dcf714c25f5d7f1eaf2f00c9a093e02e113d65f479368f30e93b5a2475c3452d63df89b5f612ac99be538acc08c2eb82a9d536f27562dca9482f"
      },
      {
        "type": "binary",
        "url": "https://github.com/theory/pg-pair/releases/download/v1.1.0/pair-1.1.0-linux-amd64.tar.gz",
        "sha512": "f140129b1b3ed7b4ef123e18abe695acc32167e9d452afd0265ed2f2781777f813c614482e7516bbeb1c92d9ed2f62e7b1b4296102cd5c3a22049a3b2d51c3bd"
      },
      {
        "type": "binary",
        "url": "https://github.com/theory/pg-pair/releases/download/v1.1.0/pair-1.1.0-linux-arm64.tar.gz",
        "sha512": "612ad0a8b7e292daf0c723bd0ac8029a838357b2d3abbada7cd7445f7690191abd6593a1336742e705314df81fc1c0063423f62e4abd846f350c251ef6a6a24f"
      }
    ]
  ]
}