Metadata-Version: 2.1
Name: pa-bin-checker
Version: 0.1.0
Summary: Python wrapper for Prompt API's BIN Checker API
Home-page: https://github.com/promptapi/bin-checker-py
Author: Prompt API
Author-email: hello@promptapi.com
License: MIT
Project-URL: Prompt API, https://promptapi.com
Project-URL: BIN Checker API, https://promptapi.com/marketplace/description/bincheck-api
Project-URL: Source, https://github.com/promptapi/bin-checker-py
Description: ![Python](https://img.shields.io/badge/python-3.7.4-green.svg)
        ![Version](https://img.shields.io/badge/version-0.1.0-orange.svg)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        [![Build Status](https://travis-ci.org/promptapi/bin-checker-py.svg?branch=main)](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
Keywords: promptapi,bin,checker
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: development
