pkl-python 0.1.10

Python library for Apple's PKL.

pkl-python - PKL Language Python Binding

Python binding for Apple's Pkl language.

Status

• Evaluator API: fully functional
• Code Generation: in development

TODO

• (codgen) binary installation feature
• (codgen) fix class order
• (codgen) clean up code

Installation

pip install pkl-python

Usage

Basic Usage

Here's how you can start using PKLL to load a PKL module:

import pkl

config = pkl.load("path/to/pkl/example_module.pkl")
print(config)

Advanced Features

For details on the parameters, refer Message Passing API.

from pkl import load

# Advanced loading with custom environment and properties
result = load(
    "path/to/pkl/example_module.pkl"
    env={"CUSTOM_ENV": "value"},
    properties={"custom.property": "value"}
)
print(result)

Custom Handler

It is possible to add custom resources or module handler:

import pkl
from pkl.handler import (
    ListResponse,
    ReadModuleResponse,
    ReadResourceResponse,
    ResourcesHandler,
)
from pkl.msgapi import ClientResourceReader

class CustomModuleHandler(ResourcesHandler):
    def list_response(self, uri: str) -> ListResponse:
        return ListResponse(
            pathElements=[{"name": "foo.pkl", "isDirectory": False}]
        )

    def read_response(self, uri: str) -> ReadResourceResponse:
        return ReadModuleResponse(
            contents="foo = 1",
        )

config = pkl.load(
    "./tests/myModule.pkl",
    allowedModules=["pkl:", "repl:", "file:", "customfs:"],
    clientModuleReaders=[
        {
            "scheme": "customfs",
            "hasHierarchicalUris": True,
            "isGlobbable": True,
            "isLocal": True,
        }
    ],
    debug=True,
    module_handler=CustomModuleHandler(),
)

Contributing

Contributions are welcome! If you'd like to contribute, please fork the repository and submit a pull request. For major changes, please open an issue first to discuss what you would like to change.

License

PKL is released under the MIT License. See the LICENSE file for more details.

Contact

For support or to contribute, please contact [e-mail] or visit our GitHub repository to report issues or submit pull requests.