gov-uk-dashboards 15.0.2__py3-none-any.whl → 15.1.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/enums.py

@@ -9,6 +9,7 @@ class XAxisFormat(Enum):
 
     YEAR = "year"
     MONTH_YEAR = "month_year"
+    MONTH_YEAR_MONTHLY_DATA = "month_year_monthly_data"
     FINANCIAL_QUARTER = "financial_quarter"
 
 

gov_uk_dashboards/components/plotly/time_series_chart.py

@@ -397,7 +397,6 @@ class TimeSeriesChart:
             tick_text_length = len(tick_text)
             total_tick_points = int((tick_text_length / 5) * 7)
             additional_tick_points = total_tick_points - tick_text_length
-
             last_current_tick_text = datetime.strptime(tick_text[-1], "%b %Y")
 
             for x in range(additional_tick_points):
@@ -417,6 +416,34 @@ class TimeSeriesChart:
                 tick_values[-1] + relativedelta(months=1),
             ]
             tick_text = replace_jun_jul_month_abbreviations(tick_text)
+
+        elif self.xaxis_tick_text_format == XAxisFormat.MONTH_YEAR_MONTHLY_DATA.value:
+            df = self.filtered_df.with_columns(
+                pl.col(self.x_axis_column)
+                .str.strptime(pl.Date, "%Y-%m-%d")
+                .alias(self.x_axis_column)
+            ).sort(self.x_axis_column)
+
+            start_datetime = datetime(2024, 7, 1).date()
+            latest_datetime = df[self.x_axis_column].max()
+            extra_datetime = latest_datetime + relativedelta(months=1)
+
+            tick_text = []
+            current = start_datetime
+            while current <= extra_datetime:
+                tick_text.append(current.strftime("%b %Y"))
+                current += relativedelta(months=1)
+
+            tick_values = [
+                datetime.strptime(month_year, "%b %Y").replace(day=1)
+                for month_year in tick_text
+            ]
+
+            range_x = [
+                tick_values[0],
+                tick_values[-1],
+            ]
+            tick_text = replace_jun_jul_month_abbreviations(tick_text)
         elif self.xaxis_tick_text_format == XAxisFormat.FINANCIAL_QUARTER.value:
             tick_values = [1, 2, 3, 4]
             tick_text = [

{gov_uk_dashboards-15.0.2.dist-info → gov_uk_dashboards-15.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gov_uk_dashboards
-Version: 15.0.2
+Version: 15.1.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.2.dist-info → gov_uk_dashboards-15.1.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
@@ -76,9 +77,9 @@ gov_uk_dashboards/components/helpers/update_layout_bgcolor_margin.py,sha256=i7Nw
 gov_uk_dashboards/components/plotly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gov_uk_dashboards/components/plotly/captioned_figure.py,sha256=T0sbtGTiJ79FXxVdPb__hqISuyTc3Dl11cKhgcuW-5U,2804
 gov_uk_dashboards/components/plotly/choropleth_map.py,sha256=U9RmS3MZGloQAt9HoSYh3Xad205DDfZOjz91ZD_ydbI,9849
-gov_uk_dashboards/components/plotly/enums.py,sha256=0QnVyXwnBQRqP3p8YIgPsvGLPu-wClBj9F_722GDfYU,794
+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=oOxGjCjoKclLc5o9qGc6vMtb1LXWZ2WbdZzQ31NLZ9E,18176
+gov_uk_dashboards/components/plotly/time_series_chart.py,sha256=whdOe4xPfpmWazPrOZDF38dfkhGWpZ7dqO3RQPIun3o,19228
 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.2.dist-info/licenses/LICENSE,sha256=GDiD7Y2Gx7JucPV1JfVySJeah-qiSyBPdpJ6RHCEHTc,1126
-gov_uk_dashboards-15.0.2.dist-info/METADATA,sha256=vnBnaJwv-t8MIGRQvARA2SNDOXHlgMQSqtTUEK77fdY,5917
-gov_uk_dashboards-15.0.2.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-gov_uk_dashboards-15.0.2.dist-info/top_level.txt,sha256=gPaN1P3-H3Rgi2me6tt-fX_cxo19CZfA4PjlZPjGRpo,18
-gov_uk_dashboards-15.0.2.dist-info/RECORD,,
+gov_uk_dashboards-15.1.0.dist-info/licenses/LICENSE,sha256=GDiD7Y2Gx7JucPV1JfVySJeah-qiSyBPdpJ6RHCEHTc,1126
+gov_uk_dashboards-15.1.0.dist-info/METADATA,sha256=AF-hcenFhQ7jtSw02N_Kb44fcGdrnPXP_G2x-l1VDgs,5917
+gov_uk_dashboards-15.1.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+gov_uk_dashboards-15.1.0.dist-info/top_level.txt,sha256=gPaN1P3-H3Rgi2me6tt-fX_cxo19CZfA4PjlZPjGRpo,18
+gov_uk_dashboards-15.1.0.dist-info/RECORD,,