pyglove 0.4.5.dev202412310809__py3-none-any.whl → 0.4.5.dev202501030808__py3-none-any.whl

pyglove/core/__init__.py

@@ -323,6 +323,12 @@ views.html.controls = controls
 
 from pyglove.core import io
 
+#
+# Symbols from `coding` sub-module.
+#
+#
+
+from pyglove.core import coding
 
 #
 # Symbols from `logging.py`.

pyglove/core/coding/__init__.py

@@ -0,0 +1,26 @@
+# Copyright 2024 The PyGlove Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# pylint: disable=line-too-long
+"""Code generation utilities."""
+
+# pylint: enable=line-too-long
+# pylint: disable=g-bad-import-order
+# pylint: disable=g-importing-member
+
+from pyglove.core.coding.function_generation import NO_TYPE_ANNOTATION
+from pyglove.core.coding.function_generation import make_function
+
+# pylint: disable=line-too-long
+# pylint: enable=g-bad-import-order
+# pylint: enable=g-importing-member

pyglove/core/{object_utils/codegen.py → coding/function_generation.py}

@@ -11,10 +11,16 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-"""Utilities for code generation."""
+"""Utilities for function generation."""
 
 from typing import Any, Dict, List, Optional
-from pyglove.core.object_utils.missing import MISSING_VALUE
+
+
+class _NoTypeAnnotation:
+  """Placeholder for no type annotation."""
+
+
+NO_TYPE_ANNOTATION = _NoTypeAnnotation()
 
 
 def make_function(
@@ -24,11 +30,11 @@ def make_function(
     *,
     exec_globals: Optional[Dict[str, Any]] = None,
     exec_locals: Optional[Dict[str, Any]] = None,
-    return_type: Any = MISSING_VALUE):
+    return_type: Any = NO_TYPE_ANNOTATION):
   """Creates a function dynamically from source."""
   if exec_locals is None:
     exec_locals = {}
-  if return_type != MISSING_VALUE:
+  if return_type != NO_TYPE_ANNOTATION:
     exec_locals['_return_type'] = return_type
     return_annotation = '->_return_type'
   else:

pyglove/core/{object_utils/codegen_test.py → coding/function_generation_test.py}

@@ -1,4 +1,4 @@
-# Copyright 2022 The PyGlove Authors
+# Copyright 2024 The PyGlove Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -11,20 +11,18 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-"""Tests for pyglove.object_utils.codegen."""
-
 import inspect
 import typing
 import unittest
 
-from pyglove.core.object_utils import codegen
+from pyglove.core.coding import function_generation
 
 
 class MakeFunctionTest(unittest.TestCase):
-  """Tests for codegen.make_function."""
+  """Tests for function_generation.make_function."""
 
   def test_make_function_with_type_annotations(self):
