#!/usr/bin/env python3
"""Run a numerical stage and retain its actual interpreter and package versions."""
import argparse
from datetime import datetime, timezone
import hashlib
from importlib.metadata import PackageNotFoundError, version
import json
from pathlib import Path
import platform
import runpy
import sys


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument('--record', type=Path, required=True)
    parser.add_argument('--package', action='append', default=[], metavar='NAME==VERSION')
    parser.add_argument('script', type=Path)
    args = parser.parse_args()
    script = args.script.resolve(strict=True)
    record_path = args.record.resolve()
    required = {}
    for selection in args.package:
        name, separator, pin = selection.partition('==')
        if not separator or not name or not pin or name in required:
            parser.error('packages require distinct NAME==VERSION selections')
        required[name] = pin
    installed = {}
    for name in required:
        try:
            installed[name] = version(name)
        except PackageNotFoundError:
            installed[name] = None
    record = {
        'schema': 'numerical-stage-execution/1',
        'script': script.name,
        'script_sha256': hashlib.sha256(script.read_bytes()).hexdigest(),
        'python': platform.python_version(),
        'required_packages': required,
        'installed_packages': installed,
        'started_utc': datetime.now(timezone.utc).isoformat(),
        'state': 'preflight',
        'script_started': False,
    }

    def save():
        record_path.parent.mkdir(parents=True, exist_ok=True)
        temporary = record_path.with_suffix('.tmp')
        temporary.write_text(json.dumps(record, indent=2) + '\n')
        temporary.replace(record_path)

    save()
    print(json.dumps({'stage': script.name, 'python': record['python'], 'packages': installed}), file=sys.stderr, flush=True)
    if installed != required:
        record.update(state='failed', exit_code=2, error='selected package versions are unavailable or different')
        save()
        return 2
    record.update(state='running', script_started=True)
    save()
    previous_argv = sys.argv
    sys.argv = [str(script)]
    code = 1
    try:
        runpy.run_path(str(script), run_name='__main__')
        code = 0
    except SystemExit as error:
        code = 0 if error.code is None else error.code if isinstance(error.code, int) else 1
        if not isinstance(error.code, (int, type(None))):
            print(error.code, file=sys.stderr)
    except BaseException as error:
        record['exception_type'] = type(error).__name__
        code = None
        raise
    finally:
        sys.argv = previous_argv
        record.update(state='completed' if code == 0 else 'failed', exit_code=code,
                      finished_utc=datetime.now(timezone.utc).isoformat())
        save()
    return code


if __name__ == '__main__':
    raise SystemExit(main())
