fastled 1.1.88__py3-none-any.whl → 1.2.0__py3-none-any.whl

fastled/__init__.py

@@ -13,15 +13,18 @@ from .types import BuildMode, CompileResult, CompileServerError
 # IMPORTANT! There's a bug in github which will REJECT any version update
 # that has any other change in the repo. Please bump the version as the
 # ONLY change in a commit, or else the pypi update and the release will fail.
-__version__ = "1.1.88"
+__version__ = "1.2.0"
 
 
 class Api:
     @staticmethod
-    def get_examples():
+    def get_examples(host: str | CompileServer | None = None) -> list[str]:
         from fastled.project_init import get_examples
 
-        return get_examples()
+        if isinstance(host, CompileServer):
+            host = host.url()
+
+        return get_examples(host=host)
 
     @staticmethod
     def project_init(
@@ -110,6 +113,13 @@ class Api:
 
 
 class Test:
+
+    @staticmethod
+    def can_run_local_docker_tests() -> bool:
+        from fastled.test.can_run_local_docker_tests import can_run_local_docker_tests
+
+        return can_run_local_docker_tests()
+
     @staticmethod
     def test_examples(
         examples: list[str] | None = None, host: str | CompileServer | None = None

fastled/app.py

@@ -16,6 +16,9 @@ def run_server(args: argparse.Namespace) -> int:
     interactive = args.interactive
     auto_update = args.auto_update
     mapped_dir = Path(args.directory).absolute() if args.directory else None
+    if interactive and mapped_dir is None:
+        print("Select a sketch when you enter interactive mode.")
+        return 1
     compile_server = CompileServer(
         interactive=interactive,
         auto_updates=auto_update,

fastled/project_init.py

@@ -5,22 +5,15 @@ import httpx
 
 from fastled.settings import DEFAULT_URL
 
-ENDPOINT_PROJECT_INIT = f"{DEFAULT_URL}/project/init"
-ENDPOINT_INFO = f"{DEFAULT_URL}/info"
 DEFAULT_EXAMPLE = "wasm"
 
-_EXCLUDED_EXAMPLES = [
-    "Pintest",
-    "OctoWS2811",
-]
 
-
-def get_examples() -> list[str]:
-    response = httpx.get(ENDPOINT_INFO, timeout=4)
+def get_examples(host: str | None = None) -> list[str]:
+    host = host or DEFAULT_URL
+    url_info = f"{host}/info"
+    response = httpx.get(url_info, timeout=4)
     response.raise_for_status()
     examples: list[str] = response.json()["examples"]
-    # filter out excluded examples
-    examples = [example for example in examples if example not in _EXCLUDED_EXAMPLES]
     return sorted(examples)
 
 
@@ -61,8 +54,9 @@ def project_init(
             )
             example = DEFAULT_EXAMPLE
     assert example is not None
-    endpoint_url = f"{host}/project/init/{example}"
-    response = httpx.get(endpoint_url, timeout=20)
+    endpoint_url = f"{host}/project/init"
+    json = example
+    response = httpx.post(endpoint_url, timeout=20, json=json)
     response.raise_for_status()
     content = response.content
     tmpzip = outputdir / "fastled.zip"
@@ -72,6 +66,7 @@ def project_init(
         zip_ref.extractall(outputdir)
     tmpzip.unlink()
     out = outputdir / example
+    print(f"Project initialized at {out}")
     assert out.exists()
     return out
 

fastled/test/can_run_local_docker_tests.py

@@ -0,0 +1,13 @@
+import os
+import platform
+
+
+def can_run_local_docker_tests() -> bool:
+    """Check if this system can run Docker Tests"""
+    is_github_runner = "GITHUB_ACTIONS" in os.environ
+    if not is_github_runner:
+        from fastled.docker_manager import DockerManager
+
+        return DockerManager.is_docker_installed()
+    # this only works in ubuntu at the moment
+    return platform.system() == "Linux"

fastled/test/examples.py

@@ -1,4 +1,8 @@
 from tempfile import TemporaryDirectory
+from time import time
+from warnings import warn
+
+_FILTER = True
 
 
 def test_examples(
@@ -8,13 +12,24 @@ def test_examples(
     from fastled import Api
 
     out: dict[str, Exception] = {}
-    examples = Api.get_examples() if examples is None else examples
+    examples = Api.get_examples(host=host) if examples is None else examples
+    if host is None and _FILTER:
+        examples.remove("Chromancer")  # Brutal
+        examples.remove("LuminescentGrand")
     with TemporaryDirectory() as tmpdir:
         for example in examples:
             print(f"Initializing example: {example}")
-            sketch_dir = Api.project_init(example, outputdir=tmpdir, host=host)
+            try:
+                sketch_dir = Api.project_init(example, outputdir=tmpdir, host=host)
+            except Exception as e:
+                warn(f"Failed to initialize example: {example}, error: {e}")
+                out[example] = e
+                continue
             print(f"Project initialized at: {sketch_dir}")
+            start = time()
             print(f"Compiling example: {example}")
+            diff = time() - start
+            print(f"Compilation took: {diff:.2f} seconds")
             result = Api.web_compile(sketch_dir, host=host)
             if not result.success:
                 out[example] = Exception(result.stdout)
@@ -22,9 +37,12 @@ def test_examples(
 
 
 def unit_test() -> None:
-    out = test_examples()
-    if out:
-        raise RuntimeError(f"Failed tests: {out}")
+    from fastled import Api
+
+    with Api.server(auto_updates=True) as server:
+        out = test_examples(host=server.url())
+        if out:
+            raise RuntimeError(f"Failed tests: {out}")
 
 
 if __name__ == "__main__":

{fastled-1.1.88.dist-info → fastled-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastled
-Version: 1.1.88
+Version: 1.2.0
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -23,9 +23,6 @@ Requires-Dist: progress>=1.6
 
 # FastLED Wasm compiler
 
-Compiles an Arduino/Platformio sketch into a wasm binary that can be run directly in the web browser.
-
-
 [![Linting](https://github.com/zackees/fastled-wasm/actions/workflows/lint.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/lint.yml)
 [![MacOS_Tests](https://github.com/zackees/fastled-wasm/actions/workflows/test_macos.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/test_macos.yml)
 [![Ubuntu_Tests](https://github.com/zackees/fastled-wasm/actions/workflows/test_ubuntu.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/test_ubuntu.yml)
@@ -35,9 +32,11 @@ Compiles an Arduino/Platformio sketch into a wasm binary that can be run directl
 [![Build Executables](https://github.com/zackees/fastled-wasm/actions/workflows/test_build_exe.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/test_build_exe.yml)
 [![Publish Release](https://github.com/zackees/fastled-wasm/actions/workflows/publish_release.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/publish_release.yml)
 
-# Demo
 
-https://zackees.github.io/fastled-wasm/
+
+## Compile your FastLED sketch and run it on the Browser!
+
+![image](https://github.com/user-attachments/assets/243aeb4d-e42f-4cc3-9c31-0af51271f3e0)
 
 
 # About
@@ -46,11 +45,17 @@ This python app will compile your FastLED style sketches into html/js/wasm outpu
 
 Compile times are extremely fast, thanks to aggressive object caching for C++ and sketch fingerprinting with a zip file cache. Recompilation of sketch files with minimal changes will occure in less than a second.
 
-By default the web compiler will always be used unless that user specifies `--local`, in which case this compiler will invoke docker to bring in a runtime necessary to run the compiler toolchain.
+If you have docker installed, the compiler will download the docker image and run a private local server on your machine. If you don't have Docker installed then the app will fall back to using the public web compiler.
 
-The local compiler will be much faster than the web version in most circumstances after the first compile. The web compiler
-has the advantage that as a persistant service the compile cache will remain much more up to date.
+In every conceivable way, the local compiler will be much faster than the web version.
 
+# Demo
+
+https://zackees.github.io/fastled-wasm/
+
+# Tutorial video
+
+**Note this video is a little outdated, you will install the app now with `pip install fastled` and run it like `fastled mysketchfolder`**
 
 https://github.com/user-attachments/assets/64ae0e6c-5f8b-4830-ab87-dcc25bc61218
 
@@ -257,9 +262,9 @@ A: `delay()` will block `loop()` which blocks the main thread of the browser. Th
 Q: How can I get the compiled size of my FastLED sketch smaller?
 A: A big chunk of space is being used by unnecessary javascript `emscripten` bundling. The wasm_compiler_settings.py file in the FastLED repo can tweak this.
 
-
 # Revisions
 
+  * 1.2.00 - `fastled.exe` is now a signed binary on windows, however it's a self signed binary so you'll still get the warning on the first open. There's been a small api change between the server and the client for fetching projects.
   * 1.1.69 - Changed the binary name to `fastled.exe` instead of something like `fastled-windows-x64.exe`
   * 1.1.68 - Add a site builder to fastled.Test which generates a website with a bunch of demos. This is used to build the demo site automatically.
   * 1.1.67 - Pinned all the minimum versions of dependencies so we don't bind to an out of date py dep: https://github.com/zackees/fastled-wasm/issues/3

{fastled-1.1.88.dist-info → fastled-1.2.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-fastled/__init__.py,sha256=D282INW9LxPw4mZCC17pye4xt-z0O6fJZip52U-jJxk,3925
-fastled/app.py,sha256=AHLQczFKLV1ZyGCh45wTvJqQpQyJ_Ukh3MmG3Om4NHQ,1844
+fastled/__init__.py,sha256=eRL6Kzu-3m84oZ9e_5JczvV90MKmxJGvQQQRvIY19EI,4258
+fastled/app.py,sha256=Y1Q5mx4zdQbZ2AaB43ZqJo-w_8ehAaWVNtvTyeCRSaE,1970
 fastled/cli.py,sha256=FjVr31ht0UPlAcmX-84NwfAGMQHTkrCe4o744jCAxiw,375
 fastled/client_server.py,sha256=8L62zNtkGtErDtWrr4XVNsv7ji2zoS5rlqfCnwI3VKU,13177
 fastled/compile_server.py,sha256=Z7rHFs3M6QPbSCsbgHAQDk6GTVAJMMPCXtD4Y0mu8RM,2659
@@ -11,7 +11,7 @@ fastled/live_client.py,sha256=_KvqmyUyyGpoYET1Z9CdeUVoIbFjIUWwPcTp5XCQuxY,2075
 fastled/open_browser.py,sha256=vzMBcpDNY0f-Bx9KmEILKDANZ6gvsywCVwn1FRhPXh4,1770
 fastled/parse_args.py,sha256=qsikaRmRDPOosPF1AmfjaATSwH2xxJbKDKswOyVn2oM,6254
 fastled/paths.py,sha256=VsPmgu0lNSCFOoEC0BsTYzDygXqy15AHUfN-tTuzDZA,99
-fastled/project_init.py,sha256=2WBdCN01hBfoYJn-x3TD5KsJEo5BTrHzr2QyszGzZAU,2416
+fastled/project_init.py,sha256=QEghpy5Vonc_fTF--3L5ySrQ1bDpdJpfnlEHHQLDKRk,2287
 fastled/select_sketch_directory.py,sha256=TZdCjl1D7YMKjodMTvDRurPcpAmN3x0TcJxffER2NfM,1314
 fastled/settings.py,sha256=3eMKv0tLXgIQ0CFDboIp_l5_71rzIIyWg353YjnYJnc,323
 fastled/sketch.py,sha256=483TrrIdZJfo1MIu5FkD-V5OGmOfHmsZ2f6VvNsJBJM,3299
@@ -22,10 +22,11 @@ fastled/util.py,sha256=t4M3NFMhnCzfYbLvIyJi0RdFssZqbTN_vVIaej1WV-U,265
 fastled/web_compile.py,sha256=05PeLJ77QQC6PUKjDhsntBmyBola6QQIfF2k-zjYNE4,10261
 fastled/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
 fastled/site/build.py,sha256=UDWaked5QFPibbKZSoDrQgiP1Laoh8f0Fbj8Qfey0I4,12503
-fastled/test/examples.py,sha256=EDXb6KastKOOWzew99zrpmcNcXTcAtYi8eud6F1pnWA,980
-fastled-1.1.88.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.1.88.dist-info/METADATA,sha256=ElHNWdBrZiXj0gmUsNmRN7GMMZ8hECrTDnTXZB0q8r8,18951
-fastled-1.1.88.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-fastled-1.1.88.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.1.88.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
-fastled-1.1.88.dist-info/RECORD,,
+fastled/test/can_run_local_docker_tests.py,sha256=LEuUbHctRhNNFWcvnz2kEGmjDJeXO4c3kNpizm3yVJs,400
+fastled/test/examples.py,sha256=6xPwx_k9_XwYTpI1nk4SrYbsJKHJACd30GzD1epGqhY,1597
+fastled-1.2.0.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.2.0.dist-info/METADATA,sha256=POxzspBb64BD74PBEe0WAE5qw7cNsDhhLGbBAp-SkDQ,19277
+fastled-1.2.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+fastled-1.2.0.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.2.0.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
+fastled-1.2.0.dist-info/RECORD,,