diff --git a/Package_html_media.mk b/Package_html_media.mk
index 6258055767..25ddb7910b 100644
--- a/Package_html_media.mk
+++ b/Package_html_media.mk
@@ -349,6 +349,7 @@ $(eval $(call gb_Package_add_files_with_dir,helpcontent2_html_media,$(LIBO_SHARE
helpimg/starmath/un21214.svg \
helpimg/starmath/un21215.svg \
helpimg/starmath/un21221.svg \
+ helpimg/python/python_interactive_console.png \
helpimg/python/python_shell.png \
helpimg/sw_paste_range.png \
helpimg/sw_signatureline01.png \
diff --git a/source/media/helpimg/python/python_interactive_console.png b/source/media/helpimg/python/python_interactive_console.png
new file mode 100644
index 0000000000..94c9452b24
Binary files /dev/null and b/source/media/helpimg/python/python_interactive_console.png differ
diff --git a/source/text/sbasic/python/python_shell.xhp b/source/text/sbasic/python/python_shell.xhp
index 0b724b88d4..745b22d18d 100644
--- a/source/text/sbasic/python/python_shell.xhp
+++ b/source/text/sbasic/python/python_shell.xhp
@@ -20,18 +20,23 @@
Python Interactive Shell
- Running Python Interactive Console
+ Running Python Interactive Console
The Python interactive console, also known as Python interpreter or Python shell, provides programmers with a quick way to execute commands and try out and test code without creating a file. UNO objects introspection as well as %PRODUCTNAME Python modules documentation can be obtained from the terminal.
- Using a Basic macro:
+
+ From a full-featured %PRODUCTNAME installed package, use either Basic or Python:
+
Using a Basic macro
Sub interpreter_console
+ Const UNIX = 4
ps = CreateUnoService("com.sun.star.util.PathSettings")
install_path = ConvertFromURL(ps.Module)
- Shell( install_path + GetPathSeparator() + "python" )
+ cmd = IIF(GetGuiType()=UNIX,"x-terminal-emulator -e ","")
+ Shell(cmd + install_path + GetPathSeparator() + "python" )
End Sub
- Using a Python macro:
+
+ Using a Python macro
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
@@ -47,13 +52,30 @@
subprocess.Popen(pgm) # Start Python interactive Shell
- Usage:
+ Example output
- Python Interactive Console
+ Python Interactive Console
+
+
+
+
+ Using the Terminal
+ From a %PRODUCTNAME copy included in a GNU/Linux platform, use the terminal as shown:
+ whereis or type terminal commands help locate Python interactive console:
+ user@computer:~$ type -p python3 /usr/bin/python3 user@computer:~$ /usr/bin/python3 Python 3.7.5 (default, Nov 20 2019, 09:21:52) [GCC 9.2.1 20191008] on linux Type "help", "copyright", "credits" or "license" for more information. >>> import uno >>> dir(uno) ['Any', 'Bool', 'ByteSequence', 'Char', 'Enum', 'PY2', 'Type', '_ConstantGroup', '__builtin__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', '_builtin_import', '_component_context', '_impl_getConstantGroupByName', '_uno_extract_printable_stacktrace', '_uno_import', '_uno_struct__eq__', '_uno_struct__getattr__', '_uno_struct__init__', '_uno_struct__ne__', '_uno_struct__repr__', '_uno_struct__setattr__', '_uno_struct__str__', 'absolutize', 'createUnoStruct', 'fileUrlToSystemPath', 'generateUuid', 'getClass', 'getComponentContext', 'getConstantByName', 'getCurrentContext', 'getTypeByName', 'invoke', 'isInterface', 'os', 'pyuno', 'setCurrentContext', 'six_string_types', 'socket', 'sys', 'systemPathToFileUrl', 'traceback', 'warnings'] >>> exit() user@computer:~$
+
+
+
+ Alternative console
+ Use APSO extension console as an alternative:
+
+ APSO console
-