PHPackages                             andreygordin/tanuki-currency - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. andreygordin/tanuki-currency

ActiveProject

andreygordin/tanuki-currency
============================

v1.0.1(5y ago)04PHPPHP ^7.2CI failing

Since Jul 17Pushed 5y ago1 watchersCompare

[ Source](https://github.com/andreygordin/tanuki-currency)[ Packagist](https://packagist.org/packages/andreygordin/tanuki-currency)[ RSS](/packages/andreygordin-tanuki-currency/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Тестовый проект для Тануки
==========================

[](#тестовый-проект-для-тануки)

Что требовалось сделать
-----------------------

[](#что-требовалось-сделать)

Есть большая система, которая приносит значительный доход компании и следовательно к качеству её кода предъявляются высокие требования.

Эта система, помимо всего прочего, использует курсы валют.

Логика получения курсов валют следующая. Вызывающий код может получить их из кеша, из базы данных и из внешнего источника по http. В случае, если курса валют нет в кеше, надо проверить базу, и если там есть, положить в кеш. Если в базе нет -- проверить внешний источник и положить и в базу, и в кеш.

Надо реализовать эту логику. Предполагается, что она будет использоваться в куче разных мест.

Вероятно, в условии есть неточности, какое-то поведение не указано и тд. Нужно самостоятельно принять решение что делать в каждом таком случае и явно это пометить -- либо в комментарии, либо в файле типа readme. В этом же файле напишите, что бы вы сделали по-другому, будь у вас больше времени; какие у вас были соображения, как в целом должен выглядеть этот код, к чему вы вообще стремились.

Функционал отправки запросов, хранения данных в базе и в кеше реализовывать не надо, вместо них достаточно сделать заглушки. Иными словами, не нужно реализовывать трудоемкие технические детали. Вместо этого важнее как вы декомпозировали предметную область, как выглядят ваши классы, куда вы поместили логику. Тем не менее, по качеству код должен выглядеть так, как будто вы отдаёте финальную его версию на ревью.

Как запустить
-------------

[](#как-запустить)

Устанавливаем через Composer:

```
composer require andreygordin/tanuki-currency

```

Пример использования:

```
use TanukiCurrency\Entity\Currency;
use TanukiCurrency\Repository\CacheRepository;
use TanukiCurrency\Repository\ChainRepository;
use TanukiCurrency\Repository\DbRepository;
use TanukiCurrency\Repository\HttpRepository;

$chainRepository = new ChainRepository(
	new CacheRepository(),
	new DbRepository(),
	new HttpRepository()
);

$currencyState = $chainRepository->find(new Currency('RUB'));

echo $currencyState->rate()->value();
```

Как проверить
-------------

[](#как-проверить)

Для проверки кода линтером, из папки с кодом запустить:

```
composer lint

```

Для проверки кода через phpcs:

```
composer cs-check

```

Для проверки кода через psalm:

```
composer psalm

```

Для запуска тестов:

```
composer test

```

Что еще можно было бы сделать
-----------------------------

[](#что-еще-можно-было-бы-сделать)

1. Сейчас классы трех внутренних репозиториев возвращают фейковые данные и по факту ничего не сохраняют. Следуюшим шагом было бы настроить каждый репозиторий под работу с определенным типом хранилища. Для работы с кешем существует PSR-6: можно было бы `CacheRepository` сделать зависимым от `Psr\Cache\CacheItemPoolInterface` и использовать такой клиент для получения-сохранения данных. Для работы с HTTP есть PSR-17 и PSR-18: в классе `HttpRepository` можно было бы сделать зависимости от `Psr\Http\Message\RequestFactoryInterface` и `Psr\Http\Client\ClientInterface`. Для работы с базой в PSR ничего нет, тут можно было бы написать свой интерфейс.
2. Сейчас при запросе данных для десяти разных валют будет сделано десять отдельных запросов и к кешу, и к базе, и к внешнему источнику по HTTP. Есть смысл сделать возможность запроса информации сразу для целой коллекции валют.
3. Код валюты сейчас валидируется только по количеству символов. Стоит загрузить список всех существующих валют и проверять по нему, чтобы нельзя было запросить трехбуквенную, но несуществующую валюту.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

2124d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0b293434ed09b9db1c515ccf07b15b92382e9d616bbf8ad44b9356e6b4f238b9?d=identicon)[Gordin](/maintainers/Gordin)

---

Top Contributors

[![andreygordin](https://avatars.githubusercontent.com/u/3458383?v=4)](https://github.com/andreygordin "andreygordin (4 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/andreygordin-tanuki-currency/health.svg)

```
[![Health](https://phpackages.com/badges/andreygordin-tanuki-currency/health.svg)](https://phpackages.com/packages/andreygordin-tanuki-currency)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)