ayerdines/meroshare-scripts

Purpose and Execution Model

This is a Python CLI for bulk MeroShare IPO workflows: list open ordinary-share issues, inspect per-account application status, submit IPO applications, and generate allotment reports. The sole executable entry point is main.py; shared constants are in constants.py.

CLI Orchestration

main.py parses shell flags and selects one of three primary modes:

• Default: discover open IPOs and show whether configured users have applied.

• --apply: submit a selected company share ID and quantity.

• --report: generate allotment-status reports.

The optional --user flag constrains all modes to one account rather than the full account set.

Paths: main.py, constants.py

Account Input Boundary

Credentials/account metadata are loaded from a local CSV file, expected to be created as accounts.csv using the documented schema in accounts.csv.example. This is the operational boundary for bulk actions: each selected account is processed independently, enabling all-account execution and user filtering.

Paths: accounts.csv.example, main.py

IPO Discovery and Status Checking

The default flow queries MeroShare issue data, filters to currently open ordinary IPO shares, then checks application state for each selected account. It exposes the company share ID needed by the apply flow and distinguishes applied versus unapplied status.

Paths: main.py, constants.py

Bulk Application Stage

Application mode requires --company-share-id; --number-of-shares defaults to 10. The workflow iterates selected accounts, checks whether each account has already applied for the requested issue, skips duplicates, and submits only missing applications. This pre-check is the key idempotency guard for repeated bulk runs.

Paths: main.py

Allotment Reporting Stage

Report mode retrieves IPO allotment outcomes for one account or all configured accounts. It is separate from application submission and is controlled by --report, allowing post-issue result collection without changing application state.

Paths: main.py

Runtime and External Dependencies

The repository targets Python 3 and is intended for direct local execution (python3 main.py). It integrates with MeroShare’s remote service for issue discovery, application-status checks, application submission, and allotment lookup. Local account credentials are sensitive operational input and should remain outside version control; .gitignore supports that boundary.

Paths: main.py, .gitignore, .tool-versions