alphabet_soup_cli_internal.h File Reference

Private host-file helpers for the Alphabet Soup CLI wrapper. More...

#include <stddef.h>
#include <stdint.h>
#include "fw_if_fs_types.h"
#include "ra8_attributes.h"
#include "ra8_err.h"

Include dependency graph for alphabet_soup_cli_internal.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
ra8_err_t	priv_alphabet_soup_split_path (const char *filepath, char *out_root, size_t root_cap, char *out_leaf, size_t leaf_cap)
ra8_err_t	priv_alphabet_soup_read_all (fw_fs_file_t *file, uint8_t *buffer, uint32_t capacity, uint32_t *out_size)
ra8_err_t	priv_alphabet_soup_load_file_contents (const char *filepath, uint8_t *out_buf, uint32_t buf_cap, uint32_t *out_len)

Detailed Description

Private host-file helpers for the Alphabet Soup CLI wrapper.

Declares the path, stream, and bounded-ingestion seams shared only by the CLI implementation and its host tests.

Copyright

Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Definition in file alphabet_soup_cli_internal.h.

Function Documentation

priv_alphabet_soup_load_file_contents()

ra8_err_t priv_alphabet_soup_load_file_contents ( const char * filepath, uint8_t * out_buf, uint32_t buf_cap, uint32_t * out_len )

nodiscard

Definition at line 92 of file alphabet_soup_cli.c.

References fw_fs_close(), fw_fs_open(), fw_fs_posix_deinit(), fw_fs_posix_init(), k_cli_file_work_capacity, k_cli_path_buffer_capacity, k_fw_fs_open_read, k_ra8_err_invalid_arg, k_ra8_err_not_found, k_ra8_fail, k_ra8_ok, priv_alphabet_soup_read_all(), priv_alphabet_soup_split_path(), RA8_PRIV, and fw_fs_t::streams.

Referenced by main().

priv_alphabet_soup_read_all()

ra8_err_t priv_alphabet_soup_read_all ( fw_fs_file_t * file, uint8_t * buffer, uint32_t capacity, uint32_t * out_size )

nodiscard

Definition at line 59 of file alphabet_soup_cli.c.

References fw_fs_read(), k_cli_read_chunk_bytes, k_ra8_err_invalid_size, k_ra8_err_null_ptr, k_ra8_ok, k_soup_max_file_capacity, and RA8_PRIV.

Referenced by priv_alphabet_soup_load_file_contents().

priv_alphabet_soup_split_path()

ra8_err_t priv_alphabet_soup_split_path ( const char * filepath, char * out_root, size_t root_cap, char * out_leaf, size_t leaf_cap )

nodiscard

Definition at line 24 of file alphabet_soup_cli.c.

References k_ra8_err_invalid_size, k_ra8_err_null_ptr, k_ra8_ok, memcpy(), RA8_PRIV, strlen(), and strrchr().

Referenced by priv_alphabet_soup_load_file_contents().