API for "has project file first save completed"

Author: CouleeApps

binaryninjaapi.h

@@ -3656,6 +3656,8 @@ namespace BinaryNinja {
 		bool SetFolder(Ref<ProjectFolder> folder);
 		bool Export(const std::string& destination) const;
 		int64_t GetCreationTimestamp() const;
+		bool IsReady() const;
+		bool SetReady(bool ready);
 		bool AddDependency(Ref<ProjectFile> file);
 		bool RemoveDependency(Ref<ProjectFile> file);
 		std::vector<Ref<ProjectFile>> GetDependencies() const;

binaryninjacore.h

@@ -4389,6 +4389,8 @@ extern "C"
 	BINARYNINJACOREAPI BNProject* BNProjectFileGetProject(BNProjectFile* file);
 	BINARYNINJACOREAPI bool BNProjectFileExport(BNProjectFile* file, const char* destination);
 	BINARYNINJACOREAPI int64_t BNProjectFileGetCreationTimestamp(BNProjectFile* file);
+	BINARYNINJACOREAPI bool BNProjectFileIsReady(BNProjectFile* file);
+	BINARYNINJACOREAPI bool BNProjectFileSetReady(BNProjectFile* file, bool ready);
 	BINARYNINJACOREAPI bool BNProjectFileAddDependency(BNProjectFile* file, BNProjectFile* dep);
 	BINARYNINJACOREAPI bool BNProjectFileRemoveDependency(BNProjectFile* file, BNProjectFile* dep);
 	BINARYNINJACOREAPI BNProjectFile** BNProjectFileGetDependencies(BNProjectFile* file, size_t* count);

project.cpp

@@ -680,6 +680,18 @@ int64_t ProjectFile::GetCreationTimestamp() const
 }
 
 
+bool ProjectFile::IsReady() const
+{
+	return BNProjectFileIsReady(m_object);
+}
+
+
+bool ProjectFile::SetReady(bool ready)
+{
+	return BNProjectFileSetReady(m_object, ready);
+}
+
+
 bool ProjectFile::AddDependency(Ref<ProjectFile> file)
 {
 	return BNProjectFileAddDependency(m_object, file->m_object);

python/project.py

@@ -159,6 +159,24 @@ def description(self, new_description: str) -> bool:
 		"""
 		return core.BNProjectFileSetDescription(self._handle, new_description)
 
+	@property
+	def ready(self) -> bool:
+		"""
+		Check if this file is ready (first save has completed)
+
+		:return: True if this file is ready, False otherwise
+		"""
+		return core.BNProjectFileIsReady(self._handle)
+
+	@ready.setter
+	def ready(self, value: bool) -> bool:
+		"""
+		Set whether this file is ready (first save has completed)
+
+		:param value: Desired ready state
+		"""
+		return core.BNProjectFileSetReady(self._handle, value)
+
 	@property
 	def folder(self) -> Optional['ProjectFolder']:
 		"""

rust/src/project/file.rs

@@ -7,8 +7,9 @@ use binaryninjacore_sys::{
     BNProjectFileGetCreationTimestamp, BNProjectFileGetDependencies, BNProjectFileGetDescription,
     BNProjectFileGetFolder, BNProjectFileGetId, BNProjectFileGetName,
     BNProjectFileGetPathInProject, BNProjectFileGetPathOnDisk, BNProjectFileGetProject,
-    BNProjectFileGetRequiredBy, BNProjectFileRemoveDependency, BNProjectFileSetDescription,
-    BNProjectFileSetFolder, BNProjectFileSetName,
+    BNProjectFileGetRequiredBy, BNProjectFileIsReady, BNProjectFileRemoveDependency,
+    BNProjectFileSetDescription, BNProjectFileSetFolder, BNProjectFileSetName,
+    BNProjectFileSetReady,
 };
 use std::fmt::Debug;
 use std::hash::Hash;
@@ -94,6 +95,16 @@ impl ProjectFile {
             .unwrap()
     }
 
+    /// Check if this file is ready (first save has completed)
+    pub fn is_ready(&self) -> bool {
+        unsafe { BNProjectFileIsReady(self.handle.as_ptr()) }
+    }
+
+    /// Set whether this file is ready (first save has completed)
+    pub fn set_ready(&self, value: bool) -> bool {
+        unsafe { BNProjectFileSetReady(self.handle.as_ptr(), value) }
+    }
+
     /// Get the folder that contains this file
     pub fn folder(&self) -> Option<Ref<ProjectFolder>> {
         let result = unsafe { BNProjectFileGetFolder(self.handle.as_ptr()) };
@@ -146,6 +157,7 @@ impl Debug for ProjectFile {
             .field("name", &self.name())
             .field("description", &self.description())
             .field("creation_time", &self.creation_time())
+            .field("ready", &self.is_ready())
             .field("exists_on_disk", &self.exists_on_disk())
             .field("project", &self.project())
             .field("folder", &self.folder())