pmbootstrap-meow/pmb/helpers/args.py

# Copyright 2023 Oliver Smith
# SPDX-License-Identifier: GPL-3.0-or-later
from argparse import Namespace
import copy
import json
import os
from pathlib import Path
import sys
import pmb.config
from pmb.core.context import Context
from pmb.types import PmbArgs
import pmb.helpers.git
import pmb.helpers.args

__args: PmbArgs = PmbArgs()

"""This file constructs the args variable, which is passed to almost all
   functions in the pmbootstrap code base. Here's a listing of the kind of
   information it stores.

    1. Argparse
       Variables directly from command line argument parsing (see
       pmb/parse/arguments.py, the "dest" parameter of the add_argument()
       calls defines where it is stored in args).

       Examples:
       args.action ("zap", "chroot", "build" etc.)
       args.as_root (True when --as-root is passed)
       ...

    2. Argparse merged with others
       Variables from the user's config file (~/.config/pmbootstrap.cfg) that
       can be overridden from the command line (pmb/parse/arguments.py) and
       fall back to the defaults defined in pmb/config/__init__.py (see
       "defaults = {..."). The user's config file gets generated interactively
        with "pmbootstrap init".

       Examples:
       args.aports ("$WORK/cache_git/pmaports", override with --aports)
       args.device ("samsung-i9100", "qemu-amd64" etc.)
       get_context().config.work ("/home/user/.local/var/pmbootstrap", override with --work)

    3. Parsed configs
       Similar to the cache above, specific config files get parsed and added
       to args, so they can get accessed quickly (without parsing the configs
       over and over). These configs are not only used in one specific
       location, so having a short name for them increases readability of the
       code as well.

       Examples:
       args.deviceinfo (e.g. {"name": "Mydevice", "arch": "armhf", ...})
"""


def check_pmaports_path(args: PmbArgs):
    """Make sure that args.aports exists when it was overridden by --aports.

    Without this check, 'pmbootstrap init' would start cloning the
    pmaports into the default folder when args.aports does not exist.
    """
    if args.from_argparse.aports and not os.path.exists(args.aports):
        raise ValueError("pmaports path (specified with --aports) does"
                        f" not exist: {args.aports}")


# def replace_placeholders(args: PmbArgs):
#     """Replace $WORK and ~ (for path variables) in variables from any config.

#     (user's config file, default config settings or config parameters specified on commandline)
#     """
#     # Replace $WORK
#     for key, value in pmb.config.defaults.items():
#         if key not in args:
#             continue
#         old = getattr(args, key)
#         if isinstance(old, str):
#             setattr(args, key, old.replace("$WORK", str(get_context().config.work)))

#     # Replace ~ (path variables only)
#     for key in ["aports", "config", "work"]:
#         if key in args:
#             setattr(args, key, Path(getattr(args, key)).expanduser())


def add_deviceinfo(args: PmbArgs):
    """Add and verify the deviceinfo (only after initialization)"""
    setattr(args, "deviceinfo", pmb.parse.deviceinfo())
    arch = args.deviceinfo["arch"]
    if (arch != pmb.config.arch_native and
            arch not in pmb.config.build_device_architectures):
        raise ValueError("Arch '" + arch + "' is not available in"
                         " postmarketOS. If you would like to add it, see:"
                         " <https://postmarketos.org/newarch>")


def init(args: PmbArgs) -> PmbArgs:
    global __args
    # Basic initialization
    config = pmb.config.load(args)
    # pmb.config.merge_with_args(args)
    # replace_placeholders(args)

    # Configure runtime context
    context = Context(config)
    context.command_timeout = args.timeout
    context.details_to_stdout = args.details_to_stdout
    context.quiet = args.quiet
    context.offline = args.offline
    context.command = args.action
    context.cross = args.cross
    if args.mirrors_postmarketos:
        context.config.mirrors_postmarketos = args.mirrors_postmarketos
    if args.mirror_alpine:
        context.config.mirror_alpine = args.mirror_alpine
    if args.aports:
        print(f"Using pmaports from: {args.aports}")
        context.config.aports = args.aports

    # Initialize context
    pmb.core.set_context(context)

    # Initialize logs (we could raise errors below)
    pmb.helpers.logging.init(args)

    # Initialization code which may raise errors
    check_pmaports_path(args)
    if args.action not in ["init", "checksum", "config", "bootimg_analyze", "log",
                           "pull", "shutdown", "zap"]:
        pmb.config.pmaports.read_config()
        add_deviceinfo(args)
        pmb.helpers.git.parse_channels_cfg(config.aports)
        context.device_arch = args.deviceinfo["arch"]

    # Remove attributes from args so they don't get used by mistake
    delattr(args, "timeout")
    delattr(args, "details_to_stdout")
    delattr(args, "log")
    delattr(args, "quiet")
    delattr(args, "offline")
    delattr(args, "aports")
    delattr(args, "mirrors_postmarketos")
    delattr(args, "mirror_alpine")
    # args.work is deprecated!
    delattr(args, "work")
    
    # Copy all properties from args to out that don't start with underscores
    for key, value in vars(args).items():
        if not key.startswith("_") and not key == "from_argparse":
            setattr(__args, key, value)

    print(json.dumps(__args.__dict__))

    #sys.exit(0)

    return __args


def update_work(args: PmbArgs, work):
    """Update the work path in args.work and wherever $WORK was used."""
    # Start with the unmodified args from argparse
    args_new = copy.deepcopy(args.from_argparse)

    # Keep from the modified args:
    # * the unmodified args from argparse (to check if --aports was specified)
    args_new.from_argparse = args.from_argparse

    # Generate modified args again, replacing $WORK with the new work folder
    # When args.log is different, this also opens the log in the new location
    args_new.work = work
    args_new = pmb.helpers.args.init(args_new)

    # Overwrite old attributes of args with the new attributes
    for key in vars(args_new):
        setattr(args, key, getattr(args_new, key))

def please_i_really_need_args() -> PmbArgs:
    print("FIXME: retrieved args where it shouldn't be needed!")
    return __args