changes

v8.27:
	support the change to QtQuick 2 first used in v3.60~18

v8.26:
	added link to IncludeHelpers so that old packages can find correct file to source

v8.25:
	changed ReadMe to a markup document
	included PackageDevelopmentGuidelines.md in the package (previously on DropBox)

v8.24:
	8.23 did not have the blind install files

v8.23:
	add code to updatePackage and CommonResources to handle directory renames
		(e.g., dbus-generator-starter to dbus-generator)
	fixed: PackageManager crash if version string contains invalid characters
	updatePackage: fixed: USE_ORIGINAL flag files not created in some cases

v8.22:
	fixed: missing log file and directories are not created
		until the PackageManager service starts
		so messages logged before that are not present in the log file

v8.21:
	fixed: patch error for some files if package is reinstalled

v8.20:
	add support for v3.50~22 (HTML style sheet in different location)
	add dbus-pi package to defaults list

v8.19:
	fixed: system reboots after user chooses to reboot later

v8.18:
	fixed: errors when installing RemoteGPIO

v8.17:
	fixed: adding dbus setting didn't accommodate values starting in --
	fixed: generator service was restarting unnecessarily when installing packages

v8.16:
	fixed: no previous patch file error created in v8.15

v8.15:
	fixed: GUI restart doesn't always occur after install
	fixed: previouis patches file creation fails on first install
		because root fs was stil read only

v8.14:
	fixed: crash when installing packages (introduced in v8.11)

v8.12:
	readded blind install files

v8.11:
	improved install/uninstall error handling in endScript ()
	fixed: GUI and other service restarts not always happening

v8.10:
	moved velib_python in SetupHelper to a single version
	dropping support for firmware earlier than v3.10

v8.9:
	fixed: further changes for the remote GUI issue

v8.8:
	fixed: GuiMods web GUI (v1) broken (patched file permissions incorrect)

v8.7:
	updatePackage: always rebuild patch files
	provide version-dependent velib_phthon for this and other packages

v8.6:
	fixed: persistent download pending message after a download fails

v8.5:
	fixed typo in version string (v8.4 was "v8.3=4")

v8.4:
	Fixed: package install fails if it has older setup script
		(for a while, packages could have their own helper files)

v8.3:
	added GitHub check frequency: 10 minutes, hourly, daily
		reduces network bandwidth

v8.2:
	fixed: auto downloads can happen even when off (introduced in v8.1)

v8.1:
	fixed: GitHub version refresses occuring too fast (~10 seconds vs 10 minutes)

v8.0:
	allow multiple packages to modify the same file
	allow multiple patch files for each active file
	fixed: PackageManager hangs if there is no setup script in package directory
	fixed: "Once" download scan doesn't check all packages
	fixed: PackageManager hangs on Python 2 (Venus OS prior to v2.80)
	use HelperResources only from SetupHelper (not from package directory)
		this was necessary because /data/SetupHelper/patch
		is now used in place of the stock patch executable
	moved SetupHelper logging to /var/log/PackageManager/current
		from /var/log/SetupHelper
	added Recheck button for errors discovered in setup script prechecks
	PackageManager now completes pending operations before exiting
	add TailscaleGX to default package list
	updatePackage: added patch options including MANUAL to prevent automatic patch updates
	updatePackage: rewrite update file sets loop for speed improvement

v7.18:
	fixed: only first service is uninstalled

v7.17:
	services not always uninstalled

v7.16:
	fixed: PackageManager hangs with package add

v7.15:
	fixed: GitHub version not refreshed when user/branch change
	fixed: old blind install

v7.14:
	fixed: incompatible message not cleared when package no longer incompatible

v7.13:
	fixed: PackageManager doesn't install packages after firmware update

v7.12:
	fixed: PackageManager hangs if there is no setup script in package directory

v7.11:
	fixed: conflicts not cleared when they have been resolved

v7.10:
	fixed: services with dash in the name do not install/uninstall

v7.9:
	added blind install .tgz files

v7.8:
	fixed: packages getting downloaded when not needed + PackageManger crash
		results in corrupted pacakges

v7.7:
	fixed: remove duplicates a package in Active packages

v7.6:
	fixed: Package editor menus shows Now / Later in stead of Proceed / Cancel
		for Show Details

v7.5:
	fixed: PackageManager restarts when removing package

v7.4:
	version bump -- HelperResources version was not updated in v7.3

