lib

• httprouter
• httpserver
• remotetab

class openlp.plugins.remotes.lib.RemoteTab(parent, title, visible_title, icon_path)

Bases: openlp.core.lib.settingstab.SettingsTab

RemoteTab is the Remotes settings tab in the settings dialog.

generate_icon()

Generate icon for main window

get_ip_address(ip_address)

returns the IP address in dependency of the passed address ip_address == 0.0.0.0: return the IP address of the first valid interface else: return ip_address

load()

Load the configuration and update the server configuration if necessary

on_thumbnails_check_box_changed(check_state)

Toggle the thumbnail check box.

on_twelve_hour_check_box_changed(check_state)

Toggle the 12 hour check box.

retranslateUi()

save()

Save the configuration and update the server configuration if necessary

set_urls()

Update the display based on the data input on the screen

setupUi()

class openlp.plugins.remotes.lib.OpenLPServer

Bases: openlp.core.common.registryproperties.RegistryProperties

start_server()

Start the correct server and save the handler

start_server_instance(address, port, server_class)

Start the server

Parameters:

• address – The server address
• port – The run port
• server_class – the class to start

stop_server()

Stop the server

class openlp.plugins.remotes.lib.HttpRouter

Bases: openlp.core.common.registryproperties.RegistryProperties

This code is called by the HttpServer upon a request and it processes it based on the routing table. This code is stateless and is created on each request. Some variables may look incorrect but this extends BaseHTTPRequestHandler.

add_to_service(plugin_name)

Add item of type plugin_name to the end of the service.

Parameters:plugin_name – name of plugin to be called

alert()

Send an alert.

call_function(function, *args)

Invoke the route function passing the relevant values

Parameters:

• function – The function to be called.
• args – Any passed data.

controller(display_type, action)

Perform an action on the slide controller.

Parameters:

• display_type – This is the type of slide controller, either preview or live.
• action – The action to perform.

controller_text(var)

Perform an action on the slide controller.

Parameters:var – variable - not used

display(action)

Hide or show the display screen. This is a cross Thread call and UI is updated so Events need to be used.

Parameters:action – This is the action, either hide or show.

do_authorisation()

Create a needs authorisation http header.

do_http_error()

Create a error http header.

do_http_success()

Create a success http header.

do_json_header()

Create a header for JSON messages

do_not_found()

Create a not found http header.

do_post_processor()

Handle the POST amd GET requests placed on the server.

get_content_type(file_name)

Examines the extension of the file and determines what the content_type should be, defaults to text/plain Returns the extension and the content_type

Parameters:file_name – name of file

go_live(plugin_name)

Go live on an item of type plugin.

Parameters:plugin_name – name of plugin

initialise()

Initialise the router stack and any other variables.

main_image()

Return the latest display image as a byte stream.

main_poll()

Poll OpenLP to determine the current slide count.

plugin_info(action)

Return plugin related information, based on the action.

Parameters:action – The action to perform. If search return a list of plugin names which support search.

poll()

Poll OpenLP to determine the current slide number and item name.

process_http_request(url_path, *args)

Common function to process HTTP requests

Parameters:

• url_path – The requested URL.
• args – Any passed data.

search(plugin_name)

Return a list of items that match the search text.

Parameters:plugin_name – The plugin name to search in.

serve_file(file_name=None)

Send a file to the socket. For now, just a subset of file types and must be top level inside the html folder. If subfolders requested return 404, easier for security for the present.

Ultimately for i18n, this could first look for xx/file.html before falling back to file.html. where xx is the language, e.g. ‘en’

serve_thumbnail(controller_name=None, dimensions=None, file_name=None)

Serve an image file. If not found return 404.

Parameters:

• file_name – file name to be served
• dimensions – image size
• controller_name – controller to be called

service(action)

Handles requests for service items in the service manager

Parameters:action – The action to perform.

service_list()

Handles requests for service items in the service manager

set_cache_headers()

stages(url_path, file_name)

Allow Stage view to be delivered with custom views.

Parameters:

• url_path – base path of the URL. Not used but passed by caller
• file_name – file name with path

Returns:

translate()

Translate various strings in the mobile app.