PythonIDE Native References

June 19, 2026 ยท View on GitHub

Machine-readable contracts and the full schema-backed routing table for pythonide-native.

Canonical URLs

Persistence Boundary

  • Use database for queryable records, caches, favorites, history, playlists, and SQL transactions.
  • Do not import CPython sqlite3 directly in MiniApps; database is the supported host-backed SQLite bridge.
  • Keep small non-secret preferences in storage, and credentials in keychain.

Music Playback Preloading

  • music_player.set_queue(..., preload_count=N), music_player.prefetch_next(N), and music_player.prepare(song) only work with songs that already contain a real audio url.
  • Resolve provider IDs, search-result IDs, signed URLs, or aggregation-service records in the MiniApp/data layer first, cache the playable URL with an expiry, then hand the resolved song to music_player.
  • Use music_player.preload_state() to inspect prepared items when next-track playback still feels slow.

Entry Routing

Route by schema entry kind before importing.

KindKeyImport / componentDocNotes
modulealarmimport alarmalarm-moduleapi
moduleassistantimport assistantassistant-moduleapi
moduleaudio_recorderimport audio_recorderaudio-recorder-moduleapi
moduleaudio_sessionimport audio_sessionaudio-session-moduleapi
moduleavplayerimport avplayeravplayer-moduleapi
modulebackgroundimport backgroundbackground-moduleapi
modulebackground_downloadimport background_downloadbackground-download-moduleapi
modulebiometricimport biometricbiometric-moduleblocking_sheet
moduleble_peripheralimport ble_peripheralble-peripheral-moduleapi
modulebluetoothimport bluetoothbluetooth-moduleapi
modulec_extensionsimport c_extensionsc-extensions-modulereference
modulecalendar_eventsimport calendar_eventscalendar-events-modulesystem_picker
moduleclipboardimport clipboardclipboard-moduleapi
moduleconsoleimport consoleconsole-moduleblocking_sheet
modulecontactsimport contactscontacts-modulesystem_picker
modulecoremlimport coremlcoreml-moduleapi
moduledatabaseimport databasedatabase-moduleapi
moduledeviceimport devicedevice-moduleapi
moduledialogsimport dialogsdialogs-moduleblocking_sheet
modulefont_pickerimport font_pickerfont-picker-moduleblocking_sheet
modulefoundation_modelsimport foundation_modelsfoundation-models-moduleapi
modulehapticsimport hapticshaptics-moduleapi
modulehealthimport healthhealth-moduleapi
modulehttp_serverimport http_serverhttp-server-moduleapi
modulekeyboardimport keyboardkeyboard-moduleapi
modulekeychainimport keychainkeychain-moduleapi
modulelive_activityimport live_activitylive-activity-moduleapi
modulelocationimport locationlocation-moduleapi
modulemailimport mailmail-modulecompose_sheet
modulemedia_composerimport media_composermedia-composer-moduleapi
modulemessageimport messagemessage-modulecompose_sheet
modulemotionimport motionmotion-moduleapi
modulemusicimport musicmusic-moduleapi
modulemusic_playerimport music_playermusic-player-moduleapi
modulenetworkimport networknetwork-moduleapi
modulenfcimport nfcnfc-modulesystem_picker
modulenotificationimport notificationnotification-moduleapi
modulenow_playingimport now_playingnow-playing-moduleapi
moduleobjc_utilimport objc_utilobjc-util-moduleapi
modulepdfimport pdfpdf-moduleapi
modulepermissionimport permissionpermission-moduleapi
modulephotosimport photosphotos-moduleapi
moduleqrcodeimport qrcodeqrcode-moduleapi
moduleshazamimport shazamshazam-moduleapi
moduleshortcutsimport shortcutsshortcuts-moduleapi
modulesoundimport soundsound-moduleapi
modulespeechimport speechspeech-moduleapi
modulespeech_recognitionimport speech_recognitionspeech-recognition-moduleapi
modulesshimport sshssh-moduleapi
modulestorageimport storagestorage-moduleapi
modulestorekitimport storekitstorekit-moduleapi
moduletranslationimport translationtranslation-moduleapi
modulevideo_recorderimport video_recordervideo-recorder-moduleapi
modulevisionimport visionvision-moduleapi
modulevision_helperimport vision_helpervision-helper-moduleapi
moduleweatherimport weatherweather-moduleapi
modulewebsocketimport websocketwebsocket-moduleapi
appui_bridgecamera_pickerappui.CameraPickercamera-moduleAppUI-first; see pythonide-appui
appui_bridgefile_importerappui.FileImporterfile-picker-moduleAppUI-first; see pythonide-appui
appui_bridgemap_viewappui.MapViewlocation-moduleAppUI-first; see pythonide-appui
appui_bridgephoto_pickerappui.PhotoPickerphotos-moduleAppUI-first; see pythonide-appui
appui_bridgeplayer_controllerappui.PlayerControllerappui-ref-mediaAppUI-first; see pythonide-appui
appui_bridgeshare_linkappui.ShareLinkshare-moduleAppUI-first; see pythonide-appui
appui_bridgevideo_playerappui.VideoPlayerappui-ref-mediaAppUI-first; see pythonide-appui
appui_bridgeweb_viewappui.WebViewappui-ref-mediaAppUI-first; see pythonide-appui
topiccameraphotoscamera-moduleCamera capture via photos.capture_image or AppUI CameraPicker.
topicfile_pickerappuifile-picker-moduleFile selection has no import module; use AppUI FileImporter.
topicshareappuishare-moduleSystem share sheet has no import module; use AppUI ShareLink.