File

Object Hierarchy:

Description:

id == -1

if (file.buffer == null) {
    file.manager.buffer_provider.create_buffer(file);
}
if (!(yield file.read())) {
    // not found on daemon
}
var contents = file.buffer.get_text();

Content:

Properties:

• public FileBuffer? buffer { get; set; }
  File buffer instance (nullable).
• public int cursor_line { get; set; }
  Last cursor line number (per-window; agent config — not on daemon).
• public int cursor_offset { get; set; }
  Last cursor character offset (per-window; agent config).
• public string display_basename { owned get; }
  Display name with basename only: basename on first line. Format: { basename}\n
• public override string display_with_indicators { get; }
  Display text with status indicators (approved, unsaved).
• public string display_with_path { owned get; }
  Display name with path: basename on first line, dirname on second line in grey. Format: {basename}\n<span grey small dirname>
• public override string icon_name { get; set; }
• public bool is_need_approval { get; set; }
  Whether the file needs approval. true = needs approval, false = approved.
• public bool is_open { get; }
  Whether file is currently open in editor. Computed property: Returns true if file was viewed within last week.
• public bool is_unsaved { get; set; }
  Whether the file has unsaved changes.
• public int scroll_position { get; set; }
  Last scroll position (per-window; agent config).

Static methods:

• public static void rpc_register ()

Creation methods:

• public File (ProjectManager manager)
  Constructor.
• public File.new_fake (ProjectManager manager, string path)
  Named constructor: Create a fake File object for files not in database.

Methods:

• public async bool @delete ()
  Delete file on daemon (

  File.delete

  ).
• public async bool apply_permissions (uint unix_mode)
  Apply unix rwx permissions on daemon (

  File.apply_permissions

  ).
• public override void bin_read_prop (Stream ctx, ParamSpec prop, uint8 type_byte) throws Error
• public override void bin_write_prop (Stream ctx, ParamSpec prop) throws Error
  Revert this file to previous version from FileHistory backup.
• public async FileUpdateStatus check_changed ()
  Check disk change vs buffer (

  File.changed.check

  ).
• public string contents (int start_or_count = -1, int end_line = -1)
  Gets file contents: either a head slice (first N lines) or a 1- based line range.
• public async FileType exists ()
  Daemon disk probe (

  File.exists

  ).
• public int get_cursor_position ()
  Gets the current cursor position (line number).
• public string get_line_content (int line)
  Gets the content of a specific line.
• public string get_selected_code ()
  Gets the currently selected text (only valid for active file).
• public int line_count ()
  Gets the total number of lines in the file.
• public async bool read ()
  Load filebase + content from daemon (

  File.read

  ).
• public async bool register ()
  Register fake file (

  id == -1

  ) on daemon (

  File.register

  ).
• public async void to_real () throws Error
  Promote fake file (

  id == -1

  ) to indexed row on daemon. Does not write disk bytes — call write first when needed.
• public override string to_summary (HashMap<int,VectorMetadata> keymap, string indent)
  Icon name for binding in lists. Returns icon_name if set, otherwise derives from file content type.
• public async bool write (string content = "", string base_type = "f", string target = "", uint unix_mode = 0)
  Write on daemon (

  File.write

  ).

Signals:

• public signal void changed ()
  Emitted when file content changes.

Inherited Members: