flet 0.70.0.dev6176__py3-none-any.whl → 0.70.0.dev6196__py3-none-any.whl

flet/__init__.py

@@ -195,6 +195,18 @@ from flet.controls.cupertino.cupertino_timer_picker import (
     CupertinoTimerPickerMode,
 )
 from flet.controls.cupertino.cupertino_tinted_button import CupertinoTintedButton
+from flet.controls.device_info import (
+    AndroidBuildVersion,
+    AndroidDeviceInfo,
+    DeviceInfo,
+    IosDeviceInfo,
+    IosUtsname,
+    LinuxDeviceInfo,
+    MacOsDeviceInfo,
+    WebBrowserName,
+    WebDeviceInfo,
+    WindowsDeviceInfo,
+)
 from flet.controls.dialog_control import DialogControl
 from flet.controls.duration import (
     DateTimeValue,
@@ -516,6 +528,8 @@ __all__ = [
     "AdaptiveControl",
     "AlertDialog",
     "Alignment",
+    "AndroidBuildVersion",
+    "AndroidDeviceInfo",
     "AnimatedSwitcher",
     "AnimatedSwitcherTransition",
     "Animation",
@@ -643,6 +657,7 @@ __all__ = [
     "DateRangePicker",
     "DateTimeValue",
     "DecorationImage",
+    "DeviceInfo",
     "DialogControl",
     "DialogTheme",
     "DismissDirection",
@@ -713,6 +728,8 @@ __all__ = [
     "InputBorder",
     "InputFilter",
     "InteractiveViewer",
+    "IosDeviceInfo",
+    "IosUtsname",
     "Key",
     "KeyDownEvent",
     "KeyRepeatEvent",
@@ -724,6 +741,7 @@ __all__ = [
     "LabelPosition",
     "LayoutControl",
     "LinearGradient",
+    "LinuxDeviceInfo",
     "ListTile",
     "ListTileStyle",
     "ListTileTheme",
@@ -734,6 +752,7 @@ __all__ = [
     "LoginEvent",
     "LongPressEndEvent",
     "LongPressStartEvent",
+    "MacOsDeviceInfo",
     "MainAxisAlignment",
     "Margin",
     "MarginValue",
@@ -926,12 +945,15 @@ __all__ = [
     "View",
     "ViewPopEvent",
     "VisualDensity",
+    "WebBrowserName",
+    "WebDeviceInfo",
     "WebRenderer",
     "Window",
     "WindowDragArea",
     "WindowEvent",
     "WindowEventType",
     "WindowResizeEdge",
+    "WindowsDeviceInfo",
     "alignment",
     "app",
     "app_async",

flet/controls/core/keyboard_listener.py

@@ -6,6 +6,9 @@ from flet.controls.control import Control
 from flet.controls.control_event import Event, EventHandler
 
 __all__ = [
+    "KeyDownEvent",
+    "KeyRepeatEvent",
+    "KeyUpEvent",
     "KeyboardListener",
 ]
 

flet/controls/device_info.py

@@ -0,0 +1,837 @@
+from dataclasses import dataclass
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+
+__all__ = [
+    "AndroidBuildVersion",
+    "AndroidDeviceInfo",
+    "DeviceInfo",
+    "IosDeviceInfo",
+    "IosUtsname",
+    "LinuxDeviceInfo",
+    "MacOsDeviceInfo",
+    "WebBrowserName",
+    "WebDeviceInfo",
+    "WindowsDeviceInfo",
+]
+
+
+@dataclass
+class DeviceInfo:
+    """
+    Base class for device information.
+
+    Platform-specific classes include:
+    - [`AndroidDeviceInfo`][flet.]
+    - [`IosDeviceInfo`][flet.]
+    - [`LinuxDeviceInfo`][flet.]
+    - [`MacOsDeviceInfo`][flet.]
+    - [`WebDeviceInfo`][flet.]
+    - [`WindowsDeviceInfo`][flet.]
+    """
+
+
+@dataclass
+class MacOsDeviceInfo(DeviceInfo):
+    active_cpus: int
+    """Number of active CPUs."""
+
+    arch: str
+    """Machine CPU architecture.
+
+    Note:
+        Apple Silicon Macs can return `"x86_64"` if app runs via Rosetta.
+    """
+
+    computer_name: str
+    """Name given to the local machine."""
+
+    cpu_frequency: int
+    """Device CPU frequency."""
+
+    host_name: str
+    """Operating system type."""
+
+    kernel_version: str
+    """Machine kernel version.
+
+    Examples:
+        - `"Darwin Kernel Version 15.3.0: Thu Dec 10 18:40:58 PST 2015; root:xnu-3248.30.4~1/RELEASE_X86_64"`
+        - `"Darwin Kernel Version 15.0.0: Wed Dec 9 22:19:38 PST 2015; root:xnu-3248.31.3~2/RELEASE_ARM64_S8000"`
+    """
+
+    major_version: int
+    """The major release number, such as `10` in version 10.9.3."""
+
+    memory_size: int
+    """Machine's memory size."""
+
+    minor_version: int
+    """The minor release number, such as `9` in version 10.9.3."""
+
+    model: str
+    """Device model identifier.
+
+    For example: `"MacBookPro18,3"`, `"Mac16,2"`.
+    """
+
+    model_name: str
+    """Device model name.
+
+    For example: `"MacBook Pro (16-inch, 2021)"`, `"iMac (24-inch, 2024)"`.
+    """
+
+    os_release: str
+    """Operating system release number."""
+
+    patch_version: int
+    """The update release number, such as `3` in `version 10.9.3`."""
+
+    system_guid: Optional[str] = None
+    """Device GUID."""
+
+
+class WebBrowserName(Enum):
+    """
+    Represents commonly used browsers.
+    """
+
+    FIREFOX = "firefox"
+    """Mozilla Firefox"""
+
+    SAMSUNG_INTERNET = "samsungInternet"
+    """Samsung Internet Browser"""
+
+    OPERA = "opera"
+    """Opera Web Browser"""
+
+    MSIE = "msie"
+    """Microsoft Internet Explorer"""
+
+    EDGE = "edge"
+    """Microsoft Edge"""
+
+    CHROME = "chrome"
+    """Google Chrome"""
+
+    SAFARI = "safari"
+    """Apple Safari"""
+
+    UNKNOWN = "unknown"
+    """Unknown web browser"""
+
+
+@dataclass
+class WebDeviceInfo(DeviceInfo):
+    """
+    Information derived from `navigator`.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Window/navigator
+    """
+
+    browser_name: WebBrowserName
+    """The name of the browser in use."""
+
+    app_code_name: Optional[str] = None
+    """The internal 'code' name of the current browser.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/appCodeName
+
+    Note:
+        Do not rely on this property to return the correct value.
+    """
+
+    app_name: Optional[str] = None
+    """A string with the official name of the browser.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/appName
+
+    Note:
+        Do not rely on this property to return the correct value.
+    """
+
+    app_version: Optional[str] = None
+    """The version of the browser as a string.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/appVersion
+
+    Note:
+        Do not rely on this property to return the correct value.
+    """
+
+    device_memory: Optional[float] = None
+    """The amount of device memory in gigabytes.
+
+    This value is an approximation given by rounding to the nearest power of `2` and
+    dividing that number by `1024`.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/deviceMemory
+    """
+
+    language: Optional[str] = None
+    """A string representing the preferred language of the user, usually the language
+    of the browser UI.
+
+    Will be `None` if unknown.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/language
+    """
+
+    languages: Optional[list[str]] = None
+    """A list of strings representing the languages known to the user, by order of
+    preference.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/languages
+    """
+
+    platform: Optional[str] = None
+    """A string representing the platform of the browser.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/platform
+
+    Note:
+        Do not rely on this property to return the correct value.
+    """
+
+    product: Optional[str] = None
+    """Always returns `"Gecko"`, on any browser.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/product
+
+    Note:
+        Do not rely on this property to return the correct value. This property is
+        kept only for compatibility purposes.
+    """
+
+    product_sub: Optional[str] = None
+    """The build number of the current browser.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/productSub
+
+    Note:
+        Do not rely on this property to return the correct value.
+    """
+
+    user_agent: Optional[str] = None
+    """The user agent string for the current browser (e.g., 'Mozilla/5.0 ...').
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+    """
+
+    vendor: Optional[str] = None
+    """The vendor name of the current browser.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/vendor
+    """
+
+    vendor_sub: Optional[str] = None
+    """Returns the vendor version number (e.g., '6.1').
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/vendorSub
+
+    Note:
+        Do not rely on this property to return the correct value.
+    """
+
+    max_touch_points: Optional[int] = None
+    """The maximum number of simultaneous touch contact points supported
+    by the current device.
+
+    More info: https://developer.mozilla.org/en-US/docs/Web/API/Navigator/maxTouchPoints
+    """
+
+    hardware_concurrency: Optional[int] = None
+    """The number of logical processor cores available.
+
+    More info:
+    https://developer.mozilla.org/en-US/docs/Web/API/Navigator/hardwareConcurrency
+    """
+
+
+@dataclass
+class AndroidBuildVersion:
+    code_name: str
+    """
+    The current development codename, or the string "REL" if this is a release build.
+    """
+
+    incremental: str
+    """
+    The internal value used by the underlying source control to represent this build.
+
+    Note:
+        Available only on Android M (API 23) and newer.
+    """
+
+    release: str
+    """The user-visible version string."""
+
+    sdk: int
+    """The user-visible SDK version of the framework.
+
+    Possible values are defined in:
+    https://developer.android.com/reference/android/os/Build.VERSION_CODES.html
+    """
+
+    base_os: Optional[str] = None
+    """The base OS build the product is based on.
+
+    Note:
+        Available only on Android M (API 23) and newer.
+    """
+
+    preview_sdk: Optional[int] = None
+    """The developer preview revision of a pre-release SDK."""
+
+    security_patch: Optional[str] = None
+    """The user-visible security patch level.
+
+    Note:
+        Available only on Android M (API 23) and newer.
+    """
+
+
+@dataclass
+class AndroidDeviceInfo(DeviceInfo):
+    available_ram_size: int
+    """Total available RAM size in bytes."""
+
+    board: str
+    """The name of the underlying board, like `"goldfish"`.
+
+    More info: https://developer.android.com/reference/android/os/Build#BOARD
+    """
+
+    bootloader: str
+    """The system bootloader version number.
+
+    More info: https://developer.android.com/reference/android/os/Build#BOOTLOADER
+    """
+
+    brand: str
+    """The consumer-visible brand with which the product/hardware will be associated,
+    if any.
+
+    More info: https://developer.android.com/reference/android/os/Build#BRAND
+    """
+
+    device: str
+    """The name of the industrial design.
+
+    More info: https://developer.android.com/reference/android/os/Build#DEVICE
+    """
+
+    display: str
+    """A build ID string meant for displaying to the user.
+
+    More info: https://developer.android.com/reference/android/os/Build#DISPLAY
+    """
+
+    fingerprint: str
+    """A string that uniquely identifies this build.
+
+    More info: https://developer.android.com/reference/android/os/Build#FINGERPRINT
+    """
+
+    free_disk_size: int
+    """Free disk size in bytes."""
+
+    hardware: str
+    """The name of the hardware (from the kernel command line or /proc).
+
+    More info: https://developer.android.com/reference/android/os/Build#HARDWARE
+    """
+
+    host: str
+    """Hostname.
+
+    More info: https://developer.android.com/reference/android/os/Build#HOST
+    """
+
+    id: str
+    """Either a changelist number, or a label like `"M4-rc20"`.
+
+    More info: https://developer.android.com/reference/android/os/Build#ID
+    """
+
+    is_low_ram_device: bool
+    """`True` if the application is running on a low-RAM device, `False` otherwise."""
+
+    is_physical_device: bool
+    """`False` if the application is running in an emulator, `True` otherwise."""
+
+    manufacturer: str
+    """The manufacturer of the product/hardware.
+
+    More info: https://developer.android.com/reference/android/os/Build#MANUFACTURER
+    """
+
+    model: str
+    """The end-user-visible name for the end product.
+
+    More info: https://developer.android.com/reference/android/os/Build#MODEL
+    """
+
+    name: str
+    """The name of the device."""
+
+    physical_ram_size: int
+    """Total physical RAM size in bytes."""
+
+    product: str
+    """The name of the overall product.
+
+    More info: https://developer.android.com/reference/android/os/Build#PRODUCT
+    """
+
+    supported_32_bit_abis: list[str]
+    """An ordered list of 32 bit ABIs supported by this device.
+    Available only on Android L (API 21) and newer.
+
+    More info:
+    https://developer.android.com/reference/android/os/Build#SUPPORTED_32_BIT_ABIS
+    """
+
+    supported_64_bit_abis: list[str]
+    """An ordered list of 64 bit ABIs supported by this device.
+    Available only on Android L (API 21) and newer.
+
+    More info:
+    https://developer.android.com/reference/android/os/Build#SUPPORTED_64_BIT_ABIS
+    """
+
+    supported_abis: list[str]
+    """An ordered list of ABIs supported by this device.
+    Available only on Android L (API 21) and newer.
+
+    More info: https://developer.android.com/reference/android/os/Build#SUPPORTED_ABIS
+    """
+
+    system_features: list[str]
+    """Describes what features are available on the current device.
+
+    This can be used to check if the device has, for example, a front-facing
+    camera, or a touchscreen. However, in many cases this is not the best
+    API to use. For example, if you are interested in bluetooth, this API
+    can tell you if the device has a bluetooth radio, but it cannot tell you
+    if bluetooth is currently enabled, or if you have been granted the
+    necessary permissions to use it. Please only use this if there is no
+    other way to determine if a feature is supported.
+
+    This data comes from Android's PackageManager.getSystemAvailableFeatures,
+    and many of the common feature strings to look for are available in
+    PackageManager's public documentation:
+    https://developer.android.com/reference/android/content/pm/PackageManager
+    """
+
+    tags: str
+    """Comma-separated tags describing the build, like `"unsigned,debug"`.
+
+    More info: https://developer.android.com/reference/android/os/Build#TAGS
+    """
+
+    total_disk_size: int
+    """Total disk size in bytes."""
+
+    type: str
+    """The type of build, like `"user"` or `"eng"`.
+
+    More info: https://developer.android.com/reference/android/os/Build#TYPE
+    """
+
+    version: AndroidBuildVersion
+    """
+    Android operating system version values derived from `android.os.Build.VERSION`.
+    """
+
+
+@dataclass
+class LinuxDeviceInfo(DeviceInfo):
+    """
+    Device information for a Linux system.
+
+    More info:
+        - https://www.freedesktop.org/software/systemd/man/os-release.html
+        - https://www.freedesktop.org/software/systemd/man/machine-id.html
+    """
+
+    name: str
+    """A string identifying the operating system, without a version component,
+    and suitable for presentation to the user.
+
+    Examples: `"Fedora"`, `"Debian GNU/Linux"`.
+
+    If not set, defaults to `"Linux"`.
+    """
+
+    id: str
+    """A lower-case string identifying the operating system, excluding any version
+    information and suitable for processing by scripts or usage in generated filenames.
+
+    The ID contains no spaces or other characters outside of 0–9, a–z, '.', '_' and '-'.
+
+    Examples: `"fedora"`, `"debian"`.
+
+    If not set, defaults to `"linux"`.
+    """
+
+    pretty_name: str
+    """A pretty operating system name in a format suitable for presentation to the
+    user. May or may not contain a release code name or OS version of some kind,
+    as suitable.
+
+    Examples: `"Fedora 17 (Beefy Miracle)"`.
+
+    If not set, defaults to `"Linux"`.
+    """
+
+    version: Optional[str] = None
+    """A string identifying the operating system version, excluding any OS name
+    information, possibly including a release code name, and suitable for presentation
+    to the user.
+
+    Examples: `"17"`, `"17 (Beefy Miracle)"`.
+
+    May be `None` on some systems.
+    """
+
+    id_like: Optional[list[str]] = None
+    """A space-separated list of operating system identifiers in the same syntax as
+    the id value. It lists identifiers of operating systems that are closely related
+    to the local operating system in regards to packaging and programming interfaces,
+    for example listing one or more OS identifiers the local OS is a derivative from.
+
+    Examples: an operating system with id `"centos"`, would list `"rhel"`
+    and `"fedora"`, and an operating system with id `"ubuntu"` would list `"debian"`.
+
+    May be `None` on some systems.
+    """
+
+    version_code_name: Optional[str] = None
+    """A lower-case string identifying the operating system release code name,
+    excluding any OS name information or release version, and suitable for processing
+    by scripts or usage in generated filenames.
+
+    The codename contains no spaces or other characters outside of 0–9, a–z, '.', '_'
+    and '-'.
+
+    Examples: `"buster"`, `"xenial"`.
+
+    May be `None` on some systems.
+    """
+
+    version_id: Optional[str] = None
+    """A lower-case string identifying the operating system version, excluding any
+    OS name information or release code name, and suitable for processing by scripts or
+    usage in generated filenames.
+
+    The version is mostly numeric, and contains no spaces or other characters outside
+    of 0–9, a–z, '.', '_' and '-'.
+
+    Examples: `"17"`, `"11.04"`.
+
+    May be `None` on some systems.
+    """
+
+    build_id: Optional[str] = None
+    """A string uniquely identifying the system image used as the origin for a
+    distribution (it is not updated with system updates). The field can be identical
+    between different version_id values as build_id is only a unique identifier to a
+    specific version.
+
+    Examples: `"2013-03-20.3"`, `"201303203"`.
+
+    May be `None` on some systems.
+    """
+
+    variant: Optional[str] = None
+    """A string identifying a specific variant or edition of the operating system
+    suitable for presentation to the user. This field may be used to inform the user
+    that the configuration of this system is subject to a specific divergent set of
+    rules or default configuration settings.
+
+    Examples: `"Server Edition"`, `"Smart Refrigerator Edition"`.
+
+    Note: this field is for display purposes only. The variant_id field should be used
+    for making programmatic decisions.
+
+    May be `None` on some systems.
+    """
+
+    variant_id: Optional[str] = None
+    """A lower-case string identifying a specific variant or edition of the operating
+    system. This may be interpreted in order to determine a divergent default
+    configuration.
+
+    The variant ID contains no spaces or other characters outside of
+    0–9, a–z, '.', '_' and '-'.
+
+    Examples: `"server"`, `"embedded"`.
+
+    May be `None` on some systems.
+    """
+
+    machine_id: Optional[str] = None
+    """A unique machine ID of the local system that is set during installation or boot.
+    The machine ID is hexadecimal, 32-character, lowercase ID. When decoded from
+    hexadecimal, this corresponds to a 16-byte/128-bit value.
+    """
+
+
+@dataclass
+class WindowsDeviceInfo(DeviceInfo):
+    computer_name: str
+    """The computer's fully-qualified DNS name, where available."""
+
+    number_of_cores: int
+    """Number of CPU cores on the local machine."""
+
+    system_memory: int
+    """The physically installed memory in the computer, in megabytes.
+
+    This may not be the same as available memory.
+    """
+
+    user_name: str
+
+    major_version: int
+    """The major version number of the operating system.
+
+    For example, for Windows 2000, the major version number is `5`.
+
+    For more info, see the table in Remarks:
+    https://docs.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/ns-wdm-_osversioninfoexw#remarks
+    """
+
+    minor_version: int
+    """The minor version number of the operating system.
+
+    For example, for Windows 2000, the minor version number is `0`.
+
+    For more info, see the table in Remarks:
+    https://docs.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/ns-wdm-_osversioninfoexw#remarks
+    """
+
+    build_number: int
+    """The build number of the operating system.
+
+    Examples:
+        - `22000` or greater for Windows 11.
+        - `10240` or greater for Windows 10.
+    """
+
+    platform_id: int
+    """The operating system platform.
+
+    For Win32 on NT-based operating systems,
+    RtlGetVersion returns the value `VER_PLATFORM_WIN32_NT`.
+    """
+
+    csd_version: str
+    """The service-pack version string.
+
+    This member contains a string, such as "Service Pack 3",
+    which indicates the latest service pack installed on the system.
+    """
+
+    service_pack_major: int
+    """The major version number of the latest service pack installed on the system.
+
+    For example, for Service Pack 3, the major version number is three.
+    If no service pack has been installed, the value is zero.
+    """
+
+    service_pack_minor: int
+    """The minor version number of the latest service pack installed on the system.
+
+    For example, for Service Pack 3, the minor version number is zero.
+    """
+
+    suit_mask: int
+    """The product suites available on the system."""
+
+    product_type: int
+    """The product type.
+
+    This member contains additional information about the system.
+    """
+
+    reserved: int
+    """Reserved for future use."""
+
+    build_lab: str
+    """Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\BuildLab`
+    registry key.
+
+    For example: `"22000.co_release.210604-1628"`.
+    """
+
+    build_lab_ex: str
+    """Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\BuildLabEx`
+    registry key.
+
+    For example: `"22000.1.amd64fre.co_release.210604-1628"`.
+    """
+
+    # digital_product_id: str
+
+    display_version: str
+    """Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\DisplayVersion`
+    registry key.
+
+    For example: `"21H2"`.
+    """
+
+    edition_id: str
+    """Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\EditionID`
+    registry key.
+    """
+
+    install_date: datetime
+    """Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\InstallDate`
+    registry key.
+    """
+
+    product_id: str
+    """Displayed as "Product ID" in Windows Settings.
+
+    Value of the `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\ProductId`
+    registry key.
+
+    For example: `"00000-00000-0000-AAAAA"`.
+    """
+
+    product_name: str
+    """Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\ProductName`
+    registry key.
+
+    For example: `"Windows 10 Home Single Language"`.
+    """
+
+    registered_owner: str
+    """Value of the `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\RegisteredOwner`
+    registry key.
+
+    For example: `"Microsoft Corporation"`.
+    """
+
+    release_id: str
+    """
+    Value of the `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\ReleaseId`
+    registry key.
+
+    For example: `"1903"`.
+    """
+
+    device_id: str
+    """Displayed as "Device ID" in Windows Settings.
+
+    Value of `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\SQMClient\\MachineId`
+    registry key.
+    """
+
+
+@dataclass
+class IosUtsname:
+    """
+    Information derived from `utsname`.
+
+    More info: http://pubs.opengroup.org/onlinepubs/7908799/xsh/sysutsname.h.html
+    """
+
+    machine: str
+    """Hardware type (e.g. `"iPhone7,1"` for iPhone 6 Plus)."""
+
+    node_name: str
+    """Network node name."""
+
+    release: str
+    """Release level."""
+
+    sys_name: str
+    """Operating system name."""
+
+    version: str
+    """Version level."""
+
+
+@dataclass
+class IosDeviceInfo(DeviceInfo):
+    available_ram_size: int
+    """Current unallocated RAM size of the device in megabytes."""
+
+    free_disk_size: int
+    """Free disk size in bytes."""
+
+    is_ios_app_on_mac: bool
+    """Indicates whether the process is an iPhone or iPad app running on a Mac.
+
+    More info:
+    https://developer.apple.com/documentation/foundation/nsprocessinfo/3608556-iosapponmac
+    """
+
+    is_physical_device: bool
+    """`False` if the application is running in a simulator, `True` otherwise."""
+
+    localized_model: str
+    """Localized name of the device model.
+
+    More info:
+    https://developer.apple.com/documentation/uikit/uidevice/1620029-localizedmodel
+    """
+
+    model: str
+    """Device model according to OS.
+
+    More info:
+    https://developer.apple.com/documentation/uikit/uidevice/1620044-model
+    """
+
+    model_name: str
+    """Commercial or user-known model name.
+
+    For example: `"iPhone 16 Pro"`, `"iPad Pro 11-Inch 3"`
+    """
+
+    name: str
+    """The device name.
+
+    Note:
+        - On iOS < 16 returns user-assigned device name.
+        - On iOS >= 16 returns a generic device name if project has
+            no entitlement to get user-assigned device name.
+
+    More info:
+    https://developer.apple.com/documentation/uikit/uidevice/1620015-name
+    """
+
+    physical_ram_size: int
+    """Total physical RAM size of the device in megabytes."""
+
+    system_name: str
+    """The name of the current operating system.
+
+    More info:
+    https://developer.apple.com/documentation/uikit/uidevice/1620054-systemname
+    """
+
+    system_version: str
+    """The current operating system version.
+
+    More info:
+    https://developer.apple.com/documentation/uikit/uidevice/1620043-systemversion
+    """
+
+    total_disk_size: int
+    """Total disk size in bytes."""
+
+    utsname: IosUtsname
+    """Operating system information derived from `sys/utsname.h`."""
+
+    identifier_for_vendor: Optional[str] = None
+    """Unique UUID value identifying the current device.
+
+    More info:
+    https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor
+    """

flet/controls/layout_control.py

@@ -10,7 +10,7 @@ from flet.controls.transform import OffsetValue, RotateValue, ScaleValue
 from flet.controls.types import Number
 from flet.utils import deprecated_class
 
-__all__ = ["LayoutControl"]
+__all__ = ["ConstrainedControl", "LayoutControl"]
 
 
 @control(kw_only=True)

flet/controls/page.py

@@ -33,6 +33,15 @@ from flet.controls.control_event import (
 )
 from flet.controls.core.view import View
 from flet.controls.core.window import Window
+from flet.controls.device_info import (
+    AndroidDeviceInfo,
+    DeviceInfo,
+    IosDeviceInfo,
+    LinuxDeviceInfo,
+    MacOsDeviceInfo,
+    WebDeviceInfo,
+    WindowsDeviceInfo,
+)
 from flet.controls.multi_view import MultiView
 from flet.controls.query_string import QueryString
 from flet.controls.ref import Ref
@@ -52,6 +61,7 @@ from flet.controls.types import (
 )
 from flet.utils import is_pyodide
 from flet.utils.deprecated import deprecated
+from flet.utils.from_dict import from_dict
 from flet.utils.strings import random_string
 
 if not is_pyodide():
@@ -326,8 +336,8 @@ class Page(BasePage):
     used for reference and the values:
     - Key: The font family name used for reference.
     - Value: The font source, either an absolute URL or a relative path to a
-      local asset. The following font file formats are supported `.ttc`, `.ttf`
-      and `.otf`.
+        local asset. The following font file formats are supported `.ttc`, `.ttf`
+        and `.otf`.
 
     Usage example [here](https://flet.dev/docs/cookbook/fonts#importing-fonts).
     """
@@ -904,3 +914,28 @@ class Page(BasePage):
         The PubSub client for the current page.
         """
         return self.session.pubsub_client
+
+    async def get_device_info(self) -> Optional[DeviceInfo]:
+        """
+        Returns device information.
+
+        Returns:
+            The device information object for the current platform,
+                or `None` if unavailable.
+        """
+        info = await self._invoke_method("get_device_info")
+
+        if self.web:
+            return from_dict(WebDeviceInfo, info)
+        elif self.platform == PagePlatform.ANDROID:
+            return from_dict(AndroidDeviceInfo, info)
+        elif self.platform == PagePlatform.IOS:
+            return from_dict(IosDeviceInfo, info)
+        elif self.platform == PagePlatform.MACOS:
+            return from_dict(MacOsDeviceInfo, info)
+        elif self.platform == PagePlatform.LINUX:
+            return from_dict(LinuxDeviceInfo, info)
+        elif self.platform == PagePlatform.WINDOWS:
+            return from_dict(WindowsDeviceInfo, info)
+        else:
+            return None

flet/messaging/protocol.py

@@ -72,6 +72,8 @@ def decode_ext_from_msgpack(code, data):
         return datetime.time(*map(int, data.decode("utf-8").split(":")))
     elif code == 3:
         return Duration.from_unit(microseconds=int(data))
+    elif code == 4:
+        return data.decode("utf-8")
     return msgpack.ExtType(code, data)
 
 

flet/version.py

@@ -10,7 +10,7 @@ from flet.utils import is_mobile, is_windows, which
 DEFAULT_VERSION = "0.1.0"
 
 # will be replaced by CI
-version = "0.70.0.dev6176"
+version = "0.70.0.dev6196"
 
 
 def update_version():

{flet-0.70.0.dev6176.dist-info → flet-0.70.0.dev6196.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6176
+Version: 0.70.0.dev6196
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0

{flet-0.70.0.dev6176.dist-info → flet-0.70.0.dev6196.dist-info}/RECORD

@@ -1,7 +1,7 @@
-flet/__init__.py,sha256=n5qVCP3EFldZdmB22hoO751d9fB5U9-AN6uMU-55IPA,25684
+flet/__init__.py,sha256=rj0DuM9ZNrzkM-TpQ35iIspYLzsrxOCwkVxOHRX6oiU,26152
 flet/app.py,sha256=HSws0Zm4ZO0-Hp2P9h7xirCVnRkKCVXhuekyAXT_9Fo,11883
 flet/cli.py,sha256=IUM25fY_sqMtl0hlQGhlMQaBb1oNyO0VZeeBgRodhuA,204
-flet/version.py,sha256=OOXW9v5bFD449k3IMfq3V3RcnBQc0NkTYV1ezhwJh_Y,2512
+flet/version.py,sha256=lEjT4drDCZ7zed-DtGi2t3mCSr7d6dXpf52GgcVaM9A,2512
 flet/auth/__init__.py,sha256=eDqmi0Ki8Resd198S7XxgYa2R14wnNqIXnYhBLPl8fQ,289
 flet/auth/authorization.py,sha256=hP_36RiRPtSwmK_Yp6MMzAjQdDxbBiEcZ2yFNqyNiRs,357
 flet/auth/authorization_service.py,sha256=6N2LvisSt7KI_VgfyCH0OaJ6jTcmXCkAldN1yYlakzQ,6410
@@ -46,6 +46,7 @@ flet/controls/context.py,sha256=xmmkrF2r4jD9ILe9lIrwtmkhvXv6awYpnwjHeqM5jFk,4239
 flet/controls/control.py,sha256=7uZKB9NOtj3zM-5uGq_x2GjsuDaXuSuVzuEKLJ1ysJU,4473
 flet/controls/control_event.py,sha256=wuI62LF8K42U6Ba2LK5R5YyhBtmxyTHBgZN4XfRKGRk,3107
 flet/controls/control_state.py,sha256=7Pi_WirBkE5dmUN0QnQLjSaW17Nj_escRlUvNxlrNR8,433
+flet/controls/device_info.py,sha256=fWhy73oldll9BZagLcPZG-YKi_wu6caEKCdOwP6SZXA,23465
 flet/controls/dialog_control.py,sha256=4a1poIK4al6DAsdiV56jE-Q4E-eKrvP12DqYw5HFvYM,507
 flet/controls/duration.py,sha256=Fwb26eyHKrU_lqvmGuTLw4m-28leLHOlgHxtqRIQsnA,7398
 flet/controls/embed_json_encoder.py,sha256=Ahd6wArEwiquZUb22FPIDRs-ppokznfTSK1QB9DQo0w,1251
@@ -56,12 +57,12 @@ flet/controls/gradients.py,sha256=oUYQTL0wI4FYbhOzd2b-KkbCUsijBgGpH9gSRIMYQdk,58
 flet/controls/icon_data.py,sha256=dtlNXm8_8yd_PRp_ogBuTDPz3-IXCXP47FA9C6SGoSk,2357
 flet/controls/id_counter.py,sha256=YhZT-dB_yYYqPEBJ8IoTA98NU_EPFnx6T7FWbA9ENB4,627
 flet/controls/keys.py,sha256=YpcAeINKelX3WgSOMF8_T7wMzcFmAXNg-ssPej_NZWY,614
-flet/controls/layout_control.py,sha256=17JFILKY6_G73VgoyGofF41E3hykUl4ipQh6EKCig3Y,7279
+flet/controls/layout_control.py,sha256=wF4W4u3MAHLjpin5nH4iOAyoq29v3QrqI6swYnl67js,7301
 flet/controls/margin.py,sha256=ni5FwkchO1LPKPTKV0Cimvh2YzABi-t5DhOqTS25eIQ,2305
 flet/controls/multi_view.py,sha256=7RbM1nt8t75qgTKyfemsV06XQ04Mer0Op409Nu9q9Vs,304
 flet/controls/object_patch.py,sha256=0OE8TswTyYH_l1yEqJPIf-Z6kLnOCCQCYiV-gNUvuSA,44111
 flet/controls/padding.py,sha256=AdxAZ5dbg1-Bo8aKeJ7AptUdyjaX7VWBIJto5mBT9Pk,2485
-flet/controls/page.py,sha256=OerVhgInFcr2C53LwvG8s5ksZ7TI9uw7WF5VL6-hTCg,26623
+flet/controls/page.py,sha256=vJAJo1purDrX-RFeWzsFtoHeI1ttUrXhbpQoyKrroj8,27788
 flet/controls/painting.py,sha256=GCEycacejiCAdA4eZBQlTgxmE2ccXyad4Gy7VsjIwn0,12108
 flet/controls/query_string.py,sha256=NDrf1P0cxSWuJd4Rqz1qYld_JKDJpHY7mKcP52-70DI,3575
 flet/controls/ref.py,sha256=Lde_Nlly6NEtJX_LYv_DxIDkao6w4Buo7Nus4XUPQDA,580
@@ -84,7 +85,7 @@ flet/controls/core/grid_view.py,sha256=kzln6PKgQ2jGEoNkNMjx0auoFfUndfzx6x0TgzLn5
 flet/controls/core/icon.py,sha256=fOf8mCKtQ8tlm_lzSliPq_qk8QTBGFE8Tq5OfiyfK3M,4001
 flet/controls/core/image.py,sha256=ES4byvkgl3z_YbsBVNnYVox8QN4_qCnOn9RjBK_3vUY,3950
 flet/controls/core/interactive_viewer.py,sha256=id5x4Z3Gf41naRy1kOj_cmBnfTlsoeBCJOmf8lLJp-o,4857
-flet/controls/core/keyboard_listener.py,sha256=S8h0ZELveIT8EyAxNilnUNPg9I9MVnOMmSKW_7cwylQ,2467
+flet/controls/core/keyboard_listener.py,sha256=Rml7c7pHNzTyBiSbW15cUXwhr5YddTrSo98z2tzWhaI,2527
 flet/controls/core/list_view.py,sha256=zyWHHG8Tpr4VYztQFWA_mRipLXKO6bVJ-Ra1Gso4qp4,3273
 flet/controls/core/markdown.py,sha256=zTAlVDJpwh5Ay1Lh7aHlTNCJ0zktCwNGit1QiyWjUyE,10939
 flet/controls/core/merge_semantics.py,sha256=o2olHjIDU-QNKAc8JHdQABiZUKeR4dWJApOCEcBaFF4,627
@@ -216,7 +217,7 @@ flet/controls/services/url_launcher.py,sha256=YfvNGaivvwJ2vrSkxwgQ2R1l3A5wbgY6Ax
 flet/fastapi/__init__.py,sha256=crLmmKE-B-O-cm5MTlXFreYCUnqkw6mK4eIPUUMvSCM,45
 flet/messaging/connection.py,sha256=yd7NlEAwAMxhCEhh6mLN-cihYfeJdUlHhx5SycRVct4,1646
 flet/messaging/flet_socket_server.py,sha256=bFeC-hlKFhBoVHBYy6o_LzWiuFaUmT-vMT81t5lGEUM,9146
-flet/messaging/protocol.py,sha256=LTdTUHD2RQfP55rL6InG2w0FfTJPWoKo_SGcand3YpA,3856
+flet/messaging/protocol.py,sha256=dxd17TINWzSYNAGbP-UC8lbhoOtRkzyvlyek5fw9488,3912
 flet/messaging/pyodide_connection.py,sha256=-bNGKh0nYNtgdJ_nhBGJTF1TNX3vHqgxygetv2ZQwUs,4313
 flet/messaging/session.py,sha256=RQkYkZDIKW-l9ShUvbYKPD6ZXgfD4yVz2WERgUnp_OA,12310
 flet/messaging/session_store.py,sha256=80yy3fjEGJs_60UxS_o2tXl2QCenFb9IVDaJCK8wckY,557
@@ -245,8 +246,8 @@ flet/utils/platform_utils.py,sha256=U4cqV3EPi5QNYjbhfZmtk41-KMtI_P7KvVdnZzMOgJA,
 flet/utils/slugify.py,sha256=e-lsoDc2_dk5jQnySaHCU83AA4O6mguEgCEdk2smW2Y,466
 flet/utils/strings.py,sha256=R63_i7PdSAStCDPJ-O_WHBt3H02JQ14GSbnjLIpPTUc,178
 flet/utils/vector.py,sha256=pYZzjldBWCZbSeSkZ8VmujwcZC7VBWk1NLBPA-2th3U,3207
-flet-0.70.0.dev6176.dist-info/METADATA,sha256=dbegGXkovTUQPhsOkyr_2moO0StiTRMY-ME27Z9e8BQ,6051
-flet-0.70.0.dev6176.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flet-0.70.0.dev6176.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
-flet-0.70.0.dev6176.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
-flet-0.70.0.dev6176.dist-info/RECORD,,
+flet-0.70.0.dev6196.dist-info/METADATA,sha256=Zzqg4QTkYfEixyxtUtW-zhU10VTmSze8QbRrcHbkkJo,6051
+flet-0.70.0.dev6196.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet-0.70.0.dev6196.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
+flet-0.70.0.dev6196.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
+flet-0.70.0.dev6196.dist-info/RECORD,,