# Copyright (c) 2014-present PlatformIO <contact@platformio.org>

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

import os

import sys

import traceback

import click

from platformio import __version__, exception, maintenance

from platformio.cli import PlatformioCLI

from platformio.compat import IS_CYGWIN, ensure_python3

@click.command(

cls=PlatformioCLI, context_settings=dict(help_option_names=["-h", "--help"])

)

@click.version_option(__version__, prog_name="PlatformIO Core")

@click.option("--force", "-f", is_flag=True, help="DEPRECATED", hidden=True)

@click.option("--caller", "-c", help="Caller ID (service)")

@click.option("--no-ansi", is_flag=True, help="Do not print ANSI control characters")

@click.pass_context

def cli(ctx, force, caller, no_ansi): # pylint: disable=unused-argument

try:

if (

no_ansi

or str(

os.getenv("PLATFORMIO_NO_ANSI", os.getenv("PLATFORMIO_DISABLE_COLOR"))

).lower()

== "true"

):

# pylint: disable=protected-access

click._compat.isatty = lambda stream: False

elif (

str(

os.getenv("PLATFORMIO_FORCE_ANSI", os.getenv("PLATFORMIO_FORCE_COLOR"))

).lower()

== "true"

):

# pylint: disable=protected-access

click._compat.isatty = lambda stream: True

except: # pylint: disable=bare-except

pass

maintenance.on_cmd_start(ctx, caller)

@cli.result_callback()

@click.pass_context

def process_result(*_, **__):

maintenance.on_cmd_end()

def configure():

if IS_CYGWIN:

raise exception.CygwinEnvDetected()

# https://urllib3.readthedocs.org

# /en/latest/security.html#insecureplatformwarning

try:

import urllib3 # pylint: disable=import-outside-toplevel

urllib3.disable_warnings()

except (AttributeError, ImportError):

pass

# Handle IOError issue with VSCode's Terminal (Windows)

click_echo_origin = [click.echo, click.secho]

def _safe_echo(origin, *args, **kwargs):

try:

click_echo_origin[origin](*args, **kwargs)

except IOError:

(sys.stderr.write if kwargs.get("err") else sys.stdout.write)(

"%s\n" % (args[0] if args else "")

)

click.echo = lambda *args, **kwargs: _safe_echo(0, *args, **kwargs)

click.secho = lambda *args, **kwargs: _safe_echo(1, *args, **kwargs)

def main(argv=None):

exit_code = 0

prev_sys_argv = sys.argv[:]

if argv:

assert isinstance(argv, list)

sys.argv = argv

try:

ensure_python3(raise_exception=True)

configure()

cli() # pylint: disable=no-value-for-parameter

except SystemExit as exc:

if exc.code and str(exc.code).isdigit():

exit_code = int(exc.code)

except Exception as exc: # pylint: disable=broad-except

if not isinstance(exc, exception.ReturnErrorCode):

maintenance.on_platformio_exception(exc)

error_str = f"{exc.__class__.__name__}: "

if isinstance(exc, exception.PlatformioException):

error_str += str(exc)

else:

error_str += traceback.format_exc()

error_str += """

============================================================

An unexpected error occurred. Further steps:

* Verify that you have the latest version of PlatformIO using

`python -m pip install -U platformio` command

* Try to find answer in FAQ Troubleshooting section

https://docs.platformio.org/page/faq/index.html

* Report this problem to the developers

https://github.com/platformio/platformio-core/issues

============================================================

"""

click.secho(error_str, fg="red", err=True)

exit_code = int(str(exc)) if str(exc).isdigit() else 1

maintenance.on_platformio_exit()

sys.argv = prev_sys_argv

return exit_code

def debug_gdb_main():

return main([sys.argv[0], "debug", "--interface", "gdb"] + sys.argv[1:])

if __name__ == "__main__":

sys.exit(main())