istcode 2.9

Command-line exam ticket helper

ISTCode

Command-line helper for exam tickets.

Русская инструкция:

USER_GUIDE_RU.md

Install for development

python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

Install from GitHub

Install on any computer:

python -m pip install --upgrade --force-reinstall --no-cache-dir https://github.com/Pyshok342/ISTCode/archive/refs/heads/main.zip

After publishing to PyPI:

python -m pip install --upgrade --force-reinstall --no-cache-dir istcode

Use

Show ticket by number:

ist-ticket 1

The command first reads ticket text from Word:

src/my_python_library/assets/files/ticket_01/ticket.docx

If ticket.docx is missing, it reads the fallback file:

src/my_python_library/assets/files/ticket_01/ticket.md

Tables from ticket.docx are printed as console-friendly ASCII tables.

Show available tickets:

ist-ticket list

Show help:

ist-ticket help

Show folder and names for attached files/photos/presentations:

ist-ticket files 6

Open all files from the ticket folder:

ist-ticket open 6

Ticket folders live in:

src/my_python_library/assets/files/ticket_01
src/my_python_library/assets/files/ticket_02
...
src/my_python_library/assets/files/ticket_20

Each folder can contain ticket.docx. This is the preferred editable Word file shown by ist-ticket N. If there is no ticket.docx, ticket.md is used as fallback.

Alternative launch:

python -m my_python_library 1

Python import:

from my_python_library import format_ticket

print(format_ticket(1))

Test

python -m pytest

Build

python -m build

Publish New Version

publish_new_version.bat

The helper automatically bumps the last number in pyproject.toml before it builds and pushes the release.

Publish

First publish to TestPyPI:

python -m twine upload --repository testpypi dist/*

Then publish to PyPI:

python -m twine upload dist/*