From 0bf4cf248b6161b6e764b47ab10a18f90639f807 Mon Sep 17 00:00:00 2001
From: jeremiedbb <jeremiedbb@yahoo.fr>
Date: Tue, 14 Mar 2023 00:18:57 +0100
Subject: [PATCH] generate warning for tempita files

---
 sklearn/_build_utils/__init__.py      |  7 +++++++
 sklearn/_loss/_loss.pyx.tp            |  5 -----
 sklearn/linear_model/_sag_fast.pyx.tp | 14 +-------------
 sklearn/linear_model/_sgd_fast.pyx.tp |  8 +-------
 sklearn/utils/_seq_dataset.pxd.tp     | 12 ++++--------
 sklearn/utils/_seq_dataset.pyx.tp     | 13 +++++--------
 sklearn/utils/_weight_vector.pxd.tp   |  2 --
 sklearn/utils/_weight_vector.pyx.tp   |  2 --
 8 files changed, 18 insertions(+), 45 deletions(-)

diff --git a/sklearn/_build_utils/__init__.py b/sklearn/_build_utils/__init__.py
index d539c0c06ecc1..b31b4c4f67078 100644
--- a/sklearn/_build_utils/__init__.py
+++ b/sklearn/_build_utils/__init__.py
@@ -103,5 +103,12 @@ def gen_from_templates(templates):
 
             tmpl_ = Tempita.sub(tmpl)
 
+            warn_msg = (
+                "# WARNING: Do not edit this file directly.\n"
+                f"# It is automatically generated from {template!r}.\n"
+                "# Changes must be made there.\n\n"
+            )
+
             with open(outfile, "w") as f:
+                f.write(warn_msg)
                 f.write(tmpl_)
diff --git a/sklearn/_loss/_loss.pyx.tp b/sklearn/_loss/_loss.pyx.tp
index efb40d678e3f6..ae4fee45540db 100644
--- a/sklearn/_loss/_loss.pyx.tp
+++ b/sklearn/_loss/_loss.pyx.tp
@@ -181,11 +181,6 @@ class_list = [
      "cgradient_half_binomial", "cgrad_hess_half_binomial"),
 ]
 }}
-"""
-WARNING: Do not edit `sklearn/_loss/_loss.pyx` file directly, as it is generated from
-`sklearn/_loss/_loss.pyx.tp`. Changes must be made there.
-"""
-#------------------------------------------------------------------------------
 
 # Design:
 # See https://github.com/scikit-learn/scikit-learn/issues/15123 for reasons.
diff --git a/sklearn/linear_model/_sag_fast.pyx.tp b/sklearn/linear_model/_sag_fast.pyx.tp
index 5449d5bf4ad02..97bf3020d6602 100644
--- a/sklearn/linear_model/_sag_fast.pyx.tp
+++ b/sklearn/linear_model/_sag_fast.pyx.tp
@@ -24,19 +24,7 @@ dtypes = [('64', 'double', 'np.float64'),
           ('32', 'float', 'np.float32')]
 
 }}
-
-#------------------------------------------------------------------------------
-
-# Authors: Danny Sullivan <dbsullivan23@gmail.com>
-#          Tom Dupre la Tour <tom.dupre-la-tour@m4x.org>
-#          Arthur Mensch <arthur.mensch@m4x.org
-#
-# License: BSD 3 clause
-
-"""
-SAG and SAGA implementation
-WARNING: Do not edit .pyx file directly, it is generated from .pyx.tp
-"""
+"""SAG and SAGA implementation"""
 
 import numpy as np
 from libc.math cimport fabs, exp, log
diff --git a/sklearn/linear_model/_sgd_fast.pyx.tp b/sklearn/linear_model/_sgd_fast.pyx.tp
index 0c98dc184ba74..2938bd0daf3f3 100644
--- a/sklearn/linear_model/_sgd_fast.pyx.tp
+++ b/sklearn/linear_model/_sgd_fast.pyx.tp
@@ -24,13 +24,7 @@ dtypes = [
 ]
 
 }}
