analog-daddy 2.0.1__tar.gz → 3.0.1.dev1__tar.gz

analog_daddy-3.0.1.dev1/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: analog-daddy
+Version: 3.0.1.dev1
+Summary: This library is an attempt to make transistor sizing for Analog Design less painful. Additionally, provides helper utilities to minimize churn and errors in repetative tasks.
+Author: Siddhant Laddha
+Author-email: Siddhant Laddha <25705822+siddhantladdha@users.noreply.github.com>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
+Classifier: Typing :: Typed
+Requires-Dist: boltons
+Requires-Dist: cyclopts ; sys_platform != 'emscripten'
+Requires-Dist: great-tables
+Requires-Dist: plotly
+Requires-Dist: polars
+Requires-Dist: pydantic>=2
+Requires-Dist: pydantic-settings
+Requires-Dist: quantiphy
+Requires-Dist: rich
+Requires-Dist: scipy
+Requires-Dist: xarray
+Maintainer: Siddhant Laddha
+Maintainer-email: Siddhant Laddha <25705822+siddhantladdha@users.noreply.github.com>
+Requires-Python: >=3.12
+Project-URL: bugs, https://github.com/siddhantladdha/analog_daddy/issues
+Project-URL: changelog, https://github.com/siddhantladdha/analog_daddy/releases
+Project-URL: documentation, https://siddhantladdha.github.io/analog_daddy/
+Project-URL: homepage, https://github.com/siddhantladdha/analog_daddy
+Description-Content-Type: text/markdown
+
+# Analog Daddy
+
+This is a dummy README for the dev version. Please refer
+[main](https://github.com/siddhantladdha/analog-daddy)

analog_daddy-3.0.1.dev1/README.md

@@ -0,0 +1,4 @@
+# Analog Daddy
+
+This is a dummy README for the dev version. Please refer
+[main](https://github.com/siddhantladdha/analog-daddy)

analog_daddy-3.0.1.dev1/pyproject.toml

@@ -0,0 +1,156 @@
+[project]
+name = "analog-daddy"
+version = "3.0.1.dev1"
+description = "This library is an attempt to make transistor sizing for Analog Design less painful. Additionally, provides helper utilities to minimize churn and errors in repetative tasks."
+readme = "README.md"
+requires-python = ">= 3.12"
+license = "MIT"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Education",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)",
+    "Typing :: Typed",
+]
+dependencies = [
+    "boltons",
+    "cyclopts; sys_platform != 'emscripten'",
+    "great-tables",
+    "plotly",
+    "polars",
+    "pydantic>=2",
+    "pydantic-settings",
+    "quantiphy",
+    "rich",
+    "scipy",
+    "xarray",
+]
+
+[[project.authors]]
+name = "Siddhant Laddha"
+email = "25705822+siddhantladdha@users.noreply.github.com"
+
+[[project.maintainers]]
+name = "Siddhant Laddha"
+email = "25705822+siddhantladdha@users.noreply.github.com"
+
+[project.urls]
+bugs = "https://github.com/siddhantladdha/analog_daddy/issues"
+changelog = "https://github.com/siddhantladdha/analog_daddy/releases"
+documentation = "https://siddhantladdha.github.io/analog_daddy/"
+homepage = "https://github.com/siddhantladdha/analog_daddy"
+
+[project.scripts]
+analog_daddy = "analog_daddy.cli:app"
+
+[dependency-groups]
+dev = [
+    "format-docstring",
+    "pytest",
+    "ruff",
+    "ty",
+]
+docs = [
+    "mkdocstrings-python",
+    "nbconvert",
+    "playwright",
+    "zensical",
+]
+lint = ["pydoclint"]
+notebooks = [
+    "marimo[lsp,mcp,recommended]",
+    "wigglystuff",
+]
+
+[[dependency-groups.all]]
+include-group = "dev"
+
+[[dependency-groups.all]]
+include-group = "docs"
+
+[[dependency-groups.all]]
+include-group = "notebooks"
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14"]
+build-backend = "uv_build"
+
+[tool.format_docstring]
+docstring_style = "numpy"
+line_length = 72
+include_arg_types = true
+include_arg_defaults = true
+fix_rst_backticks = true
+exclude = '\.git|\.venv|__pycache__|.*drafts.*\.py'
+
+[tool.pydoclint]
+style = "numpy"
+arg-type-hints-in-docstring = true
+arg-type-hints-in-signature = true
+check-return-types = true
+check-arg-defaults = true
+check-style-mismatch = true
+show-filenames-in-every-violation-message = true
+exclude = '\.git|\.tox|\.venv|build|dist|.*drafts.*\.py'
+
+[tool.pytest.ini_options]
+addopts = [
+    "--doctest-modules",
+    "--ignore-glob=*drafts*.py",
+]
+doctest_optionflags = ["IGNORE_EXCEPTION_DETAIL"]
+testpaths = [
+    "src",
+    "tests",
+]
+
+[tool.ruff]
+line-length = 79
+extend-exclude = ["*drafts*.py"]
+output-prefer-rule-codes = true
+
+[tool.ruff.lint]
+ignore = [
+    "D105",
+    "D401",
+]
+extend-select = [
+    "NPY",
+    "N",
+    "PTH",
+    "SIM",
+    "EXE",
+    "FURB110",
+    "FURB116",
+    "FURB167",
+    "FURB177",
+    "B903",
+    "TRY300",
+    "LOG004",
+    "LOG007",
+    "UP042",
+    "PERF403",
+    "PERF401",
+    "FURB113",
+    "FURB152",
+    "FURB156",
+]
+preview = true
+explicit-preview-rules = true
+external = ["DOC105"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty.src]
+exclude = ["**/*drafts*.py"]
+
+[tool.ty.terminal]
+output-format = "concise"
+
+[tool.uv]
+default-groups = ["all"]
+required-version = ">=0.13.0,<0.14"

analog_daddy-3.0.1.dev1/pyproject.toml.orig

@@ -0,0 +1,161 @@
+[project]
+name = "analog-daddy"
+version = "3.0.1.dev1"
+description = "This library is an attempt to make transistor sizing for Analog Design less painful. Additionally, provides helper utilities to minimize churn and errors in repetative tasks."
+readme = "README.md"
+requires-python = ">= 3.12"
+license = "MIT"
+authors = [
+  { name = "Siddhant Laddha", email = "25705822+siddhantladdha@users.noreply.github.com" }
+]
+maintainers = [
+  { name = "Siddhant Laddha", email = "25705822+siddhantladdha@users.noreply.github.com" }
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Education",
+  "Intended Audience :: Science/Research",
+  "Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)",
+  "Typing :: Typed",
+]
+dependencies = [
+  "boltons",
+  "cyclopts; sys_platform != 'emscripten'",
+  "great-tables",
+  "plotly",
+  "polars",
+  "pydantic>=2",
+  "pydantic-settings",
+  "quantiphy",
+  "rich",
+  "scipy",
+  "xarray",
+]
+
+[project.urls]
+bugs = "https://github.com/siddhantladdha/analog_daddy/issues"
+changelog = "https://github.com/siddhantladdha/analog_daddy/releases"
+documentation = "https://siddhantladdha.github.io/analog_daddy/"
+homepage = "https://github.com/siddhantladdha/analog_daddy"
+
+[project.scripts]
+analog_daddy = "analog_daddy.cli:app"
+
+[dependency-groups]
+dev = [
+  "format-docstring",
+  "pytest",
+  "ruff",
+  "ty",
+]
+all = [
+  { include-group = "dev" },
+  { include-group = "docs" },
+  { include-group = "notebooks" },
+]
+docs = [
+  "mkdocstrings-python",
+  "nbconvert",  # marimo pdf exports.
+  "playwright",  # marimo pdf exports.
+  "zensical",
+  # TODO: evaluate vs great-docs for marimo notebooks in docs.
+]
+lint = ["pydoclint"]
+notebooks = [
+  "marimo[lsp,mcp,recommended]",
+  "wigglystuff",
+]
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14"]
+build-backend = "uv_build"
+
+[tool.format_docstring]
+docstring_style = "numpy"
+line_length = 72
+include_arg_types = true
+include_arg_defaults = true
+fix_rst_backticks = true
+exclude = "\\.git|\\.venv|__pycache__|.*drafts.*\\.py"
+
+[tool.pydoclint]
+# issue #313 currently needs # noqa: DOC105
+style = "numpy"
+arg-type-hints-in-docstring = true
+arg-type-hints-in-signature = true
+check-return-types = true
+check-arg-defaults = true
+check-style-mismatch = true
+show-filenames-in-every-violation-message = true
+exclude = '\.git|\.tox|\.venv|build|dist|.*drafts.*\.py'
+
+[tool.pytest.ini_options]
+addopts = ["--doctest-modules", "--ignore-glob=*drafts*.py"]
+doctest_optionflags = ["IGNORE_EXCEPTION_DETAIL"]
+testpaths = ["src", "tests"]
+
+[tool.ruff]
+line-length = 79
+extend-exclude = ["*drafts*.py"]
+output-prefer-rule-codes = true
+
+[tool.ruff.lint]
+ignore = [
+  # "DOC",  # pydoclint is already handling docstring issues.
+  # "F401",  # F401: module imported but unused
+  # "D100",  # Missing docstring in public module"
+  # "D103",  # undocumented-public-method
+  "D105",  # undocumented-magic-method
+  "D401",  # non-imperative-mood
+]
+extend-select = [
+  "NPY",  # numpy
+  # "D",  # docstring # handled by format-docstring and pydoclint
+  "N",  # pep8-naming
+  "PTH",  # flake8-use-pathlib
+  "SIM",  # flake8-simplify
+  "EXE",  # flake8-executable
+  "FURB110",
+  "FURB116",
+  "FURB167",
+  "FURB177",
+  "B903",
+  "TRY300",
+  "LOG004",
+  "LOG007",
+  "UP042",
+  "PERF403",
+  "PERF401",
+  #############
+  # Preview rules
+  "FURB113",
+  "FURB152",
+  "FURB156",
+  #############
+  #############
+  # Enable the following when working on spaghetti and old code.
+  # "FURB",
+  # "UP",
+  #############
+]
+# There are certain `preview`/beta rules that I am selectively enabling.
+preview = true
+explicit-preview-rules = true
+external = ["DOC105"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty]
+[tool.ty.src]
+exclude = ["**/*drafts*.py"]
+
+[tool.ty.terminal]
+output-format = "concise"
+
+[tool.uv]
+default-groups = ["all"]
+required-version = ">=0.13.0,<0.14"

analog_daddy-3.0.1.dev1/src/analog_daddy/__init__.py

@@ -0,0 +1 @@
+"""Top-level package for Analog Daddy."""

analog_daddy-3.0.1.dev1/src/analog_daddy/__main__.py

@@ -0,0 +1,6 @@
+"""Run the analog-daddy command-line interface."""
+
+from .cli import app
+
+if __name__ == "__main__":
+    app()

analog_daddy-3.0.1.dev1/src/analog_daddy/cli.py

@@ -0,0 +1,22 @@
+"""Console script for analog_daddy."""
+
+from cyclopts import App
+from rich.console import Console
+
+app = App()
+console = Console()
+
+
+@app.default
+def main() -> None:
+    """Console script for analog_daddy."""
+    console.print(
+        "Replace this message by putting your code into analog_daddy.cli.main"
+    )
+    console.print(
+        "See Cyclopts documentation at https://cyclopts.readthedocs.io/"
+    )
+
+
+if __name__ == "__main__":
+    app()

analog_daddy-3.0.1.dev1/src/analog_daddy/gtutils.py

@@ -0,0 +1,8 @@
+import polars.selectors as cs
+from great_tables import GT
+
+
+def gt_defaults(gtbl: GT):
+    """Preferred defaults for rendering great tables."""
+    gtbl = gtbl.fmt_number_si(columns=cs.numeric()).opt_stylize(style=4)
+    return gtbl

analog_daddy-3.0.1.dev1/src/analog_daddy/mootils.py

@@ -0,0 +1,123 @@
+"""
+A collection of marimo utility functions.
+
+While marimo is quite feature-rich, these functions are intended to be
+convenience functions for common tasks that are not yet implemented in
+marimo. These might be deprecated if they become available in marimo.
+"""
+
+import io
+from collections.abc import Callable
+from typing import Any
+
+import marimo as mo
+import polars as pl
+import polars.selectors as cs
+from rich.console import Console, RenderableType
+
+from analog_daddy.utils import render
+
+
+def format_mapping_num_to_si(df: pl.DataFrame) -> dict[str, Callable]:
+    """
+    Build a format mapping that renders numeric columns as SI strings.
+
+    Intended for the ``format_mapping`` argument of ``mo.ui.table`` and
+    ``mo.ui.dataframe``. Columns are matched with ``cs.numeric()`` and
+    rendered with :func:`render`.
+
+    Parameters
+    ----------
+    df : pl.DataFrame
+        DataFrame whose numeric columns to map.
+
+    Returns
+    -------
+    dict[str, Callable]
+        Column name to formatter mapping.
+
+    References
+    ----------
+    - [marimo#9663](https://github.com/marimo-team/marimo/issues/9663)
+    - [marimo#7568](https://github.com/marimo-team/marimo/issues/7568)
+    """
+    return dict.fromkeys(cs.expand_selector(df, cs.numeric()), render)
+
+
+def mo_table(
+    data: pl.DataFrame,
+    *,
+    selection=None,
+    pagination=None,
+    page_size=30,
+    max_columns=1000,
+    **kwargs,
+) -> mo.ui.table:
+    kwargs.setdefault("format_mapping", format_mapping_num_to_si(data))
+    return mo.ui.table(
+        data,
+        selection=selection,
+        pagination=pagination,
+        page_size=page_size,
+        max_columns=max_columns,
+        **kwargs,
+    )
+
+
+def rich_md(
+    *renderables: RenderableType,
+    console_kwargs: dict[str, Any] | None = None,
+    print_kwargs: dict[str, Any] | None = None,
+    export_html_kwargs: dict[str, Any] | None = None,
+) -> mo.Html:
+    """
+    A minimal helper function to utilize rich markup within marimo.
+
+    Created this for shits-n-giggles. This is in no way complete! I
+    don't use this as much as I would like to, however, in case you have
+    some text, that you would like to keep consistent with your console
+    markup, this might be an option.
+
+    Parameters
+    ----------
+    *renderables : RenderableType
+        The renderable objects to be printed using rich.
+    console_kwargs : dict[str, Any] | None, default=None
+        Keyword arguments to customize the rich Console.
+    print_kwargs : dict[str, Any] | None, default=None
+        Keyword arguments to customize the rich print method.
+    export_html_kwargs : dict[str, Any] | None, default=None
+        Keyword arguments to customize the rich export_html method.
+
+    Returns
+    -------
+    mo.Html
+        The HTML representation of the rich renderables.
+
+    Examples
+    --------
+    >>> "font-weight: bold" in rich_md("[bold green]Hello[/] World").text
+    True
+    >>> "font-style: italic" in rich_md(
+    ...     "[bold]Bold[italic] bold and italic [/bold]italic[/italic]"
+    ... ).text
+    True
+    >>> "⚠️" in rich_md(":warning-emoji: you have been warned!").text
+    True
+    """
+    console_kwargs = {
+        "color_system": "truecolor",
+        "record": True,
+        **(console_kwargs or {}),
+    }
+    print_kwargs = print_kwargs or {}
+    export_html_kwargs = {
+        "inline_styles": True,
+        "code_format": "{code}",
+        **(export_html_kwargs or {}),
+    }
+
+    capture = io.StringIO()
+    console = Console(file=capture, **console_kwargs)
+    console.print(*renderables, **print_kwargs)
+    return mo.Html(console.export_html(**export_html_kwargs))