Add EdzArchive: extract EPLAN .edz packages (M0)

First piece of native EPLAN Data Portal (.edz) import. A .edz is a 7-Zip archive; QET previously had no archive handling. EdzArchive unpacks one to a temporary directory and locates the contained part.xml. The extraction backend is isolated behind extractWithSevenZipCli() so it can be replaced with a bundled decompressor later without touching callers; this M0 step shells out to a 7-Zip CLI via QProcess. Verified on three ifm sample parts (KG6000, MFH200, R1D200 — all 7z), plus the corrupt/missing-file paths. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-30 07:44:13 +02:00 · 2026-06-20 07:05:42 +12:00
parent 6c4711a8d0
commit 82884d1cf7
3 changed files with 218 additions and 0 deletions
@@ -0,0 +1,62 @@
+/*
+	Copyright 2006 The QElectroTech Team
+	This file is part of QElectroTech.
+
+	QElectroTech 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.
+
+	QElectroTech 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 QElectroTech. If not, see <http://www.gnu.org/licenses/>.
+*/
+#ifndef EDZARCHIVE_H
+#define EDZARCHIVE_H
+
+#include <QString>
+#include <QScopedPointer>
+
+class QTemporaryDir;
+
+/**
+	@brief Extracts an EPLAN Data Portal package (.edz) to a temporary folder.
+
+	A .edz is a 7-Zip archive holding a part definition (part.xml), an EPLAN
+	macro, a product image and metadata. EdzArchive unpacks it so the rest of the
+	import pipeline can read the (portable) part.xml.
+
+	The extraction backend sits behind a single private method so it can be
+	swapped without touching callers: this M0 spike shells out to a 7-Zip CLI via
+	QProcess; a later milestone replaces that with a bundled decompressor so no
+	external tool is required at runtime.
+
+	The extracted tree lives in a QTemporaryDir owned by this object and is
+	removed when the EdzArchive is destroyed.
+*/
+class EdzArchive
+{
+	public:
+		EdzArchive();
+		~EdzArchive();
+
+		bool extract(const QString &edz_path);
+
+		QString extractedDir() const;
+		QString partXmlPath() const;
+		QString errorString() const;
+
+	private:
+		bool extractWithSevenZipCli(const QString &edz_path,
+					    const QString &dest);
+		static QString findSevenZip();
+
+		QScopedPointer<QTemporaryDir> m_dir;
+		QString m_error;
+};
+
+#endif // EDZARCHIVE_H