pyenv-virtualenv-prefix Namespace Reference

Functions
int	run (argparse.Namespace args)
	Sub routine to run the application.
tuple[(argparse.Namespace, None), int]	parseCliArguments0 ()
	Parse CLI arguments for this application.
tuple[(argparse.Namespace, None), int]	parseCliArguments1 ()
	Parse CLI arguments for this application.
int	main ()
	Main routine of the application.

Function Documentation

run()

int pyenv-virtualenv-prefix.run

(

argparse.Namespace

args

)

Sub routine to run the application.

Parameters

args	Given command line arguments.

Returns

RC = 0 or other values in case of error.

Definition at line 51 of file pyenv-virtualenv-prefix.py.

def run(args: argparse.Namespace) -> int:
    rc: int = 0
    # noinspection PyBroadException
    try:
        while True:
            log.verbose(
                'Display "real_prefix" for a Python virtual environment version.'
            )
            name = ''
            try:
                # Use the given "version" argument
                name: str = args.name
                name_given = True
            except AttributeError:
                name_given = False
            if name_given:
                result = ''
                filtered_envs = hlp.getAllEnvs(
                    name,
                    as_paths=True
                )
                if len(filtered_envs) > 0:
                    for env in filtered_envs:
                        pl = env.split(os.sep)
                        for i in range(len(pl)):
                            item = pl[i]
                            if item == 'versions':
                                if len(result) > 0:
                                    result += '\r\n'
                                result += os.sep.join(pl[:i + 2])
                    print(result)
                else:
                    log.warning('Cannot find virtual environments like "{}".'.format(args.name))
                    log.info('Try again with another filter by name. Wildcards are implemented.')
            else:
                # Check if the path to Python executable
                # passes into a virtual environment.
                log.debug('Python executable: "{}".'.format(sys.executable))
                pl = sys.executable.split(os.sep)
                if (
                    ('envs' in pl)
                    and
                    ('Scripts' in pl)
                    and
                    (os.path.isfile(
                        os.path.join(
                            os.path.dirname(sys.executable),
                            '..',
                            'pyvenv.cfg'
                        )
                    ))
                ):
                    # Virtual environment detected
                    result = ''
                    for i in range(len(pl)):
                        item = pl[i]
                        if item == 'versions':
                            result = os.sep.join(pl[:i + 2])
                            break
                    if result == '':
                        log.error('Cannot determine Python version for this virtual environment.')
                        rc = 1
                        break
                    print(result)
                else:
                    # Not in virtual environment
                    version = sys.version.split(' ')[0]
                    log.warning("'pyenv-virtualenv': Python version {} is not a virtual environment.".format(version))
                    log.info('Executable: "{}".'.format(sys.executable))
                    log.info("Activate a virtual environment using the 'activate' command'. Then try again.")
                    rc = 5
                    break
            # End if
            # Go on
            break
        # End while
    except:
        log.error(sys.exc_info())
        rc = 1
    return rc
 
 
# --- MAIN --------------------------------------------------------------
 

parseCliArguments0()

tuple[(argparse.Namespace, None), int] pyenv-virtualenv-prefix.parseCliArguments0

(

)

Parse CLI arguments for this application.

Implement this as required, but don't touch the interface definition for input and output.

Returns

A tuple of:

• Namespace to read arguments in "dot" notation or None in case of help or error.
• RC = 0 or another value in case of error.

Definition at line 144 of file pyenv-virtualenv-prefix.py.

def parseCliArguments0() -> tuple[(argparse.Namespace, None), int]:
    rc: int = 0
    # noinspection PyBroadException
    try:
        parser = argparse.ArgumentParser(
# --- BEGIN CHANGE -----------------------------------------------------
            prog='pyenv virtualenv-prefix',
            description='Display "real_prefix" for a Python virtual environment version.'
        )
# --- END CHANGE -------------------------------------------------------
        return parser.parse_args(), rc
    except SystemExit:
        return None, 0
    except:
        log.error(sys.exc_info())
        return None, 1
 

