picoware.applications.app

module documentation

App Store - Browse, install, and update Picoware apps.

Function	`run`	Run the app.
Function	`start`	Start the app.
Function	`stop`	Stop the app.
Constant	`MAX_ITEMS`	Undocumented
Constant	`STATE_APP_DETAILS`	Undocumented
Constant	`STATE_APP_LIST`	Undocumented
Constant	`STATE_CHECKING_APP_UPDATE`	Undocumented
Constant	`STATE_CHECKING_UPDATES`	Undocumented
Constant	`STATE_CURRENT_APP_DETAILS`	Undocumented
Constant	`STATE_CURRENT_APPS_LIST`	Undocumented
Constant	`STATE_DOWNLOADING`	Undocumented
Constant	`STATE_DOWNLOADING_ALL`	Undocumented
Constant	`STATE_DOWNLOADING_UPDATES`	Undocumented
Constant	`STATE_LOADING_DETAILS`	Undocumented
Constant	`STATE_LOADING_LIST`	Undocumented
Constant	`STATE_LOADING_NEXT_APP`	Undocumented
Constant	`STATE_LOADING_UPDATE_DETAILS`	Undocumented
Constant	`STATE_MAIN_MENU`	Undocumented
Constant	`STATE_SETTINGS_INPUT`	Undocumented
Constant	`STATE_SETTINGS_MENU`	Undocumented
Constant	`STATE_SUBMISSION_DETAILS`	Undocumented
Constant	`STATE_SUBMISSIONS_LIST`	Undocumented
Constant	`STATE_SUBMISSIONS_LOADING`	Undocumented
Constant	`STATE_SUBMIT_BROWSE`	Undocumented
Constant	`STATE_SUBMIT_FORM`	Undocumented
Constant	`STATE_SUBMIT_INPUT`	Undocumented
Constant	`STATE_SUBMITTING`	Undocumented
Constant	`STATE_UPDATES_LIST`	Undocumented
Function	`__base64_encode`	Base64 encode the contents of the given file.
Function	`__check_single_app_update`	Check for update for a single app.
Function	`__check_updates_async`	Start async request to check for updates for all installed apps.
Function	`__delete_app`	Delete an installed app's files and cached data.
Function	`__download_next_file`	Download the next file in the queue.
Function	`__draw_app_details`	Draw the app details screen with professional layout.
Function	`__draw_current_app_details`	Draw current app details with optional update info.
Function	`__draw_settings_menu`	Draw the settings sub-menu showing current name and email.
Function	`__draw_submission_details`	Draw the submission detail screen.
Function	`__draw_submit_form`	Draw the submit app form screen.
Function	`__fetch_app_details`	Fetch details for a specific app.
Function	`__fetch_app_list`	Fetch the list of apps from the API.
Function	`__fetch_submission_details`	GET a single submission's details.
Function	`__fetch_submissions`	GET all submissions for the current submitter's email.
Function	`__get_installed_apps`	Scan cache folder for installed app JSON files.
Function	`__keyboard_save_callback`	Called when the keyboard 'Save' is pressed.
Function	`__load_settings`	Load submitter name/email from persistent settings.
Function	`__loading_start`	Start loading animation.
Function	`__parse_app_details`	Parse app details from JSON.
Function	`__parse_app_list`	Parse the app list JSON and populate the menu.
Function	`__parse_submission_details`	Parse single submission details from JSON.
Function	`__parse_submissions`	Parse the submissions list JSON and populate the menu.
Function	`__parse_update_check`	Parse update check response and populate updates list.
Function	`__reset`	Reset the app store state
Function	`__save_settings`	Persist submitter name/email.
Function	`__show_main_menu`	Show the main App Store menu.
Function	`__start_keyboard`	Activate the on-screen keyboard for text input.
Function	`__submit_app`	POST the app submission to the API.
Variable	`_app_menu`	Undocumented
Variable	`_apps_data`	Undocumented
Variable	`_current_app_index`	Undocumented
Variable	`_current_file_index`	Undocumented
Variable	`_current_list_index`	Undocumented
Variable	`_download_all_mode`	Undocumented
Variable	`_file_browser`	Undocumented
Variable	`_files_to_download`	Undocumented
Variable	`_http`	Undocumented
Variable	`_input_mode`	Undocumented
Variable	`_installed_apps`	Undocumented
Variable	`_keyboard_just_started`	Undocumented
Variable	`_loading`	Undocumented
Variable	`_main_menu`	Undocumented
Variable	`_selected_app_details`	Undocumented
Variable	`_selected_app_id`	Undocumented
Variable	`_submission_details`	Undocumented
Variable	`_submissions_data`	Undocumented
Variable	`_submit_app_name`	Undocumented
Variable	`_submit_app_path`	Undocumented
Variable	`_submit_app_version`	Undocumented
Variable	`_submitter_email`	Undocumented
Variable	`_submitter_name`	Undocumented
Variable	`_total_apps_to_download`	Undocumented
Variable	`_update_check_data`	Undocumented
Variable	`_updates_available`	Undocumented

