gov-uk-dashboards 15.0.3__py3-none-any.whl → 15.2.0__py3-none-any.whl

gov_uk_dashboards/assets/dashboard.css

@@ -9343,4 +9343,8 @@ mark.expenditure {
   position: absolute;
   right: -5px;
   top: 2px;
+}
+
+.font-weight-normal-override {
+  font-weight: normal !important;
 }

gov_uk_dashboards/components/dash/home_page_link_button.py

@@ -0,0 +1,74 @@
+"""home_page_link_button"""
+from typing import Optional
+from dash import html
+
+
+def home_page_link_button(
+    title: str,
+    pathname_or_url_link: str,
+    pathname_rather_than_url: bool,
+    image_path: str,
+    info: Optional[str] = None,
+):
+    """Creates home page link card.
+
+    Args:
+        title (str): Button title.
+        pathname_or_url_link (str): The target link, either a pathname or full URL.
+        pathname_rather_than_url (bool): If True, `pathname_or_url_link` is treated as a pathname
+            (loading content in the same tab). If False, it is treated as a full URL
+            (opening in a new tab).
+        image_path (str): The path to an SVG image used as an icon for the button.
+        info (Optional[str], optional): Additional text for the button. Defaults to None.
+
+    Returns:
+        dash_html_components.A: A Dash HTML `A` element representing the link button.
+    """
+
+    link_attributes = {
+        "href": pathname_or_url_link,
+        "id": f"link-to-{title.replace(' ', '-')}",
+        "className": "govuk-body homepage-card-grid-item",
+    }
+
+    if pathname_rather_than_url is False:
+        link_attributes["target"] = "_blank"
+        link_attributes["rel"] = "noopener noreferrer"
+
+    return html.A(
+        [
+            html.Div(
+                [
+                    html.Div(
+                        [
+                            html.Div(
+                                [title],
+                                className="govuk-heading-l"
+                                if info is not None
+                                else None,
+                            ),
+                            (
+                                html.Div(
+                                    [info], className="font-weight-normal-override"
+                                )
+                                if info is not None
+                                else None
+                            ),
+                        ],
+                        style={
+                            "text-align": "left",
+                            "text-decoration": "none",
+                            "padding-left": "5%",
+                        },
+                    ),
+                    html.Img(src=image_path, style={"width": "100%"}),
+                ],
+                style={
+                    "display": "grid",
+                    "grid-template-columns": "5fr 1fr",
+                    "align-items": "center",
+                },
+            )
+        ],
+        **link_attributes,
+    )

gov_uk_dashboards/components/plotly/time_series_chart.py

@@ -69,6 +69,8 @@ class TimeSeriesChart:
         last_2_traces_filled=False,
         trace_names_to_prevent_hover_of_first_point_list=None,
         x_axis_column=DATE_VALID,
+        x_unified_hovermode: Optional[bool] = False,
+        x_hoverformat: Optional[str] = None,
         x_axis_title: Optional[str] = None,
         download_chart_button_id: Optional[str] = None,
         download_data_button_id: Optional[str] = None,
@@ -91,6 +93,8 @@ class TimeSeriesChart:
             trace_names_to_prevent_hover_of_first_point_list
         )
         self.x_axis_column = x_axis_column
+        self.x_unified_hovermode = x_unified_hovermode
+        self.x_hoverformat = x_hoverformat
         self.x_axis_title = x_axis_title
         self.download_chart_button_id = download_chart_button_id
         self.download_data_button_id = download_data_button_id
@@ -125,6 +129,12 @@ class TimeSeriesChart:
         """generates a time series chart"""
         # pylint: disable=too-many-locals
         # pylint: disable=duplicate-code
