https://github.com/promptapi/bin-checker-py
Python package for Prompt API's BIN Checker API
https://github.com/promptapi/bin-checker-py
api-wrapper bin-checker bin-database bin-lookup bin-number bincheck-api credit-card credit-card-bin promptapi python3
Last synced: 29 days ago
JSON representation
Python package for Prompt API's BIN Checker API
- Host: GitHub
- URL: https://github.com/promptapi/bin-checker-py
- Owner: promptapi
- License: mit
- Created: 2020-08-27T17:56:15.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-09-16T07:42:13.000Z (over 5 years ago)
- Last Synced: 2024-08-09T17:52:53.639Z (over 1 year ago)
- Topics: api-wrapper, bin-checker, bin-database, bin-lookup, bin-number, bincheck-api, credit-card, credit-card-bin, promptapi, python3
- Language: Python
- Homepage: https://promptapi.com/marketplace/description/bincheck-api
- Size: 37.1 KB
- Stars: 16
- Watchers: 5
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://github.com/psf/black)
[](https://travis-ci.org/promptapi/bin-checker-py)
# Prompt API - BIN Checker - Python Package
`pa-bin-checker` is a simple python wrapper for [bincheck-api][bincheck-api].
## Requirements
1. You need to signup for [Prompt API][promptapi-signup]
1. You need to subscribe [bincheck-api][bincheck-api], test drive is **free!!!**
1. You need to set `PROMPTAPI_TOKEN` environment variable after subscription.
then;
```bash
$ pip install pa-bin-checker
```
---
## Example Usage
```python
from bin_checker import get_bin
bin_information = get_bin('302596') # example BIN
if bin_information.get('error', False):
print(bin_information['bank_name']) # you have a dict!
```
You’ll have a dict of data:
```python
{
'bank_name': 'Diners Club International',
'country': 'United States Of America',
'url': 'www.dinersclub.com',
'type': 'Credit',
'scheme': 'Discover',
'bin': '302596',
}
```
If you receive an error, payload will contain `error` key. Example error
response:
```python
{
'error': 'You need to set PROMPTAPI_TOKEN environment variable',
}
```
---
## Development
Create your virtual environment, then use `rake` tasks:
```bash
$ rake -T
rake build # Build package
rake bump[revision] # Bump version
rake clean # Remove/Delete build..
rake default # Default task => :install
rake install # Install package for local development purpose
rake test # Run test
rake upload:main # Upload package to main distro (release)
rake upload:test # Upload package to test distro
```
You need `ruby` to run rake tasks. Rake tasks are just helper functions for
automation. You don’t need to install anything to proceed. If you are on
macOS, you’ll already have ruby installed.
If you are on Ubuntu:
```bash
# install ruby on Ubuntu
$ sudo apt-get update -y
$ sudo apt-get install -y ruby-full
```
You need `bumpversion` to manage package versioning. If you are on
macOS:
```bash
$ brew install bumpversion
```
If you are on Ubuntu:
```bash
# install bumpversion on Ubuntu
$ sudo apt-get update -y
$ sudo apt-get -y bumpversion
```
To install and test package locally, just call `rake` or `rake install`.
Tests are available under `tests/` folder. Run `rake test` to run tests.
To continue without `ruby` or `rake`:
- Install package locally: `pip install -e .[development]`
- Build package: `python setup.py sdist bdist_wheel`
- Install `bumpversion`: `pip install bumpversion`
For uploading package to **pypi** registry you need to install:
```bash
$ pip install -U wheel setuptools
```
You need to put pypi credentials to `~/.pypirc`:
[distutils]
index-servers=
pypi-promptapi
testpypi-promptapi
[pypi-promptapi]
repository = https://upload.pypi.org/legacy/
username: __token__
password: TOKEN
[testpypi-promptapi]
repository: https://test.pypi.org/legacy/
username: __token__
password: TOKEN
- Upload to main registry: `twine upload --repository pypi-promptapi dist/*`
- Upload to test repository: `twine upload --repository testpypi-promptapi dist/*`
---
## License
This project is licensed under MIT
---
## Contributer(s)
* [Prompt API](https://github.com/promptapi) - Creator, maintainer
---
## Contribute
All PR’s are welcome!
1. `fork` (https://github.com/promptapi/bin-checker-py/fork)
1. Create your `branch` (`git checkout -b my-feature`)
1. `commit` yours (`git commit -am 'Add awesome features...'`)
1. `push` your `branch` (`git push origin my-feature`)
1. Than create a new **Pull Request**!
This project is intended to be a safe,
welcoming space for collaboration, and contributors are expected to adhere to
the [code of conduct][coc].
---
[bincheck-api]: https://promptapi.com/marketplace/description/bincheck-api
[promptapi-signup]: https://promptapi.com/#signup-form
[coc]: https://github.com/promptapi/bin-checker-py/blob/main/CODE_OF_CONDUCT.md