Skip to main content

Python Remote Console

Project description

Python Remote Console - PRC

Python Remote Console client and server communicate via sockets. PRCClient connects to PRCServer and gains access to its Python console. Everything what PRCClient types is sent and executed on PRCServer.

This can have several applications including:

  • Access to remote machine resources like files on hard drives, computation power.
  • Runtime debugging of complex Python scripts. PRCServer can be configured to access script internal variables, objects, states.
  • Remote Procedure Call (RPC). PRCClient can remotely start processes, applications, other executables on PRCServer.

PRC is writen in Python 2.7 and works on Windows and Linux. Source code can be found here: https://github.com/0x1001/PRC

PRCServer usage example

PRCServer runs socket server that spawns Python console for each PRCClient.

example_server.py:

from prc import PRCServer
import time

# Creates PRCServer object
server = PRCServer()

# Example of a mutable variable
counter = [0]

# This will allow access to counter variable in PRC
server.add_variable("counter",counter)

# Starts PRCServer. Non blocking!
server.start()

# Example of worker thread that increments counter
while True:
    counter[0] += 1
    time.sleep(1)

PRCClient usage example

PRCClient connects to PRCServer console and acts as a proxy.

example_client.py:

from prc import PRCClient

# Starts PRCClient
#
# Only stderr is redirected to RPCClient output
# To redirect stdout type following code in PRCClient console:
#   import sys
#   sys.stdout = __prcconsole__
#
# Type exit() for exit.
PRCClient().start()

PRCClient client console looks like this:

Python 2.7.3 (default, Apr 10 2012, 23:31:26) [MSC v.1500 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
(PRCConsole)

>>> import sys
>>> sys.stdout = __prcconsole__
>>> counter
[62]

>>> counter
[64]

>>> import subprocess
>>> subprocess.call("start notepad",shell=True)
>>> exit()

PRCClient constructor accepts two input paramiters: server address and port.

Contribution

Anyone is welcome to contribute to this project. Source code is available on GitHub. https://github.com/0x1001/PRC

Project details


Release history Release notifications

This version
History Node

0.9.3

History Node

0.9.2

History Node

0.9.1

History Node

0.9.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
PRC-0.9.3.zip (19.3 kB) Copy SHA256 hash SHA256 Source None Feb 17, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page