Source code for kqcircuits.pya_resolver

# This code is part of KQCircuits
# Copyright (C) 2021 IQM Finland Oy
#
# This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public
# License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later
# version.
#
# This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along with this program. If not, see
# https://www.gnu.org/licenses/gpl-3.0.html.
#
# The software distribution should follow IQM trademark policy for open-source software
# (meetiqm.com/iqm-open-source-trademark-policy). IQM welcomes contributions to the code.
# Please see our contribution agreements for individuals (meetiqm.com/iqm-individual-contributor-license-agreement)
# and organizations (meetiqm.com/iqm-organization-contributor-license-agreement).


"""This module is used for importing the KLayout Python API (pya).

Without this module, the API would need to be imported using ``import pya`` for usage in KLayout Editor and using
``import klayout.db`` for usage with standalone klayout package. To make it simple to create a python module for both
use cases, this module automatically imports the correct module and exposes it as ``pya``.

It also contains convenience functions to find the KLayout executable and the running session type.

Usage:
    from kqcircuits.pya_resolver import pya

"""

import os
import platform
from pathlib import Path
from shutil import which

try:
    import pya
    import pya as lay  # pylint: disable=unused-import
except ImportError:
    import klayout.db as pya
    from klayout import lay  # pylint: disable=unused-import


[docs] def is_standalone_session(): return not hasattr(pya, "Application")
[docs] def klayout_executable_command(): """Returns the KLayout executable command's full path in the current OS. Or ``None`` if it is not found.""" if is_standalone_session(): if platform.system() == "Windows": klayout_path = which("klayout_app.exe") if klayout_path is None: # try the default location dwp = Path(os.getenv("APPDATA")).joinpath("KLayout/klayout_app.exe") if dwp.is_file(): return str(dwp) return klayout_path klayout_path = which("klayout") # Linux is simple :) if klayout_path is None and platform.system() == "Darwin": dwp = "/Applications/klayout.app/Contents/MacOS/klayout" if Path(dwp).is_file(): return dwp dwp = "/Applications/KLayout/klayout.app/Contents/MacOS/klayout" if Path(dwp).is_file(): return dwp return klayout_path else: # The path of the currently running KLayout application return pya.Application.instance().applicationFilePath()