dart pub token

O subcomando dart pub token gerencia um armazenamento de tokens. Ao publicar pacotes e recuperar dependências, o comando dart pub usa tokens para autenticar com servidores de terceiros.

Ele armazena esses tokens em um diretório de configuração em nível de usuário. O subcomando dart pub token tem três subcomandos: add, list e remove.

O comando dart pub considera os termos credencial, token, segredo, e token secreto como intercambiáveis.

Considere um cenário quando você tem uma dependência hospedada em um repositório privado. Quando você usa o comando dart pub get, ele pode retornar um aviso para fornecer credenciais:

$ dart pub get
Resolving dependencies...
https://some-package-repo.com/my-org/my-repo package repository requested authentication!
You can provide credentials using:
    dart pub token add https://some-package-repo.com/my-org/my-repo

Alguns, mas não todos os servidores, também retornam uma mensagem com instruções sobre como você pode obter um token.

Para criar uma nova credencial, use o comando dart pub token add.

No aviso, digite a credencial na linha de comando (stdin).

$ dart pub token add https://some-package-repo.com/my-org/my-repo
Enter secret token: <Type token on stdin>
 Requests to "https://some-package-repo.com/my-org/my-repo" will now be
 authenticated using the secret token.

Para usar o mesmo token em qualquer e todas as sessões de terminal e em scripts, armazene o token em uma variável de ambiente.

1. Armazene seu token em uma variável de ambiente.

   Certifique-se de ocultar o token do histórico do seu shell. Para explorar uma maneira de fazer isso, consulte este post no Medium.

2. Para ativar qualquer variável de ambiente que você adicione, reinicie qualquer console aberto.

3. Para usar uma variável de ambiente como um token, use o comando dart pub token add:

   $ dart pub token add <hosted-url> --env-var <TOKEN_VAR>
   

   content_copy

   Este comando lê o token armazenado em $TOKEN_VAR e o usa para autenticar com hosted-url que hospeda o pacote desejado. Ele deve imprimir a seguinte resposta no terminal.

   $ dart pub token add https://other-package-repo.com/ --env-var TOKEN_VAR
   Requests to "https://other-package-repo.com/" will now be authenticated using the secret token stored in the environment variable "TOKEN_VAR".
   

   content_copy

A maioria dos ambientes de CI pode injetar tokens em uma variável de ambiente. Para saber como, consulte a documentação de GitHub Actions ou GitLab como exemplos.

Para ver uma lista de todas as credenciais ativas, use o comando dart pub token list:

$ dart pub token list
You have secret tokens for 2 package repositories:
https://some-package-repo.com/my-org/my-repo
https://other-package-repo.com/

Para remover um único token, use o comando dart pub token remove:

$ dart pub token remove https://other-package-repo.com
Removed secret token for package repository: https://other-package-repo.com

Para remover todos os tokens, use o comando anterior com a opção remove --all:

$ dart pub token remove --all
pub-tokens.json is deleted.
Removed 1 secret tokens.

ia-translate: true