xil


Namexil JSON
Version 0.3.0 PyPI version JSON
download
home_pagehttps://github.com/jond01/xil
SummaryA Python library for fetching Israeli banks' ILS exchange rates
upload_time2024-03-09 21:18:17
maintainer
docs_urlNone
authorJonathan Daniel
requires_python>=3.12
licenseMIT
keywords foreign exchange israeli banks shekel finance
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            [![PyPI](https://img.shields.io/pypi/v/xil)](https://pypi.org/project/xil/#history)
[![Python Versions](https://img.shields.io/pypi/pyversions/xil)](https://pypi.org/project/xil/)

[![Tests](https://github.com/jond01/xil/actions/workflows/tests.yml/badge.svg)](https://github.com/jond01/xil/actions/workflows/tests.yml)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/charliermarsh/ruff)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
[![linting: pylint](https://img.shields.io/badge/linting-pylint-yellowgreen)](https://github.com/PyCQA/pylint)
[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)

# XIL

Gather and compare foreign currency exchange buy and sell rates offered by Israeli
banks.

## Banks data

The XIL project supports the following banks:

| Bank and data source                                                                                                                                       | XIL module        | Tests              | Bank name (Hebrew)           |
|------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|--------------------|------------------------------|
| [Bank Leumi Le-Israel](https://www.leumi.co.il/Lobby/currency_rates/40806/)                                                                                | `leumi`           | :x:                | בנק לאומי לישראל             |
| [Bank Hapoalim](https://www.bankhapoalim.co.il/he/foreign-currency/exchange-rates)                                                                         | `poalim`          | :white_check_mark: | בנק הפועלים                  |
| [Mizrahi Tefahot Bank](https://www.mizrahi-tefahot.co.il/brokerage/currancyexchange/)                                                                      | `mizrahi_tefahot` | :x:                | בנק מזרחי טפחות              |
| [Israel Discount Bank](https://www.discountbank.co.il/private/general-information/foreign-currency-transfers/exchange-rates/)                              | `discount`        | :white_check_mark: | בנק דיסקונט לישראל           |
| [First International Bank of Israel](https://www.fibi.co.il/wps/portal/FibiMenu/Marketing/Private/ForeignCurrency/Trade/Rates)                             | `fibi`            | :x:                | הבנק הבינלאומי הראשון לישראל |
| [Bank of Jerusalem](https://www.bankjerusalem.co.il/capital-market/rates)                                                                                  | `jerusalem`       | :x:                | בנק ירושלים                  |
| [Mercantile Discount Bank](https://www.mercantile.co.il/en/private/foregin-currency/exchange-rates/)                                                       | `mercantile`      | :white_check_mark: | בנק מרכנתיל דיסקונט          |
| [Bank Massad](https://www.bankmassad.co.il/wps/portal/FibiMenu/Marketing/Private/ForeignCurrency/ForexOnline/Rates)                                        | `massad`          | :x:                | בנק מסד                      |
| [One Zero Digital Bank](https://www.onezerobank.com/currencies/)                                                                                           | `onezero`         | :white_check_mark: | וואן זירו הבנק הדיגיטלי      |
| [Bank of Israel](https://www.boi.org.il/roles/markets/%D7%A9%D7%A2%D7%A8%D7%99-%D7%97%D7%9C%D7%99%D7%A4%D7%99%D7%9F-%D7%99%D7%A6%D7%99%D7%92%D7%99%D7%9D/) | `boi`             | :x:                | בנק ישראל                    |

For the data sources (websites and URLs) for each bank, see the docstring of the
corresponding XIL module.

Banks that are not supported yet:

- Bank Yahav (בנק יהב): no public information available.
  https://www.bank-yahav.co.il/investments/foreing-currency/
- Bank Esh Israel (בנק אש ישראל): a new bank - not commercially active yet.
  https://www.esh.com/

## Installation

The project requires Python 3.12 or above. To install the project, run:

```shell
pip install xil
```

## Contributing to the XIL project

Please read the [Contribution Guide](https://github.com/jond01/xil/blob/main/CONTRIBUTING.md).

## Similar projects

* https://github.com/eshaham/israeli-bank-scrapers

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/jond01/xil",
    "name": "xil",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": "",
    "keywords": "foreign exchange,Israeli banks,Shekel,finance",
    "author": "Jonathan Daniel",
    "author_email": "jonathand655@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/f4/a1/07c194f7885caac8595017b5034c565073e6417f11bb87bfa949bcd9cf90/xil-0.3.0.tar.gz",
    "platform": null,
    "description": "[![PyPI](https://img.shields.io/pypi/v/xil)](https://pypi.org/project/xil/#history)\n[![Python Versions](https://img.shields.io/pypi/pyversions/xil)](https://pypi.org/project/xil/)\n\n[![Tests](https://github.com/jond01/xil/actions/workflows/tests.yml/badge.svg)](https://github.com/jond01/xil/actions/workflows/tests.yml)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/charliermarsh/ruff)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)\n[![linting: pylint](https://img.shields.io/badge/linting-pylint-yellowgreen)](https://github.com/PyCQA/pylint)\n[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)\n\n# XIL\n\nGather and compare foreign currency exchange buy and sell rates offered by Israeli\nbanks.\n\n## Banks data\n\nThe XIL project supports the following banks:\n\n| Bank and data source                                                                                                                                       | XIL module        | Tests              | Bank name (Hebrew)           |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|--------------------|------------------------------|\n| [Bank Leumi Le-Israel](https://www.leumi.co.il/Lobby/currency_rates/40806/)                                                                                | `leumi`           | :x:                | \u05d1\u05e0\u05e7 \u05dc\u05d0\u05d5\u05de\u05d9 \u05dc\u05d9\u05e9\u05e8\u05d0\u05dc             |\n| [Bank Hapoalim](https://www.bankhapoalim.co.il/he/foreign-currency/exchange-rates)                                                                         | `poalim`          | :white_check_mark: | \u05d1\u05e0\u05e7 \u05d4\u05e4\u05d5\u05e2\u05dc\u05d9\u05dd                  |\n| [Mizrahi Tefahot Bank](https://www.mizrahi-tefahot.co.il/brokerage/currancyexchange/)                                                                      | `mizrahi_tefahot` | :x:                | \u05d1\u05e0\u05e7 \u05de\u05d6\u05e8\u05d7\u05d9 \u05d8\u05e4\u05d7\u05d5\u05ea              |\n| [Israel Discount Bank](https://www.discountbank.co.il/private/general-information/foreign-currency-transfers/exchange-rates/)                              | `discount`        | :white_check_mark: | \u05d1\u05e0\u05e7 \u05d3\u05d9\u05e1\u05e7\u05d5\u05e0\u05d8 \u05dc\u05d9\u05e9\u05e8\u05d0\u05dc           |\n| [First International Bank of Israel](https://www.fibi.co.il/wps/portal/FibiMenu/Marketing/Private/ForeignCurrency/Trade/Rates)                             | `fibi`            | :x:                | \u05d4\u05d1\u05e0\u05e7 \u05d4\u05d1\u05d9\u05e0\u05dc\u05d0\u05d5\u05de\u05d9 \u05d4\u05e8\u05d0\u05e9\u05d5\u05df \u05dc\u05d9\u05e9\u05e8\u05d0\u05dc |\n| [Bank of Jerusalem](https://www.bankjerusalem.co.il/capital-market/rates)                                                                                  | `jerusalem`       | :x:                | \u05d1\u05e0\u05e7 \u05d9\u05e8\u05d5\u05e9\u05dc\u05d9\u05dd                  |\n| [Mercantile Discount Bank](https://www.mercantile.co.il/en/private/foregin-currency/exchange-rates/)                                                       | `mercantile`      | :white_check_mark: | \u05d1\u05e0\u05e7 \u05de\u05e8\u05db\u05e0\u05ea\u05d9\u05dc \u05d3\u05d9\u05e1\u05e7\u05d5\u05e0\u05d8          |\n| [Bank Massad](https://www.bankmassad.co.il/wps/portal/FibiMenu/Marketing/Private/ForeignCurrency/ForexOnline/Rates)                                        | `massad`          | :x:                | \u05d1\u05e0\u05e7 \u05de\u05e1\u05d3                      |\n| [One Zero Digital Bank](https://www.onezerobank.com/currencies/)                                                                                           | `onezero`         | :white_check_mark: | \u05d5\u05d5\u05d0\u05df \u05d6\u05d9\u05e8\u05d5 \u05d4\u05d1\u05e0\u05e7 \u05d4\u05d3\u05d9\u05d2\u05d9\u05d8\u05dc\u05d9      |\n| [Bank of Israel](https://www.boi.org.il/roles/markets/%D7%A9%D7%A2%D7%A8%D7%99-%D7%97%D7%9C%D7%99%D7%A4%D7%99%D7%9F-%D7%99%D7%A6%D7%99%D7%92%D7%99%D7%9D/) | `boi`             | :x:                | \u05d1\u05e0\u05e7 \u05d9\u05e9\u05e8\u05d0\u05dc                    |\n\nFor the data sources (websites and URLs) for each bank, see the docstring of the\ncorresponding XIL module.\n\nBanks that are not supported yet:\n\n- Bank Yahav (\u05d1\u05e0\u05e7 \u05d9\u05d4\u05d1): no public information available.\n  https://www.bank-yahav.co.il/investments/foreing-currency/\n- Bank Esh Israel (\u05d1\u05e0\u05e7 \u05d0\u05e9 \u05d9\u05e9\u05e8\u05d0\u05dc): a new bank - not commercially active yet.\n  https://www.esh.com/\n\n## Installation\n\nThe project requires Python 3.12 or above. To install the project, run:\n\n```shell\npip install xil\n```\n\n## Contributing to the XIL project\n\nPlease read the [Contribution Guide](https://github.com/jond01/xil/blob/main/CONTRIBUTING.md).\n\n## Similar projects\n\n* https://github.com/eshaham/israeli-bank-scrapers\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Python library for fetching Israeli banks' ILS exchange rates",
    "version": "0.3.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/jond01/xil/issues",
        "Documentation": "https://github.com/jond01/xil#readme",
        "Homepage": "https://github.com/jond01/xil",
        "Repository": "https://github.com/jond01/xil"
    },
    "split_keywords": [
        "foreign exchange",
        "israeli banks",
        "shekel",
        "finance"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "08b1b37f8a52f46c45621938e19d5262b246287d42b3fb0eb2a7321d6b8aa558",
                "md5": "37d87df2ebbf84e6e66444e148a237e5",
                "sha256": "1958fa811b6f40255486945587100e10ebb68e852f38e8cf329892737d42acbd"
            },
            "downloads": -1,
            "filename": "xil-0.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "37d87df2ebbf84e6e66444e148a237e5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 15194,
            "upload_time": "2024-03-09T21:18:15",
            "upload_time_iso_8601": "2024-03-09T21:18:15.138472Z",
            "url": "https://files.pythonhosted.org/packages/08/b1/b37f8a52f46c45621938e19d5262b246287d42b3fb0eb2a7321d6b8aa558/xil-0.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f4a107c194f7885caac8595017b5034c565073e6417f11bb87bfa949bcd9cf90",
                "md5": "e53f051cf38a516185299fcfce453824",
                "sha256": "129d37f41d9e5948d3013deb27088ccf736dc598ff99ea712dac0f562db24f0b"
            },
            "downloads": -1,
            "filename": "xil-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "e53f051cf38a516185299fcfce453824",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 12771,
            "upload_time": "2024-03-09T21:18:17",
            "upload_time_iso_8601": "2024-03-09T21:18:17.445948Z",
            "url": "https://files.pythonhosted.org/packages/f4/a1/07c194f7885caac8595017b5034c565073e6417f11bb87bfa949bcd9cf90/xil-0.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-09 21:18:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jond01",
    "github_project": "xil",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "xil"
}
Jonathan Daniel
Elapsed time: 3.44686s