# install

Installation script for the eric IDE and all eric related tools.

### Global Attributes

BlackLists
PlatformsBlackLists
apisDir
cfg
configLength
configName
createInstallInfoFile
currDir
defaultMacAppBundleName
defaultMacAppBundlePath
defaultMacPythonExe
distDir
doCleanDesktopLinks
doCleanup
doCompile
eric7SourceDir
forceCleanDesktopLinks
ignorePyqt6Tools
installApis
installCwd
installInfo
installInfoName
macAppBundleName
macAppBundlePath
macPythonExe
modDir
platBinDir
platBinDirOld
progLanguages
progName
pyModDir
sourceDir
verbose
yes2All

### Classes

None

### Functions

__pyName | Local function to create the Python source file name for the compiled .ui file.
cleanUp | Uninstall the old eric files.
cleanUpLinuxSpecifics | Clean up Linux specific files.
cleanUpMacAppBundle | Uninstall the macOS application bundle.
cleanUpWindowsLinks | Clean up the Desktop and Start Menu entries for Windows.
cleanupSource | Cleanup the sources directory to get rid of leftover files and directories.
compileUiFiles | Compile the .ui files to Python sources.
copyAppStreamFile | Modify an appstream file and write it to its destination.
copyDesktopFile | Modify a desktop file and write it to its destination.
copyToFile | Copy a string to a file.
copyTree | Copy Python, translation, documentation, wizards configuration, designer template files and DTDs of a directory tree.
createConfig | Create a config file with the respective config entries.
createGlobalPluginsDir | Create the global plugins directory, if it doesn't exist.
createInstallConfig | Create the installation config dictionary.
createInstallInfo | Record information about the way eric was installed.
createLinuxSpecifics | Install Linux specific files.
createMacAppBundle | Create a Mac application bundle.
createPyWrapper | Create an executable wrapper for a Python script.
createWindowsLinks | Create Desktop and Start Menu links.
createWindowsShortcut | Create Windows shortcut.
doDependancyChecks | Perform some dependency checks.
exit | Exit the install script.
getWinregEntry | Function to get an entry from the Windows Registry.
initGlobals | Module function to set the values of globals that need more than a simple assignment.
installEric | Actually perform the installation steps.
isPipOutdated | Check, if pip is outdated.
main | The main function of the script.
pipInstall | Install the given package via pip.
prepareInfoFile | Function to prepare an Info.py file when installing from source.
shutilCopy | Wrapper function around shutil.copy() to ensure the permissions.
updatePip | Update the installed pip package.
usage | Display a usage message and exit.
versionToStr | Function to convert a version number into a version string.
windowsDesktopEntries | Function to generate data for the Windows Desktop links.
windowsDesktopNames | Function to generate the link names for the Windows Desktop.
windowsProgramsEntry | Function to generate the name of the Start Menu top entry.
wrapperNames | Create the platform specific names for the wrapper script.

## __pyName

__pyName(py_dir, py_file)

Local function to create the Python source file name for the compiled .ui file.

py_dir
  suggested name of the directory (string)
py_file
  suggested name for the compile source file (string)

Return:
  tuple of directory name (string) and source file name (string)

Up

## cleanUp

cleanUp()

Uninstall the old eric files.

Up

## cleanUpLinuxSpecifics

cleanUpLinuxSpecifics()

Clean up Linux specific files.

Up

## cleanUpMacAppBundle

cleanUpMacAppBundle()

Uninstall the macOS application bundle.

Up

## cleanUpWindowsLinks

cleanUpWindowsLinks()

Clean up the Desktop and Start Menu entries for Windows.

Up

## cleanupSource

cleanupSource(dirName)

Cleanup the sources directory to get rid of leftover files and directories.

dirName
  name of the directory to prune (string)

Up

## compileUiFiles

compileUiFiles()

Compile the .ui files to Python sources.

Up

## copyAppStreamFile

copyAppStreamFile(src, dst)

Modify an appstream file and write it to its destination.

src
  source file name (string)
dst
  destination file name (string)

Up

## copyDesktopFile

copyDesktopFile(src, dst)

Modify a desktop file and write it to its destination.

src
  source file name (string)
dst
  destination file name (string)

Up

## copyToFile

copyToFile(name, text)

Copy a string to a file.

name
  the name of the file.
text
  the contents to copy to the file.

Up

## copyTree

copyTree(src, dst, filters, excludeDirs=None, excludePatterns=None)

