mergeron 2025.739425.0__tar.gz → 2025.739439.3__tar.gz

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mergeron
-Version: 2025.739425.0
+Version: 2025.739439.3
 Summary: Python for analyzing merger enforcement policy
 License: MIT
 Keywords: merger enforcement policy,merger guidelines,merger screening,enforcement presumptions,concentration standards,diversion ratio,upward pricing pressure,GUPPI
@@ -24,13 +24,13 @@ Requires-Dist: certifi (>=2025.6.15)
 Requires-Dist: h5py (>=3.14.0)
 Requires-Dist: jinja2 (>=3.1.6)
 Requires-Dist: joblib (>=1.5.1)
-Requires-Dist: lxml (>=5.4.0)
+Requires-Dist: lxml (>=6.0.0)
 Requires-Dist: matplotlib (>=3.10.3)
 Requires-Dist: mpmath (>=1.3.0)
 Requires-Dist: numexpr (>=2.11.0,<3.0.0)
-Requires-Dist: python-calamine (>=0.3.2)
+Requires-Dist: python-calamine (>=0.4.0)
 Requires-Dist: ruamel-yaml (>=0.18.14)
-Requires-Dist: scipy (>=1.15.3)
+Requires-Dist: scipy (>=1.16.0)
 Requires-Dist: sympy (>=1.14.0)
 Requires-Dist: types-beautifulsoup4 (>=4.12.0.20250516)
 Requires-Dist: urllib3 (>=2.5.0)

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/pyproject.toml

@@ -15,7 +15,7 @@ keywords = [
     "upward pricing pressure",
     "GUPPI",
 ]
-version = "2025.739425.0"
+version = "2025.739439.3"
 requires-python = ">=3.12,<4.0"
 
 # Classifiers list: https://pypi.org/classifiers/