v7.3:
	fixed: GitHub versions are not refreshed when reentering the Active Packages menu
	fixed: unrecognized command showDetails
	fixed: can't remove packages from Package editor menu
	improve reporting of restart/reboot requirements in GUI

v7.2:
	more fixes for install failure GUI lockups
	fixed: repeating "checking" messages (and the assocated calls to setup scripts)

v7.1:
	fixed: install failure locks up GUI
	check for and report patching errors
v7.0:
	fixed: Package editor menu sometimes locks up with Download, etc grayed out
	fixed: file set error uninstalls package without prompting for action
	fixed: running setup script from inside the package directory fails
		e.g., cd /data/GuiMods; ./setup
	add package dependencies, conflict detection and resolution
	added file system check and status to PackageManager without installing the package
		so incomplete file set displayes on the GUI without an install attempt
	fixed: RemoteGPIO hangs during install
	add RemoteGPIO to default package list
	improved reporting of errors in Package editor
		most issues are now identified BEFORE an install
		report no file set and incomplete file set separately
			no file set allows install, incomplete does not
v6.13: (betas only - never released)
	needed to skip to 6.13 so HelperFiles selection would always work 

v6.12: (betas only - never released)

v6.11: skipped

v6.10:
	enable auto download and install after package add
		previously, packagew would not auto install if uninstalled manually

v6.9:
	fixed: file uninstall fails if extracted from setup script
	removed PackageManager download delays

v6.8:
	fixed: PackageManager won't download if package directory doesn't exist
		bug created in or about v6.5

v6.7:
	fixed: GUI white screen for versions prior to v3.00

v6.6:
	fixed: PackageManager hangs on remove
	fixed: PackageManager not setting no file set for incomplete fs

v6.5:
	fixed: package download failure not always reported on the GUI

v6.4:
	fixed: setup scripts fail if no fileList file
	updatePacakge: fixed problems related to incompatible versions
	updatePackage: fixed: helper resources updated even if there were no changes

v6.3:
	fixed: removing active pachage freezes PackageManager

v6.2:
	fixed: repeaded PackageManager install attempts when failure occurs

v6.1:
	fixed: white screen for VenusOs prior to v3.00

v6.0:
	PackageManager: clear no file set flag when stored version changes
	add automated install, uninstall based on file, services and dBuse Settings lists
	moved package reinstall after Venus OS update to PackageManager
		only SetupHelper installed by reinstallMods now
	the unix patch facility is available for modifying replacement files
		this may not work for version-dependenet files however
	"helper resources" can now reside in the package directory in addition to
		SetupHelper. The code checks for the newest copy and uses that

v5.18
	fixed: installs fail on CCGX (resize2fs failure)

v5.17:
	fixed: root not always resized after firmware update

v5.16:
	fixed: white/black screen on first boot after firmware update
	incorporate changes for GUI v1 and gui-v2 selection,
		mainly to prevent package install if GUI v1 is needed and missing

v5.15:
	fixed: PackageManager isn't in menus after v5.14 install
	updateFileSets: fixed: NO_REPLACEMENT in existing file sets that should link to other sets

v5.14:
	v5.13 did not include blind install

v5.13:
	fixed: GUI not restarted in v3.20~26
	fixed: COMPLETE flag not set when creating file new file set
		this isn't critical, just slows down installs because file set must be rechecked
	updateFileSets: fixed: USE_ORIGINAL not updated proerly
	fixed: typo in package manager backup/restore menu

v5.12:
	add support for gui-v2
	documents and screen shots moved to a public DropBox:
		https://www.dropbox.com/scl/fo/bx5aftvgrqq0vp060mwip/h?rlkey=k28c2i49fjfpcyjfsuldwp159&dl=0

v5.11:
	check for room on file systems before allowing install
	resize root partition before installing a package
		the above issues are critical to avoid bricking systems !!!!!!
	updateFileSets:
		better error checking and more status while running long loops
		a replacement file and USE_ORIGINAL flag was incorrectly allowed
			the replacement file has priority during package install so
			this was not a severe issue, but USE_ORIGINAL is now removed in this case

v5.10:
	updateFileSets: check for errors before moving version-independent files

v5.9:
	updateFileSets fixed: creating symlinks in new version sometimes fails

v5.8:
	fixed bugs in updateFileSets introduced in v5.7

