pa-bin-checker
is a simple python wrapper for bincheck-api.
- You need to signup for Prompt API
- You need to subscribe bincheck-api, test drive is free!!!
- You need to set
PROMPTAPI_TOKEN
environment variable after subscription.
then;
$ pip install pa-bin-checker
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:
{
'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:
{
'error': 'You need to set PROMPTAPI_TOKEN environment variable',
}
Create your virtual environment, then use rake
tasks:
$ 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:
# 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:
$ brew install bumpversion
If you are on Ubuntu:
# 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:
$ 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/*
This project is licensed under MIT
- Prompt API - Creator, maintainer
All PR’s are welcome!
fork
(https://github.com/promptapi/bin-checker-py/fork)- Create your
branch
(git checkout -b my-feature
) commit
yours (git commit -am 'Add awesome features...'
)push
yourbranch
(git push origin my-feature
)- 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.