Commandes

Référence de ligne de commande

Cache

$ bower cache <command> [<args>]

Gérer le cache du bower

Cache propre

$ bower cache clean
$ bower cache clean <name> [<name> ...]
$ bower cache clean <name>#<version> [<name>#<version> ..]

Nettoie les packages mis en cache

Liste de cache

$ bower cache list
$ bower cache list <name> [<name> ...]

Répertorie les packages mis en cache

Aider

$ bower help <command>

Afficher les informations d’aide de Bower

À la maison

$ bower home
$ bower home <package>
$ bower home <package>#<version>

Ouvre une page d’accueil de package dans votre navigateur préféré.

Si non <package> est passé, ouvre la page d’accueil du package local.

l’information

$ bower info <package>
$ bower info <package> [<property>]
$ bower info <package>#<version> [<property>]

Affiche des informations générales sur un package ou une version spécifique.

à l’intérieur

$ bower init

Créer de manière interactive un fichier bower.json

À installer

$ bower install [<options>]
$ bower install <endpoint> [<endpoint> ..] [<options>]

Installez les dépendances de projet de manière récursive.

Les dépendances du projet se composent de:

  1. dependencies spécifié dans bower.json du projet
  2. Toutes les dépendances « externes » non spécifiées dans bower.json, mais présent dans bower_components
  3. Tout supplément <endpoint> passé en argument à cette commande

Lorsque --save L’indicateur est utilisé, tous les points de terminaison supplémentaires sont enregistrés dependencies dans le bower.json.

Bower recommande de toujours utiliser --save Drapeau pour réaliser des installations reproductibles entre les machines.

Les points de terminaison peuvent prendre plusieurs formes:

  • <package>
  • <package>#<version>
  • <name>=<package>#<version>

Où:

  • <package> est une URL de package, un emplacement physique ou un nom d’enregistrement
  • <version> est une portée, un commit, une branche, etc. valide.
  • <name> est le nom qu’il devrait avoir localement.

<package> peut être l’un des suivants:

Nom du package enregistré jquery
normalize.css
Point de terminaison Git https://github.com/user/package.git
[email protected]:user/package.git
Point de terminaison Git sans .git git+https://github.com/user/package
git+ssh://[email protected]/user/package
Dossier local my/local/folder/
Point de terminaison public Subversion svn+http://package.googlecode.com/svn/
Point de terminaison privé Subversion svn+ssh://package.googlecode.com/svn/
svn+https://package.googlecode.com/svn/
Raccourci (GitHub par défaut) user/package
URL http://example.com/script.js
http://example.com/style.css
http://example.com/package.zip (Le contenu est extrait)
http://example.com/package.tar (Le contenu est extrait)

Une version peut être:

Version Semver #1.2.3
Gamme de versions #1.2
#~1.2.3
#^1.2.3
#>=1.2.3 <2.0
Balise Git #<tag>
Git commit SHA #<sha>
Branche Git #<branch>
Révision Subversion #<revision>

Options d’installation

  • -F, --force-latest: Forcer la dernière version en cas de conflit
  • -p, --production: N’installez pas le projet devDependencies
  • -S, --save: Enregistrer les packages installés dans les dépendances bower.json du projet
  • -D, --save-dev: Enregistrez les packages installés dans les devDependencies du projet bower.json
  • -E, --save-exact: Configurer les packages installés avec une version exacte au lieu de Semver
$ bower link
$ bower link <name> [<local name>]

Avec la fonctionnalité de lien, les développeurs peuvent facilement tester leurs packages. La liaison est un processus en deux étapes.

L’utilisation de ‘lien bower’ dans un dossier de projet crée un lien global. Puis, dans un autre colis, bower link <name> crée un lien dans le dossier des composants qui pointe vers le lien créé précédemment.

Cela facilite le test d’un package car les modifications sont appliquées immédiatement. Si le lien n’est plus nécessaire, supprimez-le simplement avec bower uninstall <name>.

liste

