Package.json

Date de création : 2020/12/03 15:20

Le fichier package.json permet de configurer angular. Il y a quelques paramètre à connaitre:

Docs.npnjs

Dependencies are specified in a simple object that maps a package name to a version range. The version range is a string which has one or more space-separated descriptors. Dependencies can also be identified with a tarball or git URL.

Please do not put test harnesses or transpilers in your dependencies object. See devDependencies, below.

See semver for more details about specifying version ranges.

• version Must match version exactly
• >version Must be greater than version
• >=version etc
• <version
• ⇐version
• ~version “Approximately equivalent to version” See semver
• ^version “Compatible with version” See semver
• 1.2.x 1.2.0, 1.2.1, etc., but not 1.3.0
• http://... See 'URLs as Dependencies' below
• * Matches any version
• “ ” (just an empty string) Same as *
• version1 - version2 Same as >=version1 ⇐version2.
• range1 || range2 Passes if either range1 or range2 are satisfied.
• git… See 'Git URLs as Dependencies' below
• user/repo See 'GitHub URLs' below
• tag A specific version tagged and published as tag See npm dist-tag
• path/path/path See Local Paths below

{ "dependencies" :
  { "foo" : "1.0.0 - 2.9999.9999"
  , "bar" : ">=1.0.2 <2.1.2"
  , "baz" : ">1.0.2 <=2.3.4"
  , "boo" : "2.0.1"
  , "qux" : "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0"
  , "asd" : "http://asdf.com/asdf.tar.gz"
  , "til" : "~1.2"
  , "elf" : "~1.2.3"
  , "two" : "2.x"
  , "thr" : "3.3.x"
  , "lat" : "latest"
  , "dyl" : "file:../dyl"
  }
}

N'importe lequel de X, x ou * peut être utilisé pour “remplacer” l'une des valeurs numériques du

[major, minor, patch]tuple.

• *: = >=0.0.0(Toute version satisfait)
• 1.x: = >=1.0.0 <2.0.0(Correspondant à la version principale)
• 1.2.x: = >=1.2.0 <1.3.0(Correspondance des versions majeures et mineures)

Une plage de versions partielle est traitée comme une plage X, donc le caractère spécial est en fait facultatif.

• “”(chaîne vide): = *: ⇒=0.0.0
• 1: = 1.x.x: ⇒=1.0.0 <2.0.0
• 1.2: = 1.2.x: ⇒=1.2.0 <1.3.0

Permet les modifications au niveau du correctif si une version mineure est spécifiée sur le comparateur. Permet des modifications de niveau mineur sinon.

• ~1.2.3: = >=1.2.3 <1.(2+1).0: ⇒=1.2.3 <1.3.0
• ~1.2: = >=1.2.0 <1.(2+1).0: = >=1.2.0 <1.3.0(Identique à 1.2.x)
• ~1: = >=1.0.0 <(1+1).0.0: = >=1.0.0 <2.0.0(Identique à 1.x)
• ~0.2.3: = >=0.2.3 <0.(2+1).0: ⇒=0.2.3 <0.3.0
• ~0.2: = >=0.2.0 <0.(2+1).0: = >=0.2.0 <0.3.0(Identique à 0.2.x)
• ~0: = >=0.0.0 <(0+1).0.0: = >=0.0.0 <1.0.0(Identique à 0.x)
• ~1.2.3-beta.2: = >=1.2.3-beta.2 <1.3.0Notez que les avant- 1.2.3versions de la version seront autorisées, si elles sont supérieures ou égales à beta.2. Donc, 1.2.3-beta.4serait autorisé, mais 1.2.4-beta.2ne le serait pas, car il s'agit d'une version préliminaire d'un [major, minor, patch]tuple différent .

Autorise les modifications qui ne modifient pas le chiffre différent de zéro le plus à gauche dans le [major, minor, patch]tuple. En d'autres termes, cela permet des correctifs et des mises à jour mineures pour les versions 1.0.0et supérieures, des mises à jour de correctifs pour les versions 0.X >=0.1.0et aucune mise à jour pour les versions 0.0.X.

De nombreux auteurs traitent une 0.xversion comme si elle xétait le principal indicateur de «rupture de stock».

Les plages de curseur sont idéales lorsqu'un auteur peut apporter des modifications importantes entre les versions 0.2.4et 0.3.0, ce qui est une pratique courante. Cependant, cela suppose qu'il n'y aura pas de changements de rupture entre 0.2.4et 0.2.5. Il permet des changements supposés additifs (mais non cassants), selon les pratiques couramment observées.

• ^1.2.3 : = >=1.2.3 <2.0.0
• ^0.2.3 : = >=0.2.3 <0.3.0
• ^0.0.3 : = >=0.0.3 <0.0.4
• ^1.2.3-beta.2: = >=1.2.3-beta.2 <2.0.0Notez que les avant- 1.2.3versions de la version seront autorisées, si elles sont supérieures ou égales à beta.2. Donc, 1.2.3-beta.4serait autorisé, mais 1.2.4-beta.2ne le serait pas, car il s'agit d'une version préliminaire d'un [major, minor, patch]tuple différent .
• ^0.0.3-beta: = >=0.0.3-beta <0.0.4 Notez que les avant- 0.0.3versions de la version ne seront autorisées que si elles sont supérieures ou égales à beta. Donc, 0.0.3-pr.2serait autorisé.

Lors de l'analyse des plages de patchsigne d'insertion , une valeur manquante désuète le nombre 0, mais permettra une flexibilité dans cette valeur, même si les versions majeures et mineures sont toutes les deux 0.

• ^1.2.x : = >=1.2.0 <2.0.0
• ^0.0.x : = >=0.0.0 <0.1.0
• ^0.0 : = >=0.0.0 <0.1.0

Une valeur minorand manquante patchsera désugarée à zéro, mais permettra également une certaine flexibilité dans ces valeurs, même si la version principale est zéro.

• ^1.x : = >=1.0.0 <2.0.0
• ^0.x : = >=0.0.0 <1.0.0

En rassemblant tout cela, voici une grammaire Backus-Naur pour les plages, au profit des auteurs d'analyseurs:

range-set :: = range (logique-ou range) *
ou logique :: = ('') * '||' ('') *
range :: = tiret | simple ('' simple) * | ''
tiret :: = partiel '-' partiel
simple :: = primitif | partiel | tilde | caret
primitive :: = ('<' | '>' | '> =' | '<=' | '=') partiel
partial :: = xr ('.' xr ('.' xr qualificatif?)?)?
xr :: = 'x' | «X» | '*' | nr
nr :: = '0' | ['1' - '9'] (['0' - '9']) *
tilde :: = '~' partiel
caret :: = '^' partiel
qualificatif :: = ('-' pré)? (build '+')?
pre :: = pièces
build :: = pièces
parts :: = part ('.' part) *
part :: = nr | [-0-9A-Za-z] +