parseCliArguments1()

tuple[(argparse.Namespace, None), int] pyenv-virtualenv-prefix.parseCliArguments1

(

)

Parse CLI arguments for this application.

Implement this as required, but don't touch the interface definition for input and output.

Returns

A tuple of:

• Namespace to read arguments in "dot" notation or None in case of help or error.
• RC = 0 or another value in case of error.

Definition at line 170 of file pyenv-virtualenv-prefix.py.

def parseCliArguments1() -> tuple[(argparse.Namespace, None), int]:
    rc: int = 0
    # noinspection PyBroadException
    try:
        parser = argparse.ArgumentParser(
# --- BEGIN CHANGE -----------------------------------------------------
            prog='pyenv virtualenv-prefix',
            description='Display "real_prefix" for a Python virtual environment version.'
        )
        # Add positional str argument
        parser.add_argument(
            'name',
            help='Short name of an installed Python virtual environment. Default: Empty string = analyze the CWD.'
        )
# --- END CHANGE -------------------------------------------------------
        return parser.parse_args(), rc
    except SystemExit:
        return None, 0
    except:
        log.error(sys.exc_info())
        return None, 1
 

main()

int pyenv-virtualenv-prefix.main

(

)

Main routine of the application.

Returns

RC = 0 or other values in case of error.

Definition at line 195 of file pyenv-virtualenv-prefix.py.

def main() -> int:
    # noinspection PyBroadException
    try:
        while True:
            # Audit the operating system platform
            rc = hlp.auditPlatform('Windows')
            if rc != 0:
                # Deviation: Reject unsupported platform
                break
            # Audit the global Python version number
            rc = hlp.auditGlobalPythonVersion('3.6')
            if rc != 0:
                # Deviation: Reject unsupported Python version
                break
            # Initialize the colored logging to console
            log.initLogging()
            # Audit the "pyenv" version number
            rc = hlp.auditPyEnv('3')
            if rc != 0:
                # Deviation: Reject unsupported "pyenv" version
                break
            # Parse arguments
            # NOTE: Sorry, this is a complicated workaround to
            # bypass the lack of applicability of Python "ArgumentParser"
            # class. This simple use case to set required = False for
            # positional argument is not included and must be patched
            # away here.
            log.verbose('Parsing arguments ...')
            args = None
            args_list = sys.argv.copy()  # Clone
            # Strip program executable path
            args_list.pop(0)
            # Detect and remove all optional arguments,
            # which are not related to the positional arguments
            help_requested = False
            for i in reversed(range(len(args_list))):
                arg = args_list[i]
                if arg in ['-h', '--help']:
                    help_requested = True
                    args_list.pop(i)
            # Calculate the count of positional arguments
            positional_count = len(args_list)
            if (
                    help_requested
                    or
                    (positional_count not in [0, 1])
            ):
                text = ("""
Usage: pyenv virtualenv-prefix [-h] [name]
 
Display "real_prefix" for a Python virtual environment version.
 
Positional arguments (can be omitted):
  [name]      Short name of an installed Python virtual environment.
              Default: Empty string = analyze the CWD.
Options:
  -h, --help  Show this help message and exit
                """).strip()
                print(text)
            elif positional_count == 0:
                # Case 1: single positional argument must be "Name"
                args, rc = parseCliArguments0()
            elif positional_count == 1:
                # Case 2: duo positional arguments must be "Version" and "Name"
                args, rc = parseCliArguments1()
            if rc != 0:
                break
            if args is None:  # -h, --help
                break
            # Run this application
            log.verbose('Running application ...')
            rc = run(args)
            if rc != 0:
                break
            # Go on
            break
        # End while
    except Exception as exc:
        if log.isInitialized():
            log.error(sys.exc_info())
        else:
            print(
                '\x1b[91mERROR: Unexpected error "%s".\x1b[0m'
                %
                str(exc)
            )
        rc = 1
    return rc