def run(view_manager): ¶

Run the app.

Parameters
view_manager:`ViewManager`	The view manager context.

def start(view_manager) -> bool: ¶

Start the app.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True on success.

def stop(view_manager): ¶

Stop the app.

Parameters
view_manager:`ViewManager`	The view manager context.

MAX_ITEMS = ¶

Undocumented

Value

const(100)

STATE_APP_DETAILS = ¶

Undocumented

Value

const(4)

STATE_APP_LIST = ¶

Undocumented

Value

const(2)

STATE_CHECKING_APP_UPDATE = ¶

Undocumented

Value

const(10)

STATE_CHECKING_UPDATES = ¶

Undocumented

Value

const(11)

STATE_CURRENT_APP_DETAILS = ¶

Undocumented

Value

const(9)

STATE_CURRENT_APPS_LIST = ¶

Undocumented

Value

const(8)

STATE_DOWNLOADING = ¶

Undocumented

Value

const(5)

STATE_DOWNLOADING_ALL = ¶

Undocumented

Value

const(6)

STATE_DOWNLOADING_UPDATES = ¶

Undocumented

Value

const(13)

STATE_LOADING_DETAILS = ¶

Undocumented

Value

const(3)

STATE_LOADING_LIST = ¶

Undocumented

Value

const(1)

STATE_LOADING_NEXT_APP = ¶

Undocumented

Value

const(7)

STATE_LOADING_UPDATE_DETAILS = ¶

Undocumented

Value

const(14)

STATE_MAIN_MENU = ¶

Undocumented

Value

const(0)

STATE_SETTINGS_INPUT = ¶

Undocumented

Value

const(16)

STATE_SETTINGS_MENU = ¶

Undocumented

Value

const(15)

STATE_SUBMISSION_DETAILS = ¶

Undocumented

Value

const(23)

STATE_SUBMISSIONS_LIST = ¶

Undocumented

Value

const(22)

STATE_SUBMISSIONS_LOADING = ¶

Undocumented

Value

const(21)

STATE_SUBMIT_BROWSE = ¶

Undocumented

Value

const(19)

STATE_SUBMIT_FORM = ¶

Undocumented

Value

const(17)

STATE_SUBMIT_INPUT = ¶

Undocumented

Value

const(18)

STATE_SUBMITTING = ¶

Undocumented

Value

const(20)

STATE_UPDATES_LIST = ¶

Undocumented

Value

const(12)

def __base64_encode(view_managerr) -> bytes: ¶

Base64 encode the contents of the given file.

Parameters
view_managerr:`ViewManager`	The view manager context.

Returns
`bytes`	The base64-encoded file contents.

def __check_single_app_update(view_manager, app_id: int, current_version: str) -> bool: ¶

Check for update for a single app.

Parameters
view_manager:`ViewManager`	The view manager context.
app_id:`int`	The app ID.
current_version:`str`	The installed version.

Returns
`bool`	True if the request was started.

def __check_updates_async(view_manager) -> bool: ¶

Start async request to check for updates for all installed apps.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True if the request was started.

def __delete_app(view_manager, app_id: int) -> bool: ¶

Delete an installed app's files and cached data.

Parameters
view_manager:`ViewManager`	The view manager context.
app_id:`int`	The app ID.

Returns
`bool`	True on success.

def __download_next_file(view_manager) -> bool: ¶

Download the next file in the queue.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True if the request was started.

def __draw_app_details(view_manager): ¶

Draw the app details screen with professional layout.

Parameters
view_manager:`ViewManager`	The view manager context.

def __draw_current_app_details(view_manager, app_info: dict, update_info: dict = None): ¶

Draw current app details with optional update info.

Parameters
view_manager:`ViewManager`	The view manager context.
app_info:`dict`	The installed app info.
update_info:`dict`	The update check info. Defaults to None.

def __draw_settings_menu(view_manager): ¶

Draw the settings sub-menu showing current name and email.

Parameters
view_manager:`ViewManager`	The view manager context.

