add %there pin command

CHANGELOG.rst

@@ -5,6 +5,7 @@ Changelog
 -----
 
 * Fixed config loss when updating on Android
+* Added *pin* command: create script shortcut
 * Allow to start server again if exception occur
 * UI changes:
 

pythonhere/magic_here/shortcuts.py

@@ -21,6 +21,11 @@
 sys.stderr.write(encoded_screenshot())
 """
 
+PIN_COMMAND_TEMPLATE = """
+from android_here import pin_shortcut
+pin_shortcut(script="{script}", label="{label}")
+"""
+
 
 @there_code_shortcut
 @click.option(
@@ -69,3 +74,13 @@ def screenshot(ctx, width, output):
         output.close()
 
     display(img)
+
+
+@there_code_shortcut
+@click.option("-l", "--label", type=str, default="", help="Label for shortcut")
+@click.argument("script", nargs=1)
+def pin(code: str, script: str, label: str) -> str:  # pylint: disable=unused-argument
+    """Create pinned shortcut to run a Python script."""
+    if not label:
+        label = script.split("/")[-1]
+    return PIN_COMMAND_TEMPLATE.format(script=script, label=label)

tests/test_android_here.py

@@ -1,5 +1,4 @@
 import pytest
-from pathlib import Path
 
 
 @pytest.mark.parametrize(

tests/test_magic.py

@@ -38,3 +38,25 @@ async def test_screenshot_saved_to_file(tmpdir, app_instance, call_there_group):
     assert not os.path.exists(output)
     call_there_group(["screenshot", "-o", output], "")
     assert os.path.exists(output)
+
+
+@pytest.mark.asyncio
+async def test_pin_command_pin_shortcut_called(mocker, capfd, mocked_android_modules, call_there_group,
+                                               test_py_script):
+    pin_shortcut = mocker.patch("android_here.pin_shortcut")
+    call_there_group(["pin", test_py_script, "--label", "Test label"], "")
+    captured = capfd.readouterr()
+    assert not captured.out and not captured.err
+
+    pin_shortcut.assert_called_once_with(script=test_py_script, label="Test label")
+
+
+@pytest.mark.asyncio
+async def test_pin_command_default_label(mocker, capfd, mocked_android_modules, call_there_group,
+                                         test_py_script):
+    pin_shortcut = mocker.patch("android_here.pin_shortcut")
+    call_there_group(["pin", test_py_script], "")
+    captured = capfd.readouterr()
+    assert not captured.out and not captured.err
+
+    pin_shortcut.assert_called_once_with(script=test_py_script, label="test.py")