fastled 1.1.45__py3-none-any.whl → 1.1.66__py3-none-any.whl

fastled/__init__.py

@@ -9,7 +9,7 @@ from .compile_server import CompileServer
 from .live_client import LiveClient
 from .types import BuildMode, CompileResult, CompileServerError
 
-__version__ = "1.1.45"
+__version__ = "1.1.66"
 
 
 class Api:

fastled/app.py

@@ -57,6 +57,7 @@ def main() -> int:
 
 
 if __name__ == "__main__":
+    # Note that the entry point for the exe is in cli.py
     try:
         sys.exit(main())
     except KeyboardInterrupt:

fastled/cli.py

@@ -2,6 +2,7 @@
 Main entry point.
 """
 
+import multiprocessing
 import sys
 
 from fastled.app import main as app_main
@@ -12,5 +13,7 @@ def main() -> int:
     return app_main()
 
 
+# Cli entry point for the pyinstaller generated exe
 if __name__ == "__main__":
+    multiprocessing.freeze_support()  # needed by pyinstaller.
     sys.exit(main())

fastled/parse_args.py

@@ -18,9 +18,7 @@ from fastled.sketch import (
 def parse_args() -> argparse.Namespace:
     """Parse command-line arguments."""
     parser = argparse.ArgumentParser(description=f"FastLED WASM Compiler {__version__}")
-    parser.add_argument(
-        "--version", action="version", version=f"{__version__}"
-    )
+    parser.add_argument("--version", action="version", version=f"{__version__}")
     parser.add_argument(
         "directory",
         type=str,
@@ -30,8 +28,9 @@ def parse_args() -> argparse.Namespace:
     )
     parser.add_argument(
         "--init",
-        action="store_true",
-        help="Initialize the FastLED sketch in the current directory",
+        nargs="?",
+        const=True,
+        help="Initialize the FastLED sketch in the current directory. Optional name can be provided",
     )
     parser.add_argument(
         "--just-compile",
@@ -105,7 +104,8 @@ def parse_args() -> argparse.Namespace:
     args = parser.parse_args()
 
     if args.init:
-        args.directory = project_init()
+        example = args.init if args.init is not True else None
+        args.directory = project_init(example)
         print("\nInitialized FastLED project in", args.directory)
         print(f"Use 'fastled {args.directory}' to compile the project.")
         sys.exit(0)

fastled/project_init.py

@@ -9,12 +9,19 @@ 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)
     response.raise_for_status()
-    out: list[str] = response.json()["examples"]
-    return sorted(out)
+    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)
 
 
 def _prompt_for_example() -> str:

{fastled-1.1.45.dist-info → fastled-1.1.66.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastled
-Version: 1.1.45
+Version: 1.1.66
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -33,8 +33,7 @@ Compiles an Arduino/Platformio sketch into a wasm binary that can be run directl
 
 [![Build and Push Multi Docker Image](https://github.com/zackees/fastled-wasm/actions/workflows/build_multi_docker_image.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/build_multi_docker_image.yml)
 [![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)
-[![Create Version Tag](https://github.com/zackees/fastled-wasm/actions/workflows/create_version_tag.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/create_version_tag.yml)
-[![Build and Publish Release](https://github.com/zackees/fastled-wasm/actions/workflows/build_release.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/build_release.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)
 
 
 # About
@@ -88,7 +87,7 @@ You can also spawn a server in one process and then access it in another, like t
 ```bash
 fastled --server  # server will now run in the background.
 # now launch the client
-fastled examples/wasm --local  # local will find the local server use it do the compile.
+fastled examples/wasm --local  # local will find the local server and use it to do the compile.
 ```
 
 After compilation a web browser windows will pop up. Changes to the sketch will automatically trigger a recompilation.
@@ -184,7 +183,7 @@ with Api.server() as server:
 
 ## Hot reload by default
 
-Once launched, the compiler will remain open, listening to changes and recompiling as necessary and hot-reloading the sketch into the current browser.
+Once launched, the compiler will remain open, listening to changes and recompiling as necessary, hot-reloading the sketch into the current browser.
 
 This style of development should be familiar to those doing web development.
 
@@ -193,19 +192,19 @@ This style of development should be familiar to those doing web development.
 If you launch `fastled` in the FastLED repo then this tool will automatically detect this and map the src directory into the
 host container. Whenever there are changes in the source code from the mapped directory, then these will be re-compiled
 on the next change or if you hit the space bar when prompted. Unlike a sketch folder, a re-compile on the FastLED src
-can be much longer, for example if you modify a header file.
+can be much longer, for example, if you modify a header file.
 
 ## Big Data in `/data` directory won't be round-tripped
 
 Huge blobs of data like video will absolutely kill the compile performance as these blobs would normally have to be shuffled
 back and forth. Therefore a special directory `data/` is implicitly used to hold this blob data. Any data in this directory
-will be replaced with a stub containing the size and hash of the file during upload. On download these stubs are swapped back
+will be replaced with a stub containing the size and hash of the file during upload. On download, these stubs are swapped back
 with their originals during decompression.
 
-The wasm compiler will recognize all files in the `data/` directory and generate a `files.json` manifest and can be used
+The wasm compiler will recognize all files in the `data/` directory and generate a `files.json` manifest which can be used
 in your wasm sketch using an emulated SD card system mounted at `/data/` on the SD Card. In order to increase load speed, these
-files will be asynchroniously streamed into the running sketch instance during runtime. Files named with *.json, *.csv, *.txt will be
-immediately injected in the app before setup() is called and can be used immediatly in setup() in their entirety.
+files will be asynchronously streamed into the running sketch instance during runtime. Files named with *.json, *.csv, *.txt will be
+immediately injected in the app before setup() is called and can be used immediately in setup() in their entirety.
 
 All other files will be streamed in. The `Video` element in FastLED is designed to gracefully handle missing data streamed in through
 the file system.
@@ -214,30 +213,30 @@ For an example of how to use this see `examples/SdCard` which is fully wasm comp
 
 ## Compile Speed
 
-The compile speeds for this compiler have been optimized pretty much to the max. There are three compile settings available to the user. The default is `--quick`. Aggressive optimizations are done with `--release` which will aggressively optimize for size. The speed difference between `--release` and `--quick` seems negligable. But `--release` will produce a ~1/3 smaller binary. There is also `--debug`, which will include symbols necessary for debugging and getting the C++ function symbols working correctly in the browser during step through debugging. It works better than expected, but don't expect to have gdb or msvc debugger level of debugging experience.
+There are three compile settings available to the user. The default is `--quick`. Aggressive optimizations are done with `--release` which will optimize for size, although the speed difference between `--release` and `--quick` seems negligible. But `--release` will produce a ~1/3 smaller binary. There is also `--debug`, which will include symbols necessary for debugging and getting the C++ function symbols working correctly in the browser during step-through debugging. In my personal tests it works better than expected, but don't expect to have gdb or msvc debugger level of the debugging experience.
 
-We use `ccache` to cache object files. This seems actually help a lot and is better than platformio's method of tracking what needs to be rebuilt. This works as a two tier cache system. What Platformio misses will be covered by ccache's more advanced file changing system.
+We use `ccache` to cache object files. This seems actually help a lot and is better than Platformio's method of tracking what needs to be rebuilt. This works as a two-tier cache system. What Platformio misses will be covered by ccache's more advanced file changing system.
 
-The compilation to wasm will happen under a lock. Removing this lock requires removing the platformio toolchain as the compiler backend which enforces it's own internal lock preventing parallel use.
+The compilation to wasm will happen under a lock. Removing this lock requires removing the Platformio toolchain as the compiler backend which enforces its own internal lock preventing parallel use.
 
 ## Sketch Cache
 
-Sketchs are aggressively finger-printed and stored in a cache. White space, comments, and other superficial data will be stripped out during pre-processing and minimization for fingerprinting. This source file decimation is only used for finger
-printing while the actual source files are sent to compiler to preserve line numbers and file names.
+Sketches are aggressively fingerprinted and stored in a cache. White space, comments, and other superficial data will be stripped out during pre-processing and minimization for fingerprinting. This source file decimation is only used for finger
+printing while the actual source files are sent to the compiler to preserve line numbers and file names.
 
-This pre-processing done is done via gcc and special regex's and will happen without a lock. This will allow you to have extremely quick recompiles for whitespace and changes in comments even if the compiler is executing under it's lock.
+This pre-processing done is done via gcc and special regex's and will happen without a lock. This will allow you to have extremely quick recompiles for whitespace and changes in comments.
 
 ## Local compiles
 
-If the web-compiler get's congested then it's recommend that you run the compiler locally. This requires docker and will be invoked whenever you pass in `--local`. This will first pull the most recent Docker image of the Fastled compiler, launching a webserver and then connecting to it with the client once it's been up.
+If the web compiler gets congested then it's recommended that you run the compiler locally. This requires docker and will be invoked whenever you pass in `--local`. This will first pull the most recent Docker image of the Fastled compiler, launch a webserver, and then connect to it with the client once it's been up.
 
 ## Auto updates
 
-In server mode the git repository will be cloned as a side repo and then periodically updated and rsync'd to the src directory. This allows a long running instance to stay updated.
+In server mode, the git repository will be cloned as a side repo and then periodically updated and rsync'd to the src directory. This allows a long-running instance to stay updated.
 
-## Compatibility with Arduino sketchs
+## Compatibility with Arduino sketches
 
-The compatibility is actually pretty good. Most simple sketchs should compile out of the box. Even some of the avr platform includes are stubbed out to make it work. The familiar `digitalWrite()`, `Serial.println()` and other common functions work. Although `digitalRead()` will always return 0 and `analogRead()` will return random numbers.
+The compatibility is pretty good. Most simple sketches should compile out of the box. Even some of the AVR platforms are stubbed out to make it work. For Arduino, the familiar `digitalWrite()`, `Serial.println()`, and other common functions work. Although `digitalRead()` will always return 0 and `analogRead()` will return random numbers.
 
 ### Faqs
 
@@ -245,22 +244,26 @@ Q: How often is the docker image updated?
 A: It's scheduled for rebuild once a day at 3am Pacific time, and also on every change to this repo.
 
 Q: How can I run my own cloud instance of the FastLED wasm compiler?
-A: Render.com (which fastled is hosted on) or DigialOcean can accept a github repo and auto-build the docker image.
+A: Render.com (which fastled is hosted on) or DigialOcean can accept a GitHub repo and auto-build the docker image.
 
 Q: Why does FastLED tend to become choppy when the browser is in the background?
 A: FastLED Wasm currently runs on the main thread and therefor Chrome will begin throttling the event loop when the browser is not in the foreground. The solution to this is to move FastLED to a web worker where it will get a background thread that Chrome / Firefox won't throttle.
 
 Q: Why does a long `delay()` cause the browser to freeze and become sluggish?
-A: `delay()` will block `loop()` which blocks the main thread of the browser. The solution is a webworker which will not affect main thread performance of the browser.
+A: `delay()` will block `loop()` which blocks the main thread of the browser. The solution is a webworker which will not affect the main thread performance of the browser.
 
 
 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` is  bundling. This can be tweeked by the wasm_compiler_settings.py file in the FastLED repo.
-
+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.1.45 - Aniother try for web publishing from github.
+  * 1.1.61 - Excluded non compiling examples from the Test object as part of the api - no sense in having them if they won't compile.
+  * 1.1.60 - Platform executables (macos-arm/macos-x86/windows/linux-x86) now auto building with each release. Add tests.
+  * 1.1.52 - Add linux-arm
+  * 1.1.49 - Try again.
+  * 1.1.46 - Add mac x86 exe
+  * 1.1.45 - Another try for web publishing from github.
   * 1.1.42 - Second test for web publishing from github.
   * 1.1.41 - Platform executable (through pyinstaller) now enabled.
   * 1.1.40 - Remove `sketch_directory` from Api object. This was only needed before we had a client/server architecture.

{fastled-1.1.45.dist-info → fastled-1.1.66.dist-info}/RECORD

@@ -1,6 +1,6 @@
-fastled/__init__.py,sha256=fXkCeFWmPemmBwo5jnTUMcxhRR1oEKEQayV8ZGG_lbY,3462
-fastled/app.py,sha256=3xg7oVD-UYnKPU8SAY-Cs5UnAYdwpdpuEFRR2N8P1Tg,1787
-fastled/cli.py,sha256=CNR_pQR0sNVPNuv8e_nmm-0PI8sU-eUBUgnWgWkzW9c,237
+fastled/__init__.py,sha256=aL5prnilcRw93zFftSaKU78gvhHbutdCTrMGp8w8kd4,3462
+fastled/app.py,sha256=AHLQczFKLV1ZyGCh45wTvJqQpQyJ_Ukh3MmG3Om4NHQ,1844
+fastled/cli.py,sha256=FjVr31ht0UPlAcmX-84NwfAGMQHTkrCe4o744jCAxiw,375
 fastled/client_server.py,sha256=MGE4rg40EA2ty6nKExVxkjUbPbif1Bbx0vDjwNcDOD8,12563
 fastled/compile_server.py,sha256=Z7rHFs3M6QPbSCsbgHAQDk6GTVAJMMPCXtD4Y0mu8RM,2659
 fastled/compile_server_impl.py,sha256=ClBLtFHB0ucaT8tAJfI6o3bJ-LRnXc4Pxy7bVKnFiww,8803
@@ -9,9 +9,9 @@ fastled/filewatcher.py,sha256=LwEQJkqADsArZyY499RLAer6JjJyDwaQBcAvT7xmp3c,6708
 fastled/keyboard.py,sha256=Zz_ggxOUTX2XQEy6K6kAoorVlUev4wEk9Awpvv9aStA,3241
 fastled/live_client.py,sha256=_KvqmyUyyGpoYET1Z9CdeUVoIbFjIUWwPcTp5XCQuxY,2075
 fastled/open_browser.py,sha256=vzMBcpDNY0f-Bx9KmEILKDANZ6gvsywCVwn1FRhPXh4,1770
-fastled/parse_args.py,sha256=FKLucZPQoprln1U_L9ZhigLmoUwyGjN5U53LtIJ-rxQ,6141
+fastled/parse_args.py,sha256=zVDFudUO1pKYbC6G1h64O-riCqnNDQsJPTo4YyTIDUM,6238
 fastled/paths.py,sha256=VsPmgu0lNSCFOoEC0BsTYzDygXqy15AHUfN-tTuzDZA,99
-fastled/project_init.py,sha256=We-fVf4FqFcXhKUqjWnhV1HXmfXbo-1nCBMJ_TCip2U,2177
+fastled/project_init.py,sha256=FH8LtrFwBVijGOzM4UczIdEET7XhXDtf0LkPUMNBVCs,2367
 fastled/select_sketch_directory.py,sha256=TZdCjl1D7YMKjodMTvDRurPcpAmN3x0TcJxffER2NfM,1314
 fastled/settings.py,sha256=3eMKv0tLXgIQ0CFDboIp_l5_71rzIIyWg353YjnYJnc,323
 fastled/sketch.py,sha256=483TrrIdZJfo1MIu5FkD-V5OGmOfHmsZ2f6VvNsJBJM,3299
@@ -22,9 +22,9 @@ 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/test/examples.py,sha256=EDXb6KastKOOWzew99zrpmcNcXTcAtYi8eud6F1pnWA,980
-fastled-1.1.45.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.1.45.dist-info/METADATA,sha256=c0Dimqkl2MnOUXzuxgcdRyHglYZYNLiA6qBpZeB04OY,18461
-fastled-1.1.45.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-fastled-1.1.45.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.1.45.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
-fastled-1.1.45.dist-info/RECORD,,
+fastled-1.1.66.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.1.66.dist-info/METADATA,sha256=t0Ry3u8OPz5oQwttQxcX2jLGZsGV2R4BviIUeSl4izI,18480
+fastled-1.1.66.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+fastled-1.1.66.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.1.66.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
+fastled-1.1.66.dist-info/RECORD,,