fedeisas/laravel-dolar-blue

Laravel package to fetch latest USD conversion rate on Argentina's black market

1.0 2014-05-04 00:55 UTC

Requires

• php: >=5.4.0
• guzzlehttp/guzzle: ~4.0
• illuminate/support: 4.1.*

Requires (Dev)

• jakub-onderka/php-console-highlighter: dev-master
• jakub-onderka/php-parallel-lint: dev-master
• mockery/mockery: 0.9.*
• pdepend/pdepend: 1.1.1
• phpmd/phpmd: 1.5.*
• phpunit/phpunit: 3.7.*
• squizlabs/php_codesniffer: 1.*

MIT

• Fede Isas

README

Why?

Because Argentina has a black market for currency exchange. And this makes it easy to retrieve the current USD conversion rate from different sources. And also because I needed something small to talk about Package Development and testing on this meetup.

Requirements

• Laravel 4
• PHP >= 5.4

Installation

Begin by installing this package through Composer. Edit your project's composer.json file to require `fedeisas/laravel-dolar-blue.

{
  "require": {
        "laravel/framework": "4.0.*",
        "fedeisas/laravel-dolar-blue": "dev-master"
    },
    "minimum-stability" : "dev"
}

Next, update Composer from the Terminal:

$ composer update

Once this operation completes, the final step is to add the service provider. Open app/config/app.php, and add a new item to the providers array.

'providers' => array(
    ...
    'Fedeisas\LaravelDolarBlue\LaravelDolarBlueServiceProvider',
)

Optionally you can also add the Facade to the aliases array on app/config/app.php:

'aliases' => array(
    ...
    'DolarBlue' => 'Fedeisas\LaravelDolarBlue\Facade\LaravelDolarBlue',
)

Usage

Currenly it only supports 3 providers (more to come):

• LaNacion
• DolarBlue
• BlueLytics

$service = App::make('Fedeisas\LaravelDolarBlue\LaravelDolarBlue');
$result = $service->get('DolarBlue'); // or $service->DolarBlue();
// returns
// array(
//   'buy' => '10.15',
//   'sell' => '10.55',
//   'timestamp' => 1399080004
// )

Or you can use the facade:

$result = DolarBlue::get('LaNacion');

// and using some __call magic
$result = DolarBlue::LaNacion();
$result = DolarBlue::DolarBlue();
$result = DolarBlue::BlueLytics();

Contributing

$ composer install --dev
$ ./vendor/bin/phpunit

In addition to a full test suite, there is Travis integration.

Found a bug?

Please, let me know! Send a pull request or a patch. Questions? Ask! I will respond to all filed issues.

Inspiration

I needed an idea for a small library, and I borrowed it from a friend who has done something similar for NodeJS. You should check it out: https://github.com/matiu/dolar-blue

License

This package is open-sourced software licensed under the MIT license