def __draw_submission_details(view_manager): ¶

Draw the submission detail screen.

Parameters
view_manager:`ViewManager`	The view manager context.

def __draw_submit_form(view_manager): ¶

Draw the submit app form screen.

Parameters
view_manager:`ViewManager`	The view manager context.

def __fetch_app_details(view_manager, app_id: int) -> bool: ¶

Fetch details for a specific app.

Parameters
view_manager:`ViewManager`	The view manager context.
app_id:`int`	The app ID.

Returns
`bool`	True if the request was started.

def __fetch_app_list(view_manager) -> bool: ¶

Fetch the list of apps from the API.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True if the request was started.

def __fetch_submission_details(view_manager, submission_id: int) -> bool: ¶

GET a single submission's details.

Parameters
view_manager:`ViewManager`	The view manager context.
submission_id:`int`	The submission ID.

Returns
`bool`	True if the request was started.

def __fetch_submissions(view_manager) -> bool: ¶

GET all submissions for the current submitter's email.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True if the request was started.

def __get_installed_apps(view_manager) -> list: ¶

Scan cache folder for installed app JSON files.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`list`	App info dicts.

def __keyboard_save_callback(result: str): ¶

Called when the keyboard 'Save' is pressed.

Parameters
result:`str`	The typed text.

def __load_settings(view_manager): ¶

Load submitter name/email from persistent settings.

Parameters
view_manager:`ViewManager`	The view manager context.

def __loading_start(view_manager, text: str = 'Fetching...'): ¶

Start loading animation.

Parameters
view_manager:`ViewManager`	The view manager context.
text:`str`	The loading message. Defaults to "Fetching...".

def __parse_app_details(view_manager, app_id: int) -> bool: ¶

Parse app details from JSON.

Parameters
view_manager:`ViewManager`	The view manager context.
app_id:`int`	The app ID.

Returns
`bool`	True on success.

def __parse_app_list(view_manager) -> bool: ¶

Parse the app list JSON and populate the menu.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True on success.

def __parse_submission_details(view_manager, submission_id: int) -> bool: ¶

Parse single submission details from JSON.

Parameters
view_manager:`ViewManager`	The view manager context.
submission_id:`int`	The submission ID.

Returns
`bool`	True on success.

def __parse_submissions(view_manager) -> bool: ¶

Parse the submissions list JSON and populate the menu.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True on success.

def __parse_update_check(view_manager) -> bool: ¶

Parse update check response and populate updates list.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True on success.

def __reset(): ¶

Reset the app store state

def __save_settings(view_manager): ¶

Persist submitter name/email.

Parameters
view_manager:`ViewManager`	The view manager context.

def __show_main_menu(view_manager): ¶

Show the main App Store menu.

Parameters
view_manager:`ViewManager`	The view manager context.

def __start_keyboard(view_manager, mode: str, title: str, initial: str): ¶

Activate the on-screen keyboard for text input.

Parameters
view_manager:`ViewManager`	The view manager context.
mode:`str`	The input mode key.
title:`str`	The keyboard title.
initial:`str`	The initial response text.

def __submit_app(view_manager) -> bool: ¶

POST the app submission to the API.

Parameters
view_manager:`ViewManager`	The view manager context.

Returns
`bool`	True if the request was started.

_app_menu = ¶

Undocumented

_apps_data: dict = ¶

Undocumented

_current_app_index: int = ¶

Undocumented

_current_file_index: int = ¶

Undocumented

_current_list_index: int = ¶

Undocumented

_download_all_mode: bool = ¶

Undocumented

_file_browser = ¶

Undocumented

_files_to_download: list = ¶

Undocumented

_http = ¶

Undocumented

_input_mode: str = ¶

Undocumented

_installed_apps: list = ¶

Undocumented

_keyboard_just_started: bool = ¶

Undocumented

_loading = ¶

Undocumented

_main_menu = ¶

Undocumented

_selected_app_details = ¶

Undocumented

_selected_app_id: int = ¶

Undocumented

_submission_details: dict = ¶

Undocumented

_submissions_data: list = ¶

Undocumented

_submit_app_name: str = ¶

Undocumented

_submit_app_path: str = ¶

Undocumented

_submit_app_version: str = ¶

Undocumented

_submitter_email: str = ¶

Undocumented

_submitter_name: str = ¶

Undocumented

_total_apps_to_download: int = ¶

Undocumented

_update_check_data: dict = ¶

Undocumented

_updates_available: list = ¶

Undocumented

picoware.applications.app_store

`picoware.applications.app_store`