IPO Checker

Batch IPO (Initial Public Offering) allotment checker for CDSC Nepal.
Checks multiple BOIDs against a selected company and reports allotment status in parallel.

$ ipo --generate-config
$ ipo --file=list.txt

[Ramesh Adhikari] :: Congratulation Alloted !!! Alloted quantity : 10
[Sita Sharma] :: Sorry, not alloted for the entered BOID.

Features

• Fetches live company list from CDSC Nepal API
• Interactive company selection
• Async batch checking — checks all BOIDs in parallel
• Color-coded output (green = alloted, red = not alloted, yellow = invalid)
• Summary: count of alloted, not alloted, and invalid BOIDs
• Config stored at ~/.config/ipo_checker.txt by default

Requirements

• Python 3.6+
• pipenv

Installation

pipenv install -e .

The CLI command ipo will be available inside the pipenv shell.

Configuration

Create a config file with one BOID per line:

<BOID>, <Name>

# Auto-generate default config at ~/.config/ipo_checker.txt:
ipo --generate-config

# Or create a custom file:
echo "1234567890123, Ramesh Adhikari" > list.txt
echo "9876543210987, Sita Sharma" >> list.txt

Usage

# With default config (~/.config/ipo_checker.txt):
pipenv run ipo

# With custom config:
pipenv run ipo --file=list.txt

# Generate default config file:
pipenv run ipo --generate-config

Select a company from the interactive prompt. The tool checks allotment for all BOIDs in the file and prints results.

Development

# Install dev dependencies
pipenv install --dev

# Install pre-commit hooks
pipenv run pre-commit install

# Install mypy types
pipenv run mypy ipo_checker --install-types

Commands

Command	Description
pipenv run ipo	Run IPO checker
pipenv run pytest -vvv	Run tests
pipenv run black .	Format code
pipenv run black --check --diff .	Check formatting
pipenv run mypy ipo_checker	Type check

Or use the Makefile:

make install-dep   # install dev dependencies
make install       # install CLI
make ipo           # run checker
make test          # run tests
make format        # format code
make check         # lint + type check
make clean         # remove temp files

License

GNU General Public License v3.0