$ bower list [<options>]

Répertoriez les packages locaux et les mises à jour possibles.

Options de liste

  • -p, --paths: Génère une carte source JSON simple
  • -r, --relative: Créez des chemins relatifs à la propriété de configuration de répertoire que bower_components utilise par défaut

Chercher

$ bower lookup <name>

Rechercher une URL de package par son nom

Inscription

$ bower login

Authentifiez-vous avec GitHub et enregistrez les informations d’identification. Requis pour désenregistrer des packages.

Options de connexion

  • -t, --token: Transmettez un jeton d’authentification GitHub existant au lieu de demander un nom d’utilisateur et un mot de passe

prune

$ bower prune

Désinstalle les packages étrangers locaux

enregistrer

$ bower register <name> <url>

Enregistrer un package (obsolète)

$ bower search
$ bower search <name>

Recherche tous les packages ou un package spécifique (obsolète)

Mettre à jour

$ bower update <name> [<name> ..] [<options>]

Met à jour les packages installés vers la dernière version selon bower.json (obsolète)

Options de mise à jour

  • -F, --force-latest: Forcer la dernière version en cas de conflit
  • -p, --production: N’installez pas le projet devDependencies
  • -S, --save: Mettre à jour dependencies dans bower.json
  • -D, --save-dev: Mettre à jour devDependencies dans bower.json

désinstaller

$ bower uninstall <name> [<name> ..] [<options>]

Désinstalle un package localement de votre répertoire bower_components

Options de désinstallation

  • -S, --save: Supprimez les packages désinstallés des dépendances bower.json du projet
  • -D, --save-dev: Supprimez les packages désinstallés des devDependencies de bower.json du projet

se déconnecter

$ bower unregister <package>

Annuler l’enregistrement d’un package (obsolète)

exécution

$ bower version [<newversion> | major | minor | patch]

Faites-le dans un répertoire de package pour mettre à niveau la version et réécrire les nouvelles données dans le fichier bower.json.

L’argument newversion doit être une chaîne Semver valide ou un deuxième argument valide de semver.inc (l’un des arguments « build », « patch », « minor » ou « major »). Dans le second cas, la version existante est augmentée de 1 dans le champ spécifié.

Lorsqu’il est exécuté sur un dépôt Git, il crée également un commit et une balise de version et échoue si le dépôt n’est pas propre.

Options de version

  • -m, --message: Message de validation et de balise git personnalisé

Si livré avec --message (Sténographie: -m) Option de configuration, bower l’utilise comme message de validation lors de la création de la validation de version. Si la configuration du message contient% s, elle sera remplacée par le numéro de version résultant. Par example:

$ bower version patch -m "Upgrade to %s for reasons"

Options

Fait du

-f, --force

Rend diverses commandes plus puissantes

  • bower install --force Réinstalle tous les composants installés. L’installation est également forcée si le répertoire des composants contient des répertoires non semblables à Bower avec le même nom. Ajouter --force contourne également le cache et écrit toujours dans le cache.
  • bower uninstall <package> --force continue la désinstallation même après un conflit de dépendance

json

-j, --json

Sortie des consommables JSON

loglevel

-l, --loglevel

Quel niveau de journaux souhaitez-vous signaler? Valeurs possibles: erreur, conflit, avertissement, action, info, débogage

hors ligne

-o, --offline

N’utilisez pas de connexion réseau

calme

-q, --quiet

Ne donnez que des informations importantes. C’est un alias pour --loglevel=warn.

Tranquillement

-s, --silent

N’envoyez rien d’autre que des erreurs. C’est un alias pour --loglevel=error. Silencieux est également utile lorsque vous disposez de composants privés susceptibles de perdre les informations d’identification de votre environnement CI.

détaillé

-V, --verbose

Rend la sortie plus détaillée. C’est un alias pour --loglevel=debug.

autoriser la racine

--allow-root

