pkl-python 0.1.15__tar.gz → 0.1.17__tar.gz

{pkl_python-0.1.15/src/pkl_python.egg-info → pkl_python-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pkl-python
-Version: 0.1.15
+Version: 0.1.17
 Summary: Python library for Apple's PKL.
 Author-email: Jungwoo Yang <jwyang0213@gmail.com>
 License: MIT License
@@ -35,6 +35,7 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: msgpack>=1.0.8
+Requires-Dist: requests>=2.31.0
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -44,6 +45,7 @@ Requires-Dist: pylint; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: tox; extra == "dev"
+Dynamic: license-file
 
 > [!CAUTION]
 >
@@ -68,6 +70,7 @@ Here's how you can start using `pkl-python` to load a PKL module:
 import pkl
 
 config = pkl.load("path/to/pkl/example_module.pkl")
+config = pkl.loads("a: Int = 1 + 1")
 ```
 
 ### Code Generation
@@ -78,10 +81,6 @@ However, codegen lets you expect contents of pkl files within Python modules.
 pkl-gen-python path/to/pkl/example_module.pkl
 ```
 
-### Status
-* Evaluator API: functional
-* Code Generation: functional, but needs refining
-
 ### TODO
 * [x] (codgen) pip binary installation
 * [ ] (codgen) gatherer depth-first ordering
@@ -89,7 +88,6 @@ pkl-gen-python path/to/pkl/example_module.pkl
 
 
 ## Advanced Features
-For details on the parameters, refer [Message Passing API](https://pkl-lang.org/main/current/bindings-specification/message-passing-api.html).
 
 ```python
 import pkl
@@ -100,6 +98,11 @@ config = pkl.load(None, module_text="a: Int = 1 + 1")
 config = pkl.load("./tests/types.pkl", debug=True)
 ```
 
+### `pkl.load` Parameters Detail
+For details on the parameters, refer
+* [`pkl eval`](https://pkl-lang.org/main/current/pkl-cli/index.html#command-eval)
+* [Message Passing API](https://pkl-lang.org/main/current/bindings-specification/message-passing-api.html).
+
 ### Custom Readers
 It is possible to add module or resource or module readers:
 ```python
@@ -123,7 +126,7 @@ opts = PreconfiguredOptions(
     moduleReaders=[TestModuleReader("customfs", True, True, True)]
 )
 opts.allowedModules.append("customfs:")
-config = pkl.load("./tests/myModule.pkl", evaluator_options=opts)
+config = pkl.load("./tests/pkls/myModule.pkl", evaluator_options=opts)
 ```
 
 ## Appendix

{pkl_python-0.1.15 → pkl_python-0.1.17}/README.md

@@ -21,6 +21,7 @@ Here's how you can start using `pkl-python` to load a PKL module:
 import pkl
 
 config = pkl.load("path/to/pkl/example_module.pkl")
+config = pkl.loads("a: Int = 1 + 1")
 ```
 
 ### Code Generation
@@ -31,10 +32,6 @@ However, codegen lets you expect contents of pkl files within Python modules.
 pkl-gen-python path/to/pkl/example_module.pkl
 ```
 
-### Status
-* Evaluator API: functional
-* Code Generation: functional, but needs refining
-
 ### TODO
 * [x] (codgen) pip binary installation
 * [ ] (codgen) gatherer depth-first ordering
@@ -42,7 +39,6 @@ pkl-gen-python path/to/pkl/example_module.pkl
 
 
 ## Advanced Features
-For details on the parameters, refer [Message Passing API](https://pkl-lang.org/main/current/bindings-specification/message-passing-api.html).
 
 ```python
 import pkl
@@ -53,6 +49,11 @@ config = pkl.load(None, module_text="a: Int = 1 + 1")
 config = pkl.load("./tests/types.pkl", debug=True)
 ```
 
+### `pkl.load` Parameters Detail
+For details on the parameters, refer
+* [`pkl eval`](https://pkl-lang.org/main/current/pkl-cli/index.html#command-eval)
+* [Message Passing API](https://pkl-lang.org/main/current/bindings-specification/message-passing-api.html).
+
 ### Custom Readers
 It is possible to add module or resource or module readers:
 ```python
@@ -76,7 +77,7 @@ opts = PreconfiguredOptions(
     moduleReaders=[TestModuleReader("customfs", True, True, True)]
 )
 opts.allowedModules.append("customfs:")
-config = pkl.load("./tests/myModule.pkl", evaluator_options=opts)
+config = pkl.load("./tests/pkls/myModule.pkl", evaluator_options=opts)
 ```
 
 ## Appendix

{pkl_python-0.1.15 → pkl_python-0.1.17}/pyproject.toml

@@ -19,6 +19,7 @@ classifiers = [
 ]
 dependencies = [
     "msgpack >= 1.0.8",
+    "requests >= 2.31.0",
 ]
 
 [tool.setuptools]

pkl_python-0.1.17/src/pkl/VERSION

@@ -0,0 +1 @@
+0.1.17

{pkl_python-0.1.15 → pkl_python-0.1.17}/src/pkl/__init__.py

@@ -14,23 +14,15 @@ with open(os.path.join(os.path.dirname(__file__), "VERSION"), "r") as _f:
     __version__ = _f.read().strip()
 
 
-class PklDefaultType:
-    def __repr__(self):
-        return "<PklDefault>"
-
-
-PKL_DEFAULT = PklDefaultType()
-
-
 def _search_project_dir(module_path: str) -> str:
     cur_path = Path(module_path).parent.absolute()
+    root_path = cur_path.root
+
     while not (cur_path / "PklProject").exists():
-        cur_path = cur_path.parent
-        if str(cur_path) == "/":
+        if cur_path == cur_path.parent or cur_path == root_path:
             break
+        cur_path = cur_path.parent
 
-    if str(cur_path) == "/":
-        cur_path = Path(module_path).parent
     return str(cur_path.absolute())
 
 
@@ -54,7 +46,7 @@ def load(
     *,
     module_text: Optional[str] = None,
     expr: Optional[str] = None,
-    project_dir: str = PKL_DEFAULT,
+    project_dir: Optional[str] = None,
     evaluator_options: EvaluatorOptions = PreconfiguredOptions(),
     parser=None,
     debug=False,
@@ -69,7 +61,7 @@ def load(
             If None, the module is loaded from the specified URI.
         expr (Optional[str], None): Optionally, a Pkl expression to be evaluated
             within the loaded module. If None, the entire module is evaluated.
-        project_dir (str, PKL_DEFAULT): The project directory to use for this command.
+        project_dir (Optional[str], None): The project directory to use for this command.
             By default, searches up from the working directory for a PklProject file.
         evaluator_options (EvaluatorOptions, PreconfiguredOptions()):
             extra options for evaluator
@@ -88,7 +80,7 @@ def load(
 
     source = _parse_module_uri(module_uri, module_text)
 
-    if project_dir is PKL_DEFAULT:
+    if project_dir is None:
         project_dir = _search_project_dir(str(module_uri))
 
     with EvaluatorManager(debug=debug) as manager:
@@ -102,8 +94,36 @@ def load(
     return config
 
 
+def loads(
+    module_text: Optional[str],
+    *,
+    expr: Optional[str] = None,
+    project_dir: Optional[str] = None,
+    evaluator_options: EvaluatorOptions = PreconfiguredOptions(),
+    parser=None,
+    debug=False,
+    **kwargs,
+):
+    """
+    This function is a specialized version of `load` that defaults `module_uri` to None.
+
+    {load.__doc__}
+    """
+    return load(
+        module_uri=None,
+        module_text=module_text,
+        expr=expr,
+        project_dir=project_dir,
+        evaluator_options=evaluator_options,
+        parser=parser,
+        debug=debug,
+        **kwargs,
+    )
+
+
 __all__ = [
     "load",
+    "loads",
     "Evaluator",
     "EvaluatorManager",
     "EvaluatorOptions",

{pkl_python-0.1.15 → pkl_python-0.1.17/src/pkl_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pkl-python
-Version: 0.1.15
+Version: 0.1.17
 Summary: Python library for Apple's PKL.
 Author-email: Jungwoo Yang <jwyang0213@gmail.com>
 License: MIT License
@@ -35,6 +35,7 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: msgpack>=1.0.8
+Requires-Dist: requests>=2.31.0
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -44,6 +45,7 @@ Requires-Dist: pylint; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: tox; extra == "dev"
+Dynamic: license-file
 
 > [!CAUTION]
 >
@@ -68,6 +70,7 @@ Here's how you can start using `pkl-python` to load a PKL module:
 import pkl
 
 config = pkl.load("path/to/pkl/example_module.pkl")
+config = pkl.loads("a: Int = 1 + 1")
 ```
 
 ### Code Generation
@@ -78,10 +81,6 @@ However, codegen lets you expect contents of pkl files within Python modules.
 pkl-gen-python path/to/pkl/example_module.pkl
 ```
 
-### Status
-* Evaluator API: functional
-* Code Generation: functional, but needs refining
-
 ### TODO
 * [x] (codgen) pip binary installation
 * [ ] (codgen) gatherer depth-first ordering
@@ -89,7 +88,6 @@ pkl-gen-python path/to/pkl/example_module.pkl
 
 
 ## Advanced Features
-For details on the parameters, refer [Message Passing API](https://pkl-lang.org/main/current/bindings-specification/message-passing-api.html).
 
 ```python
 import pkl
@@ -100,6 +98,11 @@ config = pkl.load(None, module_text="a: Int = 1 + 1")
 config = pkl.load("./tests/types.pkl", debug=True)
 ```
 
+### `pkl.load` Parameters Detail
+For details on the parameters, refer
+* [`pkl eval`](https://pkl-lang.org/main/current/pkl-cli/index.html#command-eval)
+* [Message Passing API](https://pkl-lang.org/main/current/bindings-specification/message-passing-api.html).
+
 ### Custom Readers
 It is possible to add module or resource or module readers:
 ```python
@@ -123,7 +126,7 @@ opts = PreconfiguredOptions(
     moduleReaders=[TestModuleReader("customfs", True, True, True)]
 )
 opts.allowedModules.append("customfs:")
-config = pkl.load("./tests/myModule.pkl", evaluator_options=opts)
+config = pkl.load("./tests/pkls/myModule.pkl", evaluator_options=opts)
 ```
 
 ## Appendix

{pkl_python-0.1.15 → pkl_python-0.1.17}/src/pkl_python.egg-info/requires.txt

@@ -1,4 +1,5 @@
 msgpack>=1.0.8
+requests>=2.31.0
 
 [dev]
 pre-commit

{pkl_python-0.1.15 → pkl_python-0.1.17}/tests/test_load.py

@@ -5,6 +5,11 @@ def test_load():
     _ = pkl.load("./tests/pkls/types.pkl")
 
 
+def test_loads():
+    config = pkl.loads("a: Int = 1 + 1")
+    assert config.a == 2
+
+
 def test_load_expr():
     config = pkl.load("./tests/pkls/types.pkl", expr="datasize")
     assert config.__class__.__name__ == "DataSize"

pkl_python-0.1.15/src/pkl/VERSION

@@ -1 +0,0 @@
-0.1.15