Improved software engineering quality suggestions

[Timmmm]

Hi, I was wondering if you would be open to PRs to improve the general software engineering quality of this repo. This is the sort of thing I'm thinking of in increasing order of invasiveness:

• [x] Add pre-commit, tell it to format all the Python code using Black or Ruff and enforce in CI.
• [x] Add Pylint to pre-commit. #311
• [ ] Restructure the code to turn it into an actual Python package with pyproject.toml etc. Publish it on Pypi. #294
• [x] Add static type hints.
• [x] Add Pyright (static type checker) to pre-commit to enforce them.

There's also some low hanging fruit in the actual code:

• [ ] Use argparse (Typer is a better option but it's beneficial not to add a third party dependency.) #314
• [ ] Switch from ad-hoc dictionaries to dataclasses.
• [ ] Don't reparse the files 3 times.

I can do all that fairly easily but I thought I'd check if you would actually accept those improvements first. Seems like you might a bit review bottlenecked based on the open PRs (who isn't?).

[aswaterman]

@neelgala is the author of the bulk of the Python code, so I'll defer to him. But at first blush this seems reasonable.

[IIITM-Jay]

Commenting here to have just a glimpse of the improvements in software engineering qualities such as Refactorization, Modularization and using as much Optimization techniques as we can for better maintainability and enhancing the readability as well. Tagging a PR also with reference to above.

Refactor and Optimization:: constants.py

/CC @aswaterman and @rpsene