feat(fgdpp): add fgd writer

Author: craftablescience

README.md

@@ -57,9 +57,9 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
         <li><a href="https://stratasource.org">Strata Source</a> FGD modifications</li>
       </ul>
     </td>
-    <td align="center">❌</td>
     <td align="center">✅</td>
-    <td align="center">❌</td>
+    <td align="center">✅</td>
+    <td align="center">✅</td>
     <td align="center"></td>
     <td></td>
   </tr>

ext/bufferstream

@@ -6,11 +6,9 @@
 #include <unordered_map>
 #include <vector>
 
+#include <BufferStream.h>
 #include <sourcepp/math/Vector.h>
 
-class BufferStream;
-class BufferStreamReadOnly;
-
 namespace fgdpp {
 
 class FGD {
@@ -107,7 +105,7 @@ class FGD {
 
 	[[nodiscard]] const std::vector<AutoVisGroup>& getAutoVisGroups() const;
 
-private:
+protected:
 	void readEntities(BufferStreamReadOnly& stream, const std::string& path, std::vector<std::string>& seenPaths);
 
 	std::list<std::string> backingData;
@@ -119,4 +117,87 @@ class FGD {
 	std::vector<AutoVisGroup> autoVisGroups;
 };
 
+class FGDWriter {
+public:
+	class AutoVisGroupWriter {
+	public:
+		explicit AutoVisGroupWriter(FGDWriter& parent_);
+
+		AutoVisGroupWriter& visGroup(const std::string& name, const std::vector<std::string>& entities);
+
+		FGDWriter& endAutoVisGroup();
+
+	private:
+		FGDWriter& parent;
+	};
+
+	class EntityWriter {
+	public:
+		class KeyValueChoicesWriter {
+		public:
+			explicit KeyValueChoicesWriter(EntityWriter& parent_);
+
+			KeyValueChoicesWriter& choice(const std::string& value, const std::string& displayName);
+
+			EntityWriter& endKeyValueChoices();
+
+		private:
+			EntityWriter& parent;
+		};
+
+		class KeyValueFlagsWriter {
+		public:
+			explicit KeyValueFlagsWriter(EntityWriter& parent_);
+
+			KeyValueFlagsWriter& flag(uint64_t value, const std::string& displayName, bool enabledByDefault, const std::string& description = "");
+
+			EntityWriter& endKeyValueFlags();
+
+		private:
+			EntityWriter& parent;
+		};
+
+		explicit EntityWriter(FGDWriter& parent_);
+
+		EntityWriter& keyValue(const std::string& name, const std::string& valueType, const std::string& displayName = "", const std::string& valueDefault = "", const std::string& description = "", bool readOnly = false, bool report = false);
+
+		KeyValueChoicesWriter beginKeyValueChoices(const std::string& name, const std::string& displayName = "", const std::string& valueDefault = "", const std::string& description = "", bool readOnly = false, bool report = false);
+
+		KeyValueFlagsWriter beginKeyValueFlags(const std::string& name, const std::string& displayName = "", const std::string& description = "", bool readOnly = false, bool report = false);
+
+		EntityWriter& input(const std::string& name, const std::string& valueType, const std::string& description = "");
+
+		EntityWriter& output(const std::string& name, const std::string& valueType, const std::string& description = "");
+
+		FGDWriter& endEntity();
+
+	private:
+		FGDWriter& parent;
+	};
+
+	[[nodiscard]] static FGDWriter begin();
+
+	FGDWriter& include(const std::string& fgdPath);
+
+	FGDWriter& version(int version);
+
+	FGDWriter& mapSize(sourcepp::math::Vec2i mapSize);
+
+	FGDWriter& materialExclusionDirs(const std::vector<std::string>& dirs);
+
+	AutoVisGroupWriter beginAutoVisGroup(const std::string& parentName);
+
+	EntityWriter beginEntity(const std::string& classType, const std::vector<std::string>& classProperties, const std::string& name, const std::string& description);
+
+	[[nodiscard]] std::string bakeToString();
+
+	void bakeToFile(const std::string& fgdPath);
+
+protected:
+	FGDWriter();
+
+	std::string backingData;
+	BufferStream writer;
+};
+
 } // namespace fgdpp

include/fgdpp/fgdpp.h

@@ -10,4 +10,8 @@ std::vector<std::byte> readFileBuffer(const std::string& filepath, std::size_t s
 
 std::string readFileText(const std::string& filepath, std::size_t startOffset = 0);
 
+bool writeFileBuffer(const std::string& filepath, const std::vector<std::byte>& buffer);
+
+bool writeFileText(const std::string& filepath, const std::string& text);
+
 } // namespace sourcepp::fs