flet-cli 0.82.3.dev7877__tar.gz → 0.82.3.dev7882__tar.gz

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-cli
-Version: 0.82.3.dev7877
+Version: 0.82.3.dev7882
 Summary: Flet CLI
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,7 +9,7 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://flet.dev/docs
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet==0.82.3.dev7877
+Requires-Dist: flet==0.82.3.dev7882
 Requires-Dist: watchdog>=4.0.0
 Requires-Dist: packaging>=25.0
 Requires-Dist: qrcode>=7.4.2

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "flet-cli"
-version = "0.82.3.dev7877"
+version = "0.82.3.dev7882"
 description = "Flet CLI"
 authors = [{ name = "Appveyor Systems Inc.", email = "hello@flet.dev" }]
 license = "Apache-2.0"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "flet==0.82.3.dev7877",
+    "flet==0.82.3.dev7882",
     "watchdog >=4.0.0",
     "packaging >=25.0",
     "qrcode >=7.4.2",

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/src/flet_cli/commands/build.py

@@ -12,6 +12,8 @@ class Command(BaseBuildCommand):
     installable bundle. It supports building for desktop (macOS, Linux, Windows), web,
     Android (APK/AAB), and iOS (IPA and simulator .app), with a wide range of
     customization options for metadata, assets, splash screens, and signing.
