annotate sat/plugins/plugin_dbg_manhole.py @ 3028:ab2696e34d29

Python 3 port: /!\ this is a huge commit /!\ starting from this commit, SàT is needs Python 3.6+ /!\ SàT maybe be instable or some feature may not work anymore, this will improve with time This patch port backend, bridge and frontends to Python 3. Roughly this has been done this way: - 2to3 tools has been applied (with python 3.7) - all references to python2 have been replaced with python3 (notably shebangs) - fixed files not handled by 2to3 (notably the shell script) - several manual fixes - fixed issues reported by Python 3 that where not handled in Python 2 - replaced "async" with "async_" when needed (it's a reserved word from Python 3.7) - replaced zope's "implements" with @implementer decorator - temporary hack to handle data pickled in database, as str or bytes may be returned, to be checked later - fixed hash comparison for password - removed some code which is not needed anymore with Python 3 - deactivated some code which needs to be checked (notably certificate validation) - tested with jp, fixed reported issues until some basic commands worked - ported Primitivus (after porting dependencies like urwid satext) - more manual fixes
author Goffi <goffi@goffi.org>
date Tue, 13 Aug 2019 19:08:41 +0200
parents e2005dd39c92
children 9211c0d8b50c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3028
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
1 #!/usr/bin/env python3
2755
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
2 # -*- coding: utf-8 -*-
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
3
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
4 # SAT plugin for debugging, using a manhole
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
5 # Copyright (C) 2009-2019 Jérôme Poisson (goffi@goffi.org)
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
6
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
7 # This program is free software: you can redistribute it and/or modify
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
8 # it under the terms of the GNU Affero General Public License as published by
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
9 # the Free Software Foundation, either version 3 of the License, or
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
10 # (at your option) any later version.
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
11
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
12 # This program is distributed in the hope that it will be useful,
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
15 # GNU Affero General Public License for more details.
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
16
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
17 # You should have received a copy of the GNU Affero General Public License
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
19
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
20 from sat.core.i18n import _
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
21 from sat.core.constants import Const as C
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
22 from sat.core.log import getLogger
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
23 from twisted.conch.insults import insults
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
24 from twisted.conch.telnet import TelnetTransport, TelnetBootstrapProtocol
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
25 from twisted.internet import reactor, protocol
2837
e2005dd39c92 plugin manhole: added "jid" module to globals
Goffi <goffi@goffi.org>
parents: 2755
diff changeset
26 from twisted.words.protocols.jabber import jid
2755
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
27 from twisted.conch.manhole import ColoredManhole
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
28
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
29 log = getLogger(__name__)
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
30
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
31 PLUGIN_INFO = {
3028
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
32 C.PI_NAME: "Manhole debug plugin",
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
33 C.PI_IMPORT_NAME: "manhole",
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
34 C.PI_TYPE: "DEBUG",
2755
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
35 C.PI_PROTOCOLS: [],
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
36 C.PI_DEPENDENCIES: [],
3028
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
37 C.PI_MAIN: "Manhole",
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
38 C.PI_HANDLER: "no",
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
39 C.PI_DESCRIPTION: _("""Debug plugin to have a telnet server"""),
2755
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
40 }
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
41
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
42
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
43
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
44 class Manhole(object):
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
45
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
46 def __init__(self, host):
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
47 self.host = host
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
48 port = int(host.memory.getConfig(None, "manhole_debug_dangerous_port_int"))
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
49 if port:
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
50 self.startManhole(port)
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
51
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
52 def startManhole(self, port):
3028
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
53 log.warning(_("/!\\ Manhole debug server activated, be sure to not use it in "
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
54 "production, this is dangerous /!\\"))
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
55 log.info(_("You can connect to manhole server using telnet on port {port}")
2755
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
56 .format(port=port))
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
57 f = protocol.ServerFactory()
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
58 namespace = {
3028
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
59 "host": self.host,
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2837
diff changeset
60 "jid": jid,
2755
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
61 }
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
62 f.protocol = lambda: TelnetTransport(TelnetBootstrapProtocol,
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
63 insults.ServerProtocol,
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
64 ColoredManhole,
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
65 namespace=namespace,
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
66 )
12d1ca646af1 plugin manhole: manhole debug plugin, first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
67 reactor.listenTCP(port, f)