Referência para ultralytics/hub/utils.py
Nota
Este ficheiro está disponível em https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/hub/utils .py. Se detectares um problema, por favor ajuda a corrigi-lo contribuindo com um Pull Request 🛠️. Obrigado 🙏!
ultralytics.hub.utils.Events
Uma classe para recolher análises de eventos anónimos. A análise de eventos é ativada quando sync=True nas configurações e desactivada quando sync=False. Executa 'yolo settings' para ver e atualizar o ficheiro YAML das definições.
Atributos:
Nome | Tipo | Descrição |
---|---|---|
url |
str
|
O URL para enviar eventos anónimos. |
rate_limit |
float
|
O limite de velocidade em segundos para o envio de eventos. |
metadata |
dict
|
Um dicionário que contém metadados sobre o ambiente. |
enabled |
bool
|
Um sinalizador para ativar ou desativar Eventos com base em determinadas condições. |
Código fonte em ultralytics/hub/utils.py
__call__(cfg)
Tenta adicionar um novo evento à lista de eventos e enviar eventos se o limite de taxa for atingido.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
cfg |
IterableSimpleNamespace
|
O objeto de configuração que contém informações sobre o modo e a tarefa. |
necessário |
Código fonte em ultralytics/hub/utils.py
__init__()
Inicializa o objeto Events com valores padrão para eventos, rate_limit e metadados.
Código fonte em ultralytics/hub/utils.py
ultralytics.hub.utils.request_with_credentials(url)
Faz um pedido AJAX com cookies anexados num ambiente Google Colab.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
url |
str
|
O URL para o qual deves fazer o pedido. |
necessário |
Devolve:
Tipo | Descrição |
---|---|
any
|
Os dados de resposta do pedido AJAX. |
Aumenta:
Tipo | Descrição |
---|---|
OSError
|
Se a função não for executada num ambiente do Google Colab. |
Código fonte em ultralytics/hub/utils.py
ultralytics.hub.utils.requests_with_progress(method, url, **kwargs)
Faz um pedido HTTP utilizando o método e o URL especificados, com uma barra de progresso opcional.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
method |
str
|
O método HTTP a utilizar (por exemplo, "GET", "POST"). |
necessário |
url |
str
|
O URL para onde enviar o pedido. |
necessário |
**kwargs |
any
|
Argumentos adicionais de palavras-chave para passar para o subjacente |
{}
|
Devolve:
Tipo | Descrição |
---|---|
Response
|
O objeto de resposta do pedido HTTP. |
Nota
- Se 'progress' for definido como True, a barra de progresso mostrará o progresso do download para respostas com um comprimento de conteúdo conhecido.
- Se 'progresso' for um número, então a barra de progresso será apresentada assumindo que o comprimento do conteúdo = progresso.
Código fonte em ultralytics/hub/utils.py
ultralytics.hub.utils.smart_request(method, url, retry=3, timeout=30, thread=True, code=-1, verbose=True, progress=False, **kwargs)
Faz um pedido HTTP usando a biblioteca 'requests', com tentativas de backoff exponencial até um tempo limite especificado.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
method |
str
|
O método HTTP a utilizar para o pedido. As opções são 'post' e 'get'. |
necessário |
url |
str
|
O URL para o qual deves fazer o pedido. |
necessário |
retry |
int
|
Número de tentativas a tentar antes de desistir. A predefinição é 3. |
3
|
timeout |
int
|
Tempo limite em segundos após o qual a função desiste de tentar novamente. A predefinição é 30. |
30
|
thread |
bool
|
Se queres executar o pedido numa thread daemon separada. A predefinição é True. |
True
|
code |
int
|
Um identificador para o pedido, utilizado para efeitos de registo. A predefinição é -1. |
-1
|
verbose |
bool
|
Uma bandeira para determinar se imprime ou não na consola. A predefinição é True. |
True
|
progress |
bool
|
Mostra ou não uma barra de progresso durante o pedido. A predefinição é Falso. |
False
|
**kwargs |
any
|
Argumentos de palavras-chave a serem passados para a função de pedidos especificada em method. |
{}
|
Devolve:
Tipo | Descrição |
---|---|
Response
|
O objeto de resposta HTTP. Se o pedido for executado numa thread separada, devolve None. |