cronio 1.2.0
This project has a sender and a receiver, the sender sends commands through RabbitMQ on the queue of a worker (receiver), the receiver executes them either with OS or Python2.7

# cronio

INTRO

>This project has a sender and a receiver, the sender sends commands through RabbitMQ on the queue of a worker (receiver), the receiver executes them either with OS or Python2.7

## NOTE

>Following a test I did, I discovered many issues maintaining the code, I started recode the whole thing because it was not an easy thing to understand, my plan is to finish it as soon as possible and be able to make as easy as possible to understand.

## Objectives

- [x] Prototype - Send some commands in OS or in Python and execute them, bring back the log or errors if any
- [x] Package Structure
- [x] Dependent Commands ie. dependancy: [1,2,3,200, cmd_id]
- [x] Multiple Workers with one Sender, dependency on different workers to run a task with negation. 
ie. Complete Task A on Worker 1, and when done do Task B on Worker 2. If not done, do Task C on Worker 3.
check examples/sender_complex_multi_worker.py
- [ ] Time to be executed ie. using python-crontab would be a good thing
- [ ] ENVs needs to be tested with docker that it can be set and read from this app.py


## Requirements

1. STOMP Python Library 
2. SQLAlchemy (use of sqlite)
3. RabbitMQ Server (see myrabbitmq\ folder for details on raising a container with it.- You are welcome!)
	You can get one using our docker image - default username and password is guest.
	If you want the dockerfile for it, you can go to the folder's repository myrabbitmq.

Install Required packages (1,2)

	pip install -r requirements.txt 


## Installation 

PyPi

	pip install cronio



## Examples

For Code see examples\ directory

Worker:

	python worker1.py # this will start the worker process, see inline comments


Sender:

	python sender_complex_multi_workers_example2.py # this has everything in it


## Custom Listener for Sender

Modify it based on your current needs on listening for worker's messages to act accordingly.

	WORKER_ID_1 = "worker_1"
	CS_1 = CronioSender({
	# To Enable Viewer Log, uncomment the below in worker and sender:
	# 'CRONIO_SENDER_EXCHANGE_LOG_INFO': "cronio_log_info",
	# 'CRONIO_SENDER_EXCHANGE_LOG_ERROR': "cronio_log_error",
	'CRONIO_SENDER_AMQP_USERNAME': "sender1",
	'CRONIO_SENDER_AMQP_PASSWORD': "somepass",
	'CRONIO_SENDER_WORKER_QUEUE': "cronio_queue"+WORKER_ID_1,
	'CRONIO_SENDER_AMQP_HOST': 'localhost',
	'CRONIO_SENDER_AMQP_VHOST': '/',
	'CRONIO_SENDER_AMQP_PORT': 61613,
	'CRONIO_SENDER_AMQP_USE_SSL': False,
	'CRONIO_SENDER_LOGGER_LEVEL':  logging.DEBUG, #logging.DEBUG
	'CRONIO_SENDER_LOGGER_FORMATTER': '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
	'CRONIO_SENDER_RUNTIME_SECONDS': 5})

	class CronioSenderListener1(stomp.ConnectionListener):
		def on_error(self, headers, message):
			pprint.pprint(headers)
			pprint.pprint(message)
			CS_1.logger_sender.debug('Cronio Sender Listener received an error "%s"' % message)
		def on_message(self, headers, message):
			# Use the below to your discretion on receiving new messages
			# CS_1.logger_sender.debug(' %s' % str(headers['message-id']))
			# CS_1.logger_sender.debug(' Log %s' % str(message))
			# CS_1.logger_sender.debug('ACK Log - Remove from Queue %s' % str(headers['message-id']))
			# MESSAGE IS IN JSON
			message_obj = json.loads(message)
			pprint.pprint(message_obj)
			# if headers['subscription'] == "api_log":
			# 	pprint.pprint(message_obj)
			# if headers['subscription'] == "api_log":
				# This here is where the magic happens
				# print "API LOG =================================="
				# pprint.pprint(message_obj)
				# print "API LOG ENDS ============================="
			# else:
				# a bunch of other messages
				# print "view_log - or error"

			# remove from queue
			CS_1.conn.ack(headers['message-id'],1)

	CS_1.conn.disconnect()
	CS_1.conn.remove_listener('default')
	CS_1.cronio_sender_listener = CronioSenderListener1() 
	CS_1.initConnectSenderSTOMP()
	CS_1.conn.subscribe(destination=CS_1.CRONIO_SENDER_API_LOG, id="api_log1", ack='client')