v5.7:
	updateFileSets: make changes to the copy of the package
		instead of to the main package directory
		so package is not updated until changes are accepted
	updateFileSets: check for version-independent files in file sets
		and move them from the file sets to FileSets/
		version-independent files are those that do not havea stock file
		and have only one real file in all file sets (other file sets have links)

v5.6:
	fixed: version number segments starting with 0 interperted as octal
	updateFileSets: added package backup / restore
	changed status messages to: no file set for vxx.yy~zz

v5.5:
	fixed: status text in Active packages menu is black - should be white
	updateFileSets: fixed: reported no package errors when there were some

v5.3 / v5.4:
	updateFileSets: fixed: stale symlinks not removed
	updateFileSets: remove existing file sets that only contain sym links
		and are not in the stock version list
	updateFileSets: flag file sets that only contain sym links
		this aids managing file sets
	updateFileSets: add progress indication to differentiate from a hung app
		checks can now take significant amount of time

v5.1/5.2:
	removed original file symbolic links
		they are not needed (even for older verisons of SetupHelper)

v5.0:
	_checkFileSets in CommonResources:
		if file set exists and contains the COMPLETE flag file, skip all checks
		otherwise, proceed with file set validation
		or attempt to create one for the current Venus OS version
	updateFileSets now fills in all file sets with symlinks
		so that the install does not have to search for a matching original
		the search for a match has reportedly failed in a few cases for unknown reasons

v4.43:
	fixed: PackageManager crashes when reinitializing database
	fixed stuck Package Manager status messages

v4.42:
	fixed: updated services are not always restarted
	add ExtTransferSwitch to default package list

v4.41:
	added support for dark mode (thanks mr-manual)

v4.40:
	fixed bug in updateFileSets that resulted in no replacement file errors
		an incorrect not a released version warning

v4.39:
	updateFileSets now allows creating file sets for only released versions
	installService in ServiceResources now supports multiple services in package
	fixed: install button in package edit menu sometimes drawn in wrong posisition

v4.38:
	fixed: v4.37 overwrote settingsOptions and added logs.zip to /dataw

v4.37:
	add settings backup to local storage (/data/settingsBackup)

v4.36:
	fixed: crash if version file contains a zero length string (not counting white space)
	split add stored packages processing to reduce execution time in main loop
	enhanced Git Hub version updates:
		longer background updtate time (10 minutes vs 1 minute)
		complete refresh when entering Active packages menu

v4.35:
	fixed: package edit menu buttons are not active after v4.34 update

v4.34:
	disable GitHub version updates if automatic downloads are off
		eliminates internet traffic needed to retrieve version
	remove ._ files from blind install archives
	added BatteryAggregator (pulquero) to default packages
	updateFileSets now place files at highest possible version
		makes searches faster and makes removing old file sets easier
	checkFileSets now searches version list from highest version to lowest
		to improve file set creation speed

v4.33:
	fixed: menu items not being hidden
	added all logs to Settings backup
	added optional Venus OS firmware update to blindUninstall

v4.32:
	add some packages to the default list

v4.31:
	fixed: PackageManager edit menus not working

v4.30:
	fixed: can't select many items in PackageManager menus
	add Cerbo SGX platform
	add ExtTransferSwitch to default package list
	add FroniusSmartmeter to default package list
	add dbus-i2c to default package list
	add DCSystemAggregator to default package list
	add gatt-exec-server to default package list

v4.28/v4.29:
	make SetupHelper independent of Venus OS version

v4.27:
	fixed 20 MB size for blind isntall archive

v4.25:
	fixed: downloads triggered from the PackageManager edit menu
		are sometimes are delayed by automatic download checks
	fixed: fast download sometimes ends before all packages are checked
	removed Fast, then Normal download mode
		fast downloads are now automatic when enabling downloads

v4.24:
	fixed: incompatible version check somtimes fails

v4.23:
	added Cerbo tanks and temps backup/restore
v4.22:
	fixed: reinstallMods does not reboot or restart the GUI if needed
	included detailed description / help creating setup scripts and file sets

v4.21:
	add missing settings to backup/restore
v4.20:
	added support for v2.90~22


v4.19:
	fixed: after a blind install rcS.local did not get updated
	optimized reinstallMods - wait for dbus only if script needs to run