Copy Python, translation, documentation, wizards configuration, designer template files and DTDs of a directory tree.

src
  name of the source directory
dst
  name of the destination directory
filters
  list of filter pattern determining the files to be copied
excludeDirs
  list of (sub)directories to exclude from copying
excludePatterns
  list of filter pattern determining the files to be skipped

Up

## createConfig

createConfig()

Create a config file with the respective config entries.

Up

## createGlobalPluginsDir

createGlobalPluginsDir()

Create the global plugins directory, if it doesn't exist.

Up

## createInstallConfig

createInstallConfig()

Create the installation config dictionary.

Up

## createInstallInfo

createInstallInfo()

Record information about the way eric was installed.

Up

## createLinuxSpecifics

createLinuxSpecifics()

Install Linux specific files.

Up

## createMacAppBundle

createMacAppBundle(pydir)

Create a Mac application bundle.

pydir (str)
  the name of the directory where the Python script will eventually be installed

Up

## createPyWrapper

createPyWrapper(pydir, wfile, saveDir, isGuiScript=True)

Create an executable wrapper for a Python script.

pydir
  the name of the directory where the Python script will eventually be installed (string)
wfile
  the basename of the wrapper (string)
saveDir
  directory to save the file into (string)
isGuiScript
  flag indicating a wrapper script for a GUI application (boolean)

Return:
  the platform specific name of the wrapper (string)

Up

## createWindowsLinks

createWindowsLinks()

Create Desktop and Start Menu links.

Up

## createWindowsShortcut

createWindowsShortcut(linkPath, targetPath, iconPath)

Create Windows shortcut.

linkPath (str)
  path of the shortcut file
targetPath (str)
  path the shortcut shall point to
iconPath (str)
  path of the icon file

Up

## doDependancyChecks

doDependancyChecks()

Perform some dependency checks.

Up

## exit

exit(rcode=0)

Exit the install script.

rcode
  result code to report back (integer)

Up

## getWinregEntry

getWinregEntry(name, path)

Function to get an entry from the Windows Registry.

name (str)
  variable name
path (str)
  registry path of the variable

Return:
  value of requested registry variable

Return Type:
  any

Up

## initGlobals

initGlobals()

Module function to set the values of globals that need more than a simple assignment.

Up

## installEric

installEric()

Actually perform the installation steps.

Return:
  result code (integer)

Up

## isPipOutdated

isPipOutdated()

Check, if pip is outdated.

Return:
  flag indicating an outdated pip

Return Type:
  bool

Up

## main

main(argv)

The main function of the script.

argv (list of str)
  list of command line arguments

Up

## pipInstall

pipInstall(packageName, message, force=True)

Install the given package via pip.

packageName (str)
  name of the package to be installed
message (str)
  message to be shown to the user
force (bool)
  flag indicating to perform the installation without asking the user

Return:
  flag indicating a successful installation

Return Type:
  bool

Up

## prepareInfoFile

prepareInfoFile(fileName)

Function to prepare an Info.py file when installing from source.

fileName
  name of the Python file containing the info (string)

Up

## shutilCopy

shutilCopy(src, dst, perm=0o644)

Wrapper function around shutil.copy() to ensure the permissions.

src
  source file name (string)
dst
  destination file name or directory name (string)
perm
  permissions to be set (integer)

Up

## updatePip

updatePip()

Update the installed pip package.

Up

## usage

usage(rcode=2)

Display a usage message and exit.

rcode
  the return code passed back to the calling process.

Up

## versionToStr

versionToStr(version)

Function to convert a version number into a version string.

version (int)
  version number to convert

Return:
  version string

Return Type:
  str

Up

## windowsDesktopEntries

windowsDesktopEntries()

Function to generate data for the Windows Desktop links.

Return:
  list of tuples containing the desktop link name, the link target and the icon target

Return Type:
  list of tuples of (str, str, str)

Up

## windowsDesktopNames

windowsDesktopNames()

Function to generate the link names for the Windows Desktop.

Return:
  list of desktop link names

Return Type:
  list of str

Up

## windowsProgramsEntry

windowsProgramsEntry()

Function to generate the name of the Start Menu top entry.

Return:
  name of the Start Menu top entry

Return Type:
  str

Up

## wrapperNames

wrapperNames(dname, wfile)

Create the platform specific names for the wrapper script.

dname
  name of the directory to place the wrapper into
wfile
  basename (without extension) of the wrapper script

Return:
  the names of the wrapper scripts

Up