extern/nushell
1
0
Fork 1
mirror of https://github.com/nushell/nushell.git synced 2024-11-22 16:33:37 +01:00
Code Issues Packages Projects Releases Wiki Activity

Fix Python plugin (missing search terms) (#5083)

Browse Source 
* Add search_terms to Python plugin

* Clean up Python plugin comments
This commit is contained in:
Reilly Wood 2022-04-03 18:00:53 -07:00 committed by GitHub
parent d40109f210
commit c4cfbaec2d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
crates/nu_plugin_python/plugin.py
View File

@ -1,9 +1,9 @@
# Example of using python as script to create plugins for nushell # Example of using a Python script as a Nushell plugin
# #
# The example uses JSON encoding but it should be a similar process using # The example uses JSON encoding but it should be a similar process using
# capnp proto to move data betwee nushell and the plugin. The only difference # Cap'n Proto to move data between Nushell and the plugin. The only difference
# would be that you need to compile the schema file in order have the objects # would be that you need to compile the schema file in order have the objects
# that decode and encode information that is read and written to stdin and stdour # that decode and encode information that is read and written to stdin and stdout
# #
# To register the plugin use: # To register the plugin use:
# register <path-to-py-file> -e json # register <path-to-py-file> -e json
@ -13,12 +13,12 @@
# point to the beginning of the contents vector. We strongly suggest using the span # point to the beginning of the contents vector. We strongly suggest using the span
# found in the plugin call head # found in the plugin call head
# #
# The plugin will be run using the active python implementation. If you are in # The plugin will be run using the active Python implementation. If you are in
# a python environment, that is the python version that is used # a Python environment, that is the Python version that is used
# #
# Note: To keep the plugin simple and without dependencies, the dictionaries that # Note: To keep the plugin simple and without dependencies, the dictionaries that
# represent the data transferred between nushell and the plugin are kept as # represent the data transferred between Nushell and the plugin are kept as
# native python dictionaries. The encoding and decoding process could be improved # native Python dictionaries. The encoding and decoding process could be improved
# by using libraries like pydantic and marshmallow # by using libraries like pydantic and marshmallow
# #
# This plugin uses python3 # This plugin uses python3
@ -29,8 +29,8 @@ import json
def signatures(): def signatures():
""" """
Multiple signatures can be sent to nushell. Each signature will be registered Multiple signatures can be sent to Nushell. Each signature will be registered
as a different plugin function in nushell. as a different plugin function in Nushell.
In your plugin logic you can use the name of the signature to indicate what In your plugin logic you can use the name of the signature to indicate what
operation should be done with the plugin operation should be done with the plugin
@ -39,7 +39,7 @@ def signatures():
"Signature": [ "Signature": [
{ {
"name": "nu-python", "name": "nu-python",
"usage": "Signature test for python", "usage": "Signature test for Python",
"extra_usage": "", "extra_usage": "",
"required_positional": [ "required_positional": [
{ {
@ -95,6 +95,7 @@ def signatures():
"var_id": None, "var_id": None,
}, },
], ],
"search_terms": ["Python", "Example"],
"is_filter": False, "is_filter": False,
"creates_scope": False, "creates_scope": False,
"category": "Experimental", "category": "Experimental",
@ -109,7 +110,7 @@ def process_call(plugin_call):
It should contain: It should contain:
- The name of the call - The name of the call
- The call data which includes the positional and named values - The call data which includes the positional and named values
- The input from the pippeline - The input from the pipeline
Use this information to implement your plugin logic Use this information to implement your plugin logic
""" """
@ -117,7 +118,7 @@ def process_call(plugin_call):
sys.stderr.write(json.dumps(plugin_call, indent=4)) sys.stderr.write(json.dumps(plugin_call, indent=4))
sys.stderr.write("\n") sys.stderr.write("\n")
# Creates a Value of type List that will be encoded and sent to nushell # Creates a Value of type List that will be encoded and sent to Nushell
return { return {
"Value": { "Value": {
"List": { "List": {
@ -402,7 +403,7 @@ def plugin():
sys.stdout.write(json.dumps(response)) sys.stdout.write(json.dumps(response))
else: else:
# Use this error format if you want to return an error back to nushell # Use this error format if you want to return an error back to Nushell
error = { error = {
"Error": { "Error": {
"label": "ERROR from plugin", "label": "ERROR from plugin",