v4.18:
	check versions before installing a package from removable media
	check versions before transferring a package from removable media
	these prevent a package with ONE_TIME_INSTALL set from installing over and over agin
		if the removable media is left in place and the system rebooted
	additional fixes for reinstall not working after an OS update

v4.17:
	fixed: reinstall not working after OS update
	added AUTO_INSTALL_PACKAGES flag to /data
		this flag is easier to build into an archive than the one on removable media
		but is removed following the auto install to prevent repeats
	added AUTO_INSTALL flag in each package
		this overides the user auto install preferece
	dropped support for Venus OS v2.4x and 2.5x

v4.16:
	fixed: white screen in Venus v2.73 and earlier

v4.15:
	released - no changes

v4.15~7:
	added delays in install service so things get initialized properly

v4.15~6:
	added blind UNINSTALL via a special venus-data.tar.gz file
		see instructions in the ReadMe

v4.14~5:
	added PackageManager persistent storage initialize
		Both the INITIALZE_PACKAGE_MANAGER flag file on removable media
		and a menu item has been added that will trigger the 
		PackageManager dbus Setting storageto be initialized,
		then PackageManager restarted.
		The storage is then rebuilt when PackageManager starts back up.
	added UNNSTALL_ALL_PACKAGES removable media flag
		If this file is found on removable media, PackageManager
		will UNINSTALL ALL packages including SetupHelper
	these additions help recover systems without a user interface to factory conditions,
	including a blank or unresponsive GUI

v4.14~4:
	updated ReadMe
	fixed: auto eject occured on manual settings restore
		should be just AUTOMATIC restores

v4.14~3:
	add auto eject
	fixed: couldn't backup or restore settings

v4.14~2:
	settings restore now creates missing parameters
	rewrote blind install to use the pre/post hooks for v2.90
		blind install still works with prior Venus OS versions
	added AUTO_INSTALL_PACKAGES flag file on removable media
		functions same as enabling auto install in PackageManager menu
	added support for new /service mechanisms in v2.90

v4.14~1:
	add settings auto restore if SETTINGS_AUTO_RESTORE flag file exists on removable media

v4.13:
	add logs as part of settings backup

v4.12:
	added checks for file set errors before attempting auto install

v4.11:
	added support for Venus OS v2.90~3 firmware

v4.9/10:
	added dbus Settings cleanup to remove invalid packages

v4.8:
	fixed: blind install fails if stored SetupHelper version is newer than archive version
		but SetupHelper not currently installed.

v4.7:
	fixed: another bug matching original files from released and large verisons

v4.6:
	fixed: released version file set skipped for versions still in beta
		this typically only happens for a large version
		after the small version is released

v4.5:
	forgot to update blind install files

v4.4:
	added v2.80 - no functional changes

v4.3:
	include package setup script options in settings backup/restore

v4.2:
	fixed: intermittent crash on initialization
	fixed: PackageManager doesn't always start after installing SetupHelper
		with the service overlay
		when uninstalling then installing SetupHelper, PackageManager didn't start
	fixed: field reports of package with no name in active package list
		remove any such packages during initialization

v4.1:
	fixed: packageManager crash when moving old DO_NOT ... flags to setupOptions
	fixed: white screen on v2.8~33-large-24

v4.0:
	beta test period ended
	added running version to PackageManager sign-on

v4.0~38:
	fixed: backup/restore hangs

v4.0~37:
	changed the blind install process to minimize issues if venus-data.tgz is left mounted
	SetupHelper now unpacks to /data/SetupHelper-blind,
		then is moved to /data/SetupHelper and the setup script run
		ONLY IF it is a newer version

v4.0~36:
	blind install was't updated for ~35 !!!

v4.0~35:
	reinstall now compares installed and package versions and installs if they differ
	previously, booting to the alternate installed Venus version would not trigger
		a package reinstall, possibly resulting in problems or at least out of date packages

v4.0~34:
	added image overlays to backup/restore
		this includes custom logos for Mobile and Tile overviews

v4.0~33:
	fixed: PackageManager doesn't run on Venus versions prior to v2.80~10 (Python 2).

v4.0~32:
	fixed: version numbers not in the Victron format would crash PackageManager
		also accommodate a other version string formats:
		vX.Y.Z, vX.YdZ, vX.YaZ, vX.YbZ

v4.0~31:
	fixed crashes and bugs that prevented initial install on a system
		that has no packages yet

