janito 2.33.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. janito/cli/chat_mode/bindings.py +26 -0
  2. janito/cli/chat_mode/session.py +7 -1
  3. janito/cli/cli_commands/check_tools.py +212 -0
  4. janito/cli/cli_commands/list_plugins.py +52 -43
  5. janito/cli/core/getters.py +3 -0
  6. janito/cli/main_cli.py +9 -12
  7. janito/cli/prompt_core.py +19 -9
  8. janito/drivers/openai/driver.py +1 -0
  9. janito/drivers/zai/driver.py +1 -0
  10. janito/llm/agent.py +30 -17
  11. janito/llm/auth_utils.py +14 -5
  12. janito/llm/cancellation_manager.py +62 -0
  13. janito/llm/driver.py +7 -0
  14. janito/llm/enter_cancellation.py +93 -0
  15. janito/plugin_system/__init__.py +10 -0
  16. janito/{plugins → plugin_system}/base.py +5 -2
  17. janito/{plugins/core_loader_fixed.py → plugin_system/core_loader.py} +45 -26
  18. janito/plugin_system/core_loader_fixed.py +149 -0
  19. janito/plugins/__init__.py +31 -12
  20. janito/plugins/auto_loader_fixed.py +12 -11
  21. janito/plugins/builtin.py +15 -1
  22. janito/plugins/core/__init__.py +7 -0
  23. janito/plugins/core/codeanalyzer/__init__.py +43 -0
  24. janito/plugins/core/filemanager/__init__.py +124 -0
  25. janito/plugins/core/filemanager/tools/create_file.py +87 -0
  26. janito/plugins/core/filemanager/tools/replace_text_in_file.py +270 -0
  27. janito/plugins/core/imagedisplay/__init__.py +14 -0
  28. janito/plugins/core/imagedisplay/plugin.py +51 -0
  29. janito/plugins/core/imagedisplay/tools/__init__.py +1 -0
  30. janito/plugins/core/imagedisplay/tools/show_image.py +83 -0
  31. janito/{tools/adapters/local → plugins/core/imagedisplay/tools}/show_image_grid.py +13 -5
  32. janito/plugins/core/system/__init__.py +23 -0
  33. janito/plugins/core_adapter.py +11 -9
  34. janito/plugins/dev/__init__.py +7 -0
  35. janito/plugins/dev/pythondev/__init__.py +37 -0
  36. janito/plugins/dev/visualization/__init__.py +23 -0
  37. janito/plugins/discovery.py +5 -5
  38. janito/plugins/example_plugin.py +108 -0
  39. janito/plugins/manager.py +1 -1
  40. janito/plugins/tools/__init__.py +10 -0
  41. janito/{tools/adapters/local → plugins/tools}/ask_user.py +3 -3
  42. janito/plugins/tools/copy_file.py +87 -0
  43. janito/plugins/tools/core_tools_plugin.py +88 -0
  44. janito/plugins/tools/create_directory.py +70 -0
  45. janito/{tools/adapters/local → plugins/tools}/create_file.py +4 -4
  46. janito/plugins/tools/decorators.py +19 -0
  47. janito/plugins/tools/delete_text_in_file.py +134 -0
  48. janito/{tools/adapters/local → plugins/tools}/fetch_url.py +3 -3
  49. janito/plugins/tools/find_files.py +143 -0
  50. janito/plugins/tools/get_file_outline/__init__.py +7 -0
  51. janito/plugins/tools/get_file_outline/core.py +122 -0
  52. janito/plugins/tools/get_file_outline/java_outline.py +47 -0
  53. janito/plugins/tools/get_file_outline/markdown_outline.py +14 -0
  54. janito/plugins/tools/get_file_outline/python_outline.py +303 -0
  55. janito/plugins/tools/get_file_outline/search_outline.py +36 -0
  56. janito/plugins/tools/move_file.py +131 -0
  57. janito/plugins/tools/open_html_in_browser.py +51 -0
  58. janito/plugins/tools/open_url.py +37 -0
  59. janito/plugins/tools/python_code_run.py +172 -0
  60. janito/plugins/tools/python_command_run.py +171 -0
  61. janito/plugins/tools/python_file_run.py +172 -0
  62. janito/plugins/tools/read_chart.py +259 -0
  63. janito/plugins/tools/read_files.py +58 -0
  64. janito/plugins/tools/remove_directory.py +55 -0
  65. janito/plugins/tools/remove_file.py +58 -0
  66. janito/{tools/adapters/local → plugins/tools}/replace_text_in_file.py +4 -4
  67. janito/plugins/tools/run_bash_command.py +183 -0
  68. janito/plugins/tools/run_powershell_command.py +218 -0
  69. janito/plugins/tools/search_text/__init__.py +7 -0
  70. janito/plugins/tools/search_text/core.py +205 -0
  71. janito/plugins/tools/search_text/match_lines.py +67 -0
  72. janito/plugins/tools/search_text/pattern_utils.py +73 -0
  73. janito/plugins/tools/search_text/traverse_directory.py +145 -0
  74. janito/{tools/adapters/local → plugins/tools}/show_image.py +15 -6
  75. janito/plugins/tools/show_image_grid.py +85 -0
  76. janito/plugins/tools/validate_file_syntax/__init__.py +7 -0
  77. janito/plugins/tools/validate_file_syntax/core.py +114 -0
  78. janito/plugins/tools/validate_file_syntax/css_validator.py +35 -0
  79. janito/plugins/tools/validate_file_syntax/html_validator.py +100 -0
  80. janito/plugins/tools/validate_file_syntax/jinja2_validator.py +50 -0
  81. janito/plugins/tools/validate_file_syntax/js_validator.py +27 -0
  82. janito/plugins/tools/validate_file_syntax/json_validator.py +6 -0
  83. janito/plugins/tools/validate_file_syntax/markdown_validator.py +109 -0
  84. janito/plugins/tools/validate_file_syntax/ps1_validator.py +32 -0
  85. janito/plugins/tools/validate_file_syntax/python_validator.py +5 -0
  86. janito/plugins/tools/validate_file_syntax/xml_validator.py +11 -0
  87. janito/plugins/tools/validate_file_syntax/yaml_validator.py +6 -0
  88. janito/plugins/tools/view_file.py +172 -0
  89. janito/plugins/ui/__init__.py +7 -0
  90. janito/plugins/ui/userinterface/__init__.py +16 -0
  91. janito/plugins/ui/userinterface/tools/ask_user.py +110 -0
  92. janito/plugins/web/__init__.py +7 -0
  93. janito/plugins/web/webtools/__init__.py +33 -0
  94. janito/plugins/web/webtools/tools/fetch_url.py +458 -0
  95. janito/tools/__init__.py +31 -7
  96. janito/tools/adapters/__init__.py +6 -1
  97. janito/tools/adapters/local/__init__.py +7 -70
  98. janito/tools/cli_initializer.py +88 -0
  99. janito/tools/function_adapter.py +93 -16
  100. janito/tools/initialize.py +70 -0
  101. {janito-2.33.0.dist-info → janito-3.1.0.dist-info}/METADATA +1 -2
  102. {janito-2.33.0.dist-info → janito-3.1.0.dist-info}/RECORD +146 -76
  103. janito/plugins/core_loader.py +0 -120
  104. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/get_file_outline/__init__.py +0 -0
  105. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/get_file_outline/core.py +0 -0
  106. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/get_file_outline/java_outline.py +0 -0
  107. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/get_file_outline/markdown_outline.py +0 -0
  108. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/get_file_outline/python_outline.py +0 -0
  109. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/get_file_outline/search_outline.py +0 -0
  110. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/search_text/__init__.py +0 -0
  111. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/search_text/core.py +0 -0
  112. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/search_text/match_lines.py +0 -0
  113. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/search_text/pattern_utils.py +0 -0
  114. /janito/{tools/adapters/local → plugins/core/codeanalyzer/tools}/search_text/traverse_directory.py +0 -0
  115. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/copy_file.py +0 -0
  116. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/create_directory.py +0 -0
  117. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/delete_text_in_file.py +0 -0
  118. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/find_files.py +0 -0
  119. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/move_file.py +0 -0
  120. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/read_files.py +0 -0
  121. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/remove_directory.py +0 -0
  122. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/remove_file.py +0 -0
  123. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/__init__.py +0 -0
  124. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/core.py +0 -0
  125. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/css_validator.py +0 -0
  126. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/html_validator.py +0 -0
  127. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/jinja2_validator.py +0 -0
  128. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/js_validator.py +0 -0
  129. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/json_validator.py +0 -0
  130. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/markdown_validator.py +0 -0
  131. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/ps1_validator.py +0 -0
  132. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/python_validator.py +0 -0
  133. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/xml_validator.py +0 -0
  134. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/validate_file_syntax/yaml_validator.py +0 -0
  135. /janito/{tools/adapters/local → plugins/core/filemanager/tools}/view_file.py +0 -0
  136. /janito/{tools/adapters/local → plugins/core/system/tools}/run_bash_command.py +0 -0
  137. /janito/{tools/adapters/local → plugins/core/system/tools}/run_powershell_command.py +0 -0
  138. /janito/{tools/adapters/local → plugins/dev/pythondev/tools}/python_code_run.py +0 -0
  139. /janito/{tools/adapters/local → plugins/dev/pythondev/tools}/python_command_run.py +0 -0
  140. /janito/{tools/adapters/local → plugins/dev/pythondev/tools}/python_file_run.py +0 -0
  141. /janito/{tools/adapters/local → plugins/dev/visualization/tools}/read_chart.py +0 -0
  142. /janito/{tools/adapters/local → plugins/web/webtools/tools}/open_html_in_browser.py +0 -0
  143. /janito/{tools/adapters/local → plugins/web/webtools/tools}/open_url.py +0 -0
  144. {janito-2.33.0.dist-info → janito-3.1.0.dist-info}/WHEEL +0 -0
  145. {janito-2.33.0.dist-info → janito-3.1.0.dist-info}/entry_points.txt +0 -0
  146. {janito-2.33.0.dist-info → janito-3.1.0.dist-info}/licenses/LICENSE +0 -0
  147. {janito-2.33.0.dist-info → janito-3.1.0.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,172 @@
1
+ import subprocess
2
+ import os
3
+ import sys
4
+ import tempfile
5
+ import threading
6
+ from janito.tools.tool_base import ToolBase, ToolPermissions
7
+ from janito.report_events import ReportAction
8
+ from janito.plugins.tools.decorators import register_core_tool
9
+ from janito.i18n import tr
10
+
11
+
12
+ @register_core_tool
13
+ class PythonCodeRun(ToolBase):
14
+ """
15
+ Tool to execute Python code by passing it to the interpreter via standard input (stdin).
16
+
17
+ Args:
18
+ code (str): The Python code to execute as a string.
19
+ timeout (int): Timeout in seconds for the command. Defaults to 60.
20
+ silent (bool): If True, suppresses progress and status messages. Defaults to False.
21
+
22
+ Returns:
23
+ str: Output and status message, or file paths/line counts if output is large.
24
+ """
25
+
26
+ permissions = ToolPermissions(execute=True)
27
+ tool_name = "python_code_run"
28
+
29
+ def run(self, code: str, timeout: int = 60, silent: bool = False) -> str:
30
+ if not code.strip():
31
+ self.report_warning(tr("ℹ️ Empty code provided."), ReportAction.EXECUTE)
32
+ return tr("Warning: Empty code provided. Operation skipped.")
33
+ if not silent:
34
+ self.report_action(
35
+ tr("⚡ Running: python (stdin mode) ...\n{code}\n", code=code),
36
+ ReportAction.EXECUTE,
37
+ )
38
+ self.report_stdout("\n")
39
+ else:
40
+ self.report_action(tr("⚡ Executing..."), ReportAction.EXECUTE)
41
+ try:
42
+ with (
43
+ tempfile.NamedTemporaryFile(
44
+ mode="w+",
45
+ prefix="python_stdin_stdout_",
46
+ delete=False,
47
+ encoding="utf-8",
48
+ ) as stdout_file,
49
+ tempfile.NamedTemporaryFile(
50
+ mode="w+",
51
+ prefix="python_stdin_stderr_",
52
+ delete=False,
53
+ encoding="utf-8",
54
+ ) as stderr_file,
55
+ ):
56
+ process = subprocess.Popen(
57
+ [sys.executable],
58
+ stdin=subprocess.PIPE,
59
+ stdout=subprocess.PIPE,
60
+ stderr=subprocess.PIPE,
61
+ text=True,
62
+ bufsize=1,
63
+ universal_newlines=True,
64
+ encoding="utf-8",
65
+ env={**os.environ, "PYTHONIOENCODING": "utf-8"},
66
+ )
67
+ stdout_lines, stderr_lines = self._stream_process_output(
68
+ process, stdout_file, stderr_file, code
69
+ )
70
+ return_code = self._wait_for_process(process, timeout)
71
+ if return_code is None:
72
+ return tr(
73
+ "Code timed out after {timeout} seconds.", timeout=timeout
74
+ )
75
+ stdout_file.flush()
76
+ stderr_file.flush()
77
+ if not silent:
78
+ self.report_success(
79
+ tr("✅ Return code {return_code}", return_code=return_code),
80
+ ReportAction.EXECUTE,
81
+ )
82
+ return self._format_result(
83
+ stdout_file.name, stderr_file.name, return_code
84
+ )
85
+ except Exception as e:
86
+ self.report_error(tr("❌ Error: {error}", error=e), ReportAction.EXECUTE)
87
+ return tr("Error running code via stdin: {error}", error=e)
88
+
89
+ def _stream_process_output(self, process, stdout_file, stderr_file, code):
90
+ stdout_lines = 0
91
+ stderr_lines = 0
92
+
93
+ def stream_output(stream, file_obj, report_func, count_func):
94
+ nonlocal stdout_lines, stderr_lines
95
+ for line in stream:
96
+ file_obj.write(line)
97
+ file_obj.flush()
98
+ report_func(line.rstrip("\r\n"))
99
+ if count_func == "stdout":
100
+ stdout_lines += 1
101
+ else:
102
+ stderr_lines += 1
103
+
104
+ stdout_thread = threading.Thread(
105
+ target=stream_output,
106
+ args=(process.stdout, stdout_file, self.report_stdout, "stdout"),
107
+ )
108
+ stderr_thread = threading.Thread(
109
+ target=stream_output,
110
+ args=(process.stderr, stderr_file, self.report_stderr, "stderr"),
111
+ )
112
+ stdout_thread.start()
113
+ stderr_thread.start()
114
+ process.stdin.write(code)
115
+ process.stdin.close()
116
+ stdout_thread.join()
117
+ stderr_thread.join()
118
+ return stdout_lines, stderr_lines
119
+
120
+ def _wait_for_process(self, process, timeout):
121
+ try:
122
+ return process.wait(timeout=timeout)
123
+ except subprocess.TimeoutExpired:
124
+ process.kill()
125
+ self.report_error(
126
+ tr("❌ Timed out after {timeout} seconds.", timeout=timeout),
127
+ ReportAction.EXECUTE,
128
+ )
129
+ return None
130
+
131
+ def _format_result(self, stdout_file_name, stderr_file_name, return_code):
132
+ with open(stdout_file_name, "r", encoding="utf-8", errors="replace") as out_f:
133
+ stdout_content = out_f.read()
134
+ with open(stderr_file_name, "r", encoding="utf-8", errors="replace") as err_f:
135
+ stderr_content = err_f.read()
136
+ max_lines = 100
137
+ stdout_lines = stdout_content.count("\n")
138
+ stderr_lines = stderr_content.count("\n")
139
+
140
+ def head_tail(text, n=10):
141
+ lines = text.splitlines()
142
+ if len(lines) <= 2 * n:
143
+ return "\n".join(lines)
144
+ return "\n".join(
145
+ lines[:n]
146
+ + ["... ({} lines omitted) ...".format(len(lines) - 2 * n)]
147
+ + lines[-n:]
148
+ )
149
+
150
+ if stdout_lines <= max_lines and stderr_lines <= max_lines:
151
+ result = f"Return code: {return_code}\n--- python_code_run: STDOUT ---\n{stdout_content}"
152
+ if stderr_content.strip():
153
+ result += f"\n--- python_code_run: STDERR ---\n{stderr_content}"
154
+ return result
155
+ else:
156
+ result = f"stdout_file: {stdout_file_name} (lines: {stdout_lines})\n"
157
+ if stderr_lines > 0 and stderr_content.strip():
158
+ result += f"stderr_file: {stderr_file_name} (lines: {stderr_lines})\n"
159
+ result += f"returncode: {return_code}\n"
160
+ result += (
161
+ "--- python_code_run: STDOUT (head/tail) ---\n"
162
+ + head_tail(stdout_content)
163
+ + "\n"
164
+ )
165
+ if stderr_content.strip():
166
+ result += (
167
+ "--- python_code_run: STDERR (head/tail) ---\n"
168
+ + head_tail(stderr_content)
169
+ + "\n"
170
+ )
171
+ result += "Use the view_file tool to inspect the contents of these files when needed."
172
+ return result
@@ -0,0 +1,171 @@
1
+ import subprocess
2
+ import os
3
+ import sys
4
+ import tempfile
5
+ import threading
6
+ from janito.tools.tool_base import ToolBase, ToolPermissions
7
+ from janito.report_events import ReportAction
8
+ from janito.plugins.tools.decorators import register_core_tool
9
+ from janito.i18n import tr
10
+
11
+
12
+ @register_core_tool
13
+ class PythonCommandRun(ToolBase):
14
+ """
15
+ Tool to execute Python code using the `python -c` command-line flag.
16
+
17
+ Args:
18
+ code (str): The Python code to execute as a string.
19
+ timeout (int): Timeout in seconds for the command. Defaults to 60.
20
+ silent (bool): If True, suppresses progress and status messages. Defaults to False.
21
+
22
+ Returns:
23
+ str: Output and status message, or file paths/line counts if output is large.
24
+ """
25
+
26
+ permissions = ToolPermissions(execute=True)
27
+ tool_name = "python_command_run"
28
+
29
+ def run(self, code: str, timeout: int = 60, silent: bool = False) -> str:
30
+ if not code.strip():
31
+ self.report_warning(tr("ℹ️ Empty code provided."), ReportAction.EXECUTE)
32
+ return tr("Warning: Empty code provided. Operation skipped.")
33
+ if not silent:
34
+ self.report_action(
35
+ tr("🐍 Running: python -c ...\n{code}\n", code=code),
36
+ ReportAction.EXECUTE,
37
+ )
38
+ self.report_stdout("\n")
39
+ else:
40
+ self.report_action(tr("⚡ Executing..."), ReportAction.EXECUTE)
41
+ try:
42
+ with (
43
+ tempfile.NamedTemporaryFile(
44
+ mode="w+",
45
+ prefix="python_cmd_stdout_",
46
+ delete=False,
47
+ encoding="utf-8",
48
+ ) as stdout_file,
49
+ tempfile.NamedTemporaryFile(
50
+ mode="w+",
51
+ prefix="python_cmd_stderr_",
52
+ delete=False,
53
+ encoding="utf-8",
54
+ ) as stderr_file,
55
+ ):
56
+ process = subprocess.Popen(
57
+ [sys.executable, "-c", code],
58
+ stdout=subprocess.PIPE,
59
+ stderr=subprocess.PIPE,
60
+ text=True,
61
+ bufsize=1,
62
+ universal_newlines=True,
63
+ encoding="utf-8",
64
+ env={**os.environ, "PYTHONIOENCODING": "utf-8"},
65
+ )
66
+ stdout_lines, stderr_lines = self._stream_process_output(
67
+ process, stdout_file, stderr_file
68
+ )
69
+ return_code = self._wait_for_process(process, timeout)
70
+ if return_code is None:
71
+ return tr(
72
+ "Code timed out after {timeout} seconds.", timeout=timeout
73
+ )
74
+ stdout_file.flush()
75
+ stderr_file.flush()
76
+ if not silent:
77
+ self.report_success(
78
+ tr("✅ Return code {return_code}", return_code=return_code),
79
+ ReportAction.EXECUTE,
80
+ )
81
+ return self._format_result(
82
+ stdout_file.name, stderr_file.name, return_code
83
+ )
84
+ except Exception as e:
85
+ self.report_error(tr("❌ Error: {error}", error=e), ReportAction.EXECUTE)
86
+ return tr("Error running code: {error}", error=e)
87
+
88
+ def _stream_process_output(self, process, stdout_file, stderr_file):
89
+ stdout_lines = 0
90
+ stderr_lines = 0
91
+
92
+ def stream_output(stream, file_obj, report_func, count_func):
93
+ nonlocal stdout_lines, stderr_lines
94
+ for line in stream:
95
+ file_obj.write(line)
96
+ file_obj.flush()
97
+ from janito.tools.tool_base import ReportAction
98
+
99
+ report_func(line.rstrip("\r\n"), ReportAction.EXECUTE)
100
+ if count_func == "stdout":
101
+ stdout_lines += 1
102
+ else:
103
+ stderr_lines += 1
104
+
105
+ stdout_thread = threading.Thread(
106
+ target=stream_output,
107
+ args=(process.stdout, stdout_file, self.report_stdout, "stdout"),
108
+ )
109
+ stderr_thread = threading.Thread(
110
+ target=stream_output,
111
+ args=(process.stderr, stderr_file, self.report_stderr, "stderr"),
112
+ )
113
+ stdout_thread.start()
114
+ stderr_thread.start()
115
+ stdout_thread.join()
116
+ stderr_thread.join()
117
+ return stdout_lines, stderr_lines
118
+
119
+ def _wait_for_process(self, process, timeout):
120
+ try:
121
+ return process.wait(timeout=timeout)
122
+ except subprocess.TimeoutExpired:
123
+ process.kill()
124
+ self.report_error(
125
+ tr("❌ Timed out after {timeout} seconds.", timeout=timeout),
126
+ ReportAction.EXECUTE,
127
+ )
128
+ return None
129
+
130
+ def _format_result(self, stdout_file_name, stderr_file_name, return_code):
131
+ with open(stdout_file_name, "r", encoding="utf-8", errors="replace") as out_f:
132
+ stdout_content = out_f.read()
133
+ with open(stderr_file_name, "r", encoding="utf-8", errors="replace") as err_f:
134
+ stderr_content = err_f.read()
135
+ max_lines = 100
136
+ stdout_lines = stdout_content.count("\n")
137
+ stderr_lines = stderr_content.count("\n")
138
+
139
+ def head_tail(text, n=10):
140
+ lines = text.splitlines()
141
+ if len(lines) <= 2 * n:
142
+ return "\n".join(lines)
143
+ return "\n".join(
144
+ lines[:n]
145
+ + ["... ({} lines omitted) ...".format(len(lines) - 2 * n)]
146
+ + lines[-n:]
147
+ )
148
+
149
+ if stdout_lines <= max_lines and stderr_lines <= max_lines:
150
+ result = f"Return code: {return_code}\n--- python_command_run: STDOUT ---\n{stdout_content}"
151
+ if stderr_content.strip():
152
+ result += f"\n--- python_command_run: STDERR ---\n{stderr_content}"
153
+ return result
154
+ else:
155
+ result = f"stdout_file: {stdout_file_name} (lines: {stdout_lines})\n"
156
+ if stderr_lines > 0 and stderr_content.strip():
157
+ result += f"stderr_file: {stderr_file_name} (lines: {stderr_lines})\n"
158
+ result += f"returncode: {return_code}\n"
159
+ result += (
160
+ "--- python_command_run: STDOUT (head/tail) ---\n"
161
+ + head_tail(stdout_content)
162
+ + "\n"
163
+ )
164
+ if stderr_content.strip():
165
+ result += (
166
+ "--- python_command_run: STDERR (head/tail) ---\n"
167
+ + head_tail(stderr_content)
168
+ + "\n"
169
+ )
170
+ result += "Use the view_file tool to inspect the contents of these files when needed."
171
+ return result
@@ -0,0 +1,172 @@
1
+ import subprocess
2
+ import os
3
+ import sys
4
+ import tempfile
5
+ import threading
6
+ from janito.tools.tool_base import ToolBase, ToolPermissions
7
+ from janito.report_events import ReportAction
8
+ from janito.plugins.tools.decorators import register_core_tool
9
+ from janito.i18n import tr
10
+
11
+
12
+ @register_core_tool
13
+ class PythonFileRun(ToolBase):
14
+ """
15
+ Tool to execute a specified Python script file.
16
+
17
+ Args:
18
+ path (str): Path to the Python script file to execute.
19
+ timeout (int): Timeout in seconds for the command. Defaults to 60.
20
+ silent (bool): If True, suppresses progress and status messages. Defaults to False.
21
+
22
+ Returns:
23
+ str: Output and status message, or file paths/line counts if output is large.
24
+ """
25
+
26
+ permissions = ToolPermissions(execute=True)
27
+ tool_name = "python_file_run"
28
+
29
+ def run(self, path: str, timeout: int = 60, silent: bool = False) -> str:
30
+ from janito.tools.path_utils import expand_path
31
+
32
+ path = expand_path(path)
33
+ if not silent:
34
+ self.report_action(
35
+ tr("🚀 Running: python {path}", path=path),
36
+ ReportAction.EXECUTE,
37
+ )
38
+ self.report_stdout("\n")
39
+ else:
40
+ self.report_action(tr("⚡ Executing..."), ReportAction.EXECUTE)
41
+ try:
42
+ with (
43
+ tempfile.NamedTemporaryFile(
44
+ mode="w+",
45
+ prefix="python_file_stdout_",
46
+ delete=False,
47
+ encoding="utf-8",
48
+ ) as stdout_file,
49
+ tempfile.NamedTemporaryFile(
50
+ mode="w+",
51
+ prefix="python_file_stderr_",
52
+ delete=False,
53
+ encoding="utf-8",
54
+ ) as stderr_file,
55
+ ):
56
+ process = subprocess.Popen(
57
+ [sys.executable, path],
58
+ stdout=subprocess.PIPE,
59
+ stderr=subprocess.PIPE,
60
+ text=True,
61
+ bufsize=1,
62
+ universal_newlines=True,
63
+ encoding="utf-8",
64
+ env={**os.environ, "PYTHONIOENCODING": "utf-8"},
65
+ )
66
+ stdout_lines, stderr_lines = self._stream_process_output(
67
+ process, stdout_file, stderr_file
68
+ )
69
+ return_code = self._wait_for_process(process, timeout)
70
+ if return_code is None:
71
+ return tr(
72
+ "Code timed out after {timeout} seconds.", timeout=timeout
73
+ )
74
+ stdout_file.flush()
75
+ stderr_file.flush()
76
+ if not silent:
77
+ self.report_success(
78
+ tr("✅ Return code {return_code}", return_code=return_code),
79
+ ReportAction.EXECUTE,
80
+ )
81
+ return self._format_result(
82
+ stdout_file.name, stderr_file.name, return_code
83
+ )
84
+ except Exception as e:
85
+ self.report_error(tr("❌ Error: {error}", error=e), ReportAction.EXECUTE)
86
+ return tr("Error running file: {error}", error=e)
87
+
88
+ def _stream_process_output(self, process, stdout_file, stderr_file):
89
+ stdout_lines = 0
90
+ stderr_lines = 0
91
+
92
+ def stream_output(stream, file_obj, report_func, count_func):
93
+ nonlocal stdout_lines, stderr_lines
94
+ for line in stream:
95
+ file_obj.write(line)
96
+ file_obj.flush()
97
+ # Always supply a default action for stdout/stderr reporting
98
+ from janito.report_events import ReportAction
99
+
100
+ report_func(line.rstrip("\r\n"), ReportAction.EXECUTE)
101
+ if count_func == "stdout":
102
+ stdout_lines += 1
103
+ else:
104
+ stderr_lines += 1
105
+
106
+ stdout_thread = threading.Thread(
107
+ target=stream_output,
108
+ args=(process.stdout, stdout_file, self.report_stdout, "stdout"),
109
+ )
110
+ stderr_thread = threading.Thread(
111
+ target=stream_output,
112
+ args=(process.stderr, stderr_file, self.report_stderr, "stderr"),
113
+ )
114
+ stdout_thread.start()
115
+ stderr_thread.start()
116
+ stdout_thread.join()
117
+ stderr_thread.join()
118
+ return stdout_lines, stderr_lines
119
+
120
+ def _wait_for_process(self, process, timeout):
121
+ try:
122
+ return process.wait(timeout=timeout)
123
+ except subprocess.TimeoutExpired:
124
+ process.kill()
125
+ self.report_error(
126
+ tr("❌ Timed out after {timeout} seconds.", timeout=timeout),
127
+ ReportAction.EXECUTE,
128
+ )
129
+ return None
130
+
131
+ def _format_result(self, stdout_file_name, stderr_file_name, return_code):
132
+ with open(stdout_file_name, "r", encoding="utf-8", errors="replace") as out_f:
133
+ stdout_content = out_f.read()
134
+ with open(stderr_file_name, "r", encoding="utf-8", errors="replace") as err_f:
135
+ stderr_content = err_f.read()
136
+ max_lines = 100
137
+ stdout_lines = stdout_content.count("\n")
138
+ stderr_lines = stderr_content.count("\n")
139
+
140
+ def head_tail(text, n=10):
141
+ lines = text.splitlines()
142
+ if len(lines) <= 2 * n:
143
+ return "\n".join(lines)
144
+ return "\n".join(
145
+ lines[:n]
146
+ + ["... ({} lines omitted) ...".format(len(lines) - 2 * n)]
147
+ + lines[-n:]
148
+ )
149
+
150
+ if stdout_lines <= max_lines and stderr_lines <= max_lines:
151
+ result = f"Return code: {return_code}\n--- python_file_run: STDOUT ---\n{stdout_content}"
152
+ if stderr_content.strip():
153
+ result += f"\n--- python_file_run: STDERR ---\n{stderr_content}"
154
+ return result
155
+ else:
156
+ result = f"stdout_file: {stdout_file_name} (lines: {stdout_lines})\n"
157
+ if stderr_lines > 0 and stderr_content.strip():
158
+ result += f"stderr_file: {stderr_file_name} (lines: {stderr_lines})\n"
159
+ result += f"returncode: {return_code}\n"
160
+ result += (
161
+ "--- python_file_run: STDOUT (head/tail) ---\n"
162
+ + head_tail(stdout_content)
163
+ + "\n"
164
+ )
165
+ if stderr_content.strip():
166
+ result += (
167
+ "--- python_file_run: STDERR (head/tail) ---\n"
168
+ + head_tail(stderr_content)
169
+ + "\n"
170
+ )
171
+ result += "Use the view_file tool to inspect the contents of these files when needed."
172
+ return result