@@ -40,13 +40,13 @@ dependencies = [
     "h5py>=3.14.0",
     "jinja2>=3.1.6",
     "joblib>=1.5.1",
-    "lxml>=5.4.0",
+    "lxml>=6.0.0",
     "matplotlib>=3.10.3",
     "mpmath>=1.3.0",
     "numexpr (>=2.11.0,<3.0.0)",
-    "python-calamine>=0.3.2",
+    "python-calamine>=0.4.0",
     "ruamel-yaml>=0.18.14",
-    "scipy>=1.15.3",
+    "scipy>=1.16.0",
     "sympy>=1.14.0",
     "types-beautifulsoup4>=4.12.0.20250516",
     "urllib3>=2.5.0",
@@ -67,18 +67,18 @@ sphinx-autoapi = ">=3.6.0"
 sphinx-autodoc-typehints = ">=3.2.0"
 sphinx-immaterial = ">=0.13.5"
 linuxdoc = ">=20240924"
-ipython = ">=9.3.0"
+ipython = ">=9.4.0"
 ipython-pygments-lexers = ">=1.1.1"
 
 [tool.poetry.group.lint.dependencies]
-ruff = ">=0.12.0"
+ruff = ">=0.12.2"
 mypy = ">=1.16.1"
 
 [tool.poetry.group.test.dependencies]
 pytest = ">=8.4.1"
 pytest-cov = ">=6.2.1"
-pytest-xdist = ">=3.7.0"
-coverage = ">=7.9.1"
+pytest-xdist = ">=3.8.0"
+coverage = ">=7.9.2"
 
 [tool.poetry.group.other.dependencies]
 semver = ">=3.0.4"
@@ -207,7 +207,7 @@ minversion = "8.0"
 addopts = [
     "--import-mode=importlib",
     "--cov=mergeron",
-    "--cov-report=html:../tests/cov_html",
+    "--cov-report=html:tests/cov_html",
 ]
 filterwarnings = [
     "all",

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/src/mergeron/__init__.py

@@ -15,7 +15,7 @@ from ruamel import yaml
 
 _PKG_NAME: str = Path(__file__).parent.name
 
-VERSION = "2025.739425.0"
+VERSION = "2025.739439.3"
 
 __version__ = VERSION
 

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/src/mergeron/core/guidelines_boundaries.py

@@ -233,7 +233,7 @@ class DiversionRatioBoundary:
     ) -> None:
         if not (isinstance(_value, decimal.Decimal | float) and 0 <= _value <= 1):
             raise ValueError(
-                "Margin-adjusted benchmark share ratio must lie between 0 and 1."
+                "Margin-adjusted benchmark diversion share must lie between 0 and 1."
             )
 
     recapture_ratio: float = field(
@@ -324,7 +324,7 @@ class DiversionRatioBoundary:
 
     def __attrs_post_init__(self, /) -> None:
         """Initialize boundary and area based on other attributes."""
-        share_ratio = critical_share_ratio(
+        share_ratio = critical_diversion_share(
             self.diversion_ratio, r_bar=self.recapture_ratio
         )
 
@@ -403,7 +403,7 @@ def guppi_from_delta(
     )
 
 
-def critical_share_ratio(
+def critical_diversion_share(
     _guppi_bound: float = 0.075,
     /,
     *,
@@ -425,7 +425,7 @@ def critical_share_ratio(
 
     Returns
     -------
-        Critical share ratio (share ratio bound) corresponding to the GUPPI bound
+        Critical diversion share (diversion share bound) corresponding to the GUPPI bound
         for given margin and recapture ratio.
 
     """
@@ -459,7 +459,7 @@ def share_from_guppi(
 
     """
     return gbfn.round_cust(
-        (_d0 := critical_share_ratio(_guppi_bound, m_star=m_star, r_bar=r_bar))
+        (_d0 := critical_diversion_share(_guppi_bound, m_star=m_star, r_bar=r_bar))
         / (1 + _d0)
     )
 

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/src/mergeron/core/guidelines_boundary_functions.py

@@ -228,7 +228,7 @@ def diversion_share_boundary_wtd_avg(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`)
+        Diversion share (:math:`\overline{d} / \overline{r}`)
     _r_val
         recapture ratio
     agg_method
@@ -461,7 +461,7 @@ def diversion_share_boundary_xact_avg(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _r_val
         Recapture ratio
     recapture_form
@@ -590,7 +590,7 @@ def diversion_share_boundary_min(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _r_val
         Recapture ratio.
     recapture_form
@@ -634,7 +634,7 @@ def diversion_share_boundary_max(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _
         Placeholder for recapture ratio included for consistency with other
         share-ratio boundary functions.

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/src/mergeron/core/guidelines_boundary_functions_extra.py

@@ -409,7 +409,7 @@ def diversion_share_boundary_xact_avg_mp(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _r_val
         Recapture ratio
     recapture_form
@@ -534,7 +534,7 @@ def _diversion_share_boundary_wtd_avg_autoroot(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`)
+        Diversion share (:math:`\overline{d} / \overline{r}`)
     _r_val
         recapture ratio
     agg_method

{mergeron-2025.739425.0 → mergeron-2025.739439.3}/src/mergeron/gen/__init__.py

@@ -89,9 +89,9 @@ class SHRDistribution(str, Enameled):
     """Share distribution for merging-firm shares has a higher peak share
 
     By default, shape parameter for merging-firm-share is 2.5, and
-    1.0 for all others. Defining, :attr:`mergeron.ShareSpec.dist_parms`
+    1.0 for all others. Defining, :attr:`.ShareSpec.dist_parms`
     as a vector of shape parameters with length matching
-    that of :attr:`mergeron.ShareSpec.dist_parms` allows flexible specification
+    that of :attr:`.ShareSpec.dist_parms` allows flexible specification
     of Dirichlet-distributed share-data generation.
     """
 
@@ -155,7 +155,7 @@ class ShareSpec:
     A salient feature of market-share specification in this package is that
     the draws represent markets with multiple different firm-counts.
     Firm-counts are unspecified if the share distribution is
-    :attr:`mergeron.SHRDistribution.UNI`, for Dirichlet-distributed market-shares,
+    :attr:`.SHRDistribution.UNI`, for Dirichlet-distributed market-shares,
     the default specification is that firm-counts  vary between
     2 and 7 firms with each value equally likely.
 
@@ -579,14 +579,12 @@ class MarginSampleData:
     mnl_test_array: ArrayBoolean
     """Flags infeasible observations as False and rest as True
 
-    Applying restrictions from Bertrand-Nash oligopoly
-    with MNL demand results in draws of Firm 2 PCM falling
-    outside the feasible interval,:math:`[0, 1]`, depending
-    on the configuration of merging firm shares. Such draws
-    are are flagged as infeasible (False)in :code:`mnl_test_array` while
-    draws with PCM values within the feasible range are
-    flagged as True. Used from filtering-out draws with
-    infeasible PCM.
+    Applying restrictions from Bertrand-Nash oligopoly with MNL demand results
+    in some draws of Firm 2 PCM falling outside the feasible interval, :math:`[0, 1]`
+    for certain combinations of merging firms shares as initially drawn. Such draws
+    are flagged as infeasible (False) in :code:`mnl_test_array` while draws with
+    feaseible PCM values flagged True. This array is used to exclude infeasible draws
+    when imposing MNL demand in simulations.
     """