+
+    Detailed guide with usage examples: https://docs.flet.dev/publish
     """
 
     def __init__(self, parser: argparse.ArgumentParser) -> None:

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/src/flet_cli/commands/build_base.py

@@ -23,8 +23,10 @@ from flet_cli.commands.flutter_base import (
     verbose2_style,
     warning_style,
 )
+from flet_cli.utils.cli import parse_cli_bool_value
 from flet_cli.utils.hash_stamp import HashStamp
 from flet_cli.utils.merge import merge_dict
+from flet_cli.utils.plist import is_supported_plist_value, parse_cli_plist_value
 from flet_cli.utils.project_dependencies import (
     get_poetry_dependencies,
     get_project_dependencies,
@@ -250,8 +252,8 @@ class BaseBuildCommand(BaseFlutterCommand):
             action="extend",
             nargs="+",
             default=[],
-            help="Files and/or directories to exclude from the package "
-            "(can be used multiple times)",
+            help="Files and/or directories to exclude from the package"
+            "; can be used multiple times",
         )
         parser.add_argument(
             "--clear-cache",
@@ -499,42 +501,49 @@ class BaseBuildCommand(BaseFlutterCommand):
         parser.add_argument(
             "--info-plist",
             dest="info_plist",
+            action="extend",
             nargs="+",
             default=[],
-            help="The list of `<key>=<value>|True|False` pairs to add to Info.plist "
-            "for macOS and iOS builds (macos, ipa and ios-simulator only)",
+            help="The list of `<key>=<value>` pairs to add to Info.plist. Values can "
+            "be booleans, strings, numbers, TOML arrays, or TOML inline tables "
+            "(macos, ipa and ios-simulator only); can be used multiple times",
         )
         parser.add_argument(
             "--macos-entitlements",
             dest="macos_entitlements",
+            action="extend",
             nargs="+",
             default=[],
-            help="The list of `<key>=<value>|True|False` entitlements for "
-            "macOS builds (macos only)",
+            help="The list of `<key>=<value>` entitlements. Values can be booleans, "
+            "strings, numbers, TOML arrays, or TOML inline tables "
+            "(macos only); can be used multiple times",
         )
         parser.add_argument(
             "--android-features",
             dest="android_features",
+            action="extend",
             nargs="+",
             default=[],
-            help="The list of `<feature_name>=True|False` features to add to "
-            "AndroidManifest.xml for Android builds (android only)",
+            help="The list of `<feature_name>=true|false` features to add to "
+            "AndroidManifest.xml (android only); can be used multiple times",
         )
         parser.add_argument(
             "--android-permissions",
             dest="android_permissions",
+            action="extend",
             nargs="+",
             default=[],
-            help="The list of `<permission_name>=True|False` permissions to add to "
-            "AndroidManifest.xml for Android builds (android only)",
+            help="The list of `<permission_name>=true|false` permissions to add to "
+            "AndroidManifest.xml (android only); can be used multiple times",
         )
         parser.add_argument(
             "--android-meta-data",
             dest="android_meta_data",
+            action="extend",
             nargs="+",
             default=[],
             help="The list of `<name>=<value>` app meta-data entries to add to "
-            "AndroidManifest.xml for Android builds (android only)",
+            "AndroidManifest.xml (android only); can be used multiple times",
         )
         parser.add_argument(
             "--permissions",
@@ -853,12 +862,20 @@ class BaseBuildCommand(BaseFlutterCommand):
             if i > -1:
                 k = p[:i]
                 v = p[i + 1 :]
-                info_plist[k] = (
-                    (v.lower() == "true") if v.lower() in {"true", "false"} else v
-                )
+                info_plist[k] = parse_cli_plist_value(v)
             else:
                 self.cleanup(1, f"Invalid Info.plist option: {p}")
 
+        for key, value in info_plist.items():
+            if not is_supported_plist_value(value):
+                self.cleanup(
+                    1,
+                    "Unsupported Info.plist value type for "
+                    f"{key}: {type(value).__name__}. Supported types are "
+                    "string, boolean, integer, float, dictionary, and arrays "
+                    "containing those values.",
+                )
+
         macos_entitlements = merge_dict(
             macos_entitlements,
             self.get_pyproject("tool.flet.macos.entitlement") or {},
@@ -868,10 +885,20 @@ class BaseBuildCommand(BaseFlutterCommand):
         for p in self.options.macos_entitlements:
             i = p.find("=")
             if i > -1:
-                macos_entitlements[p[:i]] = p[i + 1 :] == "True"
+                macos_entitlements[p[:i]] = parse_cli_plist_value(p[i + 1 :])
             else:
                 self.cleanup(1, f"Invalid macOS entitlement option: {p}")
 
+        for key, value in macos_entitlements.items():
+            if not is_supported_plist_value(value):
+                self.cleanup(
+                    1,
+                    "Unsupported macOS entitlement value type for "
+                    f"{key}: {type(value).__name__}. Supported types are "
+                    "string, boolean, integer, float, dictionary, and arrays "
+                    "containing those values.",
+                )
+
         android_permissions = merge_dict(
             android_permissions,
             self.get_pyproject("tool.flet.android.permission") or {},
@@ -881,7 +908,14 @@ class BaseBuildCommand(BaseFlutterCommand):
         for p in self.options.android_permissions:
             i = p.find("=")
             if i > -1:
-                android_permissions[p[:i]] = p[i + 1 :] == "True"
+                try:
+                    android_permissions[p[:i]] = parse_cli_bool_value(p[i + 1 :])
+                except ValueError:
+                    self.cleanup(
+                        1,
+                        f"Invalid Android permission option value for {p[:i]}: "
+                        f"{p[i + 1 :]}. Expected true or false.",
+                    )
             else:
                 self.cleanup(1, f"Invalid Android permission option: {p}")
 
@@ -894,7 +928,14 @@ class BaseBuildCommand(BaseFlutterCommand):
         for p in self.options.android_features:
             i = p.find("=")
             if i > -1:
-                android_features[p[:i]] = p[i + 1 :] == "True"
+                try:
+                    android_features[p[:i]] = parse_cli_bool_value(p[i + 1 :])
+                except ValueError:
+                    self.cleanup(
+                        1,
+                        f"Invalid Android feature option value for {p[:i]}: "
+                        f"{p[i + 1 :]}. Expected true or false.",
+                    )
             else:
                 self.cleanup(1, f"Invalid Android feature option: {p}")
 

flet_cli-0.82.3.dev7882/src/flet_cli/utils/cli.py

@@ -0,0 +1,8 @@
+def parse_cli_bool_value(value: str) -> bool:
+    """Parse a CLI boolean value, accepting only true/false tokens."""
+    normalized = value.strip().lower()
+    if normalized == "true":
+        return True
+    if normalized == "false":
+        return False
+    raise ValueError("expected true or false")

flet_cli-0.82.3.dev7882/src/flet_cli/utils/plist.py

@@ -0,0 +1,42 @@
+try:
+    import tomllib
+except ModuleNotFoundError:
+    import tomli as tomllib
+
+
+def is_supported_plist_value(value) -> bool:
+    """Checks if the value is a supported type for plist values."""
+    # string and boolean
+    if isinstance(value, (str, bool)):
+        return True
+    # integer and float/real
+    if isinstance(value, (int, float)):
+        return True
+    # array
+    if isinstance(value, list):
+        return all(is_supported_plist_value(item) for item in value)
+    # dictionary
+    if isinstance(value, dict):
+        return all(
+            isinstance(key, str) and is_supported_plist_value(item)
+            for key, item in value.items()
+        )
+    return False
+
+
+def parse_cli_plist_value(value: str):
+    """Parses a CLI-provided plist value, supporting TOML syntax for complex types."""
+    value = value.strip()
+    lowered = value.lower()
+    if lowered in {"true", "false"}:
+        return lowered == "true"
+
+    try:
+        parsed = tomllib.loads(f"value = {value}")["value"]
+    except Exception:
+        return value
+
+    if is_supported_plist_value(parsed):
+        return parsed
+
+    return value

flet_cli-0.82.3.dev7882/src/flet_cli/version.py

@@ -0,0 +1 @@
+version = "0.82.3.dev7882"

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/src/flet_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-cli
-Version: 0.82.3.dev7877
+Version: 0.82.3.dev7882
 Summary: Flet CLI
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,7 +9,7 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://flet.dev/docs
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet==0.82.3.dev7877
+Requires-Dist: flet==0.82.3.dev7882
 Requires-Dist: watchdog>=4.0.0
 Requires-Dist: packaging>=25.0
 Requires-Dist: qrcode>=7.4.2

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/src/flet_cli.egg-info/SOURCES.txt

@@ -30,11 +30,14 @@ src/flet_cli/commands/publish.py
 src/flet_cli/commands/run.py
 src/flet_cli/commands/serve.py
 src/flet_cli/utils/android_sdk.py
+src/flet_cli/utils/cli.py
 src/flet_cli/utils/distros.py
 src/flet_cli/utils/flutter.py
 src/flet_cli/utils/hash_stamp.py
 src/flet_cli/utils/jdk.py
 src/flet_cli/utils/merge.py
+src/flet_cli/utils/plist.py
 src/flet_cli/utils/processes.py
 src/flet_cli/utils/project_dependencies.py
-src/flet_cli/utils/pyproject_toml.py
+src/flet_cli/utils/pyproject_toml.py
+tests/test_plist.py

{flet_cli-0.82.3.dev7877 → flet_cli-0.82.3.dev7882}/src/flet_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-flet==0.82.3.dev7877
+flet==0.82.3.dev7882
 watchdog>=4.0.0
 packaging>=25.0
 qrcode>=7.4.2

flet_cli-0.82.3.dev7882/tests/test_plist.py

@@ -0,0 +1,52 @@
+from flet_cli.utils.plist import is_supported_plist_value, parse_cli_plist_value
+
+
+def test_parse_cli_plist_value_supports_strings_and_booleans():
+    """Strings and booleans should parse into their respective Python types."""
+    assert parse_cli_plist_value("true") is True
+    assert parse_cli_plist_value("False") is False
+    assert parse_cli_plist_value("TEAMID.example.app") == "TEAMID.example.app"
+
+
+def test_parse_cli_plist_value_keeps_quoted_literals_as_strings():
+    """Quoted literals should remain strings even if they look typed."""
+    assert parse_cli_plist_value('"true"') == "true"
+    assert parse_cli_plist_value('"false"') == "false"
+    assert parse_cli_plist_value('"42"') == "42"
+    assert parse_cli_plist_value('"3.14"') == "3.14"
+
+
+def test_parse_cli_plist_value_supports_integers_and_floats():
+    """Numeric TOML literals should parse into Python numbers."""
+    assert parse_cli_plist_value("42") == 42
+    assert parse_cli_plist_value("3.14") == 3.14
+
+
+def test_parse_cli_plist_value_supports_toml_arrays():
+    """TOML arrays should parse into Python lists."""
+    assert parse_cli_plist_value('["group.dev.example", "group.dev.shared"]') == [
+        "group.dev.example",
+        "group.dev.shared",
+    ]
+
+
+def test_parse_cli_plist_value_supports_toml_inline_tables():
+    """TOML inline tables should parse into Python dictionaries."""
+    assert parse_cli_plist_value('{ "com.apple.mail" = ["compose"] }') == {
+        "com.apple.mail": ["compose"]
+    }
+
+
+def test_supported_plist_value_accepts_numbers():
+    """The plist validator should accept integer and real values."""
+    assert is_supported_plist_value(1)
+    assert is_supported_plist_value(1.5)
+    assert is_supported_plist_value(["group.dev.example", 1, 1.5])
+    assert is_supported_plist_value({"com.apple.mail": 1})
+
+
+def test_unsupported_plist_types_are_rejected():
+    """The plist validator should reject null values recursively."""
+    assert not is_supported_plist_value(None)
+    assert not is_supported_plist_value(["group.dev.example", None])
+    assert not is_supported_plist_value({"com.apple.mail": None})

flet_cli-0.82.3.dev7877/src/flet_cli/version.py

@@ -1 +0,0 @@
-version = "0.82.3.dev7877"