@salang/sa 0.1.3 → 0.1.4

package/sa_std/fs.sai

@@ -0,0 +1,127 @@
+// SA-facing contracts for the Zig-backed sa_std.fs module.
+// File handles are opaque owned ptr values and must be closed explicitly.
+@extern sa_fs_file_open(&path: ptr, path_len: u64, flags: u32) -> i32
+@extern sa_fs_file_create(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_file_close(file: u64) -> i32
+
+@extern sa_fs_file_read(file: u64, &buf: ptr, cap: u64) -> i32
+@extern sa_fs_file_read_exact(file: u64, &buf: ptr, len: u64) -> i32
+@extern sa_fs_file_write(file: u64, &buf: ptr, len: u64) -> i32
+@extern sa_fs_file_write_all(file: u64, &buf: ptr, len: u64) -> i32
+@extern sa_fs_file_flush(file: u64) -> i32
+@extern sa_fs_file_sync_data(file: u64) -> i32
+@extern sa_fs_file_sync(file: u64) -> i32
+@extern sa_fs_file_truncate(file: u64, new_size: u64) -> i32
+@extern sa_fs_file_seek(file: u64, whence: u32, offset: i64) -> i32
+
+@extern sa_std_fs_open_read(&path: ptr, path_len: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_open_write(&path: ptr, path_len: u64, truncate: u32, &out_handle: ptr) -> i32
+@extern sa_std_fs_open_options(&path: ptr, path_len: u64, flags: u32, create_mode: u32, custom_flags: u32, &out_handle: ptr) -> i32
+@extern sa_std_fs_file_from_raw_fd(fd: i32, &out_handle: ptr) -> i32
+@extern sa_std_fs_file_read(file: u64, &buf: ptr, cap: u64, &out_read: ptr) -> i32
+@extern sa_std_fs_file_read_at(file: u64, &buf: ptr, cap: u64, offset: u64, &out_read: ptr) -> i32
+@extern sa_std_fs_file_read_exact_at(file: u64, &buf: ptr, len: u64, offset: u64) -> i32
+@extern sa_std_fs_file_write(file: u64, &buf: ptr, len: u64, &out_written: ptr) -> i32
+@extern sa_std_fs_file_write_at(file: u64, &buf: ptr, len: u64, offset: u64, &out_written: ptr) -> i32
+@extern sa_std_fs_file_write_all_at(file: u64, &buf: ptr, len: u64, offset: u64) -> i32
+@extern sa_std_fs_file_seek(file: u64, whence: u32, offset: i64, &out_pos: ptr) -> i32
+@extern sa_std_fs_remove(&path: ptr, path_len: u64) -> i32
+@extern sa_std_fs_exists(&path: ptr, path_len: u64) -> i32
+@extern sa_std_fs_try_exists(&path: ptr, path_len: u64, &out_exists: ptr) -> i32
+@extern sa_std_fs_len(&path: ptr, path_len: u64, &out_len: ptr) -> i32
+@extern sa_std_fs_read_file(&path: ptr, path_len: u64, max_bytes: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_read_to_string(&path: ptr, path_len: u64, max_bytes: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_read_file_base64(&path: ptr, path_len: u64, max_bytes: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_read_dir_json(&path: ptr, path_len: u64, max_entries: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_read_dir_entries(&path: ptr, path_len: u64, max_entries: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_dir_entries_get(entries: u64, index: u64, &out_entry: ptr) -> i32
+@extern sa_std_fs_metadata(&path: ptr, path_len: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_metadata_json(&path: ptr, path_len: u64, &out_handle: ptr) -> i32
+@extern sa_std_fs_metadata_free(metadata: u64) -> i32
+@extern sa_std_fs_canonicalize(&path: ptr, path_len: u64, &out_handle: ptr) -> i32
+@extern sa_std_close(handle: u64) -> i32
+
+// Whole-file reads return an owned buffer handle. Free it with sa_fs_read_buffer_free.
+@extern sa_fs_read_file(&path: ptr, path_len: u64, max_bytes: u64) -> u64!
+@extern sa_fs_read_to_string(&path: ptr, path_len: u64, max_bytes: u64) -> u64!
+@extern sa_fs_write_file(&path: ptr, path_len: u64, &buf: ptr, len: u64) -> i32
+@extern sa_fs_read_buffer_data(buffer: u64) -> &ptr
+@extern sa_fs_read_buffer_len(buffer: u64) -> u64
+@extern sa_fs_read_buffer_free(^buffer: u64) -> i32
+@extern sa_fs_read_file_base64(&path: ptr, path_len: u64, max_bytes: u64) -> u64!
+@extern sa_fs_write_file_base64(&path: ptr, path_len: u64, &data_base64: ptr, data_base64_len: u64) -> i32
+@extern sa_fs_read_dir_json(&path: ptr, path_len: u64, max_entries: u64) -> u64!
+@extern sa_fs_dir_buffer_data(buffer: u64) -> &ptr
+@extern sa_fs_dir_buffer_len(buffer: u64) -> u64
+@extern sa_fs_dir_buffer_free(^buffer: u64) -> i32
+@extern sa_fs_read_dir_entries(&path: ptr, path_len: u64, max_entries: u64) -> u64!
+@extern sa_fs_dir_entries_len(entries: u64) -> u64
+@extern sa_fs_dir_entries_free(^entries: u64) -> i32
+@extern sa_fs_dir_entry_name_ptr(entry: u64) -> &ptr
+@extern sa_fs_dir_entry_name_len(entry: u64) -> u64
+@extern sa_fs_dir_entry_file_name_ptr(entry: u64) -> &ptr
+@extern sa_fs_dir_entry_file_name_len(entry: u64) -> u64
+@extern sa_fs_dir_entry_kind(entry: u64) -> u32
+@extern sa_fs_dir_entry_ino(entry: u64) -> u64
+@extern sa_fs_dir_entry_free(^entry: u64) -> i32
+
+@extern sa_fs_metadata(&path: ptr, path_len: u64) -> u64!
+@extern sa_fs_metadata_json(&path: ptr, path_len: u64) -> u64!
+@extern sa_fs_metadata_is_file(metadata: u64) -> u8
+@extern sa_fs_metadata_is_directory(metadata: u64) -> u8
+@extern sa_fs_metadata_is_symlink(metadata: u64) -> u8
+@extern sa_fs_metadata_is_block_device(metadata: u64) -> u8
+@extern sa_fs_metadata_is_char_device(metadata: u64) -> u8
+@extern sa_fs_metadata_is_fifo(metadata: u64) -> u8
+@extern sa_fs_metadata_is_socket(metadata: u64) -> u8
+@extern sa_fs_metadata_modified_ms(metadata: u64) -> i64
+@extern sa_fs_metadata_created_ms(metadata: u64) -> i64
+@extern sa_fs_metadata_accessed_ms(metadata: u64) -> i64
+@extern sa_fs_metadata_changed_ms(metadata: u64) -> i64
+@extern sa_fs_metadata_len(metadata: u64) -> u64
+@extern sa_fs_metadata_mode(metadata: u64) -> u32
+@extern sa_fs_metadata_uid(metadata: u64) -> u32
+@extern sa_fs_metadata_gid(metadata: u64) -> u32
+@extern sa_fs_metadata_ino(metadata: u64) -> u64
+@extern sa_fs_metadata_dev(metadata: u64) -> u64
+@extern sa_fs_metadata_nlink(metadata: u64) -> u64
+@extern sa_fs_metadata_rdev(metadata: u64) -> u64
+@extern sa_fs_metadata_blksize(metadata: u64) -> u64
+@extern sa_fs_metadata_blocks(metadata: u64) -> u64
+@extern sa_fs_metadata_st_dev(metadata: u64) -> u64
+@extern sa_fs_metadata_st_ino(metadata: u64) -> u64
+@extern sa_fs_metadata_st_mode(metadata: u64) -> u32
+@extern sa_fs_metadata_st_nlink(metadata: u64) -> u64
+@extern sa_fs_metadata_st_uid(metadata: u64) -> u32
+@extern sa_fs_metadata_st_gid(metadata: u64) -> u32
+@extern sa_fs_metadata_st_rdev(metadata: u64) -> u64
+@extern sa_fs_metadata_st_size(metadata: u64) -> u64
+@extern sa_fs_metadata_st_atime(metadata: u64) -> i64
+@extern sa_fs_metadata_st_atime_nsec(metadata: u64) -> i64
+@extern sa_fs_metadata_st_mtime(metadata: u64) -> i64
+@extern sa_fs_metadata_st_mtime_nsec(metadata: u64) -> i64
+@extern sa_fs_metadata_st_ctime(metadata: u64) -> i64
+@extern sa_fs_metadata_st_ctime_nsec(metadata: u64) -> i64
+@extern sa_fs_metadata_st_blksize(metadata: u64) -> u64
+@extern sa_fs_metadata_st_blocks(metadata: u64) -> u64
+@extern sa_fs_metadata_free(metadata: u64) -> i32!
+@extern sa_fs_remove_file(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_rename(&from_path: ptr, from_len: u64, &to_path: ptr, to_len: u64) -> i32
+@extern sa_fs_make_dir(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_make_dir_mode(&path: ptr, path_len: u64, mode: u32) -> i32
+@extern sa_fs_create_dir(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_create_dir_mode(&path: ptr, path_len: u64, mode: u32) -> i32
+@extern sa_fs_remove_dir(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_remove_dir_all(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_remove_path(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_copy_file(&from_path: ptr, from_len: u64, &to_path: ptr, to_len: u64) -> i32
+@extern sa_fs_set_permissions(&path: ptr, path_len: u64, mode: u32) -> i32
+@extern sa_fs_set_times_ms(&path: ptr, path_len: u64, accessed_ms: i64, modified_ms: i64) -> i32
+@extern sa_fs_hard_link(&from_path: ptr, from_len: u64, &to_path: ptr, to_len: u64) -> i32
+@extern sa_fs_symlink(&target_path: ptr, target_len: u64, &link_path: ptr, link_len: u64) -> i32
+@extern sa_fs_chown(&path: ptr, path_len: u64, uid: u32, gid: u32, has_uid: u32, has_gid: u32) -> i32
+@extern sa_fs_lchown(&path: ptr, path_len: u64, uid: u32, gid: u32, has_uid: u32, has_gid: u32) -> i32
+@extern sa_fs_fchown(file: u64, uid: u32, gid: u32, has_uid: u32, has_gid: u32) -> i32
+@extern sa_fs_chroot(&path: ptr, path_len: u64) -> i32
+@extern sa_fs_mkfifo(&path: ptr, path_len: u64, mode: u32) -> i32
+@extern sa_std_fs_read_link(&path: ptr, path_len: u64, &out_handle: ptr) -> i32

package/sa_std/fs.sal

@@ -0,0 +1,51 @@
+#def SA_FS_OK = 0
+#def SA_FS_ERR_UNKNOWN = 1
+#def SA_FS_ERR_NOT_FOUND = 2
+#def SA_FS_ERR_PERMISSION_DENIED = 3
+#def SA_FS_ERR_ALREADY_EXISTS = 4
+#def SA_FS_ERR_INVALID_PATH = 5
+#def SA_FS_ERR_IS_DIR = 6
+#def SA_FS_ERR_NOT_DIR = 7
+
+#def SA_FS_OPEN_READ = 1
+#def SA_FS_OPEN_WRITE = 2
+#def SA_FS_OPEN_CREATE = 4
+#def SA_FS_OPEN_TRUNCATE = 8
+#def SA_FS_OPEN_APPEND = 16
+#def SA_FS_OPEN_MODE_DEFAULT = 438
+#def SA_FS_CHOWN_ID_UNCHANGED = 4294967295
+
+#def SA_FS_CUSTOM_APPEND = 1024
+#def SA_FS_CUSTOM_NONBLOCK = 2048
+#def SA_FS_CUSTOM_DSYNC = 4096
+#def SA_FS_CUSTOM_DIRECT = 16384
+#def SA_FS_CUSTOM_DIRECTORY = 65536
+#def SA_FS_CUSTOM_NOFOLLOW = 131072
+#def SA_FS_CUSTOM_CLOEXEC = 524288
+#def SA_FS_CUSTOM_SYNC = 1052672
+
+#def SA_FS_SEEK_START = 0
+#def SA_FS_SEEK_CURRENT = 1
+#def SA_FS_SEEK_END = 2
+
+#def SA_FS_FILE_REGULAR = 1
+#def SA_FS_FILE_DIR = 2
+#def SA_FS_FILE_SYMLINK = 3
+#def SA_FS_FILE_OTHER = 255
+
+#def SaFsReadBuffer_SIZE = 24
+#def SaFsReadBuffer_ptr = +0
+#def SaFsReadBuffer_len = +8
+#def SaFsReadBuffer_cap = +16
+
+#def SaFsPermissions_SIZE = 4
+#def SaFsPermissions_mode = +0
+#def SA_FS_PERM_WRITE_BITS = 146
+#def SA_FS_PERM_OWNER_WRITE = 128
+
+#def SaFsMetadata_SIZE = 32
+#def SaFsMetadata_kind = +0
+#def SaFsMetadata_permissions = +4
+#def SaFsMetadata_len = +8
+#def SaFsMetadata_modified_unix_sec = +16
+#def SaFsMetadata_created_unix_sec = +24

package/sa_std/future.sa

@@ -0,0 +1,2 @@
+@import "core/future.sal"
+@import "core/future.sa"

package/sa_std/future.sal

@@ -0,0 +1 @@
+@import "core/future.sal"