https://github.com/yaleksandr89/freecurrencyapi-converter-python
Конвертор валют. В качестве API используется freecurrencyapi.com
https://github.com/yaleksandr89/freecurrencyapi-converter-python
api api-currency currency currency-converter freecurrencyapi freecurrencyconverterapi python python3
Last synced: 2 months ago
JSON representation
Конвертор валют. В качестве API используется freecurrencyapi.com
- Host: GitHub
- URL: https://github.com/yaleksandr89/freecurrencyapi-converter-python
- Owner: yaleksandr89
- License: mit
- Created: 2024-11-17T20:41:18.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-11-18T18:55:59.000Z (7 months ago)
- Last Synced: 2025-01-26T10:30:51.046Z (4 months ago)
- Topics: api, api-currency, currency, currency-converter, freecurrencyapi, freecurrencyconverterapi, python, python3
- Language: Python
- Homepage:
- Size: 1.37 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Конвертер валют
### Выберите язык
| Русский | English | Español | 中文 | Français | Deutsch |
|----------|--------------------------------------|--------------------------------------|---------------------------------|---------------------------------------|--------------------------------------|
| **Выбран** | [English](./docs/lang/README_en.md) | [Español](./docs/lang/README_es.md) | [中文](./docs/lang/README_zh.md) | [Français](./docs/lang/README_fr.md) | [Deutsch](./docs/lang/README_de.md) |
---
**Currency Converter** — это проект для работы с API обмена валют. Вы можете запрашивать курсы валют, выполнять конвертацию и тестировать функционал через готовые тесты.
---
## Структура проекта
```plaintext
currency-converter/
├── docs/... # Материалы используемые в README.md
├── src/
│ ├── main.py # Основной файл для запуска приложения
│ ├── api_service.py # Работа с API (запросы и обработка)
├── tests/
│ ├── test.py # Тесты для проверки функционала
├── index.py # Точка входа для запуска приложения
├── .env # Конфигурационный файл (токен и URL). Создается самостоятельно!
├── .env.example # Пример конфигурационного файла
├── .gitignore # Игнорируемые файлы Git
├── requirements.txt # Список зависимостей
├── README.md # Документация проекта
```
---
## Установка
### 1. Клонирование репозитория
Склонируйте проект на ваш локальный компьютер:
```bash
git clone https://github.com/yaleksandr89/freecurrencyapi-converter-python.git
cd freecurrencyapi-converter-python
```
### 2. Создание виртуального окружения
Рекомендуется использовать виртуальное окружение для изоляции зависимостей:
```bash
# Создание виртуального окружения
python3 -m venv venv
# Активация виртуального окружения
source venv/bin/activate # Для Bash/Zsh/Linux/MacOS
venv\Scripts\activate # Для Windows
```
### 3. Установка зависимостей
Установите зависимости из `requirements.txt`:
```bash
pip install -r requirements.txt
```
---
## Конфигурация
1. Переименуйте файл `.env.example` в `.env`:
```bash
mv .env.example .env
```
2. Укажите токен и базовый URL API в `.env`:
```plaintext
API_TOKEN='ВАШ_API_ТОКЕН'
API_URL='https://api.freecurrencyapi.com/v1'
```
---
## Запуск
### 1. Запуск приложения
Запустите проект через файл `index.py`:
```bash
python3 index.py
```
---
## Тестирование
### Запуск тестов
Для выполнения тестов используйте файл `tests/test.py`:
```bash
python3 tests/test.py
```
Этот файл проверяет корректность подключения к API и отображает список доступных валют.
---
## Демонстрация работы
Успешная конвертация
Процесс конвертации (успешная конвертация (GIF))
Ошибка при конвертации
Процесс конвертации (ошибка при конвертации (GIF))
---
## Конвертер валют на PHP
Создан проект на PHP с похожим функционалом, но имеющий ряд отличий:
- Реализован веб-интерфейс
- Описаны все имеющиеся эндпоинты сервиса.
Пример кода: [freecurrencyapi-converter-php](https://github.com/yaleksandr89/freecurrencyapi-converter-php) — всё там, заходите! 😄
---
## Примечания
1. **Токен безопасности:**
- Убедитесь, что ваш токен API указан корректно в `.env`.
- Никогда не добавляйте файл `.env` в репозиторий.
2. **Рекомендации:**
- Используйте виртуальное окружение для изоляции зависимостей.
- Обновляйте зависимости при необходимости через `pip install --upgrade`.