frequenz-cs-reporting 0.0.1__tar.gz

frequenz_cs_reporting-0.0.1/.streamlit/config.toml

@@ -0,0 +1,10 @@
+[theme]
+base = "light"
+primaryColor = "#FF4B4B"
+backgroundColor = "#FFFFFF"
+secondaryBackgroundColor = "#F0F2F6"
+textColor = "#262730"
+font = "sans serif"
+
+[server]
+headless = true

frequenz_cs_reporting-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

frequenz_cs_reporting-0.0.1/MANIFEST.in

@@ -0,0 +1,13 @@
+exclude .cookiecutter-replay.json
+exclude .editorconfig
+exclude .gitignore
+exclude CODEOWNERS
+exclude CONTRIBUTING.md
+exclude mkdocs.yml
+exclude noxfile.py
+exclude src/conftest.py
+recursive-exclude .github *
+recursive-exclude benchmarks *
+recursive-exclude docs *
+recursive-exclude tests *
+recursive-include py *.pyi

frequenz_cs_reporting-0.0.1/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: frequenz-cs-reporting
+Version: 0.0.1
+Summary: Streamlit application for reporting and solar monitoring
+Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
+License: MIT
+Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-cs-reporting/
+Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-cs-reporting/releases
+Project-URL: Issues, https://github.com/frequenz-floss/frequenz-cs-reporting/issues
+Project-URL: Repository, https://github.com/frequenz-floss/frequenz-cs-reporting
+Project-URL: Support, https://github.com/frequenz-floss/frequenz-cs-reporting/discussions/categories/support
+Keywords: frequenz,python,lib,library,frequenz-cs-reporting,tooling,notebooks,streamlit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: css-inline>=0.17.0
+Requires-Dist: frequenz-lib-notebooks<0.15.0,>=0.13.0
+Requires-Dist: matplotlib>=3.10.6
+Requires-Dist: numpy>=2.3.2
+Requires-Dist: pandas>=2.3.2
+Requires-Dist: plotly>=6.3.0
+Requires-Dist: pyarrow>=21.0.0
+Requires-Dist: python-box>=7.3.2
+Requires-Dist: python-dateutil>=2.9.0.post0
+Requires-Dist: python-dotenv>=1.1.1
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: streamlit>=1.49.1
+Requires-Dist: streamlit-aggrid>=1.1.8.post1
+Requires-Dist: watchdog>=6.0.0
+Provides-Extra: dev-flake8
+Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
+Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
+Requires-Dist: flake8-pyproject==1.2.4; extra == "dev-flake8"
+Requires-Dist: pydoclint==0.8.3; extra == "dev-flake8"
+Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
+Provides-Extra: dev-formatting
+Requires-Dist: black==26.1.0; extra == "dev-formatting"
+Requires-Dist: isort==7.0.0; extra == "dev-formatting"
+Provides-Extra: dev-mkdocs
+Requires-Dist: Markdown==3.10; extra == "dev-mkdocs"
+Requires-Dist: black==26.1.0; extra == "dev-mkdocs"
+Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-gen-files==0.6.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-macros-plugin==1.5.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocs-material==9.7.1; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings[python]==1.0.1; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings-python==2.0.1; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.14.0; extra == "dev-mkdocs"
+Provides-Extra: dev-mypy
+Requires-Dist: mypy==1.19.1; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.10.0.20251106; extra == "dev-mypy"
+Requires-Dist: pandas-stubs; extra == "dev-mypy"
+Requires-Dist: frequenz-cs-reporting[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
+Provides-Extra: dev-noxfile
+Requires-Dist: nox==2025.11.12; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.14.0; extra == "dev-noxfile"
+Provides-Extra: dev-pylint
+Requires-Dist: frequenz-cs-reporting[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
+Provides-Extra: dev-pytest
+Requires-Dist: pytest==9.0.2; extra == "dev-pytest"
+Requires-Dist: pylint==4.0.4; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.14.0; extra == "dev-pytest"
+Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
+Requires-Dist: pytest-asyncio==1.3.0; extra == "dev-pytest"
+Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"
+Provides-Extra: dev
+Requires-Dist: frequenz-cs-reporting[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]; extra == "dev"
+Dynamic: license-file
+
+# Frequenz CS Reporting Library
+
+[![Build Status](https://github.com/frequenz-floss/frequenz-cs-reporting/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-cs-reporting/actions/workflows/ci.yaml)
+[![PyPI Package](https://img.shields.io/pypi/v/frequenz-cs-reporting)](https://pypi.org/project/frequenz-cs-reporting/)
+[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-cs-reporting/)
+
+## Introduction
+
+Streamlit application for reporting and solar monitoring
+
+TODO(cookiecutter): Improve the README file
+
+## Supported Platforms
+
+The following platforms are officially supported (tested):
+
+- **Python:** 3.11
+- **Operating System:** Ubuntu Linux 20.04
+- **Architectures:** amd64, arm64
+
+## Contributing
+
+If you want to know how to build this project and contribute to it, please
+check out the [Contributing Guide](CONTRIBUTING.md).

frequenz_cs_reporting-0.0.1/README.md

@@ -0,0 +1,24 @@
+# Frequenz CS Reporting Library
+
+[![Build Status](https://github.com/frequenz-floss/frequenz-cs-reporting/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-cs-reporting/actions/workflows/ci.yaml)
+[![PyPI Package](https://img.shields.io/pypi/v/frequenz-cs-reporting)](https://pypi.org/project/frequenz-cs-reporting/)
+[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-cs-reporting/)
+
+## Introduction
+
+Streamlit application for reporting and solar monitoring
+
+TODO(cookiecutter): Improve the README file
+
+## Supported Platforms
+
+The following platforms are officially supported (tested):
+
+- **Python:** 3.11
+- **Operating System:** Ubuntu Linux 20.04
+- **Architectures:** amd64, arm64
+
+## Contributing
+
+If you want to know how to build this project and contribute to it, please
+check out the [Contributing Guide](CONTRIBUTING.md).

frequenz_cs_reporting-0.0.1/RELEASE_NOTES.md

@@ -0,0 +1,16 @@
+# Frequenz CS Reporting Library Release Notes
+
+## Summary
+- Initial Streamlit-based reporting app that discovers packaged pages, shows branded navigation, and renders microgrid reporting dashboards backed by the frequenz data stack.
+
+## Upgrading
+
+
+## New Features
+- Added app.py entrypoint that loads PageSpec definitions, persists navigation in query params, and renders sidebar branding.
+- New Home and Reporting pages: the dashboard offers microgrid/date/timezone/resolution filters, fetches/caches microgrid power data, builds a master dataframe, and drives overview metrics plus consumption breakdowns.
+- Dashboard visuals now include time-series plots, energy-mix pie, component-specific tabs (PV, battery, wind, BHKW, EV), and styled plot cards.
+- Data tables use AgGrid with CSV downloads for power mix, component analyses, and the combined master dataframe; reusable UI helpers and constants were added for consistent styling and column naming.
+
+## Bug Fixes
+

frequenz_cs_reporting-0.0.1/app.py

@@ -0,0 +1,211 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+"""Main application module for the Frequenz CS Reporting Suite."""
+
+from __future__ import annotations
+
+import importlib
+import sys
+from pathlib import Path
+import importlib.resources as resources
+import importlib.util
+import streamlit as st
+import pkgutil
+import os
+
+# --- Check if running in deepnote to pick up environment variables ---
+def running_in_deepnote() -> bool:
+    # Common Deepnote env vars (if one changes, the others may still work)
+    return any(k in os.environ for k in (
+        "DEEPNOTE_PROJECT_ID",
+        "DEEPNOTE_WORKSPACE_ID",
+        "DEEPNOTE",
+    ))
+
+IN_DEEPNOTE = running_in_deepnote()
+
+if IN_DEEPNOTE:
+    import deepnote_toolkit
+    deepnote_toolkit.set_integration_env()
+
+# --- Project paths & sys.path wiring ----------------------------------------
+PACKAGE_DIR = Path(__file__).resolve().parent
+LIB_PAGES_ROOT = "frequenz.frequenz_cs_reporting.app_pages"
+LOGO_NAME = "neustrom_logo.png"
+
+
+def _resolve_package_root() -> Path:
+    """Return the installed frequenz package path, with a local fallback for dev."""
+    spec = importlib.util.find_spec("frequenz.frequenz_cs_reporting")
+    if spec and spec.submodule_search_locations:
+        return Path(next(iter(spec.submodule_search_locations))).resolve()
+    if spec and spec.origin:
+        return Path(spec.origin).resolve().parent
+    return (PACKAGE_DIR / "src" / "frequenz" / "frequenz_cs_reporting").resolve()
+
+
+PACKAGE_ROOT = _resolve_package_root()
+APP_PAGES_DIR = PACKAGE_ROOT / "app_pages"
+ASSETS_DIR = PACKAGE_ROOT / "assets"
+
+package_parent = str(PACKAGE_ROOT.parent)
+if package_parent not in sys.path:
+    sys.path.insert(0, package_parent)
+
+# Import PageSpec from your custom library
+from frequenz.frequenz_cs_reporting.rep_cs_core.page_spec import PageSpec
+
+# --- Local page loader (from ./app_pages) -----------------------------------
+def _load_local_pages() -> list[PageSpec]:
+    """Load PAGE specs from local app_pages/*.py files."""
+    if not APP_PAGES_DIR.exists():
+        return []
+
+    pages: list[PageSpec] = []
+
+    for module_path in sorted(APP_PAGES_DIR.glob("*.py")):
+        if module_path.name.startswith("_") or module_path.name == "__init__.py":
+            continue
+        spec = importlib.util.spec_from_file_location(module_path.stem, module_path)
+        if spec is None or spec.loader is None:
+            continue
+
+        module = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(module)
+        page = getattr(module, "PAGE", None)
+
+        if page and all(
+            hasattr(page, attr)
+            for attr in ("key", "title", "icon", "order", "render")
+        ):
+            pages.append(page)
+
+    return pages
+
+
+# --- Library page discovery (from frequenz.app_pages) -----------------------
+def discover_library_pages(pkg_root: str = LIB_PAGES_ROOT) -> list[PageSpec]:
+    """Discover PAGE specs from the installed frequenz app_pages package.
+
+    Falls back to local ./app_pages if the library package is missing.
+    """
+    try:
+        pkg = importlib.import_module(pkg_root)
+    except ModuleNotFoundError:
+        # Library not installed; fall back to local pages
+        return _load_local_pages()
+
+    pages: list[PageSpec] = []
+
+    for _, modname, _ in pkgutil.iter_modules(pkg.__path__, pkg.__name__ + "."):
+        short = modname.rsplit(".", 1)[-1]
+        if short.startswith("_"):
+            continue
+
+        module = importlib.import_module(modname)
+        page = getattr(module, "PAGE", None)
+
+        if page and all(
+            hasattr(page, attr)
+            for attr in ("key", "title", "icon", "order", "render")
+        ):
+            pages.append(page)
+
+    # Sort by (order, title) for stable navigation
+    return sorted(pages, key=lambda p: (p.order, p.title.lower()))
+
+
+def _load_logo_bytes() -> bytes | None:
+    """Fetch the sidebar logo from the installed package resources."""
+    try:
+        return resources.files("frequenz.frequenz_cs_reporting.assets").joinpath(LOGO_NAME).read_bytes()
+    except (FileNotFoundError, ModuleNotFoundError):
+        pass
+
+    local_logo = ASSETS_DIR / LOGO_NAME
+    if local_logo.exists():
+        return local_logo.read_bytes()
+    return None
+
+
+# Sidebar navigation
+def sidebar(pages: list[PageSpec]) -> PageSpec:
+    if logo_bytes := _load_logo_bytes():
+        st.sidebar.image(logo_bytes, width='stretch')
+
+    st.sidebar.divider()
+
+    state_key = "selected_page"
+    valid_keys = {p.key for p in pages}
+    default_key = st.query_params.get("page", [pages[0].key])[0]
+
+    if default_key not in valid_keys:
+        default_key = pages[0].key
+
+    # Initialize session state with the URL query parameter
+    st.session_state.setdefault(state_key, default_key)
+
+    # Ensure the state matches the URL param on the initial load/rerun
+    if st.session_state[state_key] != default_key:
+        st.session_state[state_key] = default_key
+
+    # Map display labels to internal keys
+    options = {f"{p.icon} {p.title}": p.key for p in pages}
+    display_options = list(options.keys())
+
+    current_key = st.session_state[state_key]
+    initial_index = next(
+        (idx for idx, page in enumerate(pages) if page.key == current_key), 0
+    )
+
+    # Function to resolve the selected key from the display label
+    def get_key_from_label(label: str) -> str:
+        return options.get(label, pages[0].key)
+
+    # Add page navigation header
+    st.sidebar.header("📑 Seiten")
+    
+    # Use st.sidebar.radio to manage selection
+    selected_label = st.sidebar.radio(
+        "Navigation",
+        options=display_options,
+        index=initial_index,
+        key="navigation_radio",
+        label_visibility="collapsed",
+    )
+
+    # Add divider after navigation
+    st.sidebar.divider()
+
+    # Update session state and query params based on radio selection
+    selected_key = get_key_from_label(selected_label)
+    if st.session_state[state_key] != selected_key:
+        st.session_state[state_key] = selected_key
+        st.query_params.page = selected_key
+
+    selected = next(p for p in pages if p.key == st.session_state[state_key])
+    return selected
+
+
+# --- Main entrypoint --------------------------------------------------------
+def main() -> None:
+    st.set_page_config(
+        page_title="Enterprise Reporting App",
+        page_icon="🏢",
+        layout="wide",
+    )
+
+    pages = discover_library_pages()
+    if not pages:
+        st.info(f"No pages found under `{LIB_PAGES_ROOT}` (or local app_pages).")
+        return
+
+    selected = sidebar(pages)
+
+    # Render selected page
+    selected.render()
+
+
+if __name__ == "__main__":
+    main()

frequenz_cs_reporting-0.0.1/pyproject.toml

@@ -0,0 +1,221 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+[build-system]
+requires = [
+  "setuptools == 80.9.0",
+  "setuptools_scm[toml] == 9.2.2",
+  "frequenz-repo-config[lib] == 0.14.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "frequenz-cs-reporting"
+description = "Streamlit application for reporting and solar monitoring"
+readme = "README.md"
+dynamic = ["version"]
+license = { text = "MIT" }
+keywords = ["frequenz", "python", "lib", "library", "frequenz-cs-reporting", "tooling", "notebooks", "streamlit"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: Libraries",
+  "Typing :: Typed",
+]
+requires-python = ">= 3.11, < 4"
+
+dependencies = [
+    "css-inline>=0.17.0",
+    "frequenz-lib-notebooks>=0.13.0, < 0.15.0",
+    "matplotlib>=3.10.6",
+    "numpy>=2.3.2",
+    "pandas>=2.3.2",
+    "plotly>=6.3.0",
+    "pyarrow>=21.0.0",
+    "python-box>=7.3.2",
+    "python-dateutil>=2.9.0.post0",
+    "python-dotenv>=1.1.1",
+    "pyyaml>=6.0.3",
+    "streamlit>=1.49.1",
+    "streamlit-aggrid>=1.1.8.post1",
+    "watchdog>=6.0.0",
+]
+
+[[project.authors]]
+name = "Frequenz Energy-as-a-Service GmbH"
+email = "floss@frequenz.com"
+
+[project.optional-dependencies]
+dev-flake8 = [
+  "flake8 == 7.3.0",
+  "flake8-docstrings == 1.7.0",
+  "flake8-pyproject == 1.2.4",  # For reading the flake8 config from pyproject.toml
+  "pydoclint == 0.8.3",
+  "pydocstyle == 6.3.0",
+]
+dev-formatting = ["black == 26.1.0", "isort == 7.0.0"]
+dev-mkdocs = [
+  "Markdown == 3.10",
+  "black == 26.1.0",
+  "mike == 2.1.3",
+  "mkdocs-gen-files == 0.6.0",
+  "mkdocs-literate-nav == 0.6.2",
+  "mkdocs-macros-plugin == 1.5.0",
+  "mkdocs-material == 9.7.1",
+  "mkdocstrings[python] == 1.0.1",
+  "mkdocstrings-python == 2.0.1",
+  "frequenz-repo-config[lib] == 0.14.0",
+]
+dev-mypy = [
+  "mypy == 1.19.1",
+  "types-Markdown == 3.10.0.20251106",
+  "pandas-stubs",
+  # For checking the noxfile, docs/ script, and tests
+  "frequenz-cs-reporting[dev-mkdocs,dev-noxfile,dev-pytest]",
+]
+dev-noxfile = [
+  "nox == 2025.11.12",
+  "frequenz-repo-config[lib] == 0.14.0",
+]
+dev-pylint = [
+  # dev-pytest already defines a dependency to pylint because of the examples
+  # For checking the noxfile, docs/ script, and tests
+  "frequenz-cs-reporting[dev-mkdocs,dev-noxfile,dev-pytest]",
+]
+dev-pytest = [
+  "pytest == 9.0.2",
+  "pylint == 4.0.4",       # We need this to check for the examples
+  "frequenz-repo-config[extra-lint-examples] == 0.14.0",
+  "pytest-mock == 3.15.1",
+  "pytest-asyncio == 1.3.0",
+  "async-solipsism == 0.9",
+]
+dev = [
+  "frequenz-cs-reporting[dev-mkdocs,dev-flake8,dev-formatting,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]",
+]
+
+[project.urls]
+Documentation = "https://frequenz-floss.github.io/frequenz-cs-reporting/"
+Changelog = "https://github.com/frequenz-floss/frequenz-cs-reporting/releases"
+Issues = "https://github.com/frequenz-floss/frequenz-cs-reporting/issues"
+Repository = "https://github.com/frequenz-floss/frequenz-cs-reporting"
+Support = "https://github.com/frequenz-floss/frequenz-cs-reporting/discussions/categories/support"
+
+[tool.setuptools]
+# This tells setuptools to look for packages inside the 'src' directory.
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["frequenz*"]
+namespaces = true
+
+[tool.setuptools.package-data]
+"frequenz.frequenz_cs_reporting" = [
+    "assets/*.png",
+    "assets/*.jpg",
+    "assets/*.svg",
+    "assets/*.json",
+    ".streamlit/config.toml",
+]
+
+[tool.black]
+line-length = 88
+target-version = ["py311", "py312"]
+
+[tool.isort]
+profile = "black"
+line_length = 88
+src_paths = ["benchmarks", "examples", "src", "tests"]
+
+[tool.flake8]
+# We give some flexibility to go over 88, there are cases like long URLs or
+# code in documenation that have extra indentation. Black will still take care
+# of making everything that can be 88 wide, 88 wide.
+max-line-length = 100
+extend-ignore = [
+  "E203", # Whitespace before ':' (conflicts with black)
+  "W503", # Line break before binary operator (conflicts with black)
+]
+# pydoclint options
+style = "google"
+check-return-types = false
+check-yield-types = false
+arg-type-hints-in-docstring = false
+arg-type-hints-in-signature = true
+allow-init-docstring = true
+check-class-attributes = false
+
+[tool.pylint.similarities]
+ignore-comments = ['yes']
+ignore-docstrings = ['yes']
+ignore-imports = ['no']
+min-similarity-lines = 40
+
+[tool.pylint.messages_control]
+disable = [
+  "too-few-public-methods",
+  "too-many-return-statements",
+  # disabled because it conflicts with isort
+  "wrong-import-order",
+  "ungrouped-imports",
+  # Checked by mypy (and pylint is very flaky checking these)
+  "unsubscriptable-object",
+  "no-member",
+  "no-name-in-module",
+  "possibly-used-before-assignment",
+  # Checked by flake8
+  "f-string-without-interpolation",
+  "line-too-long",
+  "missing-function-docstring",
+  "redefined-outer-name",
+  "unnecessary-lambda-assignment",
+  "unused-import",
+  "unused-variable",
+]
+
+[tool.pytest.ini_options]
+addopts = "-vv"
+filterwarnings = [
+  "error",
+  "once::DeprecationWarning",
+  "once::PendingDeprecationWarning",
+  # We ignore warnings about protobuf gencode version being one version older
+  # than the current version, as this is supported by protobuf, and we expect to
+  # have such cases. If we go too far, we will get a proper error anyways.
+  # We use a raw string (single quotes) to avoid the need to escape special
+  # characters as this is a regex.
+  'ignore:Protobuf gencode version .*exactly one major version older.*:UserWarning',
+]
+testpaths = ["tests", "src"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+required_plugins = ["pytest-asyncio", "pytest-mock"]
+
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+# This option disables mypy cache, and it is sometimes useful to enable it if
+# you are getting weird intermittent error, or error in the CI but not locally
+# (or vice versa). In particular errors saying that type: ignore is not
+# used but getting the original ignored error when removing the type: ignore.
+# See for example: https://github.com/python/mypy/issues/2960
+#no_incremental = true
+packages = ["frequenz.frequenz_cs_reporting"]
+strict = true
+
+[[tool.mypy.overrides]]
+module = ["mkdocs_macros.*", "sybil", "sybil.*", "pvlib", "pvlib.*", "plotly", "plotly.*"]
+ignore_missing_imports = true
+
+[tool.setuptools_scm]
+version_scheme = "post-release"
+
+[dependency-groups]
+dev = [
+    "pandas-stubs>=2.3.3.260113",
+]

frequenz_cs_reporting-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

frequenz_cs_reporting-0.0.1/src/frequenz/frequenz_cs_reporting/__init__.py

@@ -0,0 +1,4 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+"""Top-level package for Frequenz reporting utilities and views."""

frequenz_cs_reporting-0.0.1/src/frequenz/frequenz_cs_reporting/app_pages/__init__.py

@@ -0,0 +1,4 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+"""Frequenz CS Reporting App Pages."""