initial upload

LICENSE

@@ -631,8 +631,8 @@ to attach them to the start of each source file to most effectively
 state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
+    Setzer
+    Copyright (C) 2018  Robert Griesel
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -652,7 +652,7 @@ Also add information on how to contact you by electronic and paper mail.
   If the program does terminal interaction, make it output a short
 notice like this when it starts in an interactive mode:
 
-    <program>  Copyright (C) <year>  <name of author>
+    Setzer  Copyright (C) 2018  Robert Griesel
     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `show c' for details.

README.md

@@ -1 +1,33 @@
-# GSNB
+# Porto
+
+![Screenshot](https://github.com/cvfosammmm/Porto/raw/master/resources/images/screenshots/2017-12-25.png)
+
+Porto is a notebook style interface to the SageMath CAS (sagemath.org) similar to Jupyter but written in Python and Gtk. It's currently not stable and likely has a lot of bugs. It's also lacking many features that Jupyter supports like 3D plots, tab-autocomplete, function references, pretty printing, LaTeX support, ... Markdown cells support only the most basic functions (paragraphs and headers).
+
+That said it's still usable and - in my opinion - enjoyable. So as you might not want to consider this for production use yet you can still play around with it and maybe file any issues you encounter here on Github. I'm really happy about any feedback I get, be it about code architecture, design, bugs, feature suggestion, ... Even better of course if you want to help with development: I will definately work on and maintain this project for the foreseeable future and review your contributions ASAP, so we can faster "create a viable free open source alternative to Magma, Maple, Mathematica and Matlab."
+
+## Installation on Debian (Ubuntu?)
+
+I'm developing Porto on Debian and that's what I exclusively tested it with. Installing on Ubuntu should probably work exactly the same.
+
+1. Run the following command to install prerequisite Debian packages:
+apt-get install sagemath python3-bleach python3-markdown python3-pypandoc libgtk-3-dev libgtksourceview-3.0-dev
+
+2. Download und Unpack Porto from GitHub
+
+3. cd to Porto folder
+
+4. Running the following command should start Porto:
+python3 __main__.py
+
+## Installation on other Linux Distributions
+
+Installation on distributions different from Debian or Ubuntu should work more or less the same (if you have SageMath installed). If you have any trouble please get in touch by opening an issue on GitHub.
+
+## Getting in touch
+
+Porto development / discussion takes place on GitHub at [https://github.com/cvfosammmm/porto](https://github.com/cvfosammmm/porto "project url").
+
+## License
+
+Porto is licensed under GPL version 3 or later. See the COPYING file for details.

backend/backend_code.py

@@ -0,0 +1,289 @@
+#!/usr/bin/env python3
+# coding: utf-8
+
+# Copyright (C) 2017, 2018 Robert Griesel
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>
+
+import gi
+gi.require_version('Gtk', '3.0')
+from gi.repository import GObject
+
+import jupyter_client
+import _thread as thread
+import queue
+import time
+
+from helpers.observable import Observable
+
+
+class BackendCode(Observable):
+
+    def __init__(self):
+        Observable.__init__(self)
+        self.kernels = dict()
+        self.continue_fetching = True
+        self.fetch_func_id = GObject.timeout_add(50, self.fetch_results)
+
+    def fetch_results(self):
+        for kernel in self.kernels.values():
+            result = kernel.get_result()
+            if result:
+                if result.result_message == 'evaluation_stopped':
+                    self.add_change_code('cell_evaluation_stopped', result)
+
+                elif len(result.result_list) > 0:
+                    for result_msg in result.result_list:
+                        msg_type = result_msg['header']['msg_type']
+                        #print(msg_type)
+
+                        if msg_type == 'error':
+                            print(result_msg['content'].get('evalue', ''))
+
+                        if msg_type == 'execute_input' and result.cell != None:
+                            self.add_change_code('evaluation_started', result)
+
+                        if msg_type == 'stream':
+                            text = result_msg['content'].get('text', None)
+                            if text != None:
+                                print(text)
+
+                        if msg_type == 'execute_result':
+                            data = result_msg['content'].get('data', None)
+                            self.add_change_code('evaluation_result', {'cell': result.cell, 'data': data})
+
+                        if msg_type == 'status':
+                            if result_msg['content'].get('execution_state', '') == 'idle':
+                                self.add_change_code('kernel_started', result.worksheet)
+                                if result.cell != None:
+                                    self.add_change_code('cell_evaluation_stopped', result)
+                            elif result_msg['content'].get('execution_state', '') == 'idle':
+                                self.add_change_code('kernel_started', result.worksheet)
+                            else:
+                                print(result_msg['content'])
+        return True
+
+    def start_kernel(self, worksheet):
+        try: kernel = self.kernels[worksheet]
+        except KeyError:
+            kernel = Kernel(worksheet.get_kernelname(), worksheet)
+            self.kernels[worksheet] = kernel
+        else: self.add_change_code('kernel_started', worksheet)
+
+    def run_cell(self, worksheet, cell):
+        try: kernel = self.kernels[worksheet]
+        except KeyError:
+            kernel = Kernel(worksheet.get_kernelname(), worksheet)
+            self.kernels[worksheet] = kernel
+        query = Query(worksheet, cell, cell.get_all_text().strip())
+        kernel.add_query(query)
+        self.add_change_code('query_queued', query)
+
+    def stop_evaluation_of_cell(self, worksheet, cell):
+        try: kernel = self.kernels[worksheet]
+        except KeyError: return
+        kernel.remove_queries_by_cell(cell)
+
+    def stop_evaluation(self, worksheet):
+        try: kernel = self.kernels[worksheet]
+        except KeyError: return
+
+        kernel.remove_all_queries()
+        kernel.kernel_manager.interrupt_kernel()
+
+    def shutdown_for_real(self, worksheet):
+        if worksheet.get_busy_cell_count() == 0:
+            try: kernel = self.kernels[worksheet]
+            except KeyError: return
+            else:
+                del(self.kernels[worksheet])
+                kernel.shutdown()
+                kernel.kernel_manager.finish_shutdown()
+            return False
+        return True
+
+    def restart_for_real(self, worksheet):
+        if worksheet.get_busy_cell_count() == 0:
+            try: kernel = self.kernels[worksheet]
+            except KeyError: return
+            else:
+                del(self.kernels[worksheet])
+                kernel.shutdown()
+                kernel.kernel_manager.finish_shutdown()
+            self.start_kernel(worksheet)
+            return False
+        return True
+
+    def shutdown(self, worksheet):
+        self.stop_evaluation(worksheet)
+        GObject.timeout_add(50, self.shutdown_for_real, worksheet)
+
+    def restart(self, worksheet):
+        self.stop_evaluation(worksheet)
+        shutdown_func_id = GObject.timeout_add(50, self.restart_for_real, worksheet)
+
+    def shutdown_all(self):
+        keys = list(self.kernels.keys())
+        for worksheet in keys:
+            try: kernel = self.kernels[worksheet]
+            except KeyError: return
+            else:
+                del(self.kernels[worksheet])
+                kernel.shutdown()
+                kernel.kernel_manager.finish_shutdown()
+
+
+class Query():
+
+    def __init__(self, worksheet, cell, code):
+        self.worksheet = worksheet
+        self.cell = cell
+        self.code = code
+
+
+class Kernel():
+
+    def __init__(self, kernel_name, worksheet):
+        self.kernel_spec = jupyter_client.kernelspec.KernelSpecManager().get_kernel_spec(kernel_name)
+
+        self.query_queue = list()#queue.Queue()
+        self.query_queue_lock = thread.allocate_lock()
+        self.results_temp = dict()
+        self.results_temp_lock = thread.allocate_lock()
+        self.result_queue = queue.Queue()
+        self.kernel_name = kernel_name
+        self.kernel_started = False
+        self.worksheet = worksheet
+        thread.start_new_thread(self.run_queries, ())
+
+    def start_kernel(self):
+        self.kernel_manager = jupyter_client.KernelManager()
+        self.kernel_manager.kernel_name = self.kernel_name
+        self.kernel_manager.start_kernel()
+        self.client = self.kernel_manager.blocking_client()
+        self.client.start_channels()
+        try: self.client.wait_for_ready()
+        except RuntimeError: pass
+        else:
+            query_id = self.client.comm_info()
+            self.results_temp_lock.acquire()
+            self.results_temp[query_id] = Result(self.worksheet, None)
+            self.results_temp_lock.release()
+
+    def start_fetching(self):
+        thread.start_new_thread(self.fetch_results, ())
+
+    def add_query(self, query):
+        self.query_queue_lock.acquire()
+        self.query_queue.append(query)
+        self.query_queue_lock.release()
+
+    def get_result(self):
+        try: return self.result_queue.get(block=False)
+        except queue.Empty: return None
+
+    def run_queries(self):
+        while True:
+            time.sleep(0.05)
+            self.results_temp_lock.acquire()
+            nothing_running = (len(self.results_temp) == 0)
+            self.results_temp_lock.release()
+            if not self.kernel_started:
+                self.kernel_started = True
+                self.start_kernel()
+                self.start_fetching()
+            elif nothing_running:
+                    self.query_queue_lock.acquire()
+                    try: query = self.query_queue.pop(0)
+                    except IndexError: query = None
+                    self.query_queue_lock.release()
+                    if query != None:
+                        query_id = self.client.execute(query.code)
+                        self.results_temp_lock.acquire()
+                        self.results_temp[query_id] = Result(query.worksheet, query.cell)
+                        self.results_temp_lock.release()
+
+    def remove_queries_by_cell(self, cell):
+        self.query_queue_lock.acquire()
+        for query in self.query_queue:
+            if query.cell == cell:
+                self.query_queue.remove(query)
+        self.query_queue_lock.release()
+        self.results_temp_lock.acquire()
+        for result_temp in self.results_temp.values():
+            if result_temp.cell == cell:
+                self.kernel_manager.interrupt_kernel()
+        self.results_temp_lock.release()
+
+    def remove_all_queries(self):
+        self.query_queue_lock.acquire()
+        queue_empty = (len(self.query_queue) == 0)
+        self.query_queue_lock.release()
+        while not queue_empty:
+            self.query_queue_lock.acquire()
+            try: query = self.query_queue.pop(0)
+            except IndexError: query = None
+            self.query_queue_lock.release()
+            if query != None:
+                result = Result(query.worksheet, query.cell)
+                result.result_message = 'evaluation_stopped'
+                self.result_queue.put(result)
+                self.query_queue_lock.acquire()
+                queue_empty = (len(self.query_queue) == 0)
+                self.query_queue_lock.release()
+
+    def fetch_results(self):
+        while True:
+            '''try: print(self.client.get_stdin_msg(timeout=0.1))
+            except queue.Empty: pass
+            try: print(self.client.get_shell_msg(timeout=0.1))
+            except queue.Empty: pass'''
+            try: result = self.client.get_iopub_msg(timeout=1)
+            except queue.Empty: pass
+            else:
+                #print(result)
+                try: query_id = result['parent_header']['msg_id']
+                except KeyError: pass
+                else:
+                    if result['parent_header']['msg_type'] == 'shutdown_request':
+                        return
+                    else:
+                        self.results_temp_lock.acquire()
+                        worksheet = self.results_temp[query_id].worksheet
+                        cell = self.results_temp[query_id].cell
+                        self.results_temp_lock.release()
+                        if result['msg_type'] == 'execute_input':
+                            eval_started_result = Result(worksheet, cell)
+                            eval_started_result.result_list.append(result)
+                            self.result_queue.put(eval_started_result)
+                        else:
+                            self.results_temp_lock.acquire()
+                            self.results_temp[query_id].result_list.append(result)
+                            if result['content'].get('execution_state', '') == 'idle':
+                                self.result_queue.put(self.results_temp[query_id])
+                                del(self.results_temp[query_id])
+                            self.results_temp_lock.release()
+
+    def shutdown(self):
+        self.client.shutdown()
+
+
+class Result():
+
+    def __init__(self, worksheet, cell):
+        self.worksheet = worksheet
+        self.cell = cell
+        self.result_list = list()
+        self.result_message = None
+
+