-
-#------------------------------------------------------------------------------
-
-"""
-SGD implementation
-WARNING: Do not edit .pyx file directly, it is generated from .pyx.tp
-"""
+"""SGD implementation"""
 
 from cython cimport floating
 import numpy as np
diff --git a/sklearn/utils/_seq_dataset.pxd.tp b/sklearn/utils/_seq_dataset.pxd.tp
index e6c46a7ac73ca..7349cfad4a452 100644
--- a/sklearn/utils/_seq_dataset.pxd.tp
+++ b/sklearn/utils/_seq_dataset.pxd.tp
@@ -17,20 +17,16 @@ dtypes = [('64', 'double'),
           ('32', 'float')]
 
 }}
-{{for name_suffix, c_type in dtypes}}
-
-#------------------------------------------------------------------------------
-
-"""
-Dataset abstractions for sequential data access.
-WARNING: Do not edit .pxd file directly, it is generated from .pxd.tp
-"""
+"""Dataset abstractions for sequential data access."""
 
 cimport numpy as cnp
 
 # SequentialDataset and its two concrete subclasses are (optionally randomized)
 # iterators over the rows of a matrix X and corresponding target values y.
 
+{{for name_suffix, c_type in dtypes}}
+
+#------------------------------------------------------------------------------
 
 cdef class SequentialDataset{{name_suffix}}:
     cdef int current_index
diff --git a/sklearn/utils/_seq_dataset.pyx.tp b/sklearn/utils/_seq_dataset.pyx.tp
index ae302b7565fb5..9e3355e2ef3cb 100644
--- a/sklearn/utils/_seq_dataset.pyx.tp
+++ b/sklearn/utils/_seq_dataset.pyx.tp
@@ -22,14 +22,7 @@ dtypes = [('64', 'double', 'np.float64'),
           ('32', 'float', 'np.float32')]
 
 }}
-{{for name_suffix, c_type, np_type in dtypes}}
-
-#------------------------------------------------------------------------------
-
-"""
-Dataset abstractions for sequential data access.
-WARNING: Do not edit .pyx file directly, it is generated from .pyx.tp
-"""
+"""Dataset abstractions for sequential data access."""
 
 cimport cython
 from libc.limits cimport INT_MAX
@@ -40,6 +33,10 @@ cnp.import_array()
 
 from ._random cimport our_rand_r
 
+{{for name_suffix, c_type, np_type in dtypes}}
+
+#------------------------------------------------------------------------------
+
 cdef class SequentialDataset{{name_suffix}}:
     """Base class for datasets with sequential data access.
 
diff --git a/sklearn/utils/_weight_vector.pxd.tp b/sklearn/utils/_weight_vector.pxd.tp
index f5e3e4af5aefd..075b0f5250d1b 100644
--- a/sklearn/utils/_weight_vector.pxd.tp
+++ b/sklearn/utils/_weight_vector.pxd.tp
@@ -18,8 +18,6 @@ dtypes = [('64', 'double'),
 
 }}
 
-# WARNING: Do not edit this .pyx file directly, it is generated from its .pyx.tp
-
 {{for name_suffix, c_type in dtypes}}
 
 cdef class WeightVector{{name_suffix}}(object):
diff --git a/sklearn/utils/_weight_vector.pyx.tp b/sklearn/utils/_weight_vector.pyx.tp
index 307546fcfb0a2..bd2ac79a6764f 100644
--- a/sklearn/utils/_weight_vector.pyx.tp
+++ b/sklearn/utils/_weight_vector.pyx.tp
@@ -26,8 +26,6 @@ dtypes = [('64', 'double', 1e-9),
 #
 # License: BSD 3 clause
 
-# WARNING: Do not edit this .pyx file directly, it is generated from its .pyx.tp
-
 cimport cython
 from libc.limits cimport INT_MAX
 from libc.math cimport sqrt