vluzrmos/precodahora

Precodahora API

v0.0.3 2024-11-25 12:02 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.9
• symfony/css-selector: ^7.1
• symfony/dom-crawler: ^7.1
• symfony/string: ^7.1
• symfony/validator: ^7.1

Requires (Dev)

• mockery/mockery: ^1.6
• pestphp/pest: ^3.5
• symfony/var-dumper: ^7.1

MIT

• Vagner do Carmo

README

Descrição

Cliente para busca de preços dos produtos nos principais mercados/supermercados da Bahia.

Os preços são obtidos através do site https://precodahora.ba.gov.br/.

Como usar

<?php

require __DIR__ . '/vendor/autoload.php';

use Vluzrmos\Precodahora\Client;
use Vluzrmos\Precodahora\Exceptions\ValidationException;
use Vluzrmos\Precodahora\Queries\ProdutoQuery;

$client = new Client();

$codigoIBGEItabuna = 2914802;
$codigoIBGE = (int) ($argv[1] ?? $codigoIBGEItabuna);
$termo = (string) ($argv[2] ?? 'feijao fradinho');

try {
    $municipio = $client->municipios()->findByCodigoIBGE($codigoIBGE);

    $query = (new ProdutoQuery())
        ->termo($termo)
        ->latitude($municipio?->latitude)
        ->longitude($municipio?->longitude)
        ->ordenarPorDistancia();

    $response = $client->produto($query);
} catch (ValidationException $e) {
    $errors = $e->getErrors();

    echo implode("\n", $errors?->all()) . PHP_EOL;

    exit(1);
}

echo "Município: {$municipio->localidade}\n";
echo "Latitude: {$municipio->latitude}\n";
echo "Longitude: {$municipio->longitude}\n";
echo "--------------------------------\n\n";

foreach ($response->resultado ?? [] as $resultado) {
    $produto = $resultado->produto;
    $estabelecimento = $resultado->estabelecimento;

    echo "Produto: {$produto->descricao}\n";
    echo "Preço: {$produto->precoUnitario}\n";
    echo "Data: {$produto->data}\n";
    echo "Estabelecimento: {$estabelecimento->nomeEstabelecimento}\n";
    echo "Endereço: {$estabelecimento->endLogradouro}, nº{$estabelecimento->endNumero}\n";
    echo "Bairro: {$estabelecimento->bairro}\n";
    echo "CEP: {$estabelecimento->cep}\n";
    echo "Cidade: {$estabelecimento->municipio}\n";
    echo "Estado: {$estabelecimento->uf}\n";
    echo "Telefone: {$estabelecimento->telefone}\n";

    echo "--------------------------------\n";
}

Docker

/path/to/this-project/run.sh

Se nenhum argumento for passado, o script fará o build do container docker e executará o comando "php example.php" presente na pasta do projeto.

Talvez seja necessário dar permissão de execução ao script:

chmod +x /path/to/this-project/run.sh

É possível executar example.php passando o codigo IBGE da cidade como argumento:

# Exemplo: Ilhéus/Bahia
/path/to/this-project/run.sh php example.php 2913606

Executar testes:

/path/to/this-project/run.sh vendor/bin/pest

Atenção

Nota: Este cliente não é oficial e não tem nenhuma relação com o site https://precodahora.ba.gov.br/.

Nota²: O site https://precodahora.ba.gov.br/ não possui uma API pública, então este cliente faz web scraping para obter os dados. Use com moderação, pois pode haver bloqueio de acesso ao site.