h2o-wave 0.26.3__py3-none-any.whl → 1.0.1__py3-none-any.whl

h2o_wave/ui.py

@@ -58,7 +58,6 @@ def command(
         icon: Optional[str] = None,
         items: Optional[List[Command]] = None,
         value: Optional[str] = None,
-        data: Optional[str] = None,
 ) -> Command:
     """Create a command.
 
@@ -71,12 +70,9 @@ def command(
         icon: The icon to be displayed for this command.
         items: Sub-commands, if any
         value: Data associated with this command, if any.
-        data: DEPRECATED. Use `value` instead. Data associated with this command, if any.
     Returns:
         A `h2o_wave.types.Command` instance.
     """
-    if data is not None:
-        warnings.warn('The data argument is deprecated.')
     return Command(
         name,
         label,
@@ -84,7 +80,6 @@ def command(
         icon,
         items,
         value,
-        data,
     )
 
 
@@ -1280,7 +1275,7 @@ def markdown_table_cell_type(
 
     Args:
         name: An identifying name for this component.
-        target: Where to display the link. Setting this to '_blank'` opens the link in a new tab or window.
+        target: Where to display the link. An empty string or `'_blank'` opens the link in a new tab. `_self` opens in the current tab.
     Returns:
         A `h2o_wave.types.MarkdownTableCellType` instance.
     """
@@ -1510,7 +1505,7 @@ def link(
         button: True if the link should be rendered as a button.
         width: The width of the link, e.g. '100px'.
         visible: True if the component should be visible. Defaults to True.
-        target: Where to display the link. Setting this to an empty string or `'_blank'` opens the link in a new tab or window.
+        target: Where to display the link. An empty string or `'_blank'` opens the link in a new tab. `_self` opens in the current tab.
         tooltip: An optional tooltip message displayed when a user clicks the help icon to the right of the component.
         name: An identifying name for this component.
     Returns:
@@ -2092,6 +2087,7 @@ def visualization(
         visible: Optional[bool] = None,
         events: Optional[List[str]] = None,
         interactions: Optional[List[str]] = None,
+        animate: Optional[bool] = None,
 ) -> Component:
     """Create a visualization for display inside a form.
 
@@ -2104,6 +2100,7 @@ def visualization(
         visible: True if the component should be visible. Defaults to True.
         events: The events to capture on this visualization. One of 'select_marks'.
         interactions: The interactions to be allowed for this plot. One of 'drag_move' | 'scale_zoom' | 'brush'. Note: `brush` does not raise `select_marks` event.
+        animate: EXPERIMENTAL: True to turn on the chart animations. Defaults to False.
     Returns:
         A `h2o_wave.types.Visualization` instance.
     """
@@ -2116,6 +2113,7 @@ def visualization(
         visible,
         events,
         interactions,
+        animate,
     ))
 
 
@@ -2497,7 +2495,7 @@ def image_annotator(
         trigger: True if the form should be submitted as soon as an annotation is drawn.
         image_height: The card’s image height. The actual image size is used by default.
         allowed_shapes: List of allowed shapes. Available values are 'rect' and 'polygon'. If not set, all shapes are available by default.
-        events: The events to capture on this image annotator. One of `click` or `tool_change`.
+        events: The events to capture on this image annotator. One of `click` | `tool_change`.
     Returns:
         A `h2o_wave.types.ImageAnnotator` instance.
     """
@@ -2514,6 +2512,80 @@ def image_annotator(
     ))
 
 
+def audio_annotator_tag(
+        name: str,
+        label: str,
+        color: str,
+) -> AudioAnnotatorTag:
+    """Create a unique tag type for use in an audio annotator.
+
+    Args:
+        name: An identifying name for this tag.
+        label: Text to be displayed for the annotation.
+        color: Hex or RGB color string to be used as the background color.
+    Returns:
+        A `h2o_wave.types.AudioAnnotatorTag` instance.
+    """
+    return AudioAnnotatorTag(
+        name,
+        label,
+        color,
+    )
+
+
+def audio_annotator_item(
+        start: float,
+        end: float,
+        tag: str,
+) -> AudioAnnotatorItem:
+    """Create an annotator item with initial selected tags or no tags.
+
+    Args:
+        start: The start of the audio annotation in seconds.
+        end: The end of the audio annotation in seconds.
+        tag: The `name` of the audio annotator tag to refer to for the `label` and `color` of this item.
+    Returns:
+        A `h2o_wave.types.AudioAnnotatorItem` instance.
+    """
+    return AudioAnnotatorItem(
+        start,
+        end,
+        tag,
+    )
+
+
+def audio_annotator(
+        name: str,
+        title: str,
+        path: str,
+        tags: List[AudioAnnotatorTag],
+        items: Optional[List[AudioAnnotatorItem]] = None,
+        trigger: Optional[bool] = None,
+) -> Component:
+    """Create an audio annotator component.
+
+    This component allows annotating and labeling parts of audio file.
+
+    Args:
+        name: An identifying name for this component.
+        title: The audio annotator's title.
+        path: The path to the audio file. Use mp3 or wav formats to achieve the best cross-browser support. See https://caniuse.com/?search=audio%20format for other formats.
+        tags: The master list of tags that can be used for annotations.
+        items: Annotations to display on the image, if any.
+        trigger: True if the form should be submitted as soon as an annotation is made.
+    Returns:
+        A `h2o_wave.types.AudioAnnotator` instance.
+    """
+    return Component(audio_annotator=AudioAnnotator(
+        name,
+        title,
+        path,
+        tags,
+        items,
+        trigger,
+    ))
+
+
 def facepile(
         items: List[Component],
         name: Optional[str] = None,
@@ -3701,6 +3773,7 @@ def meta_card(
         script: Optional[InlineScript] = None,
         stylesheet: Optional[InlineStylesheet] = None,
         stylesheets: Optional[List[Stylesheet]] = None,
+        animate: Optional[bool] = None,
         commands: Optional[List[Command]] = None,
 ) -> MetaCard:
     """Represents page-global state.
@@ -3726,6 +3799,7 @@ def meta_card(
         script: Javascript code to execute on this page.
         stylesheet: CSS stylesheet to be applied to this page.
         stylesheets: External CSS files to load into the page.
+        animate: EXPERIMENTAL: True to turn on the card animations. Defaults to False.
         commands: Contextual menu commands for this component.
     Returns:
         A `h2o_wave.types.MetaCard` instance.
@@ -3748,6 +3822,7 @@ def meta_card(
         script,
         stylesheet,
         stylesheets,
+        animate,
         commands,
     )
 
@@ -3834,6 +3909,7 @@ def plot_card(
         plot: Plot,
         events: Optional[List[str]] = None,
         interactions: Optional[List[str]] = None,
+        animate: Optional[bool] = None,
         commands: Optional[List[Command]] = None,
 ) -> PlotCard:
     """Create a card displaying a plot.
@@ -3845,6 +3921,7 @@ def plot_card(
         plot: The plot to be displayed in this card.
         events: The events to capture on this card. One of 'select_marks'.
         interactions: The interactions to be allowed for this card. One of 'drag_move' | 'scale_zoom' | 'brush'. Note: `brush` does not raise `select_marks` event.
+        animate: EXPERIMENTAL: True to turn on the chart animations. Defaults to False.
         commands: Contextual menu commands for this component.
     Returns:
         A `h2o_wave.types.PlotCard` instance.
@@ -3856,6 +3933,7 @@ def plot_card(
         plot,
         events,
         interactions,
+        animate,
         commands,
     )
 
@@ -4532,7 +4610,6 @@ def wide_article_preview_card(
         title: str,
         name: Optional[str] = None,
         aux_value: Optional[str] = None,
-        caption: Optional[str] = None,
         items: Optional[List[Component]] = None,
         content: Optional[str] = None,
         commands: Optional[List[Command]] = None,
@@ -4546,15 +4623,12 @@ def wide_article_preview_card(
         title: The card's title on the right-hand side
         name: An identifying name for this card. Makes the card clickable, similar to a button.
         aux_value: The card's auxiliary text, displayed on the right-hand side of the header.
-        caption: DEPRECATED. Use `content` instead. The card's caption, displayed below the title on the right-hand side.
         items: The card's buttons, displayed under the caption.
         content: The card's markdown content, displayed below the title on the right-hand side.
         commands: Contextual menu commands for this component.
     Returns:
         A `h2o_wave.types.WideArticlePreviewCard` instance.
     """
-    if caption is not None:
-        warnings.warn('The caption argument is deprecated.')
     return WideArticlePreviewCard(
         box,
         persona,
@@ -4562,7 +4636,6 @@ def wide_article_preview_card(
         title,
         name,
         aux_value,
-        caption,
         items,
         content,
         commands,

h2o_wave/version.py

@@ -1 +1 @@
-__version__ = '0.26.2'
+__version__ = '1.0.1'

{h2o_wave-0.26.3.dist-info → h2o_wave-1.0.1.dist-info}/METADATA

@@ -1,33 +1,38 @@
 Metadata-Version: 2.1
 Name: h2o-wave
-Version: 0.26.3
+Version: 1.0.1
 Summary: Python driver for H2O Wave Realtime Apps
-Home-page: https://h2o.ai/products/h2o-wave
-Author: Prithvi Prabhu
-Author-email: prithvi@h2o.ai
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Operating System :: OS Independent
+Project-URL: Homepage, https://wave.h2o.ai/
+Project-URL: Documentation, https://wave.h2o.ai/
+Project-URL: Repository, https://github.com/h2oai/wave
+Project-URL: Changelog, https://github.com/h2oai/wave/releases
+Author-email: Prithvi Prabhu <prithvi@h2o.ai>
+Maintainer-email: Martin Turoci <martin.turoci@h2o.ai>, Marek Mihok <marek.mihok@h2o.ai>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: Data Science,Low code,Machine Learning,Realtime,UI
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Topic :: Database
-Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Widget Sets
 Classifier: Topic :: System :: Distributed Computing
-Requires-Python: >=3.7.1
-Requires-Dist: Click
-Requires-Dist: httpx >=0.16.1
+Requires-Python: >=3.8
+Requires-Dist: click
+Requires-Dist: httpx>=0.16.1
 Requires-Dist: inquirer
-Requires-Dist: starlette >=0.13.8
-Requires-Dist: uvicorn >=0.17.6
-Provides-Extra: ml
-Requires-Dist: h2o-wave-ml ; extra == 'ml'
+Requires-Dist: starlette>=0.13.8
+Requires-Dist: uvicorn>=0.17.6
+Description-Content-Type: text/x-rst
 
 H2O Wave
 ========
@@ -61,26 +66,24 @@ Hello world
 
 .. code-block:: python
 
-    from h2o_wave import site, ui
+    from h2o_wave import main, app, Q, ui
 
-    # Access the web page at http://localhost:10101/demo
-    page = site['/demo']
 
-    # Add some content.
-    page['example'] = ui.markdown_card(
-      box='1 1 2 2',
-      title='Hello World!',
-      content='And now for something completely different.',
-    )
+    @app('/')
+    async def serve(q: Q):
+        q.page['hello'] = ui.markdown_card(
+            box='1 1 3 3',
+            title='Hello world!',
+            content='Welcome to Wave!'
+        )
+        await q.page.save()
 
-    # Save the page
-    page.save()
 
 Run ``hello.py``:
 
 .. code-block:: text
 
-    $ python hello.py
+    $ wave run hello.py
 
 
 Links
@@ -93,5 +96,3 @@ Links
 
 .. _pip: https://pip.pypa.io/en/stable/quickstart/
 
-
-

h2o_wave-1.0.1.dist-info/RECORD

@@ -0,0 +1,22 @@
+h2o_wave/__init__.py,sha256=XIclw-HLtXgr0wNf5eQpkh6ZiqD9QAoiS-vZhp3IR5k,1674
+h2o_wave/__main__.py,sha256=MoNOW43ppIqCdY3iq0n25Q3SKLyk8Igg5fD_sSROK4c,638
+h2o_wave/cli.py,sha256=KPcHXIYdxoc5DMIHsyVSNgC1I9JgqJRtkpO0vEGwv_8,13424
+h2o_wave/core.py,sha256=whFb-Z2wokNXe_39I8aL3i7JOx6eczRfWOkn5wb_YwM,39087
+h2o_wave/db.py,sha256=H3W_EyMfnwr4UjqPVoAsE19O2QzY1ptIYGMOqU0YUQo,7489
+h2o_wave/graphics.py,sha256=HLYrX-lwsMKbyLmy2ClG5L46DA2_hSCEPTsv0gPVoyg,25866
+h2o_wave/ide.py,sha256=wAJjfEI1ekQrL455FGRVeNi3KiH6ELgsG3qm31Q-kRs,6810
+h2o_wave/metadata.py,sha256=5UwOlmD6MsSqn0Px6RXzcKAfu4WRqOsS1M-OCf_gmkw,94
+h2o_wave/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+h2o_wave/routing.py,sha256=de8GVfUAb6bwFXtsWj6NXmjMVGELknlZb03F-R4ManY,10592
+h2o_wave/server.py,sha256=u80Jma83mMKqmTitVDFO703SrcC4Y29DQM2letSVNyA,17900
+h2o_wave/share.py,sha256=2zgywet8540O6xM-JD3po1glyP2PBJ3lIxaWBJbQvtQ,1164
+h2o_wave/test.py,sha256=hF_fS5e25bACnzENjpDrikv7nPOs0iENh4MuXX9BaVA,2738
+h2o_wave/types.py,sha256=PKvvwDeQj9dqRyIwUVRtQpmnPVF0TI3gkLn8M4i7Y4E,645052
+h2o_wave/ui.py,sha256=mJzYyqWsZ-_6dmwPdG8rdPRsIdtD3x_NS1jz1l1SJRg,168352
+h2o_wave/ui_ext.py,sha256=zx_2Ec2-p_ztm8brfVaVF0fTQWVDrb_YxcGfVb-wA10,2325
+h2o_wave/version.py,sha256=3KXfAcA5rzzQXMtfwpHphgbJNZdA0XWaW96kdWVSZJw,22
+h2o_wave-1.0.1.dist-info/METADATA,sha256=uCgdpPbIo045BeTkt9Q6wi4LQWaeRQdSvEEUC_cDGO4,2907
+h2o_wave-1.0.1.dist-info/WHEEL,sha256=TJPnKdtrSue7xZ_AVGkp9YXcvDrobsjBds1du3Nx6dc,87
+h2o_wave-1.0.1.dist-info/entry_points.txt,sha256=kFeXNqSZlW1_H7YcRdSOhz5V00F4vhDQ0NuDuvRwLGw,43
+h2o_wave-1.0.1.dist-info/licenses/LICENSE,sha256=hpuFayniDwysSKD0tHGELH2KJDVyhUrKS29torRIpqY,53
+h2o_wave-1.0.1.dist-info/RECORD,,

{h2o_wave-0.26.3.dist-info → h2o_wave-1.0.1.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.2)
+Generator: hatchling 1.21.1
 Root-Is-Purelib: true
 Tag: py3-none-any
-

{h2o_wave-0.26.3.dist-info → h2o_wave-1.0.1.dist-info}/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 wave = h2o_wave.cli:main
-

h2o_wave-0.26.3.data/data/project_templates/README.md

@@ -1,41 +0,0 @@
-# Getting Started with H2O Wave
-
-This project was bootstrapped with `wave init` command.
-
-## Running the app
-
-Make sure you have activated a Python virtual environment with `h2o-wave` installed.
-
-If you haven't created a python env yet, simply run the following command (assuming Python 3.7 is installed properly).
-
-For MacOS / Linux:
-
-```sh
-python3 -m venv venv
-source venv/bin/activate
-pip install h2o-wave
-```
-
-For Windows:
-
-```sh
-python3 -m venv venv
-venv\Scripts\activate
-pip install h2o-wave
-```
-
-Once the virtual environment is setup and active, run:
-
-```sh
-wave run app.py
-```
-
-Which will start a Wave app at <http://localhost:10101>.
-
-## Interactive examples
-
-If you prefer learning by doing, you can run `wave fetch` command that will download all the existing small Python examples that show Wave in action. The best part is that all these examples are interactive, meaning you can edit their code directly within the browser and observe the changes.
-
-## Learn More
-
-To learn more about H2O Wave, check out the [docs](https://wave.h2o.ai/).

h2o_wave-0.26.3.data/data/project_templates/header.py

@@ -1,85 +0,0 @@
-from h2o_wave import main, app, Q, ui, on, handle_on
-
-
-@app('/')
-async def serve(q: Q):
-    # First time a browser comes to the app
-    if not q.client.initialized:
-        await init(q)
-        q.client.initialized = True
-
-    # Other browser interactions
-    await handle_on(q)
-    await q.page.save()
-
-
-async def init(q: Q) -> None:
-    q.client.cards = set()
-    q.client.dark_mode = False
-
-    q.page['meta'] = ui.meta_card(
-        box='',
-        title='My Wave App',
-        theme='light',
-        layouts=[
-            ui.layout(
-                breakpoint='xs',
-                min_height='100vh',
-                max_width='1200px',
-                zones=[
-                    ui.zone('header'),
-                    ui.zone('content', size='1', zones=[
-                        ui.zone('horizontal', direction=ui.ZoneDirection.ROW),
-                        ui.zone('vertical', size='1', ),
-                        ui.zone('grid', direction=ui.ZoneDirection.ROW, wrap='stretch', justify='center')
-                    ]),
-                    ui.zone(name='footer'),
-                ]
-            )
-        ]
-    )
-    q.page['header'] = ui.header_card(
-        box='header',
-        title='My Wave App',
-        subtitle="Example to get us started",
-        image='https://wave.h2o.ai/img/h2o-logo.svg',
-        items=[ui.menu(icon='', items=[ui.command(name='change_theme', icon='ClearNight', label='Dark Mode')])]
-    )
-    q.page['footer'] = ui.footer_card(
-        box='footer',
-        caption='Made with 💛 using [H2O Wave](https://wave.h2o.ai).'
-    )
-
-    await home(q)
-
-
-@on()
-async def home(q: Q):
-    clear_cards(q)
-    add_card(q, 'form', ui.form_card(box='vertical', items=[ui.text('This is my app!')]))
-
-
-@on()
-async def change_theme(q: Q):
-    """Change the app from light to dark mode"""
-    if q.client.dark_mode:
-        q.page["header"].items = [ui.menu([ui.command(name='change_theme', icon='ClearNight', label='Dark mode')])]
-        q.page["meta"].theme = "light"
-        q.client.dark_mode = False
-    else:
-        q.page["header"].items = [ui.menu([ui.command(name='change_theme', icon='Sunny', label='Light mode')])]
-        q.page["meta"].theme = "h2o-dark"
-        q.client.dark_mode = True
-
-
-# Use for cards that should be deleted on calling `clear_cards`. Useful for routing and page updates.
-def add_card(q, name, card) -> None:
-    q.client.cards.add(name)
-    q.page[name] = card
-
-
-def clear_cards(q, ignore=[]) -> None:
-    for name in q.client.cards.copy():
-        if name not in ignore:
-            del q.page[name]
-            q.client.cards.remove(name)