-    func = codegen.make_function(
+    func = function_generation.make_function(
         'foo',
         ['x: typing.Optional[int]', 'y: int = 0'],
         ['return x + y'],
@@ -41,7 +39,7 @@ class MakeFunctionTest(unittest.TestCase):
     self.assertEqual(func(1, 2), 3)
 
   def test_make_function_without_type_annotations(self):
-    func = codegen.make_function(
+    func = function_generation.make_function(
         'foo',
         ['x', 'y'],
         ['return x + y'])

pyglove/core/object_utils/__init__.py

@@ -126,9 +126,6 @@ from pyglove.core.object_utils.common_traits import Functor
 from pyglove.core.object_utils.common_traits import explicit_method_override
 from pyglove.core.object_utils.common_traits import ensure_explicit_method_override
 
-# Handling code generation.
-from pyglove.core.object_utils.codegen import make_function
-
 # Handling thread local values.
 from pyglove.core.object_utils.thread_local import thread_local_value_scope
 from pyglove.core.object_utils.thread_local import thread_local_has

pyglove/core/symbolic/object.py

@@ -19,6 +19,7 @@ import inspect
 import typing
 from typing import Any, Dict, Iterator, List, Optional, Sequence, Union
 
+from pyglove.core import coding
 from pyglove.core import object_utils
 from pyglove.core import typing as pg_typing
 from pyglove.core.symbolic import base
@@ -504,7 +505,7 @@ class Object(base.Symbolic, metaclass=ObjectMeta):
   def _create_sym_attribute(cls, attr_name, field):
     """Customizable trait: template of single symbolic attribute."""
     return property(
-        object_utils.make_function(
+        coding.make_function(
             attr_name,
             ['self'],
             [f"return self.sym_inferred('{attr_name}')"],

pyglove/core/typing/callable_signature.py

@@ -21,6 +21,7 @@ import types
 import typing
 from typing import Any, Callable, Dict, List, Optional, Union
 
+from pyglove.core import coding
 from pyglove.core import object_utils
 from pyglove.core.typing import class_schema
 from pyglove.core.typing import key_specs as ks
@@ -753,14 +754,15 @@ class Signature(object_utils.Formattable):
       )
 
     # Generate function.
-    fn = object_utils.make_function(
+    fn = coding.make_function(
         self.name,
         args=args,
         body=body,
         exec_globals=exec_globals,
         exec_locals=exec_locals,
         return_type=getattr(
-            self.return_value, 'annotation', object_utils.MISSING_VALUE))
+            self.return_value, 'annotation', coding.NO_TYPE_ANNOTATION)
+    )
     fn.__module__ = self.module_name
     fn.__name__ = self.name
     fn.__qualname__ = self.qualname

{pyglove-0.4.5.dev202412310809.dist-info → pyglove-0.4.5.dev202501030808.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyglove
-Version: 0.4.5.dev202412310809
+Version: 0.4.5.dev202501030808
 Summary: PyGlove: A library for manipulating Python objects.
 Home-page: https://github.com/google/pyglove
 Author: PyGlove Authors

{pyglove-0.4.5.dev202412310809.dist-info → pyglove-0.4.5.dev202501030808.dist-info}/RECORD

@@ -1,7 +1,10 @@
 pyglove/__init__.py,sha256=YPUWALRDu4QuI7N3TUmVaVr513hUt0qXrjY582I1q5c,1352
-pyglove/core/__init__.py,sha256=FDGkzVlLR0FohA8_ZBFrxhEYxQWAGKe72mjUDjE_SDY,9293
+pyglove/core/__init__.py,sha256=pEvIMPH7pu03Ir1rnLWCuWbriobwBTYACP22fMIg-8U,9368
 pyglove/core/logging.py,sha256=Sr5nLyUQmc4CAEYAq8qbP3ghpjmpz2sOuhq2A0tgQ6I,2456
 pyglove/core/logging_test.py,sha256=QM59tCAFOUKm4gM6ef_9eG1AvSGEYRDLrrprUQyslcA,1956
+pyglove/core/coding/__init__.py,sha256=nVKjJQYhvzJNr1zj0GuCsz_ltGLqhQEtBQj0zPiOkqA,998
+pyglove/core/coding/function_generation.py,sha256=2fCqcdcizVYtGYE6QGpw5m1kuH9Fp0OF4BjyJ4en6tw,1636
+pyglove/core/coding/function_generation_test.py,sha256=kbSwmZF8Vog0R0OTSpuzPblEbMLoRJ1TigeIrwDhHS8,2161
 pyglove/core/detouring/__init__.py,sha256=ck_n2VSuU31HNVYQkbG4Zvnx90mNYtSVc2StN3rXbU8,1891
 pyglove/core/detouring/class_detour.py,sha256=ejuUr7UfRU3l9PrDxD0dpKmt2iqdDU6liHdebA1jEfQ,13312
 pyglove/core/detouring/class_detour_test.py,sha256=9aAK6qPiT0_HJe5oUpqMVTpoHv0wr_h6c4gWYKMTJoM,5507
@@ -47,9 +50,7 @@ pyglove/core/io/file_system.py,sha256=ps5SVckgFsrZk4xCu37iXkeIrvydLzLs9NsF14VzEc
 pyglove/core/io/file_system_test.py,sha256=FX0ySuh_Xcg1RO68do7ikD4pvslKUzfSpwZ6P4wIP7c,8691
 pyglove/core/io/sequence.py,sha256=7QWMGXPtJzHyGPgqkT3yJ01FxKJ4mP4lF5HRDiIHNbQ,8165
 pyglove/core/io/sequence_test.py,sha256=6tmnS7frBuDR8ussT5jugeh23TDsPDrDnbfxHh81Gy4,3891
-pyglove/core/object_utils/__init__.py,sha256=bFyt-_uNzpOjJGDfYFTRP1kV6rL4du9xGx_OaFMcIxI,8758
-pyglove/core/object_utils/codegen.py,sha256=HQlpjz42oh_2lrGSflwuAcEneE9Bv8pgPahQzvJm1KI,1568
-pyglove/core/object_utils/codegen_test.py,sha256=ThPVyE805plNvM8vwlDxMrcjV-GGdDgbBLSqSOpCvJ0,2166
+pyglove/core/object_utils/__init__.py,sha256=i-WXhMKZWV2yC2u7TpzhIT9XraTdx8BzT5pqdfaK_yc,8669
 pyglove/core/object_utils/common_traits.py,sha256=PWxOgPhG5H60ZwfO8xNAEGRjFUqqDZQBWQYomOfvdy8,3640
 pyglove/core/object_utils/common_traits_test.py,sha256=wIeVsF3kon9K0Kbblcaib9hBJeZ76LyGZDD-5A1BD9w,1182
 pyglove/core/object_utils/docstr_utils.py,sha256=5BY40kXozPKVGOB0eN8jy1P5_GHIzqFJ9FXAu_kzxaw,5119
@@ -98,7 +99,7 @@ pyglove/core/symbolic/inferred.py,sha256=jGCKXLkYGDs-iUflR57UWrCrOQIpkpv5kHVyj-J
 pyglove/core/symbolic/inferred_test.py,sha256=G6uPykONcChvs6vZujXHSWaYfjewLTVBscMqzzKNty0,1270
 pyglove/core/symbolic/list.py,sha256=63v4Ph0FdkoCDj1FjwcmjUHGZSJLBLxaTKcGg7PdghE,30345
 pyglove/core/symbolic/list_test.py,sha256=yHYAJhe_EYwtU9p8eDztSXNBjnAGKe0UDN5U6S-xDr8,60627
-pyglove/core/symbolic/object.py,sha256=hy2waFCo3NFPzymXbDHGBUqW2EhEmF9fE4Crp9Hnewc,42137
+pyglove/core/symbolic/object.py,sha256=cf9GELfLEZSESxQU9BlA06yTtv2XWsnwXgONjkfOzNo,42163
 pyglove/core/symbolic/object_test.py,sha256=WNp8lB202EMn7RDJbMAV_VVdtjg9MB3HKTgaJN8GTuw,93617
 pyglove/core/symbolic/origin.py,sha256=5bH1jZvFHY5jwku32vDm8Bj2i-buv-YNuzOOsA5GlSA,6177
 pyglove/core/symbolic/origin_test.py,sha256=dU_ZGrGDetM_lYVMn3wQO0d367_t_t8eESe3NrKPBNE,3159
@@ -123,7 +124,7 @@ pyglove/core/typing/annotation_conversion.py,sha256=rNYOyC0ury-kiDpxRqABz-E3ll7r
 pyglove/core/typing/annotation_conversion_test.py,sha256=tZheqbLWbr76WBIDOplLtY3yznMc4m9u7KCznWEJdEs,11660
 pyglove/core/typing/callable_ext.py,sha256=1OM770LhT46qjhriKEgyDHp6whAGG0inobPbFUM2J8k,9218
 pyglove/core/typing/callable_ext_test.py,sha256=TnWKU4_ZjvpbHZFtFHgFvCMDiCos8VmLlODcM_7Xg8M,10156
-pyglove/core/typing/callable_signature.py,sha256=MAH7isqhxXp8QdMw8jqxqWbsKs2jMh7uJlFIBL0tTQk,27242
+pyglove/core/typing/callable_signature.py,sha256=35cYIWMUR0Qr8gkbsx1kf_HcWxNPiwDvV3oQMULsbDs,27272
 pyglove/core/typing/callable_signature_test.py,sha256=BYdn0i7nd0ITkACnR1RNtnmpXiE0MfpBrlQ7-yWSxYE,25223
 pyglove/core/typing/class_schema.py,sha256=ls_pg4MgwvV4s5gLnsjqDkiP3O2Fg0sWdjL1NVD-iyE,53273
 pyglove/core/typing/class_schema_test.py,sha256=1DvJTss20jzjruTnB4CuW6ozO6Hcs6TIN-xsJzEQkCM,29244
@@ -196,8 +197,8 @@ pyglove/ext/scalars/randoms.py,sha256=LkMIIx7lOq_lvJvVS3BrgWGuWl7Pi91-lA-O8x_gZs
 pyglove/ext/scalars/randoms_test.py,sha256=nEhiqarg8l_5EOucp59CYrpO2uKxS1pe0hmBdZUzRNM,2000
 pyglove/ext/scalars/step_wise.py,sha256=IDw3tuTpv0KVh7AN44W43zqm1-E0HWPUlytWOQC9w3Y,3789
 pyglove/ext/scalars/step_wise_test.py,sha256=TL1vJ19xVx2t5HKuyIzGoogF7N3Rm8YhLE6JF7i0iy8,2540
-pyglove-0.4.5.dev202412310809.dist-info/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
-pyglove-0.4.5.dev202412310809.dist-info/METADATA,sha256=CqEnw85uluzvOYd7Lf_2aSLOjxGm_XWf5f1Lg26xsso,6828
-pyglove-0.4.5.dev202412310809.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-pyglove-0.4.5.dev202412310809.dist-info/top_level.txt,sha256=wITzJSKcj8GZUkbq-MvUQnFadkiuAv_qv5qQMw0fIow,8
-pyglove-0.4.5.dev202412310809.dist-info/RECORD,,
+pyglove-0.4.5.dev202501030808.dist-info/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
+pyglove-0.4.5.dev202501030808.dist-info/METADATA,sha256=WtNne1_ODAbjcjCcuix0uIdfDwv7PMbcwCmORPcWiYI,6828
+pyglove-0.4.5.dev202501030808.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+pyglove-0.4.5.dev202501030808.dist-info/top_level.txt,sha256=wITzJSKcj8GZUkbq-MvUQnFadkiuAv_qv5qQMw0fIow,8
+pyglove-0.4.5.dev202501030808.dist-info/RECORD,,