## Worker Queues
> After version 1.1.0, the worker queues are modified in a more standardized way to enable the multiworker dependancy, if you want to do such a thing!:
ie.

	self.CRONIO_WORKER_ID = 'worker_1'
	self.CRONIO_WORKER_PREFIX = '/queue/cronio/'
	self.CRONIO_WORKER_QUEUE =  self.CRONIO_WORKER_PREFIX + self.CRONIO_WORKER_ID

> Hence that, the CRONIO_WORKER_QUEUE param in class and settings needs to be avoided if you want to have the multiworker dependancy to work. Otherwise we will need to add namespaces for it. Which are going a bit off topic.
> Ensure that you set CRONIO_WORKER_ID and CRONIO_WORKER_PREFIX on each worker and have the same CRONIO_WORKER_PREFIX in all workers. 
> Avoid using CRONIO_WORKER_ID in the format: worker1 and worker11 otherwise you might end up having difficulty setting permissions for specific workers.


## Dependency Checks

Each worker (ie. worker_1) has a specific log which receives notices when one a workers job (ie. worker_2) has finished which is a dependency on the other worker (ie. worker_1). 
ie.

	queue_cronio_workers_dependency_worker_1




## Execute OS commands and pass a cmd_id (ID)

>Generate cmd_ids to use for each:

	import pprint
	cmd_ids = [str(uuid.uuid4()),str(uuid.uuid4()),str(uuid.uuid4()),str(uuid.uuid4()),str(uuid.uuid4()),str(uuid.uuid4())]
	pprint.pprint(cmd_ids)


>Execute a git command and get the result in the listener

	# Use those on the following commands:

	# clear database of worker
	CS_1.sendCMD('cleardb',WORKER_ID_1,'operation',0)

	# git clone a repo
	CS_1.sendCMD("git clone https://gitlab.com/doctormo/python-crontab.git", WORKER_ID_1, "os", cmd_ids[1])

>or just a simple listing

	#execute ls command on the current folder
	CS_1.sendCMD("ls", WORKER_ID_1, "os", cmd_ids[2])


>Can send files if you want to execute those:

	# Absolute Path only
	PythonFile = "/opt/cronio/examples/test.py"
	CmdFile = "/opt/cronio/examples/test.sh"
	CS_1.sendPythonFile(PythonFile,WORKER_ID_1,1)
	CS_1.sendCmdFile(CmdFile,WORKER_ID_1,2)


	# Clear Database of its commands
	CS_1.sendCMD('cleardb',WORKER_ID_1,'operation',cmd_ids[4])


>Use workflow to run on the worker.

	# Workflow Example - Set of commands related with each other.
	commands = [ {"cmd": "ls", "worker_id": "worker_1", type": "os", "cmd_id": 1, "dependencies": None}, {"cmd": "mkdir test_1", "worker_id": "worker_1", type": "os", "cmd_id": 2, "dependencies": None}, {"cmd": "cd test_1", "worker_id": "worker_1", type": "os", "cmd_id": 3, "dependencies": [2]},{"cmd": "print \"hello cronio\"", "worker_id": "worker_1", type": "python", "cmd_id": 4,"dependencies" : None}]
	CS_1.sendWorkflow(commands)


>Just add the python commands and add \n after each line

	CS_1.sendCMD("iter2=[2,3,4,5,6,7]\nfor item2 in iter2:\n\tprint item2",WORKER_ID_1,"python",2)