kitstarter 0.1.0__py2.py3-none-any.whl

kitstarter/__init__.py

@@ -0,0 +1,141 @@
+#  kitstarter/__init__.py
+#
+#  Copyright 2025 Leon Dionne <ldionne@dridesign.sh.cn>
+#
+"""
+kitstarter is a program you can use to "sketch in" a drumkit SFZ file.
+"""
+import sys, os, argparse, logging, json, glob
+try:
+	from functools import cache
+except ImportError:
+	from functools import lru_cache as cache
+from PyQt5.QtCore import QSettings
+from PyQt5.QtWidgets import QApplication, QWidget, QSplitter
+from qt_extras import DevilBox
+from conn_jack import JackConnectError
+
+__version__ = "0.1.0"
+
+
+APPLICATION_NAME	= "KitStarter"
+PACKAGE_DIR			= os.path.dirname(__file__)
+DEFAULT_STYLE		= 'system'
+KEY_STYLE			= 'Style'
+KEY_RECENT_FOLDER	= 'RecentProjectFolder'
+KEY_FILES_ROOT		= 'FilesRoot'
+KEY_FILES_CURRENT	= 'FilesCurrent'
+
+@cache
+def settings():
+	return QSettings('ZenSoSo', 'kitstarter')
+
+
+@cache
+def styles():
+	return {
+		os.path.splitext(os.path.basename(path))[0] : path \
+		for path in glob.glob(os.path.join(PACKAGE_DIR, 'styles', '*.css'))
+	}
+
+def set_application_style():
+	style = settings().value(KEY_STYLE, DEFAULT_STYLE)
+	try:
+		with open(styles()[style], 'r', encoding = 'utf-8') as cssfile:
+			QApplication.instance().setStyleSheet(cssfile.read())
+	except KeyError:
+		pass
+
+# -------------------------------------------------------------------
+# Cross-platform open any file / folder with system associated tool
+
+def xdg_open(filename):
+	if system() == "Windows":
+		startfile(filename)
+	elif system() == "Darwin":
+		Popen(["open", filename])
+	else:
+		Popen(["xdg-open", filename])
+
+
+# -------------------------------------------------------------------
+# Add save / restore geometry methods to the QWidget class:
+
+def _restore_geometry(widget):
+	"""
+	Restores geometry from musecbox settings using automatically generated key.
+	"""
+	if not hasattr(widget, 'restoreGeometry'):
+		return
+	geometry = settings().value(_geometry_key(widget))
+	if not geometry is None:
+		widget.restoreGeometry(geometry)
+	for splitter in widget.findChildren(QSplitter):
+		geometry = settings().value(_splitter_geometry_key(widget, splitter))
+		if not geometry is None:
+			splitter.restoreState(geometry)
+
+def _save_geometry(widget):
+	"""
+	Saves geometry to musecbox settings using automatically generated key.
+	"""
+	if not hasattr(widget, 'saveGeometry'):
+		return
+	settings().setValue(_geometry_key(widget), widget.saveGeometry())
+	for splitter in widget.findChildren(QSplitter):
+		settings().setValue(_splitter_geometry_key(widget, splitter), splitter.saveState())
+
+def _geometry_key(widget):
+	"""
+	Automatic QSettings key generated from class name.
+	"""
+	return f'{type(widget).__name__}/geometry'
+
+def _splitter_geometry_key(widget, splitter):
+	"""
+	Automatic QSettings key generated from class name.
+	"""
+	return f'{type(widget).__name__}/{splitter.objectName()}/geometry'
+
+QWidget.restore_geometry = _restore_geometry
+QWidget.save_geometry = _save_geometry
+
+
+def main():
+	from kitstarter.gui.main_window import MainWindow
+
+	p = argparse.ArgumentParser()
+	p.epilog = """
+	Write your help text!
+	"""
+	p.add_argument('Filename', type=str, nargs='?', help='.SFZ file to import')
+	p.add_argument("--verbose", "-v", action="store_true", help="Show more detailed debug information")
+	options = p.parse_args()
+	log_level = logging.DEBUG if options.verbose else logging.ERROR
+	log_format = "[%(filename)24s:%(lineno)4d] %(levelname)-8s %(message)s"
+	logging.basicConfig(level = log_level, format = log_format)
+
+	#-----------------------------------------------------------------------
+	# Annoyance fix per:
+	# https://stackoverflow.com/questions/986964/qt-session-management-error
+	try:
+		del os.environ['SESSION_MANAGER']
+	except KeyError:
+		pass
+	#-----------------------------------------------------------------------
+
+	app = QApplication([])
+	try:
+		main_window = MainWindow(options.Filename or None)
+	except JackConnectError:
+		DevilBox('Could not connect to JACK server. Is it running?')
+		sys.exit(1)
+	main_window.show()
+	sys.exit(app.exec())
+
+
+if __name__ == "__main__":
+	sys.exit(main())
+
+
+#  end kitstarter/__init__.py

kitstarter/gui/__init__.py

@@ -0,0 +1,20 @@
+#  kitstarter/gui/__init__.py
+#
+#  Copyright 2025 Leon Dionne <ldionne@dridesign.sh.cn>
+#
+#  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 2 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, write to the Free Software
+#  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+#  MA 02110-1301, USA.
+#
+#  end kitstarter/gui/__init__.py