v4.0~30:
	added settings backup/restore
		note this is NOT the Victron mechanism
		rather, it extracts SOME of the Settings parameters
		and writes these to a file
		care was taken to save/restore only those parameters that
			should not cause conflicts
		When Victron releases their mechanism, this one will be removed

v4.0~26:
	fixed: Large features not appearing
	fixed: typo in 123SmartBMS-Venus in defaultPackageList

v4.0~25:
	handle nonexistant package directory
	pull GitHub user/branch from package directory file
	optimize AddStoredPackages so it can run all the time
		(some updates were being missed)
	changed default package name: smartbms-venus to 123SmartBMS-Venus

v4.0~24:
	add Reboot/GUI restart button to Package Manager main menu
		to address deferred operations ("Later")

v4.0~23:
	fixed: GUI restart not happening after auto install
	fixed: GUI restart notificaiton in menu not cleared after GUI restart
v4.0~22: not used
v4.0~21:
	fixed: adding package didn't carry over GitHub user and branch

v4.0~20:
	rearranged package editor menus
		Package version list -> Active packages
			tapping on an entry leads to Package editor
		added Inactive packages
			which shows only packages that are not on the system yet (or manually removed)
			tapping on entry leads to Add package menu
		added separate Add package menu
		Package Editor eliminated from main menu (access through Active packages only)
	default packages are no longer automatically added to the active package list

v4.0~19:
	fixed: venus-data.tar.gz in v2.80~18 didn't include PackageManager.py

v4.0~18:
	fixed: packages auto add/install when PackageManager is restarted
		even if REMOVED / DO_NOT_AUTO_INSTALL was set
	more work on GUI getting "stuck"
	bogus "unpack tar from GitHub failed" message - package downloads properly
	major change to thread structure to make operations more responsive
		and to minimize CPU consumption when idle

v4.0~17:
	fixed: package editor status did not always show package name
	fixed?: occationally, Package Editor appears to get stuck when a PackageManager
			action completes.
		A missed property update from the dbus paramter may be yhe cause
		Set a timer to refresh properties in the GUI

v4.0~16:
	fixed: packages auto auto-adding following manual removal

v4.0~15:
	fixed: auto download not working
	moved dbus settings for PackageManager to /Settings/PackageManager
		from /Settings/PackageMonitor
	remove dbusSettings when package is removed
		previously these were left in place
	changed menu items and titles to conform to Victron standards:
		only firt word capitalized

v4.0~14:
	fixed: selecting "Now" in GUI when reboot needed does nothing
	fixed: blind install did not work

v4.0~13:
	added support for Venus OS v2.80~33-large-24

v4.0~12:
	fixed: manually uninstalled packages would reinstall immediately
		if auto install was on
	accommodate Python 2.7 for Venus OS prior to v2.80~10
	fixed: a setup script run failure was not handled properly and
		caused the install thread to hang
v4.0~11:
	fixed bug that caused GUI to restart repeatedly if package was not
		compatible with the current Venus version
		e.g., a file set error
	major rewrite to PackageManager download code
	changes to GUI:
		Add Package -> New Package
		moved SetpHelper uninstall warning to status
		moved action confirmaiton message to status,
			Confirm ... button now reads Proceed
		removed "can't remove" ... message
v4.0~10:
	GitHub downloads and SD/USB transfers now scan the entire directory tree
		searching for a package directory. This was done because of the 123 smartBMS
		archive directory structure but there are other issues preventing integration
		with PackageManger.
	Fixed bug that showed a blank status line with the OK button after a download
		Rhe OK button no longer appears and Package Editor menu returns
		to the "navigation" mode

v4.0~9:
	fixed bug with firstCompatibleVersion
	added try: / except: around all subprocess.run calls
		so if the call fails, the program continues to run

v4.0~8:
	refresh GitHub version prior to download checks
		new upadates to GitHub could be missed
	reduced GitHub vesion refres delay
	touching a row in Package Version List menu
		leads to Package Editor menu
		and < will return to the version list

v4.0~5 - 7:
	download bug fixes
v4.0~4:
	add Package Manager & GUI
	add setup script return codes for above
	add optionsRequired flag file (VeCanSetup is only package that needs this now)

	add platform and version checks to CommonResources
	add install opiton to CommonResources
	better support installs without command line
	### TBD remove logging to package log files

	improve adding packages from SD/USB

	split auto download and auto install