Permet aux commandes d’être exécutées en tant que root. Bower est une commande utilisateur qui n’a pas besoin d’être exécutée avec les privilèges de superutilisateur. Cependant, si vous souhaitez toujours exécuter des commandes avec sudo, utilisez --allow-root Possibilité.

Consommez un paquet

Vous pouvez utiliser Construire des outils Bower packs faciles à consommer.

Lorsque vous utilisez bower list --paths ou alors bower list --paths --jsonvous obtenez un simple mappage du nom au chemin:

$ bower list --paths
# or
$ bower list --paths --json
{
  "backbone": "bower_components/backbone/backbone.js",
  "jquery": "bower_components/jquery/dist/jquery.js",
  "underscore": "bower_components/underscore/underscore.js"
}

Chaque commande prend en charge le --json possibilité Cela obligera Bower à générer du JSON. Le résultat de la commande est émis vers stdout et les erreurs / journaux aussi stderr.

API programmatique

Bower propose une puissante API programmatique. Toutes les commandes sont accessibles via le bower.commands Objet.

var bower = require('bower');

bower.commands
.install(['jquery'], { save: true }, { /* custom config */ })
.on('end', function (installed) {
    console.log(installed);
});

bower.commands
.search('jquery', {})
.on('end', function (results) {
    console.log(results);
});

Les commandes émettent quatre types d’événements: log, prompt, end, error.

  • log est émis pour signaler l’état / la progression de la commande.
  • prompt est émis lorsque l’utilisateur doit être invité.
  • error n’est émis qu’en cas de problème.
  • end est émis lorsque la commande se termine avec succès.

Pour avoir une meilleure idée de son fonctionnement, jetez-y un œil notre fichier bin.

Lors de l’utilisation de Bower par programme, l’invite est désactivée par défaut. Vous pouvez l’activer lorsque vous appelez des commandes avec interactive: true dans la configuration. Cela nécessite que vous les écoutiez prompt Événement et gérez l’appel vous-même. Le moyen le plus simple est d’utiliser le Questionneur module npm comme suit:

var inquirer =  require('inquirer');

bower.commands
.install(['jquery'], { save: true }, { interactive: true })
// ..
.on('prompt', function (prompts, callback) {
    inquirer.prompt(prompts).then(callback);
});

Fonctionne sur un serveur d’intégration continue

Bower ignore certaines opérations interactives lorsqu’il trouve un CI Variable d’environnement définie sur true. Vous constaterez que le CI Sur de nombreux serveurs d’intégration continue, la variable est déjà définie pour vous; CircleCI et Travis-CI.

Vous pouvez essayer de définir cela CI modifier manuellement avant d’exécuter vos commandes Bower. Sur Mac ou Linux export CI=true et sous Windows set CI=true

Si pour une raison quelconque vous ne pouvez pas le configurer CI Vous pouvez également utiliser la variable d’environnement --config.interactive=false Drapeau.

$ bower install --config.interactive=false

Mode non interactif

Par défaut, Bower fonctionne en mode interactif. Il existe plusieurs façons de le désactiver:

  • passe CI=true dans l’environnement
  • passe --config.interactive=false aux ordres de Bower
  • Fixation d’un tuyau au Bower (ex bower install | cat)
  • Rediriger la sortie vers un fichier (ex bower install > logs.txt)
  • Courir à travers son Bower API programmatique

Lorsque le mode interactif est désactivé:

  • bower init ça ne marche pas
  • bower register et bower unregister Confirmation de contournement
  • bower login échoue à moins que --token Le paramètre est fourni
  • bower install échoue en cas de conflit au lieu de demander une sélection
  • bower uninstall ne demande pas de confirmation s’il faut supprimer la dépendance

Utilisez le cache local

Bower prend en charge l’installation de packages à partir du cache local – sans connexion Internet – si les packages ont été installés au préalable.

$ bower install <package> --offline

Le contenu du cache peut être répertorié avec bower cache list::

$ bower cache list

Le cache peut être nettoyé avec bower cache clean::

$ bower cache clean



Source link

Recent Posts