+
+        if not self.x_unified_hovermode and self.x_hoverformat is not None:
+            raise ValueError(
+                "x_hoverformat can only be specified if x_unified_hovermode is True"
+            )
+
         fig = go.Figure()
         for i, (df, trace_name, colour, marker) in enumerate(
             zip(
@@ -232,6 +242,8 @@ class TimeSeriesChart:
             legend=get_legend_configuration(),
             font={"size": CHART_LABEL_FONT_SIZE},
             yaxis_tickformat=",",
+            hovermode="x unified" if self.x_unified_hovermode is True else "closest",
+            hoverdistance=1000,  # Increase distance to simulate hover 'always on'
         )
         return fig
 
@@ -244,6 +256,7 @@ class TimeSeriesChart:
             ticktext=tick_text,
             tickmode="array",
             range=range_x,
+            hoverformat=self.x_hoverformat,
         )
 
     def create_time_series_trace(
@@ -301,6 +314,8 @@ class TimeSeriesChart:
         ]
 
     def _get_custom_hover_template(self, i, df, trace_name):
+        if self.x_unified_hovermode is True:
+            return "%{customdata[0]}"
         hover_text_headers = self.hover_data[trace_name][HOVER_TEXT_HEADERS]
         if (
             self.hover_data_for_traces_with_different_hover_for_last_point is not None

{gov_uk_dashboards-15.0.3.dist-info → gov_uk_dashboards-15.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gov_uk_dashboards
-Version: 15.0.3
+Version: 15.2.0
 Summary: Provides access to functionality common to creating a data dashboard.
 Author: Department for Levelling Up, Housing and Communities
 Description-Content-Type: text/markdown

{gov_uk_dashboards-15.0.3.dist-info → gov_uk_dashboards-15.2.0.dist-info}/RECORD

@@ -7,7 +7,7 @@ gov_uk_dashboards/template.html,sha256=uFAki9bEpcei5dP_NZYP8dsxpxXpNIDQPn7ezsE7V
 gov_uk_dashboards/template.py,sha256=WNVkAW3LCNoUHcxQ1kiUPkGCKIan5DgZQaAA_ZbE5WA,534
 gov_uk_dashboards/assets/__init__.py,sha256=SwV4sjjMQmuZXloVcvf2H86XFiAd8xhPLJvaSMC2MQE,101
 gov_uk_dashboards/assets/attach-event-to-dash.js,sha256=mbea5TaxEnjMN-MebR3J0hVjOb1B27-zXwWw9ZYqBBw,562
-gov_uk_dashboards/assets/dashboard.css,sha256=dK50L3FmOu1QGS3a1ShdwVSzkwJVyfJfwG9EuCrObVk,202066
+gov_uk_dashboards/assets/dashboard.css,sha256=exnujRlse2xHOeuE_TAs84gITv5YMRzKJKEeSjoXO6U,202134
 gov_uk_dashboards/assets/get_assets_folder.py,sha256=ozYOmuO2r36vaTdWMU5cBuskl47RHBp8z9KIO06BXBM,171
 gov_uk_dashboards/assets/govuk-frontend-3.14.0.min.js,sha256=kKi_r2hAqumi2pKM43W8NKpR2UtksUww9lSQOjkOmMI,34806
 gov_uk_dashboards/assets/mobile-nav.js,sha256=wsmOQtunN6HiA4EimNWPsr-qXomp9UruS2zr09Tsbeg,1772
@@ -52,6 +52,7 @@ gov_uk_dashboards/components/dash/footer.py,sha256=RnJKN1YTP88GuJ4e7ci2T-jDqIe0-
 gov_uk_dashboards/components/dash/graph.py,sha256=bd49W5sVyhtWd4lNBfQST1RyLNlTLA0KRxS7jTgVMwE,886
 gov_uk_dashboards/components/dash/header.py,sha256=ncwPcrGLLSpEL2E1NzSh6qtVW92B5JgAmA-qcTnNBhE,2886
 gov_uk_dashboards/components/dash/heading.py,sha256=VjyBng591B_366vnan96PukpCDBTTj-2iJWuq0s0CLw,766
+gov_uk_dashboards/components/dash/home_page_link_button.py,sha256=kmdNNMM7QaxPizUbwLR7XIDgCTZ3u-pVhb3DrpmPuHs,2536
 gov_uk_dashboards/components/dash/html_list.py,sha256=P3xkxxDp8oT81SSbK594IyX8l2PClufUG3cUTtlARrI,674
 gov_uk_dashboards/components/dash/key_value_pair.py,sha256=L8mjdCfqpBxOdbcEqZWDC36ou4xISNQSTsmXIWteUxI,690
 gov_uk_dashboards/components/dash/main_content.py,sha256=GBqVlNx_ambSiW1lsKpwB6-mFVZAvcTZq5oBYzHRza0,545
@@ -78,7 +79,7 @@ gov_uk_dashboards/components/plotly/captioned_figure.py,sha256=T0sbtGTiJ79FXxVdP
 gov_uk_dashboards/components/plotly/choropleth_map.py,sha256=U9RmS3MZGloQAt9HoSYh3Xad205DDfZOjz91ZD_ydbI,9849
 gov_uk_dashboards/components/plotly/enums.py,sha256=ebHiFQljA7O4HJxKoslqlNXcAjUZi1askpTSwxKEcYQ,850
 gov_uk_dashboards/components/plotly/stacked_barchart.py,sha256=y2XOf96tMfy5ythPb5RzqW5qGc2sKU3W508UbWO2iC0,12175
-gov_uk_dashboards/components/plotly/time_series_chart.py,sha256=whdOe4xPfpmWazPrOZDF38dfkhGWpZ7dqO3RQPIun3o,19228
+gov_uk_dashboards/components/plotly/time_series_chart.py,sha256=-hO_yz6CmwylLS8x0qW_Me6PgAUu5Kyl0PQ_UO_zaM8,19927
 gov_uk_dashboards/figures/__init__.py,sha256=_snQeNlM81nNKERl4gg9ScH2HYbtwaBjl8yQonccx34,712
 gov_uk_dashboards/figures/chart_data.py,sha256=fEsNkQFzXKIQ0h7aLBWq3J1qAxHbxvJeKU23JrVodVc,757
 gov_uk_dashboards/figures/line_chart.py,sha256=rEB51_z9cPl7BcT94iA6ZsZXzecnVCnGpQWW_9SNGUY,2813
@@ -99,8 +100,8 @@ gov_uk_dashboards/lib/dap/dap_deployment.py,sha256=ZXixeOAtRNjMsPdGKLwwLNamlo0mi
 gov_uk_dashboards/lib/dap/get_dataframe_from_cds.py,sha256=OiusRCgYnkBjK_GZgYLGzNrxOGizYt8CgThiWRCVKK0,3921
 gov_uk_dashboards/lib/datetime_functions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gov_uk_dashboards/lib/datetime_functions/datetime_functions.py,sha256=BQgr8I_vFNYwLi-fE4YC6jZ5PpbPea2rnD_2a_lw0YE,12209
-gov_uk_dashboards-15.0.3.dist-info/licenses/LICENSE,sha256=GDiD7Y2Gx7JucPV1JfVySJeah-qiSyBPdpJ6RHCEHTc,1126
-gov_uk_dashboards-15.0.3.dist-info/METADATA,sha256=zVTYb10D5dl_s0qkhzZ3IPgM41B6NegcQ6tMSBPRsgo,5917
-gov_uk_dashboards-15.0.3.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-gov_uk_dashboards-15.0.3.dist-info/top_level.txt,sha256=gPaN1P3-H3Rgi2me6tt-fX_cxo19CZfA4PjlZPjGRpo,18
-gov_uk_dashboards-15.0.3.dist-info/RECORD,,
+gov_uk_dashboards-15.2.0.dist-info/licenses/LICENSE,sha256=GDiD7Y2Gx7JucPV1JfVySJeah-qiSyBPdpJ6RHCEHTc,1126
+gov_uk_dashboards-15.2.0.dist-info/METADATA,sha256=EJHevNpKFYF8I9Fgf54MIQVTv9oqnxiVabqn8tnDTF4,5917
+gov_uk_dashboards-15.2.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+gov_uk_dashboards-15.2.0.dist-info/top_level.txt,sha256=gPaN1P3-H3Rgi2me6tt-fX_cxo19CZfA4PjlZPjGRpo,18
+gov_uk_dashboards-15.2.0.dist-info/RECORD,,