{"id":13730572,"url":"https://github.com/kunitoki/popsicle","last_synced_at":"2025-04-06T03:06:13.025Z","repository":{"id":40575324,"uuid":"272198594","full_name":"kunitoki/popsicle","owner":"kunitoki","description":"Popsicle aims to bridge the JUCE c++ framework to python.","archived":false,"fork":false,"pushed_at":"2024-07-15T10:29:24.000Z","size":13932,"stargazers_count":182,"open_issues_count":4,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-30T02:06:07.795Z","etag":null,"topics":["bindings","framework","juce","python","rapid-development"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/popsicle","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kunitoki.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"kunitoki","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-06-14T12:33:40.000Z","updated_at":"2025-03-22T08:37:35.000Z","dependencies_parsed_at":"2024-01-06T13:08:47.254Z","dependency_job_id":"619bfad4-f394-427d-9858-9da6b9304d3b","html_url":"https://github.com/kunitoki/popsicle","commit_stats":{"total_commits":80,"total_committers":2,"mean_commits":40.0,"dds":"0.012499999999999956","last_synced_commit":"eaa150b8e08e05e8d22c92c59edeacba35c54cdb"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunitoki%2Fpopsicle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunitoki%2Fpopsicle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunitoki%2Fpopsicle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunitoki%2Fpopsicle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kunitoki","download_url":"https://codeload.github.com/kunitoki/popsicle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247427005,"owners_count":20937200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bindings","framework","juce","python","rapid-development"],"created_at":"2024-08-03T02:01:16.714Z","updated_at":"2025-04-06T03:06:13.003Z","avatar_url":"https://github.com/kunitoki.png","language":"C++","readme":".. image:: popsicle.jpg\n    :alt: Popsicle: Python integration for JUCE with pybind11.\n    :target: https://github.com/kunitoki/popsicle\n\n\n===================================================\nPopsicle: Python integration for JUCE with pybind11\n===================================================\n\n|linux_builds| |macos_builds| |windows_builds| |pypi_version| |pypi_downloads|\n\n|coveralls| |pypi_status| |pypi_license| |commercial_license|\n\n\n--------\nOverview\n--------\n\nPopsicle is a groundbreaking project designed to extend the accessibility of `JUCE \u003chttps://juce.com/\u003e`_ by seamlessly integrating it with Python. Leveraging the power of `pybind11 \u003chttps://pybind11.readthedocs.io/en/stable/\u003e`_, Popsicle offers a Pythonic interface to the JUCE framework. This integration allows developers to utilize JUCE in a manner similar to using Qt with PySide, offering a simplified yet robust approach.\n\nPopsicle serves multiple purposes, each contributing to its significance in the development landscape.\n\n\n--------\nFeatures\n--------\n\n- **Effortless JUCE App Prototyping**: Effortlessly prototype JUCE apps. Popsicle streamlines the development process, allowing developers to focus on creativity by eliminating the need for intricate build configurations and setups.\n\n- **Python Scripting Integration**: Seamlessly integrate Python scripting by embedding Popsicle into existing JUCE applications as a dedicated module. Extend and enhance your JUCE projects with the flexibility and ease of Python within the familiar JUCE framework.\n\n- **Unit Testing Made Easy**: Ensure the robustness and reliability of JUCE classes with Popsicle's built-in unit testing support. Leverage Python's testing infrastructure for a seamless testing process.\n\n- **Cross-Platform Compatibility**: Enjoy cross-platform compatibility with Popsicle. Work consistently across Windows, macOS, and Linux environments for a unified development experience.\n\nPopsicle stands as a humble yet powerful solution, aimed at enriching the development experience with JUCE by simplifying, extending, and enhancing its integration with Python.\n\n\n-------------\nExample Usage\n-------------\n\nA single 80 lines script is better than thousand of words:\n\n.. code-block:: python\n\n  import popsicle as juce\n\n\n  class MainContentComponent(juce.Component, juce.Timer):\n      def __init__(self):\n          juce.Component.__init__(self)\n          juce.Timer.__init__(self)\n\n          self.setSize(600, 400)\n          self.startTimerHz(60)\n\n      def __del__(self):\n          self.stopTimer()\n\n      def paint(self, g):\n          g.fillAll(juce.Colours.black)\n\n          random = juce.Random.getSystemRandom()\n          rect = juce.Rectangle[int](0, 0, 20, 20)\n\n          for _ in range(100):\n              g.setColour(juce.Colour.fromRGBA(\n                  random.nextInt(256),\n                  random.nextInt(256),\n                  random.nextInt(256),\n                  255))\n\n              rect.setCentre(random.nextInt(self.getWidth()), random.nextInt(self.getHeight()))\n              g.drawRect(rect, 1)\n\n      def timerCallback(self):\n          if self.isVisible():\n              self.repaint()\n\n\n  class MainWindow(juce.DocumentWindow):\n      component = None\n\n      def __init__(self):\n          super().__init__(\n              juce.JUCEApplication.getInstance().getApplicationName(),\n              juce.Desktop.getInstance().getDefaultLookAndFeel()\n                  .findColour(juce.ResizableWindow.backgroundColourId),\n              juce.DocumentWindow.allButtons,\n              True)\n\n          self.component = MainContentComponent()\n\n          self.setResizable(True, True)\n          self.setContentNonOwned(self.component, True)\n          self.centreWithSize(800, 600)\n          self.setVisible(True)\n\n      def __del__(self):\n          if self.component:\n              del self.component\n\n      def closeButtonPressed(self):\n          juce.JUCEApplication.getInstance().systemRequestedQuit()\n\n\n  class Application(juce.JUCEApplication):\n      window = None\n\n      def getApplicationName(self):\n          return \"JUCE-o-matic\"\n\n      def getApplicationVersion(self):\n          return \"1.0\"\n\n      def initialise(self, commandLine):\n          self.window = MainWindow()\n\n      def shutdown(self):\n          if self.window:\n              del self.window\n\n\n  if __name__ == \"__main__\":\n      juce.START_JUCE_APPLICATION(Application)\n\nAs easy as that ! You will find more example on JUCE usage in the *examples* folder.\n\n.. image:: images/juce_o_matic.png\n    :target: examples/juce_o_matic.py\n\n\n-------------------\nSupported Platforms\n-------------------\n\n.. list-table:: List of popsicle supported platforms\n   :widths: 40 10 10 10 20\n   :header-rows: 1\n\n   * - Platform\n     - Python 3.10\n     - Python 3.11\n     - Python 3.12\n     - Notes\n   * - macOS-universal2\n     - ✅\n     - ✅\n     - ✅\n     -\n   * - win_amd64\n     - ✅\n     - ✅\n     - ✅\n     -\n   * - win_arm64\n     - ✅\n     - ✅\n     - ✅\n     -\n   * - manylinux_2014-x86_64\n     - ✅\n     - ✅\n     - ✅\n     -\n   * - manylinux_2014-aarch64\n     - ⚠️\n     - ⚠️\n     - ⚠️\n     - Built but not tested exhaustively\n\n-----------------\nSupported Modules\n-----------------\n\n.. list-table:: List of popsicle supported JUCE modules\n   :widths: 40 8 12 40\n   :header-rows: 1\n\n   * - Module\n     - Supported\n     - Test Coverage\n     - Notes\n   * - juce_analytics\n     - ⛔️\n     - N/A\n     - Not Planned\n   * - juce_audio_basics\n     - ✅\n     - 0.87%\n     - In Progress\n   * - juce_audio_devices\n     - ✅\n     - 0.0%\n     - In Progress\n   * - juce_audio_formats\n     - ✅\n     - 0.0%\n     - In Progress\n   * - juce_audio_plugin_client\n     - ⛔️\n     - N/A\n     - Not planned\n   * - juce_audio_processors\n     - ✅\n     - 0.0%\n     - In Progress\n   * - juce_audio_utils\n     - ✅\n     - 0.0%\n     - In Progress\n   * - juce_box2d\n     - ⛔️\n     - N/A\n     - Planned\n   * - juce_core\n     - ✅\n     - 47.7%\n     - Ready\n   * - juce_cryptography\n     - ⛔️\n     - N/A\n     - Planned\n   * - juce_data_structures\n     - ✅\n     - 55.61%\n     - Ready\n   * - juce_dsp\n     - ⛔️\n     - N/A\n     - Planned\n   * - juce_events\n     - ✅\n     - 49.68%\n     - Ready\n   * - juce_graphics\n     - ✅\n     - 15.76%\n     - In Progress\n   * - juce_gui_basics\n     - ✅\n     - 9.77%\n     - In Progress, Basic Components Available\n   * - juce_gui_extra\n     - ✅\n     - 0.57%\n     - In Progress\n   * - juce_midi_ci\n     - ⛔️\n     - N/A\n     - Not Planned\n   * - juce_opengl\n     - ⛔️\n     - N/A\n     - Planned\n   * - juce_osc\n     - ⛔️\n     - N/A\n     - Not Planned\n   * - juce_product_unlocking\n     - ⛔️\n     - N/A\n     - Not Planned\n   * - juce_video\n     - ⛔️\n     - N/A\n     - Not planned\n\n\n--------------------\nExample Applications\n--------------------\n\nSome images of JUCE tutorials and other small apps ported to *popsicle*.\n\n- Hot Reloading (`hotreload_main.py \u003cexamples/hotreload_main.py\u003e`_ and `hotreload_component.py \u003cexamples/hotreload_component.py\u003e`_)\n\n   .. image:: images/hot_reloading_video.png\n       :target: https://www.youtube.com/watch?v=nZUL_1Tnyy8\n\n- Animated Component (https://docs.juce.com/master/tutorial_animation.html)\n\n   .. image:: images/animated_component.png\n       :target: examples/animated_component.py\n\n- Advanced GUI layout techniques (https://docs.juce.com/master/tutorial_rectangle_advanced.html)\n\n   .. image:: images/layout_rectangles.png\n       :target: examples/layout_rectangles.py\n\n- Responsive GUI layouts using FlexBox and Grid (https://docs.juce.com/master/tutorial_flex_box_grid.html)\n\n   .. image:: images/layout_flexgrid.png\n       :target: examples/layout_flexgrid.py\n\n- Table listbox (https://docs.juce.com/master/tutorial_table_list_box.html)\n\n   .. image:: images/table_list_box.png\n       :target: examples/table_list_box.py\n\n- Slider values example (https://docs.juce.com/master/tutorial_slider_values.html)\n\n   .. image:: images/slider_values.png\n       :target: examples/slider_values.py\n\n- Audio Player (https://docs.juce.com/master/tutorial_playing_sound_files.html)\n\n   .. image:: images/audio_player.png\n       :target: examples/audio_player.py\n\n- Audio Player with waveform (https://docs.juce.com/master/tutorial_audio_thumbnail.html)\n\n   .. image:: images/audio_player_waveform.png\n       :target: examples/audio_player_waveform.py\n\n- OpenCV Integration\n\n   .. image:: images/opencv_integration.png\n       :target: examples/opencv_integration.py\n\n- Matplotlib Integration\n\n   .. image:: images/matplotlib_integration.png\n       :target: examples/matplotlib_integration.py\n\n- Emojis Components (`emojis_component.py \u003cexamples/emojis_component.py\u003e`_ and `emojis_font_component.py \u003cexamples/emojis_font_component.py\u003e`_)\n\n   .. image:: images/emojis_component.png\n       :target: examples/emojis_font_component.py\n\n- Wgpu Triangle Rendering Embedded Component\n\n   .. image:: images/wgpu_triangle.png\n       :target: examples/webgpu/\n\n- Pygfx PBR Renderer Integration (`pbr2_embed.py \u003cexamples/webgpu/pbr2_embed.py\u003e`_)\n\n   .. image:: images/pygfx_3d_video.png\n       :target: https://www.youtube.com/watch?v=8aV-wZtRkIg\n\n\n-------------\nCode Coverage\n-------------\n\n|coveralls|\n\n**The current code coverage of the project refers to the combined JUCE + popsicle**\n\nPopsicle places a strong emphasis on comprehensive code coverage to ensure the reliability and quality of the project. Our code coverage encompasses thorough testing of the JUCE framework, providing developers with confidence in the stability and performance of their applications.\n\nTo explore detailed information about the testing, refer to the `tests directory \u003ctests/\u003e`_ in our GitHub repository. This resource offers insights into the specific areas of the JUCE framework that have been rigorously tested, empowering developers to make informed decisions about the robustness of their implementations.\n\nAt Popsicle, we believe that extensive code coverage is essential for delivering software solutions that meet the highest standards of excellence. Feel free to delve into our testing documentation to gain a deeper understanding of the meticulous approach we take towards ensuring code quality and reliability.\n\n\n---------\nLicensing\n---------\n\nPopsicle is offered in two distinct licensed flavors to cater to diverse usage scenarios:\n\n- **GPLv3 License**: This license is applicable when utilizing Popsicle from Python through the PyPi-provided wheels or embedding it in an open-source (OSS) application. Embracing the principles of open-source development, the GPLv3 license ensures that Popsicle remains freely accessible and modifiable within the open-source community.\n\n- **Commercial License**: Tailored for scenarios where Popsicle is integrated into a closed-source application, the commercial license provides a flexible solution for proprietary software development. This option offers a streamlined approach for utilizing Popsicle within closed environments, with further details to be announced.\n\nPopsicle's dual licensing approach ensures compatibility with a wide range of projects, whether they align with open-source principles or require the flexibility of a commercial license for closed-source applications.\n\n**It's important to note that when Popsicle is employed in a closed-source application, a corresponding JUCE license is also required to ensure proper adherence to licensing requirements.**\n\n\n------------\nInstallation\n------------\n\nGetting started with Popsicle is a straightforward process, requiring just a few simple steps. Follow the instructions below to install Popsicle effortlessly:\n\n.. code-block:: bash\n\n  pip3 install popsicle\n\nEnsure that you have an up-to-date version of **pip** to ensure a smooth installation process.\n\nBe sure you follow the `quick start guide \u003cdocs/QuickStartGuide.rst\u003e`_ to know more abut how to use **popsicle**.\n\n\n-----------------\nBuild From Source\n-----------------\n\nClone the repository recursively as JUCE is a submodule.\n\n.. code-block:: bash\n\n  git clone --recursive git@github.com:kunitoki/popsicle.git\n\nInstall python dependencies.\n\n.. code-block:: bash\n\n  # Build the binary distribution\n  python3 -m build --wheel\n\n  # Install the local wheel\n  pip3 install dist/popsicle-*.whl\n\n\n.. |linux_builds| image:: https://github.com/kunitoki/popsicle/actions/workflows/build_linux.yml/badge.svg?branch=master\n    :alt: Linux Builds Status\n    :target: https://github.com/kunitoki/popsicle/actions/workflows/build_linux.yml\n\n.. |macos_builds| image:: https://github.com/kunitoki/popsicle/actions/workflows/build_macos.yml/badge.svg?branch=master\n    :alt: macOS Builds Status\n    :target: https://github.com/kunitoki/popsicle/actions/workflows/build_macos.yml\n\n.. |windows_builds| image:: https://github.com/kunitoki/popsicle/actions/workflows/build_windows.yml/badge.svg?branch=master\n    :alt: Windows Builds Status\n    :target: https://github.com/kunitoki/popsicle/actions/workflows/build_windows.yml\n\n.. |coveralls| image:: https://coveralls.io/repos/github/kunitoki/popsicle/badge.svg\n    :alt: Coveralls - Code Coverage\n    :target: https://coveralls.io/github/kunitoki/popsicle\n\n.. |commercial_license| image:: https://img.shields.io/badge/license-Commercial-blue\n    :alt: Commercial License\n    :target: LICENSE.COMMERCIAL\n\n.. |pypi_license| image:: https://img.shields.io/pypi/l/popsicle\n    :alt: Open Source License\n    :target: LICENSE.GPLv3\n\n.. |pypi_status| image:: https://img.shields.io/pypi/status/popsicle\n    :alt: PyPI - Status\n    :target: https://pypi.org/project/popsicle/\n\n.. |pypi_version| image:: https://img.shields.io/pypi/pyversions/popsicle\n    :alt: PyPI - Python Version\n    :target: https://pypi.org/project/popsicle/\n\n.. |pypi_downloads| image:: https://img.shields.io/pypi/dm/popsicle\n    :alt: PyPI - Downloads\n    :target: https://pypi.org/project/popsicle/\n","funding_links":["https://github.com/sponsors/kunitoki"],"categories":["Integrations"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunitoki%2Fpopsicle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkunitoki%2Fpopsicle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunitoki%2Fpopsicle/lists"}