├── .gitignore ├── CHANGELOG ├── INSTALL ├── INSTALL.mac ├── LICENSE ├── README.md ├── TODO ├── bin ├── lib │ ├── inbuilts.dart │ ├── pyrandom.dart │ ├── pytime.dart │ ├── slice.dart │ ├── sprintf.dart │ └── src │ │ ├── formatters │ │ ├── Formatter.dart │ │ ├── float_formatter.dart │ │ ├── int_formatter.dart │ │ └── string_formatter.dart │ │ └── sprintf_impl.dart └── transform.py ├── docs ├── About.rst ├── DevDocs.rst ├── Intro.rst ├── License.rst ├── Makefile ├── _build │ ├── doctrees │ │ ├── About.doctree │ │ ├── DevDocs.doctree │ │ ├── DevWorkflow.doctree │ │ ├── Intro.doctree │ │ ├── License.doctree │ │ ├── MedDevTeam.doctree │ │ ├── environment.pickle │ │ ├── index.doctree │ │ ├── indro.doctree │ │ ├── installation.doctree │ │ └── workflow.doctree │ └── html │ │ ├── .buildinfo │ │ ├── About.html │ │ ├── DevDocs.html │ │ ├── DevWorkflow.html │ │ ├── Intro.html │ │ ├── License.html │ │ ├── MedDevTeam.html │ │ ├── _images │ │ └── image1.png │ │ ├── _sources │ │ ├── About.txt │ │ ├── DevDocs.txt │ │ ├── DevWorkflow.txt │ │ ├── Intro.txt │ │ ├── License.txt │ │ ├── MedDevTeam.txt │ │ ├── index.txt │ │ ├── indro.txt │ │ ├── installation.txt │ │ └── workflow.txt │ │ ├── _static │ │ ├── ajax-loader.gif │ │ ├── basic.css │ │ ├── comment-bright.png │ │ ├── comment-close.png │ │ ├── comment.png │ │ ├── default.css │ │ ├── doctools.js │ │ ├── down-pressed.png │ │ ├── down.png │ │ ├── file.png │ │ ├── image1.png │ │ ├── jquery.js │ │ ├── minus.png │ │ ├── plus.png │ │ ├── pygments.css │ │ ├── searchtools.js │ │ ├── sidebar.js │ │ ├── underscore.js │ │ ├── up-pressed.png │ │ ├── up.png │ │ └── websupport.js │ │ ├── genindex.html │ │ ├── index.html │ │ ├── installation.html │ │ ├── objects.inv │ │ ├── search.html │ │ ├── searchindex.js │ │ └── workflow.html ├── _static │ └── image1.png ├── autodoc ├── conf.py ├── index.rst ├── installation.rst └── make.bat ├── icon.jpg ├── icon.png ├── inc ├── cache.h ├── exec.h ├── sha256.h ├── static_data.h └── transform.h ├── medusa.pro └── src ├── cache.cpp ├── exec.cpp ├── main.cpp ├── sha256.cpp └── transform.cpp /.gitignore: -------------------------------------------------------------------------------- 1 | **/.DS_Store 2 | medusavm 3 | .qmake.stash 4 | Makefile 5 | inc/transform_moc.h 6 | -------------------------------------------------------------------------------- /CHANGELOG: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/CHANGELOG -------------------------------------------------------------------------------- /INSTALL: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | echo "Checking for Qt5 Libs..." 4 | if dpkg -s qtdeclarative5-dev > /dev/null 2>&1 5 | then 6 | echo "Qt5 Libs found, moving on..." 7 | else 8 | echo "Qt5 Libs not found, installing..." 9 | sudo apt-add-repository -y ppa:ubuntu-sdk-team/ppa 10 | sudo apt-get update 11 | sudo apt-get -y install qtdeclarative5-dev 12 | fi 13 | 14 | echo "Checking for Python 2.7 Installation..." 15 | if type "python" > /dev/null 2>&1 16 | then 17 | echo "Python 2.7 found, moving on..." 18 | else 19 | echo "Python 2.7 not found, installing..." 20 | sudo apt-get -y install python 21 | fi 22 | 23 | echo "Checking for Dart SDK Installation..." 24 | if type "dart" > /dev/null 2>&1 25 | then 26 | echo "Dart SDK found, moving on..." 27 | else 28 | echo "Dart SDK not found, installing..." 29 | sudo apt-get update 30 | sudo apt-get install apt-transport-https 31 | sudo sh -c 'curl https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -' 32 | sudo sh -c 'curl https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > /etc/apt/sources.list.d/dart_stable.list' 33 | sudo apt-get update 34 | sudo apt-get install dart/stable 35 | fi 36 | 37 | echo "Checking for C++ compilers..." 38 | qmake_opt="" 39 | if type "clang++" > /dev/null 2>&1 40 | then 41 | echo "clang++ found, using it." 42 | qmake_opt="-recursive -spec linux-clang" 43 | elif type "g++" > /dev/null 2>&1 44 | then 45 | echo "g++ found, using it." 46 | else 47 | echo "No C++ compilers found. Installing GNU build tools..." 48 | sudo apt-get -y install build-essential 49 | fi 50 | 51 | echo "All dependencies satisified! We are good to go... :D" 52 | echo "Starting Medusa build..." 53 | 54 | echo "Setting Qt5 build home.." 55 | if [ -d /usr/lib/x86_64-linux-gnu/qt5 ]; 56 | then 57 | qHome="/usr/lib/x86_64-linux-gnu/qt5/bin" 58 | else 59 | qHome="/usr/lib/i686-linux-gnu/qt5/bin" 60 | fi 61 | echo "Qt5 build home set at: " $qHome 62 | 63 | echo "moc'ing transform.h..." 64 | $qHome/moc inc/transform.h > inc/transform_moc.h 65 | echo "Done!" 66 | 67 | echo "Generating Makefile..." 68 | $qHome/qmake -o Makefile medusa.pro $qmake_opt 69 | echo "Done" 70 | 71 | echo "Building and Installing Medusa 2.7.3..." 72 | make -j $(grep -c ^processor /proc/cpuinfo) 73 | sudo make install 74 | make clean 75 | echo "Done!" 76 | 77 | echo "Installing Medusa 2.7.3 Runtime..." 78 | if [ ! -d ~/.medusa ]; 79 | then 80 | echo "Creating Medusa Home Directory" 81 | mkdir ~/.medusa 82 | fi 83 | echo "Installing Dart Libs and FPT Transformer" 84 | cp -a bin/. ~/.medusa 85 | echo "Medusa 2.7.3 Successfully installed Yo! Runnable directly as 'medusavm' from the terminal. Happy Pythoning!" 86 | -------------------------------------------------------------------------------- /INSTALL.mac: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | echo "Checking for qmake..." 4 | if type "qmake" > /dev/null 2>&1 5 | then 6 | echo "qmake found, moving on..." 7 | else 8 | echo "qmake not found, Install Qt5 first." 9 | exit 10 | fi 11 | 12 | echo "Checking for moc..." 13 | if type "moc" > /dev/null 2>&1 14 | then 15 | echo "moc found, moving on..." 16 | else 17 | echo "moc not found, Install Qt5 first." 18 | exit 19 | fi 20 | 21 | echo "Checking for Python 2.7..." 22 | if type "python" > /dev/null 2>&1 23 | then 24 | echo "Python 2.7 found, moving on..." 25 | else 26 | echo "Python 2.7 not found, Install Python 2.7.x." 27 | exit 28 | fi 29 | 30 | echo "Checking for dart..." 31 | if type "dart" > /dev/null 2>&1 32 | then 33 | echo "Dart VM found, moving on..." 34 | else 35 | echo "Dart VM not found, Install Dart SDK first." 36 | exit 37 | fi 38 | 39 | echo "Checking for clang++..." 40 | if type "clang++" > /dev/null 2>&1 41 | then 42 | echo "clang++ found, moving on..." 43 | else 44 | echo "clang++ compilers found. Instal XCode first..." 45 | exit 46 | fi 47 | 48 | echo "All dependencies satisified! We are good to go... :D" 49 | echo "Starting Medusa build..." 50 | 51 | echo "moc'ing transform.h..." 52 | moc inc/transform.h > inc/transform_moc.h 53 | echo "Done!" 54 | 55 | echo "Generating Makefile..." 56 | qmake -o Makefile medusa.pro -recursive -spec macx-clang 57 | echo "Done" 58 | 59 | echo "Buliding and Installing Medusa 2.7.3..." 60 | make -j $(sysctl -n hw.ncpu) 61 | sudo make install 62 | make clean 63 | echo "Done!" 64 | 65 | echo "Installing Medusa 2.7.3 Runtime..." 66 | if [ ! -d ~/.medusa ]; 67 | then 68 | echo "Creating Medusa Home Directory" 69 | mkdir ~/.medusa 70 | fi 71 | echo "Installing Dart Libs and FPT Transformer" 72 | cp -a bin/. ~/.medusa 73 | echo "Medusa 2.7.3 Successfully installed Yo! Runnable directly as 'medusavm' from the terminal. Happy Pythoning!" 74 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The BSD 3-Clause License 2 | 3 | Copyright (c) 2013-2014, Rahul De, Apoorv Agarwal and Aakash Giri. VIT University 4 | All rights reserved. 5 | 6 | Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 7 | 8 | 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 9 | 10 | 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 11 | 12 | 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 13 | 14 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ## Medusa 2 | 3 | [![Join the chat at https://gitter.im/rahul080327/medusa](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/rahul080327/medusa?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 4 | 5 | ![alt tag](https://raw.github.com/rahul080327/medusa/master/icon.png) 6 | 7 | An attempt at making Python stronger and faster like Medusa herself! 8 | 9 | Python being an interpreted language has its pros and cons and the aim is to fix one of the most obvious cons of Python: its execution speed. 10 | We all love Python for its simplicity and flexibility but when it comes to writing large volumes of code involving complex operations and recursions Python somewhat falls short compared to the other native/JIT languages. 11 | 12 | In late 2012, Google came up with Dart, a language aiming for the unification of server and client side web development and scalable apps. Along with it came The Dart Virtual Machine. A hyper fast VM which builds upon the V8 js engine and even outperforms it. We decided why not let Python have a go on this? 13 | 14 | The main aim behind creating the Medusa project is giving a typless and flexible language like Python a faster execution environment while still maintaining all its flexibility which we all love. Numerous projects such as the ShedSkin project which converts implicitly typed Python to C++ have tried doing it, but have put some or the other restriction on the input Python code. The Medusa project aims at running pre-existing Python code without any or minimal modification at a much faster rates compared to the usual implementations. 15 | 16 | Still in its nascent stages and implemented using Qt/C++, Python and Dart, the project works by compiling Python code to a highly optimized Dart code in real time, persistently caching it and letting it rip on the Dart VM. The Dart VM like V8 compiles the dart code directly to machine code and using its vast array of runtime optimizations runs at a much higher speed compared to the CPython implementation and at times upto a 1000 - 1500% faster while maintaining all the features Python offers. Apart from this Python is further enriched with extra features provided by the Dart VM and you can do more stuff with Python which isn't possible with the vanilla Python. 17 | 18 | ## Installing 19 | 20 | Ubuntu/Ubuntu-derived Linux users: 21 | 22 | Simply run ./INSTALL after cloning this repo on your Ubuntu based Linux distro. Thats it. All dependencies are installed, code compiled and paths setup automatically. 23 | 24 | Mac OSX Users (packaged app): 25 | Coming Soon ;) Thanks for your patience. 26 | 27 | Mac OSX Users (building from source): 28 | * Install Xcode if not installed (Sorry for the bandwidth hogging...) 29 | * Install python 2.7.x if not installed and add it to PATH 30 | * Download and Install latest Qt5 for Mac from [here](http://qt-project.org/downloads) and add qmake and moc to PATH 31 | * Download the latest Dart SDK from [here](https://storage.googleapis.com/dart-archive/channels/stable/release/latest/sdk/dartsdk-macos-ia32-release.zip), unzip and add the dart executable to PATH 32 | * Clone this repo and simply run ./INSTALL.mac 33 | * After a succesful compile medusavm binary is available in /usr/bin/ for use 34 | * For updates and subsequent builds, fetch changes and just run ./INSTALL.mac 35 | 36 | Yeah, I finally have a MacBook! ^_^ 37 | 38 | Others: 39 | * Install C++ compilers and Make tools 40 | * Install Qt5 build tools and libs 41 | * Install Dart SDK 42 | * Install Python 2.7.x 43 | * Rum moc on inc/transform.h to inc/transform_moc.h 44 | * Run qmake on medusa.pro 45 | * Run make 46 | * Use the medusavm executable 47 | 48 | ## Running 49 | 50 | Using Medusa: 51 | * Medusa is available as medusavm after a successful buid and install 52 | * Python programs can be run by passing them as parameters: medusavm hello.py 53 | * Medusa can be stopped after the Dart compile phase by passing a -c switch: medusavm -c hello.py. The Dart code is obtained in hello.dart in the same directory. 54 | * Python files can be globally installed into Medusa for imports by other files: medusavm -install python_file 55 | * Help is at: medusavm --help 56 | 57 | ## Documentation 58 | 59 | The medusa's documentation for developers and users can be accessed [here](http://medusa.readthedocs.org/) 60 | 61 | 62 | ## Contributing 63 | 64 | We'd love to have your help in making Medusa better and Python faster. Any and all contributions are welcome. Frankly speaking there's still a hell lot to do. 65 | 66 | ## License 67 | 68 | The BSD 3-Clause License 69 | 70 | Copyright (c) 2013-2014, Rahul De, Apoorv Agarwal and Aakash Giri. VIT University 71 | All rights reserved. 72 | 73 | Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 74 | 75 | 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 76 | 77 | 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 78 | 79 | 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 80 | 81 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 82 | 83 | ## Fear and Respect her at the same time! 84 | 85 | ![alt tag](https://raw.github.com/rahul080327/medusa/master/icon.jpg) 86 | 87 | ## Just Kidding, Happy Pythoning Yo! 88 | -------------------------------------------------------------------------------- /TODO: -------------------------------------------------------------------------------- 1 | 1. Support for native OS functionality 2 | -------------------------------------------------------------------------------- /bin/lib/pyrandom.dart: -------------------------------------------------------------------------------- 1 | import "dart:math"; 2 | import "inbuilts.dart"; 3 | 4 | class $PyRandom { 5 | var _rng; 6 | 7 | $PyRandom([s]) { 8 | seed(s); 9 | } 10 | 11 | seed([value]) { 12 | if (value == null) 13 | _rng = new Random(); 14 | else 15 | _rng = new Random(value.value()); 16 | } 17 | 18 | randrange(start, [stop, step = 1]) { 19 | var space; 20 | 21 | if (stop == null) 22 | space = range(start); 23 | else if (step != 1) 24 | space = range(start, stop, step); 25 | else 26 | space = range(start, stop); 27 | 28 | return space.toList()[_rng.nextInt(space.length - 1)]; 29 | } 30 | 31 | randint(a, b) => new $PyNum(range(a, b).toList()[_rng.nextInt((b - a) - 1)]); 32 | choice(seq) => seq[_rng.nextInt(seq.length - 1)]; 33 | shuffle(x, [rand]) => x.shuffle(); 34 | random() => new $PyNum(_rng.nextDouble()); 35 | } 36 | -------------------------------------------------------------------------------- /bin/lib/pytime.dart: -------------------------------------------------------------------------------- 1 | library PyTime; 2 | 3 | import "inbuilts.dart"; 4 | 5 | class $PyTime { 6 | var _tobj; 7 | 8 | $PyTime() { 9 | _tobj = new DateTime.now(); 10 | } 11 | 12 | time() => new $PyNum(_tobj.millisecondsSinceEpoch); 13 | } -------------------------------------------------------------------------------- /bin/lib/slice.dart: -------------------------------------------------------------------------------- 1 | library slice; 2 | 3 | import "dart:collection"; 4 | import "dart:mirrors"; 5 | 6 | $slice(list, lower, higher, step) { 7 | var c = []; 8 | var i = 0; 9 | 10 | lower = lower.value(); 11 | higher = higher.value(); 12 | step = step.value(); 13 | 14 | if (higher < 0) 15 | higher = list.length.value() + higher; 16 | 17 | if (lower < 0) 18 | lower = list.length.value() + lower; 19 | 20 | if (lower > list.length.value() - 1) 21 | lower = list.length.value() - 1; 22 | 23 | if (higher > list.length.value() - 1) 24 | higher = list.length.value() - 1; 25 | 26 | if (step < 0) { 27 | for (i = lower; i >= higher; i += step) 28 | c.add(list[i]); 29 | } else { 30 | for (i = lower; i < higher; i += step) 31 | c.add(list[i]); 32 | } 33 | 34 | return c; 35 | } -------------------------------------------------------------------------------- /bin/lib/sprintf.dart: -------------------------------------------------------------------------------- 1 | library sprintf; 2 | 3 | import 'dart:math'; 4 | 5 | part 'src/formatters/Formatter.dart'; 6 | part 'src/formatters/int_formatter.dart'; 7 | part 'src/formatters/float_formatter.dart'; 8 | part 'src/formatters/string_formatter.dart'; 9 | part 'src/sprintf_impl.dart'; 10 | 11 | typedef SPrintF(String fmt, var args); 12 | 13 | var $sprintf = new PrintFormat(); 14 | -------------------------------------------------------------------------------- /bin/lib/src/formatters/Formatter.dart: -------------------------------------------------------------------------------- 1 | part of sprintf; 2 | 3 | class Formatter { 4 | 5 | var fmt_type; 6 | var options; 7 | 8 | Formatter(this.fmt_type, this.options); 9 | 10 | static String get_padding(int count, String pad) { 11 | String padding_piece = pad; 12 | StringBuffer padding = new StringBuffer(); 13 | 14 | while (count > 0) { 15 | if ((count & 1) == 1) { padding.write(padding_piece); } 16 | count >>= 1; 17 | padding_piece = "${padding_piece}${padding_piece}"; 18 | } 19 | 20 | return padding.toString(); 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /bin/lib/src/formatters/float_formatter.dart: -------------------------------------------------------------------------------- 1 | part of sprintf; 2 | 3 | class FloatFormatter extends Formatter { 4 | // TODO: can't rely on '.' being the decimal separator 5 | static final _number_rx = new RegExp(r'^[\-\+]?(\d+)\.(\d+)$'); 6 | static final _expo_rx = new RegExp(r'^[\-\+]?(\d)\.(\d+)e([\-\+]?\d+)$'); 7 | static final _leading_zeroes_rx = new RegExp(r'^(0*)[1-9]+'); 8 | 9 | double _arg; 10 | List _digits = new List(); 11 | int _exponent = 0; 12 | int _decimal = 0; 13 | bool _is_negative = false; 14 | bool _fraction_is_negative = false; 15 | bool _has_init = false; 16 | String _output = null; 17 | 18 | FloatFormatter(this._arg, var fmt_type, var options) : super(fmt_type, options) { 19 | if (_arg < 0) { 20 | this._is_negative = true; 21 | _arg = -_arg; 22 | } 23 | 24 | String arg_str = _arg.toDouble().toString(); 25 | 26 | Match m1 = _number_rx.firstMatch(arg_str); 27 | if (m1 != null) { 28 | String int_part = m1.group(1); 29 | String fraction = m1.group(2); 30 | 31 | /* 32 | * Cases: 33 | * 1.2345 = 1.2345e0 -> [12345] e+0 d1 l5 34 | * 123.45 = 1.2345e2 -> [12345] e+2 d3 l5 35 | * 0.12345 = 1.2345e-1 -> [012345] e-1 d1 l6 36 | * 0.0012345 = 1.2345e-3 -> [00012345] e-3 d1 l8 37 | */ 38 | 39 | _decimal = int_part.length; 40 | _digits.addAll(int_part.split('')); 41 | _digits.addAll(fraction.split('')); 42 | 43 | if (int_part.length == 1) { 44 | if (int_part == '0') { 45 | Match leading_zeroes_match = _leading_zeroes_rx.firstMatch(fraction); 46 | 47 | if (leading_zeroes_match != null) { 48 | int zeroes_count = leading_zeroes_match.group(1).length; 49 | // print("zeroes_count=${zeroes_count}"); 50 | _exponent = zeroes_count > 0 ? -(zeroes_count + 1) : zeroes_count - 1; 51 | } 52 | else { 53 | _exponent = 0; 54 | } 55 | } // else int_part != 0 56 | else { 57 | _exponent = 0; 58 | } 59 | } 60 | else { 61 | _exponent = int_part.length - 1; 62 | } 63 | } 64 | 65 | else { 66 | Match m2 = _expo_rx.firstMatch(arg_str); 67 | if (m2 != null) { 68 | String int_part = m2.group(1); 69 | String fraction = m2.group(2); 70 | _exponent = int.parse(m2.group(3)); 71 | 72 | if (_exponent > 0) { 73 | int diff = _exponent - fraction.length + 1; 74 | _decimal = _exponent + 1; 75 | _digits.addAll(int_part.split('')); 76 | _digits.addAll(fraction.split('')); 77 | _digits.addAll(Formatter.get_padding(diff, '0').split('')); 78 | } 79 | else { 80 | int diff = int_part.length - _exponent - 1; 81 | _decimal = int_part.length; 82 | _digits.addAll(Formatter.get_padding(diff, '0').split('')); 83 | _digits.addAll(int_part.split('')); 84 | _digits.addAll(fraction.split('')); 85 | } 86 | 87 | 88 | } // else something wrong 89 | } 90 | _has_init = true; 91 | //print("arg_str=${arg_str}"); 92 | //print("decimal=${_decimal}, exp=${_exponent}, digits=${_digits}"); 93 | } 94 | 95 | String asString() { 96 | String ret = ''; 97 | 98 | if (!_has_init) { 99 | return ret; 100 | } 101 | 102 | if (_output != null) { 103 | return _output; 104 | } 105 | 106 | if (options['add_space'] && options['sign'] == '' && _arg >= 0) { 107 | options['sign'] = ' '; 108 | } 109 | 110 | if (_arg.isInfinite) { 111 | if (_arg.isNegative) { 112 | options['sign'] = '-'; 113 | } 114 | 115 | ret = 'inf'; 116 | options['padding_char'] = ' '; 117 | } 118 | 119 | if (_arg.isNaN) { 120 | ret = 'nan'; 121 | options['padding_char'] = ' '; 122 | } 123 | 124 | if (options['precision'] == -1) { 125 | options['precision'] = 6; // TODO: make this configurable 126 | } 127 | else if (fmt_type == 'g' && options['precision'] == 0) { 128 | options['precision'] = 1; 129 | } 130 | 131 | if (_arg is num) { 132 | if (_is_negative) { 133 | options['sign'] = '-'; 134 | } 135 | 136 | if (fmt_type == 'e') { 137 | ret = asExponential(options['precision'], remove_trailing_zeros : false); 138 | } 139 | else if (fmt_type == 'f') { 140 | ret = asFixed(options['precision'], remove_trailing_zeros : false); 141 | } 142 | else { // type == g 143 | int _exp = _exponent; 144 | var sig_digs = options['precision']; 145 | // print("${_exp} ${sig_digs}"); 146 | if (-4 <= _exp && _exp < options['precision']) { 147 | sig_digs -= _decimal; 148 | num precision = max(options['precision'] - 1 - _exp, sig_digs); 149 | 150 | ret = asFixed(precision, remove_trailing_zeros : !options['alternate_form']); 151 | } 152 | else { 153 | ret = asExponential(options['precision'] - 1, remove_trailing_zeros : !options['alternate_form']); 154 | } 155 | } 156 | } 157 | 158 | var min_chars = options['width']; 159 | num str_len = ret.length + options['sign'].length; 160 | String padding = ''; 161 | 162 | if (min_chars > str_len) { 163 | if (options['padding_char'] == '0' && !options['left_align']) { 164 | padding = Formatter.get_padding(min_chars - str_len, '0'); 165 | } 166 | else { 167 | padding = Formatter.get_padding(min_chars - str_len, ' '); 168 | } 169 | } 170 | 171 | if (options['left_align']) { 172 | ret ="${options['sign']}${ret}${padding}"; 173 | } 174 | else if (options['padding_char'] == '0') { 175 | ret = "${options['sign']}${padding}${ret}"; 176 | } 177 | else { 178 | ret = "${padding}${options['sign']}${ret}"; 179 | } 180 | 181 | if (options['is_upper']) { 182 | ret = ret.toUpperCase(); 183 | } 184 | 185 | return (_output = ret); 186 | } 187 | 188 | String asFixed(int precision, {bool remove_trailing_zeros : true}) { 189 | String ret = _digits.sublist(0, _decimal).fold('', (i,e) => "${i}${e}"); 190 | int offset = _decimal; 191 | int extra_zeroes = precision - (_digits.length - offset); 192 | int rounding_offset = offset + precision ; 193 | 194 | if (extra_zeroes > 0) { 195 | _digits.addAll(Formatter.get_padding(extra_zeroes, '0').split('')); 196 | } 197 | 198 | _round(rounding_offset, offset); 199 | 200 | List trailing_digits = _digits.sublist(offset, offset + precision); 201 | if (remove_trailing_zeros) { 202 | trailing_digits = _remove_trailing_zeros(trailing_digits); 203 | } 204 | var trailing_zeroes = trailing_digits.fold('', (i,e) => "${i}${e}"); 205 | if (trailing_zeroes.length == 0) { 206 | return ret; 207 | } 208 | ret = "${ret}.${trailing_zeroes}"; 209 | 210 | return ret; 211 | } 212 | 213 | String asExponential(int precision, {bool remove_trailing_zeros : true}) { 214 | int offset = _decimal - _exponent; 215 | String ret = _digits[offset-1]; 216 | 217 | 218 | int extra_zeroes = precision - (_digits.length - offset); 219 | 220 | if (extra_zeroes > 0) { 221 | _digits.addAll(Formatter.get_padding(extra_zeroes, '0').split('')); 222 | } 223 | 224 | _round(offset + precision, offset); 225 | 226 | //print ("(${offset}, ${precision})${_digits}"); 227 | List trailing_digits = _digits.sublist(offset, offset + precision); 228 | // print ("trailing_digits=${trailing_digits}"); 229 | String _exp_str = _exponent.abs().toString(); 230 | 231 | 232 | if (_exponent < 10 && _exponent > -10) { 233 | _exp_str = "0${_exp_str}"; 234 | } 235 | 236 | _exp_str = (_exponent < 0) ? "e-${_exp_str}" : "e+${_exp_str}"; 237 | 238 | if (remove_trailing_zeros) { 239 | trailing_digits = _remove_trailing_zeros(trailing_digits); 240 | } 241 | 242 | if (trailing_digits.length > 0) { 243 | ret += '.'; 244 | } 245 | 246 | ret = trailing_digits.fold(ret, (i, e) => "${i}${e}"); 247 | ret = "${ret}${_exp_str}"; 248 | 249 | return ret; 250 | } 251 | 252 | List _remove_trailing_zeros(List trailing_digits) { 253 | int nzeroes = 0; 254 | for (int i = trailing_digits.length - 1; i >= 0; i--) { 255 | if (trailing_digits[i] == '0') { 256 | nzeroes++; 257 | } 258 | else { 259 | break; 260 | } 261 | } 262 | return trailing_digits.sublist(0, trailing_digits.length - nzeroes); 263 | } 264 | 265 | void _round(var rounding_offset, var offset) { 266 | int carry = 0; 267 | while (rounding_offset > offset && rounding_offset < _digits.length) { 268 | int d = int.parse(_digits[rounding_offset]) + carry; 269 | if (d >= 5) { 270 | int prev = int.parse(_digits[rounding_offset - 1]) + 1; 271 | carry = prev > 9 ? 1 : 0; 272 | if (carry > 0) { 273 | prev = 0; 274 | } 275 | _digits[rounding_offset - 1] = prev.toString(); 276 | if (carry == 0) { 277 | break; 278 | } 279 | } 280 | else { 281 | break; 282 | } 283 | rounding_offset--; 284 | } 285 | } 286 | 287 | } -------------------------------------------------------------------------------- /bin/lib/src/formatters/int_formatter.dart: -------------------------------------------------------------------------------- 1 | part of sprintf; 2 | 3 | class IntFormatter extends Formatter { 4 | int _arg; 5 | static const int MAX_INT = 0xffffffffffffffff; // 64bit 6 | IntFormatter(this._arg, var fmt_type, var options) : super(fmt_type, options); 7 | 8 | String asString() { 9 | String ret = ''; 10 | String prefix = ''; 11 | 12 | int radix = fmt_type == 'x' ? 16 : (fmt_type == 'o' ? 8 : 10); 13 | 14 | if (_arg < 0) { 15 | _arg = _arg.abs(); 16 | if (radix == 10) { 17 | options['sign'] = '-'; 18 | } 19 | else { 20 | _arg = (MAX_INT - (_arg % MAX_INT) + 1) & MAX_INT; 21 | } 22 | } 23 | 24 | ret = _arg.toRadixString(radix); 25 | 26 | if (options['alternate_form']) { 27 | if (radix == 16 && _arg != 0) { 28 | prefix = "0x"; 29 | } 30 | else if (radix == 8 && _arg != 0) { 31 | prefix = "0"; 32 | } 33 | if (options['sign'] == '+' && radix != 10) { 34 | options['sign'] = ''; 35 | } 36 | } 37 | 38 | // space "prefixes non-negative signed numbers with a space" 39 | if ((options['add_space'] && options['sign'] == '' && _arg > -1 && radix == 10)) { 40 | options['sign'] = ' '; 41 | } 42 | 43 | if (radix != 10) { 44 | options['sign'] = ''; 45 | } 46 | 47 | String padding = ''; 48 | var min_digits = options['precision']; 49 | var min_chars = options['width']; 50 | int num_length = ret.length; 51 | var sign_length = options['sign'].length; 52 | num str_len = 0; 53 | 54 | if (radix == 8 && min_chars <= min_digits) { 55 | num_length += prefix.length; 56 | } 57 | 58 | if (min_digits > num_length) { 59 | padding = Formatter.get_padding(min_digits - num_length, '0'); 60 | ret = "${padding}${ret}"; 61 | num_length = ret.length; 62 | padding = ''; 63 | } 64 | 65 | str_len = num_length + sign_length + prefix.length; 66 | if (min_chars > str_len) { 67 | if (options['padding_char'] == '0' && !options['left_align']) { 68 | padding = Formatter.get_padding(min_chars - str_len, '0'); 69 | } 70 | else { 71 | padding = Formatter.get_padding(min_chars - str_len, ' '); 72 | } 73 | } 74 | 75 | if (options['left_align']) { 76 | ret ="${options['sign']}${prefix}${ret}${padding}"; 77 | } 78 | else if (options['padding_char'] == '0') { 79 | ret = "${options['sign']}${prefix}${padding}${ret}"; 80 | } 81 | else { 82 | ret = "${padding}${options['sign']}${prefix}${ret}"; 83 | } 84 | 85 | if (options['is_upper']) { 86 | ret = ret.toUpperCase(); 87 | } 88 | 89 | return ret; 90 | } 91 | } 92 | -------------------------------------------------------------------------------- /bin/lib/src/formatters/string_formatter.dart: -------------------------------------------------------------------------------- 1 | part of sprintf; 2 | 3 | class StringFormatter extends Formatter { 4 | String _arg; 5 | 6 | StringFormatter(this._arg, var fmt_type, var options) : super(fmt_type, options) { 7 | options['padding_char'] = ' '; 8 | } 9 | 10 | String asString() { 11 | String ret = _arg; 12 | 13 | if (options['precision'] > -1 && options['precision'] <= ret.length) { 14 | ret = ret.substring(0, options['precision']); 15 | } 16 | 17 | if (options['width'] > -1) { 18 | int diff = (options['width'] - ret.length); 19 | 20 | if (diff > 0) { 21 | String padding = Formatter.get_padding(diff, options['padding_char']); 22 | if (!options['left_align']) { 23 | ret = "${padding}${ret}"; 24 | } 25 | else { 26 | ret = "${ret}${padding}"; 27 | } 28 | } 29 | } 30 | return ret; 31 | } 32 | } -------------------------------------------------------------------------------- /bin/lib/src/sprintf_impl.dart: -------------------------------------------------------------------------------- 1 | part of sprintf; 2 | 3 | typedef PrintFormatFormatter(arg, options); 4 | 5 | class PrintFormat { 6 | static final RegExp specifier = new RegExp(r'%(?:(\d+)\$)?([\+\-\#0 ]*)(\d+|\*)?(?:\.(\d+|\*))?([a-z%])', caseSensitive : false); 7 | static final RegExp uppercase_rx = new RegExp(r'[A-Z]', caseSensitive: true); 8 | 9 | var _formatters = { 10 | 'i' : (arg, options) => new IntFormatter(arg, 'i', options), 11 | 'd' : (arg, options) => new IntFormatter(arg, 'd', options), 12 | 'x' : (arg, options) => new IntFormatter(arg, 'x', options), 13 | 'X' : (arg, options) => new IntFormatter(arg, 'x', options), 14 | 'o' : (arg, options) => new IntFormatter(arg, 'o', options), 15 | 'O' : (arg, options) => new IntFormatter(arg, 'o', options), 16 | 17 | 'e' : (arg, options) => new FloatFormatter(arg, 'e', options), 18 | 'E' : (arg, options) => new FloatFormatter(arg, 'e', options), 19 | 'f' : (arg, options) => new FloatFormatter(arg, 'f', options), 20 | 'F' : (arg, options) => new FloatFormatter(arg, 'f', options), 21 | 'g' : (arg, options) => new FloatFormatter(arg, 'g', options), 22 | 'G' : (arg, options) => new FloatFormatter(arg, 'g', options), 23 | 24 | 's' : (arg, options) => new StringFormatter(arg, 's', options), 25 | }; 26 | 27 | String call(String fmt, var args) { 28 | String ret = ''; 29 | 30 | 31 | int offset = 0; 32 | int arg_offset = 0; 33 | 34 | if (args is! List) { 35 | throw new ArgumentError('Expecting list as second argument'); 36 | } 37 | 38 | for (Match m in specifier.allMatches(fmt)) { 39 | String _parameter = m[1]; 40 | String _flags = m[2]; 41 | String _width = m[3]; 42 | String _precision = m[4]; 43 | String _type = m[5]; 44 | 45 | String _arg_str = ''; 46 | Map _options = { 47 | 'is_upper' : false, 48 | 'width' : -1, 49 | 'precision' : -1, 50 | 'length' : -1, 51 | 'radix' : 10, 52 | 'sign' : '', 53 | 'specifier_type' : _type, 54 | }; 55 | 56 | _parse_flags(_flags).forEach((var K, var V) { _options[K] = V; }); 57 | 58 | // The argument we want to deal with 59 | var _arg = _parameter == null ? null : args[int.parse(_parameter)]; 60 | 61 | // parse width 62 | if (_width != null) { 63 | _options['width'] = (_width == '*' ? args[arg_offset++] : int.parse(_width)); 64 | } 65 | 66 | // parse precision 67 | if (_precision != null) { 68 | _options['precision'] = (_precision == '*' ? args[arg_offset++] : int.parse(_precision)); 69 | } 70 | 71 | // grab the argument we'll be dealing with 72 | if (_arg == null && _type != '%') { 73 | _arg = args[arg_offset++]; 74 | } 75 | 76 | _options['is_upper'] = uppercase_rx.hasMatch(_type); 77 | 78 | if (_type == '%') { 79 | if (_flags.length > 0 || _width != null || _precision != null) { 80 | throw new Exception('"%" does not take any flags'); 81 | } 82 | _arg_str = '%'; 83 | } 84 | else if (this._formatters.containsKey(_type)) { 85 | _arg_str = _formatters[_type](_arg, _options).asString(); 86 | } 87 | else { 88 | throw new ArgumentError("Unknown format type ${_type}"); 89 | } 90 | 91 | // Add the pre-format string to the return 92 | ret += fmt.substring(offset, m.start); 93 | offset = m.end; 94 | 95 | ret += _arg_str; 96 | } 97 | 98 | return ret += fmt.substring(offset); 99 | } 100 | 101 | register_specifier(String specifier, PrintFormatFormatter formatter) { 102 | this._formatters[specifier] = formatter; 103 | } 104 | 105 | unregistier_specifier(String specifier) { 106 | this._formatters.remove(specifier); 107 | } 108 | 109 | Map _parse_flags(String flags) { 110 | return { 111 | 'sign' : flags.indexOf('+') > -1 ? '+' : '', 112 | 'padding_char' : flags.indexOf('0') > -1 ? '0' : ' ', 113 | 'add_space' : flags.indexOf(' ') > -1, 114 | 'left_align' : flags.indexOf('-') > -1, 115 | 'alternate_form' : flags.indexOf('#') > -1, 116 | }; 117 | } 118 | } 119 | -------------------------------------------------------------------------------- /docs/About.rst: -------------------------------------------------------------------------------- 1 | ===== 2 | About 3 | ===== 4 | Development Team 5 | ================ 6 | 7 | This project was started by `Rahul De' `_, Apoorv Agarwal and Akash Giri in the spring of 2014. 8 | 9 | Everyone who has contributed towards this project are: 10 | 11 | 1. `Rahul De' `_ 12 | 2. `Apoorv Agarwal `_ 13 | 3. `Akash Giri `_ 14 | 4. Pratik Shah 15 | 5. `Mayuresh Waykole `_ 16 | 6. `Aditi Mahajan `_ 17 | -------------------------------------------------------------------------------- /docs/DevDocs.rst: -------------------------------------------------------------------------------- 1 | ================= 2 | Developers Corner 3 | ================= 4 | 5 | We'd love to have your help in making Medusa better and Python faster. Any and all contributions are welcome. Frankly speaking there's still a hell lot to do. 6 | 7 | How Medusa works 8 | ================ 9 | 10 | Python is one of the most widely used scripting languages and has immense deployment 11 | and brought with it the joy of flexibility and simpler prototyping.One place where it falls short is development of very large scale software implementations primarily because the implementation is not fast enough. 12 | | 13 | What Medusa intends to do is run the same python code you wrote a lot faster. 14 | 15 | The Concept 16 | ----------- 17 | Medusa follows a six step procedure: 18 | 1. Breaks the python source file into tokens 19 | 2. Parse these tokens into an Abstract Syntax Tree while checking for errors 20 | 3. Walk the tree and emit the equivalent Dart code at each node while optimizing it 21 | 4. Cache the code in persistent SQLite3 Database 22 | 5. Invoke the Dart virtual machine with Dart code 23 | 6. Cache the generated machine code and provide output 24 | 25 | .. image:: /_static/image1.png 26 | 27 | Development Workflow 28 | ==================== 29 | Introduction 30 | ------------ 31 | Medusa encourages everyone to join and implement new features, fix some bugs, 32 | review pull requests and suggest ideas, take part in general discussions etc. 33 | 34 | Creating the environment 35 | ------------------------ 36 | Before you start contributing, you will have to follow the steps below to make 37 | sure that there are no hiccups when you are working. 38 | 39 | Install git 40 | ^^^^^^^^^^^ 41 | Installing git on linux-like systems can be done using the native package management systems. 42 | :: 43 | $ sudo apt-get install git 44 | 45 | or. 46 | :: 47 | $ yum install git 48 | 49 | Windows users may download the installer from 50 | :: 51 | http://python.org/download/ 52 | 53 | Then do not forget to add Python to the $PATH environment. 54 | 55 | On Windows and Mac OS X, the easiest way to get git is to download GitHub’s 56 | software, which will install git, and also provide a nice GUI (this tutorial 57 | will be based on the command line interface). Note, you may need to go into the 58 | GitHub preferences and choose the “Install Command Line Tools” option to get git 59 | installed into the terminal. 60 | If you do decide to use the GitHub GUI, you should make sure that any 61 | “sync does rebase” option is disabled in the settings. 62 | 63 | Cloning Medusa 64 | ^^^^^^^^^^^^^^ 65 | Clone medusa's repository on your machine to browse and work on the code locally. 66 | :: 67 | $ git clone https://github.com/rahul080327/medusa 68 | $ cd medusa 69 | 70 | How to submit a patch 71 | ^^^^^^^^^^^^^^^^^^^^^ 72 | Currently we follow a very simple system. 73 | 1. Fork this `repo `_ 74 | 2. Clone it to your machine 75 | 3. Make the changes locally 76 | 4. Rebase the local repository with upstream 77 | 5. Commit changes with valid verbose comments 78 | 6. Push to your repository 79 | 7. Compare and send a pull request 80 | -------------------------------------------------------------------------------- /docs/Intro.rst: -------------------------------------------------------------------------------- 1 | Introduction 2 | ============ 3 | 4 | Medusa 5 | 6 | Medusa in a glance 7 | ------------------- 8 | In 2011 google released `Dart `_ and with it came the Dart VM. 9 | The power of Medusa lies in running the python code on the DartVM . Python runs about 1000% 10 | faster on Medusa as compared to cpython. 11 | -------------------------------------------------------------------------------- /docs/License.rst: -------------------------------------------------------------------------------- 1 | License 2 | ======== 3 | 4 | The BSD 3-Clause License 5 | 6 | Copyright (c) 2013-2014, Rahul De, Apoorv Agarwal and Aakash Giri. VIT University All rights reserved. 7 | 8 | Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 9 | 10 | Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 11 | 12 | Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 13 | 14 | Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 15 | 16 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 17 | -------------------------------------------------------------------------------- /docs/Makefile: -------------------------------------------------------------------------------- 1 | # Makefile for Sphinx documentation 2 | # 3 | 4 | # You can set these variables from the command line. 5 | SPHINXOPTS = 6 | SPHINXBUILD = sphinx-build 7 | PAPER = 8 | BUILDDIR = _build 9 | 10 | # User-friendly check for sphinx-build 11 | ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1) 12 | $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/) 13 | endif 14 | 15 | # Internal variables. 16 | PAPEROPT_a4 = -D latex_paper_size=a4 17 | PAPEROPT_letter = -D latex_paper_size=letter 18 | ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . 19 | # the i18n builder cannot share the environment and doctrees with the others 20 | I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . 21 | 22 | .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext 23 | 24 | help: 25 | @echo "Please use \`make ' where is one of" 26 | @echo " html to make standalone HTML files" 27 | @echo " dirhtml to make HTML files named index.html in directories" 28 | @echo " singlehtml to make a single large HTML file" 29 | @echo " pickle to make pickle files" 30 | @echo " json to make JSON files" 31 | @echo " htmlhelp to make HTML files and a HTML help project" 32 | @echo " qthelp to make HTML files and a qthelp project" 33 | @echo " devhelp to make HTML files and a Devhelp project" 34 | @echo " epub to make an epub" 35 | @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" 36 | @echo " latexpdf to make LaTeX files and run them through pdflatex" 37 | @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" 38 | @echo " text to make text files" 39 | @echo " man to make manual pages" 40 | @echo " texinfo to make Texinfo files" 41 | @echo " info to make Texinfo files and run them through makeinfo" 42 | @echo " gettext to make PO message catalogs" 43 | @echo " changes to make an overview of all changed/added/deprecated items" 44 | @echo " xml to make Docutils-native XML files" 45 | @echo " pseudoxml to make pseudoxml-XML files for display purposes" 46 | @echo " linkcheck to check all external links for integrity" 47 | @echo " doctest to run all doctests embedded in the documentation (if enabled)" 48 | 49 | clean: 50 | rm -rf $(BUILDDIR)/* 51 | 52 | html: 53 | $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html 54 | @echo 55 | @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." 56 | 57 | dirhtml: 58 | $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml 59 | @echo 60 | @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." 61 | 62 | singlehtml: 63 | $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml 64 | @echo 65 | @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." 66 | 67 | pickle: 68 | $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle 69 | @echo 70 | @echo "Build finished; now you can process the pickle files." 71 | 72 | json: 73 | $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json 74 | @echo 75 | @echo "Build finished; now you can process the JSON files." 76 | 77 | htmlhelp: 78 | $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp 79 | @echo 80 | @echo "Build finished; now you can run HTML Help Workshop with the" \ 81 | ".hhp project file in $(BUILDDIR)/htmlhelp." 82 | 83 | qthelp: 84 | $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp 85 | @echo 86 | @echo "Build finished; now you can run "qcollectiongenerator" with the" \ 87 | ".qhcp project file in $(BUILDDIR)/qthelp, like this:" 88 | @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/medusa.qhcp" 89 | @echo "To view the help file:" 90 | @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/medusa.qhc" 91 | 92 | devhelp: 93 | $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp 94 | @echo 95 | @echo "Build finished." 96 | @echo "To view the help file:" 97 | @echo "# mkdir -p $$HOME/.local/share/devhelp/medusa" 98 | @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/medusa" 99 | @echo "# devhelp" 100 | 101 | epub: 102 | $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub 103 | @echo 104 | @echo "Build finished. The epub file is in $(BUILDDIR)/epub." 105 | 106 | latex: 107 | $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex 108 | @echo 109 | @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." 110 | @echo "Run \`make' in that directory to run these through (pdf)latex" \ 111 | "(use \`make latexpdf' here to do that automatically)." 112 | 113 | latexpdf: 114 | $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex 115 | @echo "Running LaTeX files through pdflatex..." 116 | $(MAKE) -C $(BUILDDIR)/latex all-pdf 117 | @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." 118 | 119 | latexpdfja: 120 | $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex 121 | @echo "Running LaTeX files through platex and dvipdfmx..." 122 | $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja 123 | @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." 124 | 125 | text: 126 | $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text 127 | @echo 128 | @echo "Build finished. The text files are in $(BUILDDIR)/text." 129 | 130 | man: 131 | $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man 132 | @echo 133 | @echo "Build finished. The manual pages are in $(BUILDDIR)/man." 134 | 135 | texinfo: 136 | $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo 137 | @echo 138 | @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." 139 | @echo "Run \`make' in that directory to run these through makeinfo" \ 140 | "(use \`make info' here to do that automatically)." 141 | 142 | info: 143 | $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo 144 | @echo "Running Texinfo files through makeinfo..." 145 | make -C $(BUILDDIR)/texinfo info 146 | @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." 147 | 148 | gettext: 149 | $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale 150 | @echo 151 | @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." 152 | 153 | changes: 154 | $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes 155 | @echo 156 | @echo "The overview file is in $(BUILDDIR)/changes." 157 | 158 | linkcheck: 159 | $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck 160 | @echo 161 | @echo "Link check complete; look for any errors in the above output " \ 162 | "or in $(BUILDDIR)/linkcheck/output.txt." 163 | 164 | doctest: 165 | $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest 166 | @echo "Testing of doctests in the sources finished, look at the " \ 167 | "results in $(BUILDDIR)/doctest/output.txt." 168 | 169 | xml: 170 | $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml 171 | @echo 172 | @echo "Build finished. The XML files are in $(BUILDDIR)/xml." 173 | 174 | pseudoxml: 175 | $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml 176 | @echo 177 | @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." 178 | -------------------------------------------------------------------------------- /docs/_build/doctrees/About.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/About.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/DevDocs.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/DevDocs.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/DevWorkflow.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/DevWorkflow.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/Intro.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/Intro.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/License.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/License.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/MedDevTeam.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/MedDevTeam.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/environment.pickle: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/environment.pickle -------------------------------------------------------------------------------- /docs/_build/doctrees/index.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/index.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/indro.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/indro.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/installation.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/installation.doctree -------------------------------------------------------------------------------- /docs/_build/doctrees/workflow.doctree: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/doctrees/workflow.doctree -------------------------------------------------------------------------------- /docs/_build/html/.buildinfo: -------------------------------------------------------------------------------- 1 | # Sphinx build info version 1 2 | # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. 3 | config: f9afcf3f2136cbaa3d91781f8e1c236b 4 | tags: 645f666f9bcd5a90fca523b33c5a78b7 5 | -------------------------------------------------------------------------------- /docs/_build/html/About.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | About — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 |
33 |

Navigation

34 | 46 |
47 | 48 |
49 |
50 |
51 |
52 | 53 |
54 |

About

55 |
56 |

Development Team

57 |

This project was started by Rahul De’, Apoorv Agarwal and Akash Giri in the spring of 2014.

58 |

Everyone who has contributed towards this project are:

59 |
    60 |
  1. Rahul De'
    2. 61 |
  2. Apoorv Agarwal
    3. 62 |
  3. Akash Giri
    4. 63 |
  4. Pratik Shah
    5. 64 |
  5. Mayuresh Waykole
    6. 65 |
  6. Aditi Mahajan
    7. 66 |
67 |
68 |
69 | 70 | 71 |
72 |
73 |
74 |
75 |
76 |

Table Of Contents

77 | 83 | 84 |

Previous topic

85 |

Developers Corner

87 |

Next topic

88 |

License

90 |

This Page

91 | 95 | 107 | 108 |
109 |
110 |
111 |
112 |
113 |

Navigation

114 | 126 |
127 |
128 | © Copyright 2014, Rahul De'. 129 | Created using Sphinx 1.2.2. 130 |
131 | 132 | -------------------------------------------------------------------------------- /docs/_build/html/DevDocs.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Developers Corner — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 |
33 |

Navigation

34 | 46 |
47 | 48 |
49 |
50 |
51 |
52 | 53 |
54 |

Developers Corner

55 |

We’d love to have your help in making Medusa better and Python faster. Any and all contributions are welcome. Frankly speaking there’s still a hell lot to do.

56 |
57 |

How Medusa works

58 |

Python is one of the most widely used scripting languages and has immense deployment 59 | and brought with it the joy of flexibility and simpler prototyping.One place where it falls short is development of very large scale software implementations primarily because the implementation is not fast enough. 60 | | 61 | What Medusa intends to do is run the same python code you wrote a lot faster.

62 |
63 |

The Concept

64 |
65 |
Medusa follows a six step procedure:
66 |
    67 |
  1. Breaks the python source file into tokens
    2. 68 |
  2. Parse these tokens into an Abstract Syntax Tree while checking for errors
    3. 69 |
  3. Walk the tree and emit the equivalent Dart code at each node while optimizing it
    4. 70 |
  4. Cache the code in persistent SQLite3 Database
    5. 71 |
  5. Invoke the Dart virtual machine with Dart code
    6. 72 |
  6. Cache the generated machine code and provide output
    7. 73 |
74 |
75 |
76 | _images/image1.png 77 |
78 |
79 |
80 |

Development Workflow

81 |
82 |

Introduction

83 |

Medusa encourages everyone to join and implement new features, fix some bugs, 84 | review pull requests and suggest ideas, take part in general discussions etc.

85 |
86 |
87 |

Creating the environment

88 |

Before you start contributing, you will have to follow the steps below to make 89 | sure that there are no hiccups when you are working.

90 |
91 |

Install git

92 |

Installing git on linux-like systems can be done using the native package management systems.

93 | 
$ sudo apt-get install git
 94 |
95 |
96 |

or.

97 | 
$ yum install git
 98 |
99 |
100 |

Windows users may download the installer from

101 | 
http://python.org/download/
102 |
103 |
104 |

Then do not forget to add Python to the $PATH environment.

105 |

On Windows and Mac OS X, the easiest way to get git is to download GitHub’s 106 | software, which will install git, and also provide a nice GUI (this tutorial 107 | will be based on the command line interface). Note, you may need to go into the 108 | GitHub preferences and choose the “Install Command Line Tools” option to get git 109 | installed into the terminal. 110 | If you do decide to use the GitHub GUI, you should make sure that any 111 | “sync does rebase” option is disabled in the settings.

112 |
113 |
114 |

Cloning Medusa

115 |

Clone medusa’s repository on your machine to browse and work on the code locally.

116 | 
$ git clone https://github.com/rahul080327/medusa
117 | $ cd medusa
118 |
119 |
120 |
121 |
122 |

How to submit a patch

123 |
124 |
Currently we follow a very simple system.
125 |
    126 |
  1. Fork this repo
    2. 127 |
  2. Clone it to your machine
    3. 128 |
  3. Make the changes locally
    4. 129 |
  4. Rebase the local repository with upstream
    5. 130 |
  5. Commit changes with valid verbose comments
    6. 131 |
  6. Push to your repository
    7. 132 |
  7. Compare and send a pull request
    8. 133 |
134 |
135 |
136 |
137 |
138 |
139 |
140 | 141 | 142 |
143 |
144 |
145 |
146 |
147 |

Table Of Contents

148 | 167 | 168 |

Previous topic

169 |

Installation

171 |

Next topic

172 |

About

174 |

This Page

175 | 179 | 191 | 192 |
193 |
194 |
195 |
196 |
197 |

Navigation

198 | 210 |
211 |
212 | © Copyright 2014, Rahul De'. 213 | Created using Sphinx 1.2.2. 214 |
215 | 216 | -------------------------------------------------------------------------------- /docs/_build/html/DevWorkflow.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Development Workflow — medusa 0.01 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 |
31 |

Navigation

32 | 38 |
39 | 40 |
41 |
42 |
43 |
44 | 45 |
46 |

Development Workflow

47 |
48 |
    49 |
  • Creating the environment
    • 50 |
  • Workflow process
    • 51 |
  • How to submit a patch
    • 52 |
  • Coding Conventions
    • 53 |
54 |
55 |
56 | 57 | 58 |
59 |
60 |
61 |
62 |
63 |

This Page

64 | 68 | 80 | 81 |
82 |
83 |
84 |
85 |
86 |

Navigation

87 | 93 |
94 |
95 | © Copyright 2014, Rahul De'. 96 | Created using Sphinx 1.2.2. 97 |
98 | 99 | -------------------------------------------------------------------------------- /docs/_build/html/Intro.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Introduction — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 |
33 |

Navigation

34 | 46 |
47 | 48 |
49 |
50 |
51 |
52 | 53 |
54 |

Introduction

55 |

Medusa

56 |
57 |

Medusa in a glance

58 |

In 2011 google released Dart and with it came the Dart VM. 59 | The power of Medusa lies in running the python code on the DartVM . Python runs about 1000% 60 | faster on Medusa as compared to cpython.

61 |
62 |
63 | 64 | 65 |
66 |
67 |
68 |
69 |
70 |

Table Of Contents

71 | 77 | 78 |

Previous topic

79 |

Welcome to medusa’s documentation!

81 |

Next topic

82 |

Installation

84 |

This Page

85 | 89 | 101 | 102 |
103 |
104 |
105 |
106 |
107 |

Navigation

108 | 120 |
121 |
122 | © Copyright 2014, Rahul De'. 123 | Created using Sphinx 1.2.2. 124 |
125 | 126 | -------------------------------------------------------------------------------- /docs/_build/html/License.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | License — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 |
31 |

Navigation

32 | 38 |
39 | 40 |
41 |
42 |
43 |
44 | 45 |
46 |

License

47 |

The BSD 3-Clause License

48 |

Copyright (c) 2013-2014, Rahul De, Apoorv Agarwal and Aakash Giri. VIT University All rights reserved.

49 |

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

50 |

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

51 |

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

52 |

Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

53 |

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

54 |
55 | 56 | 57 |
58 |
59 |
60 |
61 |
62 |

This Page

63 | 67 | 79 | 80 |
81 |
82 |
83 |
84 |
85 |

Navigation

86 | 92 |
93 |
94 | © Copyright 2014, Rahul De'. 95 | Created using Sphinx 1.2.2. 96 |
97 | 98 | -------------------------------------------------------------------------------- /docs/_build/html/MedDevTeam.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Medusa Development Team — medusa 0.01 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 |
31 |

Navigation

32 | 38 |
39 | 40 |
41 |
42 |
43 |
44 | 45 |
46 |

Medusa Development Team

47 |

This project was started by Rahul De’ in the spring of 2014.

48 |

Rahul De’ is an alumni of VIT University and currently working in Hyderabad,India.

49 |
50 | 51 | 52 |
53 |
54 |
55 |
56 |
57 |

This Page

58 | 62 | 74 | 75 |
76 |
77 |
78 |
79 |
80 |

Navigation

81 | 87 |
88 |
89 | © Copyright 2014, Rahul De'. 90 | Created using Sphinx 1.2.2. 91 |
92 | 93 | -------------------------------------------------------------------------------- /docs/_build/html/_images/image1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_images/image1.png -------------------------------------------------------------------------------- /docs/_build/html/_sources/About.txt: -------------------------------------------------------------------------------- 1 | ===== 2 | About 3 | ===== 4 | Development Team 5 | ================ 6 | 7 | This project was started by `Rahul De' `_, Apoorv Agarwal and Akash Giri in the spring of 2014. 8 | 9 | Everyone who has contributed towards this project are: 10 | 11 | 1. `Rahul De' `_ 12 | 2. `Apoorv Agarwal `_ 13 | 3. `Akash Giri `_ 14 | 4. Pratik Shah 15 | 5. `Mayuresh Waykole `_ 16 | 6. `Aditi Mahajan `_ 17 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/DevDocs.txt: -------------------------------------------------------------------------------- 1 | ================= 2 | Developers Corner 3 | ================= 4 | 5 | We'd love to have your help in making Medusa better and Python faster. Any and all contributions are welcome. Frankly speaking there's still a hell lot to do. 6 | 7 | How Medusa works 8 | ================ 9 | 10 | Python is one of the most widely used scripting languages and has immense deployment 11 | and brought with it the joy of flexibility and simpler prototyping.One place where it falls short is development of very large scale software implementations primarily because the implementation is not fast enough. 12 | | 13 | What Medusa intends to do is run the same python code you wrote a lot faster. 14 | 15 | The Concept 16 | ----------- 17 | Medusa follows a six step procedure: 18 | 1. Breaks the python source file into tokens 19 | 2. Parse these tokens into an Abstract Syntax Tree while checking for errors 20 | 3. Walk the tree and emit the equivalent Dart code at each node while optimizing it 21 | 4. Cache the code in persistent SQLite3 Database 22 | 5. Invoke the Dart virtual machine with Dart code 23 | 6. Cache the generated machine code and provide output 24 | 25 | .. image:: /_static/image1.png 26 | 27 | Development Workflow 28 | ==================== 29 | Introduction 30 | ------------ 31 | Medusa encourages everyone to join and implement new features, fix some bugs, 32 | review pull requests and suggest ideas, take part in general discussions etc. 33 | 34 | Creating the environment 35 | ------------------------ 36 | Before you start contributing, you will have to follow the steps below to make 37 | sure that there are no hiccups when you are working. 38 | 39 | Install git 40 | ^^^^^^^^^^^ 41 | Installing git on linux-like systems can be done using the native package management systems. 42 | :: 43 | $ sudo apt-get install git 44 | 45 | or. 46 | :: 47 | $ yum install git 48 | 49 | Windows users may download the installer from 50 | :: 51 | http://python.org/download/ 52 | 53 | Then do not forget to add Python to the $PATH environment. 54 | 55 | On Windows and Mac OS X, the easiest way to get git is to download GitHub’s 56 | software, which will install git, and also provide a nice GUI (this tutorial 57 | will be based on the command line interface). Note, you may need to go into the 58 | GitHub preferences and choose the “Install Command Line Tools” option to get git 59 | installed into the terminal. 60 | If you do decide to use the GitHub GUI, you should make sure that any 61 | “sync does rebase” option is disabled in the settings. 62 | 63 | Cloning Medusa 64 | ^^^^^^^^^^^^^^ 65 | Clone medusa's repository on your machine to browse and work on the code locally. 66 | :: 67 | $ git clone https://github.com/rahul080327/medusa 68 | $ cd medusa 69 | 70 | How to submit a patch 71 | ^^^^^^^^^^^^^^^^^^^^^ 72 | Currently we follow a very simple system. 73 | 1. Fork this `repo `_ 74 | 2. Clone it to your machine 75 | 3. Make the changes locally 76 | 4. Rebase the local repository with upstream 77 | 5. Commit changes with valid verbose comments 78 | 6. Push to your repository 79 | 7. Compare and send a pull request 80 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/DevWorkflow.txt: -------------------------------------------------------------------------------- 1 | Development Workflow 2 | ===================== 3 | * :ref:`Creating the environment` 4 | * :ref:`Workflow process` 5 | * :ref:`How to submit a patch` 6 | * :ref:`Coding Conventions` 7 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/Intro.txt: -------------------------------------------------------------------------------- 1 | Introduction 2 | ============ 3 | 4 | Medusa 5 | 6 | Medusa in a glance 7 | ------------------- 8 | In 2011 google released `Dart `_ and with it came the Dart VM. 9 | The power of Medusa lies in running the python code on the DartVM . Python runs about 1000% 10 | faster on Medusa as compared to cpython. 11 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/License.txt: -------------------------------------------------------------------------------- 1 | License 2 | ======== 3 | 4 | The BSD 3-Clause License 5 | 6 | Copyright (c) 2013-2014, Rahul De, Apoorv Agarwal and Aakash Giri. VIT University All rights reserved. 7 | 8 | Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 9 | 10 | Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 11 | 12 | Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 13 | 14 | Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 15 | 16 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 17 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/MedDevTeam.txt: -------------------------------------------------------------------------------- 1 | Medusa Development Team 2 | ======================= 3 | 4 | This project was started by Rahul De' in the spring of 2014. 5 | 6 | Rahul De' is an alumni of VIT University and currently working in Hyderabad,India. 7 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/index.txt: -------------------------------------------------------------------------------- 1 | .. medusa documentation master file, created by 2 | sphinx-quickstart on Mon Sep 1 22:57:23 2014. 3 | You can adapt this file completely to your liking, but it should at least 4 | contain the root `toctree` directive. 5 | 6 | Welcome to medusa's documentation! 7 | ================================== 8 | 9 | Contents: 10 | 11 | .. toctree:: 12 | :maxdepth: 2 13 | 14 | Intro.rst 15 | installation.rst 16 | DevDocs.rst 17 | About.rst 18 | License.rst 19 | 20 | 21 | 22 | Indices and tables 23 | ================== 24 | 25 | * :ref:`genindex` 26 | * :ref:`modindex` 27 | * :ref:`search` 28 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/indro.txt: -------------------------------------------------------------------------------- 1 | Introduction 2 | ==== 3 | 4 | Medusa 5 | 6 | What is medusa ? 7 | ----------------- 8 | In 2011 google released `https://www.Dartlang.org` and with it came the Dart VM. 9 | The power of medusa lies in running the python code on the DartVM . Python runs about 1000% 10 | faster on medusa as compared to cpython. 11 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/installation.txt: -------------------------------------------------------------------------------- 1 | ============= 2 | Installation 3 | ============= 4 | 5 | Medusa is currently supported only on debian. Windows and Mac builds will soon be available 6 | 7 | Debian Users 8 | ============ 9 | 10 | Simply run ./INSTALL after cloning this `repo `_ on your Debian 11 | based Linux distro. 12 | Thats it. All dependencies are installed, code compiled and paths setup automatically. 13 | 14 | Mac OSX Users (building from source) 15 | ==================================== 16 | 17 | * Install XCode if not installed (Sorry for the bandwidth hogging...) 18 | * Install python 2.7.x if not installed and add it to PATH 19 | * Download and Install latest Qt5 for Mac from `here `_ and add qmake and moc to PATH 20 | * Download the latest Dart SDK from `here `_, unzip and add the dart executable to PATH 21 | * Clone this repo and simply run ./INSTALL.mac 22 | * After a successful compile medusavm binary is available in /usr/bin/ for use 23 | * For updates and subsequent builds, fetch changes and just run ./INSTALL.mac 24 | 25 | Others 26 | ====== 27 | * Install C++ compilers and Make tools 28 | * Install Qt5 build tools and libs 29 | * Install Dart SDK 30 | * Install Python 2.7.x 31 | * Rum moc on inc/transform.h to inc/transform_moc.h 32 | * Run qmake on medusa.pro 33 | * Run make 34 | * Use the medusavm executable 35 | 36 | Using Medusa 37 | ============ 38 | * Medusa is available as medusavm after a successful buid and install 39 | * Python programs can be run by passing them as parameters: medusavm hello.py 40 | * Medusa can be stopped after the Dart compile phase by passing a -c switch: medusavm -c hello.py. The Dart code is obtained in hello.dart in the same directory. 41 | * Python files can be globally installed into Medusa for imports by other files: medusavm -install python_file 42 | * Help is at: medusavm --help 43 | -------------------------------------------------------------------------------- /docs/_build/html/_sources/workflow.txt: -------------------------------------------------------------------------------- 1 | ======================== 2 | Development Introduction 3 | ======================== 4 | -------------------------------------------------------------------------------- /docs/_build/html/_static/ajax-loader.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/ajax-loader.gif -------------------------------------------------------------------------------- /docs/_build/html/_static/basic.css: -------------------------------------------------------------------------------- 1 | /* 2 | * basic.css 3 | * ~~~~~~~~~ 4 | * 5 | * Sphinx stylesheet -- basic theme. 6 | * 7 | * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | /* -- main layout ----------------------------------------------------------- */ 13 | 14 | div.clearer { 15 | clear: both; 16 | } 17 | 18 | /* -- relbar ---------------------------------------------------------------- */ 19 | 20 | div.related { 21 | width: 100%; 22 | font-size: 90%; 23 | } 24 | 25 | div.related h3 { 26 | display: none; 27 | } 28 | 29 | div.related ul { 30 | margin: 0; 31 | padding: 0 0 0 10px; 32 | list-style: none; 33 | } 34 | 35 | div.related li { 36 | display: inline; 37 | } 38 | 39 | div.related li.right { 40 | float: right; 41 | margin-right: 5px; 42 | } 43 | 44 | /* -- sidebar --------------------------------------------------------------- */ 45 | 46 | div.sphinxsidebarwrapper { 47 | padding: 10px 5px 0 10px; 48 | } 49 | 50 | div.sphinxsidebar { 51 | float: left; 52 | width: 230px; 53 | margin-left: -100%; 54 | font-size: 90%; 55 | } 56 | 57 | div.sphinxsidebar ul { 58 | list-style: none; 59 | } 60 | 61 | div.sphinxsidebar ul ul, 62 | div.sphinxsidebar ul.want-points { 63 | margin-left: 20px; 64 | list-style: square; 65 | } 66 | 67 | div.sphinxsidebar ul ul { 68 | margin-top: 0; 69 | margin-bottom: 0; 70 | } 71 | 72 | div.sphinxsidebar form { 73 | margin-top: 10px; 74 | } 75 | 76 | div.sphinxsidebar input { 77 | border: 1px solid #98dbcc; 78 | font-family: sans-serif; 79 | font-size: 1em; 80 | } 81 | 82 | div.sphinxsidebar #searchbox input[type="text"] { 83 | width: 170px; 84 | } 85 | 86 | div.sphinxsidebar #searchbox input[type="submit"] { 87 | width: 30px; 88 | } 89 | 90 | img { 91 | border: 0; 92 | max-width: 100%; 93 | } 94 | 95 | /* -- search page ----------------------------------------------------------- */ 96 | 97 | ul.search { 98 | margin: 10px 0 0 20px; 99 | padding: 0; 100 | } 101 | 102 | ul.search li { 103 | padding: 5px 0 5px 20px; 104 | background-image: url(file.png); 105 | background-repeat: no-repeat; 106 | background-position: 0 7px; 107 | } 108 | 109 | ul.search li a { 110 | font-weight: bold; 111 | } 112 | 113 | ul.search li div.context { 114 | color: #888; 115 | margin: 2px 0 0 30px; 116 | text-align: left; 117 | } 118 | 119 | ul.keywordmatches li.goodmatch a { 120 | font-weight: bold; 121 | } 122 | 123 | /* -- index page ------------------------------------------------------------ */ 124 | 125 | table.contentstable { 126 | width: 90%; 127 | } 128 | 129 | table.contentstable p.biglink { 130 | line-height: 150%; 131 | } 132 | 133 | a.biglink { 134 | font-size: 1.3em; 135 | } 136 | 137 | span.linkdescr { 138 | font-style: italic; 139 | padding-top: 5px; 140 | font-size: 90%; 141 | } 142 | 143 | /* -- general index --------------------------------------------------------- */ 144 | 145 | table.indextable { 146 | width: 100%; 147 | } 148 | 149 | table.indextable td { 150 | text-align: left; 151 | vertical-align: top; 152 | } 153 | 154 | table.indextable dl, table.indextable dd { 155 | margin-top: 0; 156 | margin-bottom: 0; 157 | } 158 | 159 | table.indextable tr.pcap { 160 | height: 10px; 161 | } 162 | 163 | table.indextable tr.cap { 164 | margin-top: 10px; 165 | background-color: #f2f2f2; 166 | } 167 | 168 | img.toggler { 169 | margin-right: 3px; 170 | margin-top: 3px; 171 | cursor: pointer; 172 | } 173 | 174 | div.modindex-jumpbox { 175 | border-top: 1px solid #ddd; 176 | border-bottom: 1px solid #ddd; 177 | margin: 1em 0 1em 0; 178 | padding: 0.4em; 179 | } 180 | 181 | div.genindex-jumpbox { 182 | border-top: 1px solid #ddd; 183 | border-bottom: 1px solid #ddd; 184 | margin: 1em 0 1em 0; 185 | padding: 0.4em; 186 | } 187 | 188 | /* -- general body styles --------------------------------------------------- */ 189 | 190 | a.headerlink { 191 | visibility: hidden; 192 | } 193 | 194 | h1:hover > a.headerlink, 195 | h2:hover > a.headerlink, 196 | h3:hover > a.headerlink, 197 | h4:hover > a.headerlink, 198 | h5:hover > a.headerlink, 199 | h6:hover > a.headerlink, 200 | dt:hover > a.headerlink { 201 | visibility: visible; 202 | } 203 | 204 | div.body p.caption { 205 | text-align: inherit; 206 | } 207 | 208 | div.body td { 209 | text-align: left; 210 | } 211 | 212 | .field-list ul { 213 | padding-left: 1em; 214 | } 215 | 216 | .first { 217 | margin-top: 0 !important; 218 | } 219 | 220 | p.rubric { 221 | margin-top: 30px; 222 | font-weight: bold; 223 | } 224 | 225 | img.align-left, .figure.align-left, object.align-left { 226 | clear: left; 227 | float: left; 228 | margin-right: 1em; 229 | } 230 | 231 | img.align-right, .figure.align-right, object.align-right { 232 | clear: right; 233 | float: right; 234 | margin-left: 1em; 235 | } 236 | 237 | img.align-center, .figure.align-center, object.align-center { 238 | display: block; 239 | margin-left: auto; 240 | margin-right: auto; 241 | } 242 | 243 | .align-left { 244 | text-align: left; 245 | } 246 | 247 | .align-center { 248 | text-align: center; 249 | } 250 | 251 | .align-right { 252 | text-align: right; 253 | } 254 | 255 | /* -- sidebars -------------------------------------------------------------- */ 256 | 257 | div.sidebar { 258 | margin: 0 0 0.5em 1em; 259 | border: 1px solid #ddb; 260 | padding: 7px 7px 0 7px; 261 | background-color: #ffe; 262 | width: 40%; 263 | float: right; 264 | } 265 | 266 | p.sidebar-title { 267 | font-weight: bold; 268 | } 269 | 270 | /* -- topics ---------------------------------------------------------------- */ 271 | 272 | div.topic { 273 | border: 1px solid #ccc; 274 | padding: 7px 7px 0 7px; 275 | margin: 10px 0 10px 0; 276 | } 277 | 278 | p.topic-title { 279 | font-size: 1.1em; 280 | font-weight: bold; 281 | margin-top: 10px; 282 | } 283 | 284 | /* -- admonitions ----------------------------------------------------------- */ 285 | 286 | div.admonition { 287 | margin-top: 10px; 288 | margin-bottom: 10px; 289 | padding: 7px; 290 | } 291 | 292 | div.admonition dt { 293 | font-weight: bold; 294 | } 295 | 296 | div.admonition dl { 297 | margin-bottom: 0; 298 | } 299 | 300 | p.admonition-title { 301 | margin: 0px 10px 5px 0px; 302 | font-weight: bold; 303 | } 304 | 305 | div.body p.centered { 306 | text-align: center; 307 | margin-top: 25px; 308 | } 309 | 310 | /* -- tables ---------------------------------------------------------------- */ 311 | 312 | table.docutils { 313 | border: 0; 314 | border-collapse: collapse; 315 | } 316 | 317 | table.docutils td, table.docutils th { 318 | padding: 1px 8px 1px 5px; 319 | border-top: 0; 320 | border-left: 0; 321 | border-right: 0; 322 | border-bottom: 1px solid #aaa; 323 | } 324 | 325 | table.field-list td, table.field-list th { 326 | border: 0 !important; 327 | } 328 | 329 | table.footnote td, table.footnote th { 330 | border: 0 !important; 331 | } 332 | 333 | th { 334 | text-align: left; 335 | padding-right: 5px; 336 | } 337 | 338 | table.citation { 339 | border-left: solid 1px gray; 340 | margin-left: 1px; 341 | } 342 | 343 | table.citation td { 344 | border-bottom: none; 345 | } 346 | 347 | /* -- other body styles ----------------------------------------------------- */ 348 | 349 | ol.arabic { 350 | list-style: decimal; 351 | } 352 | 353 | ol.loweralpha { 354 | list-style: lower-alpha; 355 | } 356 | 357 | ol.upperalpha { 358 | list-style: upper-alpha; 359 | } 360 | 361 | ol.lowerroman { 362 | list-style: lower-roman; 363 | } 364 | 365 | ol.upperroman { 366 | list-style: upper-roman; 367 | } 368 | 369 | dl { 370 | margin-bottom: 15px; 371 | } 372 | 373 | dd p { 374 | margin-top: 0px; 375 | } 376 | 377 | dd ul, dd table { 378 | margin-bottom: 10px; 379 | } 380 | 381 | dd { 382 | margin-top: 3px; 383 | margin-bottom: 10px; 384 | margin-left: 30px; 385 | } 386 | 387 | dt:target, .highlighted { 388 | background-color: #fbe54e; 389 | } 390 | 391 | dl.glossary dt { 392 | font-weight: bold; 393 | font-size: 1.1em; 394 | } 395 | 396 | .field-list ul { 397 | margin: 0; 398 | padding-left: 1em; 399 | } 400 | 401 | .field-list p { 402 | margin: 0; 403 | } 404 | 405 | .optional { 406 | font-size: 1.3em; 407 | } 408 | 409 | .versionmodified { 410 | font-style: italic; 411 | } 412 | 413 | .system-message { 414 | background-color: #fda; 415 | padding: 5px; 416 | border: 3px solid red; 417 | } 418 | 419 | .footnote:target { 420 | background-color: #ffa; 421 | } 422 | 423 | .line-block { 424 | display: block; 425 | margin-top: 1em; 426 | margin-bottom: 1em; 427 | } 428 | 429 | .line-block .line-block { 430 | margin-top: 0; 431 | margin-bottom: 0; 432 | margin-left: 1.5em; 433 | } 434 | 435 | .guilabel, .menuselection { 436 | font-family: sans-serif; 437 | } 438 | 439 | .accelerator { 440 | text-decoration: underline; 441 | } 442 | 443 | .classifier { 444 | font-style: oblique; 445 | } 446 | 447 | abbr, acronym { 448 | border-bottom: dotted 1px; 449 | cursor: help; 450 | } 451 | 452 | /* -- code displays --------------------------------------------------------- */ 453 | 454 | pre { 455 | overflow: auto; 456 | overflow-y: hidden; /* fixes display issues on Chrome browsers */ 457 | } 458 | 459 | td.linenos pre { 460 | padding: 5px 0px; 461 | border: 0; 462 | background-color: transparent; 463 | color: #aaa; 464 | } 465 | 466 | table.highlighttable { 467 | margin-left: 0.5em; 468 | } 469 | 470 | table.highlighttable td { 471 | padding: 0 0.5em 0 0.5em; 472 | } 473 | 474 | tt.descname { 475 | background-color: transparent; 476 | font-weight: bold; 477 | font-size: 1.2em; 478 | } 479 | 480 | tt.descclassname { 481 | background-color: transparent; 482 | } 483 | 484 | tt.xref, a tt { 485 | background-color: transparent; 486 | font-weight: bold; 487 | } 488 | 489 | h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { 490 | background-color: transparent; 491 | } 492 | 493 | .viewcode-link { 494 | float: right; 495 | } 496 | 497 | .viewcode-back { 498 | float: right; 499 | font-family: sans-serif; 500 | } 501 | 502 | div.viewcode-block:target { 503 | margin: -1px -10px; 504 | padding: 0 10px; 505 | } 506 | 507 | /* -- math display ---------------------------------------------------------- */ 508 | 509 | img.math { 510 | vertical-align: middle; 511 | } 512 | 513 | div.body div.math p { 514 | text-align: center; 515 | } 516 | 517 | span.eqno { 518 | float: right; 519 | } 520 | 521 | /* -- printout stylesheet --------------------------------------------------- */ 522 | 523 | @media print { 524 | div.document, 525 | div.documentwrapper, 526 | div.bodywrapper { 527 | margin: 0 !important; 528 | width: 100%; 529 | } 530 | 531 | div.sphinxsidebar, 532 | div.related, 533 | div.footer, 534 | #top-link { 535 | display: none; 536 | } 537 | } -------------------------------------------------------------------------------- /docs/_build/html/_static/comment-bright.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/comment-bright.png -------------------------------------------------------------------------------- /docs/_build/html/_static/comment-close.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/comment-close.png -------------------------------------------------------------------------------- /docs/_build/html/_static/comment.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/comment.png -------------------------------------------------------------------------------- /docs/_build/html/_static/default.css: -------------------------------------------------------------------------------- 1 | /* 2 | * default.css_t 3 | * ~~~~~~~~~~~~~ 4 | * 5 | * Sphinx stylesheet -- default theme. 6 | * 7 | * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | @import url("basic.css"); 13 | 14 | /* -- page layout ----------------------------------------------------------- */ 15 | 16 | body { 17 | font-family: sans-serif; 18 | font-size: 100%; 19 | background-color: #11303d; 20 | color: #000; 21 | margin: 0; 22 | padding: 0; 23 | } 24 | 25 | div.document { 26 | background-color: #1c4e63; 27 | } 28 | 29 | div.documentwrapper { 30 | float: left; 31 | width: 100%; 32 | } 33 | 34 | div.bodywrapper { 35 | margin: 0 0 0 230px; 36 | } 37 | 38 | div.body { 39 | background-color: #ffffff; 40 | color: #000000; 41 | padding: 0 20px 30px 20px; 42 | } 43 | 44 | div.footer { 45 | color: #ffffff; 46 | width: 100%; 47 | padding: 9px 0 9px 0; 48 | text-align: center; 49 | font-size: 75%; 50 | } 51 | 52 | div.footer a { 53 | color: #ffffff; 54 | text-decoration: underline; 55 | } 56 | 57 | div.related { 58 | background-color: #133f52; 59 | line-height: 30px; 60 | color: #ffffff; 61 | } 62 | 63 | div.related a { 64 | color: #ffffff; 65 | } 66 | 67 | div.sphinxsidebar { 68 | } 69 | 70 | div.sphinxsidebar h3 { 71 | font-family: 'Trebuchet MS', sans-serif; 72 | color: #ffffff; 73 | font-size: 1.4em; 74 | font-weight: normal; 75 | margin: 0; 76 | padding: 0; 77 | } 78 | 79 | div.sphinxsidebar h3 a { 80 | color: #ffffff; 81 | } 82 | 83 | div.sphinxsidebar h4 { 84 | font-family: 'Trebuchet MS', sans-serif; 85 | color: #ffffff; 86 | font-size: 1.3em; 87 | font-weight: normal; 88 | margin: 5px 0 0 0; 89 | padding: 0; 90 | } 91 | 92 | div.sphinxsidebar p { 93 | color: #ffffff; 94 | } 95 | 96 | div.sphinxsidebar p.topless { 97 | margin: 5px 10px 10px 10px; 98 | } 99 | 100 | div.sphinxsidebar ul { 101 | margin: 10px; 102 | padding: 0; 103 | color: #ffffff; 104 | } 105 | 106 | div.sphinxsidebar a { 107 | color: #98dbcc; 108 | } 109 | 110 | div.sphinxsidebar input { 111 | border: 1px solid #98dbcc; 112 | font-family: sans-serif; 113 | font-size: 1em; 114 | } 115 | 116 | 117 | 118 | /* -- hyperlink styles ------------------------------------------------------ */ 119 | 120 | a { 121 | color: #355f7c; 122 | text-decoration: none; 123 | } 124 | 125 | a:visited { 126 | color: #355f7c; 127 | text-decoration: none; 128 | } 129 | 130 | a:hover { 131 | text-decoration: underline; 132 | } 133 | 134 | 135 | 136 | /* -- body styles ----------------------------------------------------------- */ 137 | 138 | div.body h1, 139 | div.body h2, 140 | div.body h3, 141 | div.body h4, 142 | div.body h5, 143 | div.body h6 { 144 | font-family: 'Trebuchet MS', sans-serif; 145 | background-color: #f2f2f2; 146 | font-weight: normal; 147 | color: #20435c; 148 | border-bottom: 1px solid #ccc; 149 | margin: 20px -20px 10px -20px; 150 | padding: 3px 0 3px 10px; 151 | } 152 | 153 | div.body h1 { margin-top: 0; font-size: 200%; } 154 | div.body h2 { font-size: 160%; } 155 | div.body h3 { font-size: 140%; } 156 | div.body h4 { font-size: 120%; } 157 | div.body h5 { font-size: 110%; } 158 | div.body h6 { font-size: 100%; } 159 | 160 | a.headerlink { 161 | color: #c60f0f; 162 | font-size: 0.8em; 163 | padding: 0 4px 0 4px; 164 | text-decoration: none; 165 | } 166 | 167 | a.headerlink:hover { 168 | background-color: #c60f0f; 169 | color: white; 170 | } 171 | 172 | div.body p, div.body dd, div.body li { 173 | text-align: justify; 174 | line-height: 130%; 175 | } 176 | 177 | div.admonition p.admonition-title + p { 178 | display: inline; 179 | } 180 | 181 | div.admonition p { 182 | margin-bottom: 5px; 183 | } 184 | 185 | div.admonition pre { 186 | margin-bottom: 5px; 187 | } 188 | 189 | div.admonition ul, div.admonition ol { 190 | margin-bottom: 5px; 191 | } 192 | 193 | div.note { 194 | background-color: #eee; 195 | border: 1px solid #ccc; 196 | } 197 | 198 | div.seealso { 199 | background-color: #ffc; 200 | border: 1px solid #ff6; 201 | } 202 | 203 | div.topic { 204 | background-color: #eee; 205 | } 206 | 207 | div.warning { 208 | background-color: #ffe4e4; 209 | border: 1px solid #f66; 210 | } 211 | 212 | p.admonition-title { 213 | display: inline; 214 | } 215 | 216 | p.admonition-title:after { 217 | content: ":"; 218 | } 219 | 220 | pre { 221 | padding: 5px; 222 | background-color: #eeffcc; 223 | color: #333333; 224 | line-height: 120%; 225 | border: 1px solid #ac9; 226 | border-left: none; 227 | border-right: none; 228 | } 229 | 230 | tt { 231 | background-color: #ecf0f3; 232 | padding: 0 1px 0 1px; 233 | font-size: 0.95em; 234 | } 235 | 236 | th { 237 | background-color: #ede; 238 | } 239 | 240 | .warning tt { 241 | background: #efc2c2; 242 | } 243 | 244 | .note tt { 245 | background: #d6d6d6; 246 | } 247 | 248 | .viewcode-back { 249 | font-family: sans-serif; 250 | } 251 | 252 | div.viewcode-block:target { 253 | background-color: #f4debf; 254 | border-top: 1px solid #ac9; 255 | border-bottom: 1px solid #ac9; 256 | } -------------------------------------------------------------------------------- /docs/_build/html/_static/doctools.js: -------------------------------------------------------------------------------- 1 | /* 2 | * doctools.js 3 | * ~~~~~~~~~~~ 4 | * 5 | * Sphinx JavaScript utilities for all documentation. 6 | * 7 | * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | /** 13 | * select a different prefix for underscore 14 | */ 15 | $u = _.noConflict(); 16 | 17 | /** 18 | * make the code below compatible with browsers without 19 | * an installed firebug like debugger 20 | if (!window.console || !console.firebug) { 21 | var names = ["log", "debug", "info", "warn", "error", "assert", "dir", 22 | "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", 23 | "profile", "profileEnd"]; 24 | window.console = {}; 25 | for (var i = 0; i < names.length; ++i) 26 | window.console[names[i]] = function() {}; 27 | } 28 | */ 29 | 30 | /** 31 | * small helper function to urldecode strings 32 | */ 33 | jQuery.urldecode = function(x) { 34 | return decodeURIComponent(x).replace(/\+/g, ' '); 35 | }; 36 | 37 | /** 38 | * small helper function to urlencode strings 39 | */ 40 | jQuery.urlencode = encodeURIComponent; 41 | 42 | /** 43 | * This function returns the parsed url parameters of the 44 | * current request. Multiple values per key are supported, 45 | * it will always return arrays of strings for the value parts. 46 | */ 47 | jQuery.getQueryParameters = function(s) { 48 | if (typeof s == 'undefined') 49 | s = document.location.search; 50 | var parts = s.substr(s.indexOf('?') + 1).split('&'); 51 | var result = {}; 52 | for (var i = 0; i < parts.length; i++) { 53 | var tmp = parts[i].split('=', 2); 54 | var key = jQuery.urldecode(tmp[0]); 55 | var value = jQuery.urldecode(tmp[1]); 56 | if (key in result) 57 | result[key].push(value); 58 | else 59 | result[key] = [value]; 60 | } 61 | return result; 62 | }; 63 | 64 | /** 65 | * highlight a given string on a jquery object by wrapping it in 66 | * span elements with the given class name. 67 | */ 68 | jQuery.fn.highlightText = function(text, className) { 69 | function highlight(node) { 70 | if (node.nodeType == 3) { 71 | var val = node.nodeValue; 72 | var pos = val.toLowerCase().indexOf(text); 73 | if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { 74 | var span = document.createElement("span"); 75 | span.className = className; 76 | span.appendChild(document.createTextNode(val.substr(pos, text.length))); 77 | node.parentNode.insertBefore(span, node.parentNode.insertBefore( 78 | document.createTextNode(val.substr(pos + text.length)), 79 | node.nextSibling)); 80 | node.nodeValue = val.substr(0, pos); 81 | } 82 | } 83 | else if (!jQuery(node).is("button, select, textarea")) { 84 | jQuery.each(node.childNodes, function() { 85 | highlight(this); 86 | }); 87 | } 88 | } 89 | return this.each(function() { 90 | highlight(this); 91 | }); 92 | }; 93 | 94 | /** 95 | * Small JavaScript module for the documentation. 96 | */ 97 | var Documentation = { 98 | 99 | init : function() { 100 | this.fixFirefoxAnchorBug(); 101 | this.highlightSearchWords(); 102 | this.initIndexTable(); 103 | }, 104 | 105 | /** 106 | * i18n support 107 | */ 108 | TRANSLATIONS : {}, 109 | PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, 110 | LOCALE : 'unknown', 111 | 112 | // gettext and ngettext don't access this so that the functions 113 | // can safely bound to a different name (_ = Documentation.gettext) 114 | gettext : function(string) { 115 | var translated = Documentation.TRANSLATIONS[string]; 116 | if (typeof translated == 'undefined') 117 | return string; 118 | return (typeof translated == 'string') ? translated : translated[0]; 119 | }, 120 | 121 | ngettext : function(singular, plural, n) { 122 | var translated = Documentation.TRANSLATIONS[singular]; 123 | if (typeof translated == 'undefined') 124 | return (n == 1) ? singular : plural; 125 | return translated[Documentation.PLURALEXPR(n)]; 126 | }, 127 | 128 | addTranslations : function(catalog) { 129 | for (var key in catalog.messages) 130 | this.TRANSLATIONS[key] = catalog.messages[key]; 131 | this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); 132 | this.LOCALE = catalog.locale; 133 | }, 134 | 135 | /** 136 | * add context elements like header anchor links 137 | */ 138 | addContextElements : function() { 139 | $('div[id] > :header:first').each(function() { 140 | $('\u00B6'). 141 | attr('href', '#' + this.id). 142 | attr('title', _('Permalink to this headline')). 143 | appendTo(this); 144 | }); 145 | $('dt[id]').each(function() { 146 | $('\u00B6'). 147 | attr('href', '#' + this.id). 148 | attr('title', _('Permalink to this definition')). 149 | appendTo(this); 150 | }); 151 | }, 152 | 153 | /** 154 | * workaround a firefox stupidity 155 | */ 156 | fixFirefoxAnchorBug : function() { 157 | if (document.location.hash && $.browser.mozilla) 158 | window.setTimeout(function() { 159 | document.location.href += ''; 160 | }, 10); 161 | }, 162 | 163 | /** 164 | * highlight the search words provided in the url in the text 165 | */ 166 | highlightSearchWords : function() { 167 | var params = $.getQueryParameters(); 168 | var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; 169 | if (terms.length) { 170 | var body = $('div.body'); 171 | if (!body.length) { 172 | body = $('body'); 173 | } 174 | window.setTimeout(function() { 175 | $.each(terms, function() { 176 | body.highlightText(this.toLowerCase(), 'highlighted'); 177 | }); 178 | }, 10); 179 | $('

' + _('Hide Search Matches') + '

') 181 | .appendTo($('#searchbox')); 182 | } 183 | }, 184 | 185 | /** 186 | * init the domain index toggle buttons 187 | */ 188 | initIndexTable : function() { 189 | var togglers = $('img.toggler').click(function() { 190 | var src = $(this).attr('src'); 191 | var idnum = $(this).attr('id').substr(7); 192 | $('tr.cg-' + idnum).toggle(); 193 | if (src.substr(-9) == 'minus.png') 194 | $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); 195 | else 196 | $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); 197 | }).css('display', ''); 198 | if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { 199 | togglers.click(); 200 | } 201 | }, 202 | 203 | /** 204 | * helper function to hide the search marks again 205 | */ 206 | hideSearchWords : function() { 207 | $('#searchbox .highlight-link').fadeOut(300); 208 | $('span.highlighted').removeClass('highlighted'); 209 | }, 210 | 211 | /** 212 | * make the url absolute 213 | */ 214 | makeURL : function(relativeURL) { 215 | return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; 216 | }, 217 | 218 | /** 219 | * get the current relative url 220 | */ 221 | getCurrentURL : function() { 222 | var path = document.location.pathname; 223 | var parts = path.split(/\//); 224 | $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { 225 | if (this == '..') 226 | parts.pop(); 227 | }); 228 | var url = parts.join('/'); 229 | return path.substring(url.lastIndexOf('/') + 1, path.length - 1); 230 | } 231 | }; 232 | 233 | // quick alias for translations 234 | _ = Documentation.gettext; 235 | 236 | $(document).ready(function() { 237 | Documentation.init(); 238 | }); 239 | -------------------------------------------------------------------------------- /docs/_build/html/_static/down-pressed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/down-pressed.png -------------------------------------------------------------------------------- /docs/_build/html/_static/down.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/down.png -------------------------------------------------------------------------------- /docs/_build/html/_static/file.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/file.png -------------------------------------------------------------------------------- /docs/_build/html/_static/image1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/image1.png -------------------------------------------------------------------------------- /docs/_build/html/_static/minus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/minus.png -------------------------------------------------------------------------------- /docs/_build/html/_static/plus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/_static/plus.png -------------------------------------------------------------------------------- /docs/_build/html/_static/pygments.css: -------------------------------------------------------------------------------- 1 | .highlight .hll { background-color: #ffffcc } 2 | .highlight { background: #eeffcc; } 3 | .highlight .c { color: #408090; font-style: italic } /* Comment */ 4 | .highlight .err { border: 1px solid #FF0000 } /* Error */ 5 | .highlight .k { color: #007020; font-weight: bold } /* Keyword */ 6 | .highlight .o { color: #666666 } /* Operator */ 7 | .highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */ 8 | .highlight .cp { color: #007020 } /* Comment.Preproc */ 9 | .highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */ 10 | .highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */ 11 | .highlight .gd { color: #A00000 } /* Generic.Deleted */ 12 | .highlight .ge { font-style: italic } /* Generic.Emph */ 13 | .highlight .gr { color: #FF0000 } /* Generic.Error */ 14 | .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ 15 | .highlight .gi { color: #00A000 } /* Generic.Inserted */ 16 | .highlight .go { color: #333333 } /* Generic.Output */ 17 | .highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ 18 | .highlight .gs { font-weight: bold } /* Generic.Strong */ 19 | .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ 20 | .highlight .gt { color: #0044DD } /* Generic.Traceback */ 21 | .highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ 22 | .highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ 23 | .highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ 24 | .highlight .kp { color: #007020 } /* Keyword.Pseudo */ 25 | .highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ 26 | .highlight .kt { color: #902000 } /* Keyword.Type */ 27 | .highlight .m { color: #208050 } /* Literal.Number */ 28 | .highlight .s { color: #4070a0 } /* Literal.String */ 29 | .highlight .na { color: #4070a0 } /* Name.Attribute */ 30 | .highlight .nb { color: #007020 } /* Name.Builtin */ 31 | .highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ 32 | .highlight .no { color: #60add5 } /* Name.Constant */ 33 | .highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ 34 | .highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ 35 | .highlight .ne { color: #007020 } /* Name.Exception */ 36 | .highlight .nf { color: #06287e } /* Name.Function */ 37 | .highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ 38 | .highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ 39 | .highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ 40 | .highlight .nv { color: #bb60d5 } /* Name.Variable */ 41 | .highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ 42 | .highlight .w { color: #bbbbbb } /* Text.Whitespace */ 43 | .highlight .mf { color: #208050 } /* Literal.Number.Float */ 44 | .highlight .mh { color: #208050 } /* Literal.Number.Hex */ 45 | .highlight .mi { color: #208050 } /* Literal.Number.Integer */ 46 | .highlight .mo { color: #208050 } /* Literal.Number.Oct */ 47 | .highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ 48 | .highlight .sc { color: #4070a0 } /* Literal.String.Char */ 49 | .highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ 50 | .highlight .s2 { color: #4070a0 } /* Literal.String.Double */ 51 | .highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ 52 | .highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ 53 | .highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ 54 | .highlight .sx { color: #c65d09 } /* Literal.String.Other */ 55 | .highlight .sr { color: #235388 } /* Literal.String.Regex */ 56 | .highlight .s1 { color: #4070a0 } /* Literal.String.Single */ 57 | .highlight .ss { color: #517918 } /* Literal.String.Symbol */ 58 | .highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ 59 | .highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ 60 | .highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ 61 | .highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ 62 | .highlight .il { color: #208050 } /* Literal.Number.Integer.Long */ -------------------------------------------------------------------------------- /docs/_build/html/_static/searchtools.js: -------------------------------------------------------------------------------- 1 | /* 2 | * searchtools.js_t 3 | * ~~~~~~~~~~~~~~~~ 4 | * 5 | * Sphinx JavaScript utilties for the full-text search. 6 | * 7 | * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | 13 | /** 14 | * Porter Stemmer 15 | */ 16 | var Stemmer = function() { 17 | 18 | var step2list = { 19 | ational: 'ate', 20 | tional: 'tion', 21 | enci: 'ence', 22 | anci: 'ance', 23 | izer: 'ize', 24 | bli: 'ble', 25 | alli: 'al', 26 | entli: 'ent', 27 | eli: 'e', 28 | ousli: 'ous', 29 | ization: 'ize', 30 | ation: 'ate', 31 | ator: 'ate', 32 | alism: 'al', 33 | iveness: 'ive', 34 | fulness: 'ful', 35 | ousness: 'ous', 36 | aliti: 'al', 37 | iviti: 'ive', 38 | biliti: 'ble', 39 | logi: 'log' 40 | }; 41 | 42 | var step3list = { 43 | icate: 'ic', 44 | ative: '', 45 | alize: 'al', 46 | iciti: 'ic', 47 | ical: 'ic', 48 | ful: '', 49 | ness: '' 50 | }; 51 | 52 | var c = "[^aeiou]"; // consonant 53 | var v = "[aeiouy]"; // vowel 54 | var C = c + "[^aeiouy]*"; // consonant sequence 55 | var V = v + "[aeiou]*"; // vowel sequence 56 | 57 | var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 58 | var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 59 | var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 60 | var s_v = "^(" + C + ")?" + v; // vowel in stem 61 | 62 | this.stemWord = function (w) { 63 | var stem; 64 | var suffix; 65 | var firstch; 66 | var origword = w; 67 | 68 | if (w.length < 3) 69 | return w; 70 | 71 | var re; 72 | var re2; 73 | var re3; 74 | var re4; 75 | 76 | firstch = w.substr(0,1); 77 | if (firstch == "y") 78 | w = firstch.toUpperCase() + w.substr(1); 79 | 80 | // Step 1a 81 | re = /^(.+?)(ss|i)es$/; 82 | re2 = /^(.+?)([^s])s$/; 83 | 84 | if (re.test(w)) 85 | w = w.replace(re,"$1$2"); 86 | else if (re2.test(w)) 87 | w = w.replace(re2,"$1$2"); 88 | 89 | // Step 1b 90 | re = /^(.+?)eed$/; 91 | re2 = /^(.+?)(ed|ing)$/; 92 | if (re.test(w)) { 93 | var fp = re.exec(w); 94 | re = new RegExp(mgr0); 95 | if (re.test(fp[1])) { 96 | re = /.$/; 97 | w = w.replace(re,""); 98 | } 99 | } 100 | else if (re2.test(w)) { 101 | var fp = re2.exec(w); 102 | stem = fp[1]; 103 | re2 = new RegExp(s_v); 104 | if (re2.test(stem)) { 105 | w = stem; 106 | re2 = /(at|bl|iz)$/; 107 | re3 = new RegExp("([^aeiouylsz])\\1$"); 108 | re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); 109 | if (re2.test(w)) 110 | w = w + "e"; 111 | else if (re3.test(w)) { 112 | re = /.$/; 113 | w = w.replace(re,""); 114 | } 115 | else if (re4.test(w)) 116 | w = w + "e"; 117 | } 118 | } 119 | 120 | // Step 1c 121 | re = /^(.+?)y$/; 122 | if (re.test(w)) { 123 | var fp = re.exec(w); 124 | stem = fp[1]; 125 | re = new RegExp(s_v); 126 | if (re.test(stem)) 127 | w = stem + "i"; 128 | } 129 | 130 | // Step 2 131 | re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; 132 | if (re.test(w)) { 133 | var fp = re.exec(w); 134 | stem = fp[1]; 135 | suffix = fp[2]; 136 | re = new RegExp(mgr0); 137 | if (re.test(stem)) 138 | w = stem + step2list[suffix]; 139 | } 140 | 141 | // Step 3 142 | re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; 143 | if (re.test(w)) { 144 | var fp = re.exec(w); 145 | stem = fp[1]; 146 | suffix = fp[2]; 147 | re = new RegExp(mgr0); 148 | if (re.test(stem)) 149 | w = stem + step3list[suffix]; 150 | } 151 | 152 | // Step 4 153 | re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; 154 | re2 = /^(.+?)(s|t)(ion)$/; 155 | if (re.test(w)) { 156 | var fp = re.exec(w); 157 | stem = fp[1]; 158 | re = new RegExp(mgr1); 159 | if (re.test(stem)) 160 | w = stem; 161 | } 162 | else if (re2.test(w)) { 163 | var fp = re2.exec(w); 164 | stem = fp[1] + fp[2]; 165 | re2 = new RegExp(mgr1); 166 | if (re2.test(stem)) 167 | w = stem; 168 | } 169 | 170 | // Step 5 171 | re = /^(.+?)e$/; 172 | if (re.test(w)) { 173 | var fp = re.exec(w); 174 | stem = fp[1]; 175 | re = new RegExp(mgr1); 176 | re2 = new RegExp(meq1); 177 | re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); 178 | if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) 179 | w = stem; 180 | } 181 | re = /ll$/; 182 | re2 = new RegExp(mgr1); 183 | if (re.test(w) && re2.test(w)) { 184 | re = /.$/; 185 | w = w.replace(re,""); 186 | } 187 | 188 | // and turn initial Y back to y 189 | if (firstch == "y") 190 | w = firstch.toLowerCase() + w.substr(1); 191 | return w; 192 | } 193 | } 194 | 195 | 196 | 197 | /** 198 | * Simple result scoring code. 199 | */ 200 | var Scorer = { 201 | // Implement the following function to further tweak the score for each result 202 | // The function takes a result array [filename, title, anchor, descr, score] 203 | // and returns the new score. 204 | /* 205 | score: function(result) { 206 | return result[4]; 207 | }, 208 | */ 209 | 210 | // query matches the full name of an object 211 | objNameMatch: 11, 212 | // or matches in the last dotted part of the object name 213 | objPartialMatch: 6, 214 | // Additive scores depending on the priority of the object 215 | objPrio: {0: 15, // used to be importantResults 216 | 1: 5, // used to be objectResults 217 | 2: -5}, // used to be unimportantResults 218 | // Used when the priority is not in the mapping. 219 | objPrioDefault: 0, 220 | 221 | // query found in title 222 | title: 15, 223 | // query found in terms 224 | term: 5 225 | }; 226 | 227 | 228 | /** 229 | * Search Module 230 | */ 231 | var Search = { 232 | 233 | _index : null, 234 | _queued_query : null, 235 | _pulse_status : -1, 236 | 237 | init : function() { 238 | var params = $.getQueryParameters(); 239 | if (params.q) { 240 | var query = params.q[0]; 241 | $('input[name="q"]')[0].value = query; 242 | this.performSearch(query); 243 | } 244 | }, 245 | 246 | loadIndex : function(url) { 247 | $.ajax({type: "GET", url: url, data: null, 248 | dataType: "script", cache: true, 249 | complete: function(jqxhr, textstatus) { 250 | if (textstatus != "success") { 251 | document.getElementById("searchindexloader").src = url; 252 | } 253 | }}); 254 | }, 255 | 256 | setIndex : function(index) { 257 | var q; 258 | this._index = index; 259 | if ((q = this._queued_query) !== null) { 260 | this._queued_query = null; 261 | Search.query(q); 262 | } 263 | }, 264 | 265 | hasIndex : function() { 266 | return this._index !== null; 267 | }, 268 | 269 | deferQuery : function(query) { 270 | this._queued_query = query; 271 | }, 272 | 273 | stopPulse : function() { 274 | this._pulse_status = 0; 275 | }, 276 | 277 | startPulse : function() { 278 | if (this._pulse_status >= 0) 279 | return; 280 | function pulse() { 281 | var i; 282 | Search._pulse_status = (Search._pulse_status + 1) % 4; 283 | var dotString = ''; 284 | for (i = 0; i < Search._pulse_status; i++) 285 | dotString += '.'; 286 | Search.dots.text(dotString); 287 | if (Search._pulse_status > -1) 288 | window.setTimeout(pulse, 500); 289 | } 290 | pulse(); 291 | }, 292 | 293 | /** 294 | * perform a search for something (or wait until index is loaded) 295 | */ 296 | performSearch : function(query) { 297 | // create the required interface elements 298 | this.out = $('#search-results'); 299 | this.title = $('

' + _('Searching') + '

').appendTo(this.out); 300 | this.dots = $('').appendTo(this.title); 301 | this.status = $('

').appendTo(this.out); 302 | this.output = $('
    ').appendTo(this.out); 303 | 304 | $('#search-progress').text(_('Preparing search...')); 305 | this.startPulse(); 306 | 307 | // index already loaded, the browser was quick! 308 | if (this.hasIndex()) 309 | this.query(query); 310 | else 311 | this.deferQuery(query); 312 | }, 313 | 314 | /** 315 | * execute search (requires search index to be loaded) 316 | */ 317 | query : function(query) { 318 | var i; 319 | var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]; 320 | 321 | // stem the searchterms and add them to the correct list 322 | var stemmer = new Stemmer(); 323 | var searchterms = []; 324 | var excluded = []; 325 | var hlterms = []; 326 | var tmp = query.split(/\s+/); 327 | var objectterms = []; 328 | for (i = 0; i < tmp.length; i++) { 329 | if (tmp[i] !== "") { 330 | objectterms.push(tmp[i].toLowerCase()); 331 | } 332 | 333 | if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i].match(/^\d+$/) || 334 | tmp[i] === "") { 335 | // skip this "word" 336 | continue; 337 | } 338 | // stem the word 339 | var word = stemmer.stemWord(tmp[i].toLowerCase()); 340 | var toAppend; 341 | // select the correct list 342 | if (word[0] == '-') { 343 | toAppend = excluded; 344 | word = word.substr(1); 345 | } 346 | else { 347 | toAppend = searchterms; 348 | hlterms.push(tmp[i].toLowerCase()); 349 | } 350 | // only add if not already in the list 351 | if (!$u.contains(toAppend, word)) 352 | toAppend.push(word); 353 | } 354 | var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); 355 | 356 | // console.debug('SEARCH: searching for:'); 357 | // console.info('required: ', searchterms); 358 | // console.info('excluded: ', excluded); 359 | 360 | // prepare search 361 | var terms = this._index.terms; 362 | var titleterms = this._index.titleterms; 363 | 364 | // array of [filename, title, anchor, descr, score] 365 | var results = []; 366 | $('#search-progress').empty(); 367 | 368 | // lookup as object 369 | for (i = 0; i < objectterms.length; i++) { 370 | var others = [].concat(objectterms.slice(0, i), 371 | objectterms.slice(i+1, objectterms.length)); 372 | results = results.concat(this.performObjectSearch(objectterms[i], others)); 373 | } 374 | 375 | // lookup as search terms in fulltext 376 | results = results.concat(this.performTermsSearch(searchterms, excluded, terms, Scorer.term)) 377 | .concat(this.performTermsSearch(searchterms, excluded, titleterms, Scorer.title)); 378 | 379 | // let the scorer override scores with a custom scoring function 380 | if (Scorer.score) { 381 | for (i = 0; i < results.length; i++) 382 | results[i][4] = Scorer.score(results[i]); 383 | } 384 | 385 | // now sort the results by score (in opposite order of appearance, since the 386 | // display function below uses pop() to retrieve items) and then 387 | // alphabetically 388 | results.sort(function(a, b) { 389 | var left = a[4]; 390 | var right = b[4]; 391 | if (left > right) { 392 | return 1; 393 | } else if (left < right) { 394 | return -1; 395 | } else { 396 | // same score: sort alphabetically 397 | left = a[1].toLowerCase(); 398 | right = b[1].toLowerCase(); 399 | return (left > right) ? -1 : ((left < right) ? 1 : 0); 400 | } 401 | }); 402 | 403 | // for debugging 404 | //Search.lastresults = results.slice(); // a copy 405 | //console.info('search results:', Search.lastresults); 406 | 407 | // print the results 408 | var resultCount = results.length; 409 | function displayNextItem() { 410 | // results left, load the summary and display it 411 | if (results.length) { 412 | var item = results.pop(); 413 | var listItem = $('
  • '); 414 | if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') { 415 | // dirhtml builder 416 | var dirname = item[0] + '/'; 417 | if (dirname.match(/\/index\/$/)) { 418 | dirname = dirname.substring(0, dirname.length-6); 419 | } else if (dirname == 'index/') { 420 | dirname = ''; 421 | } 422 | listItem.append($('').attr('href', 423 | DOCUMENTATION_OPTIONS.URL_ROOT + dirname + 424 | highlightstring + item[2]).html(item[1])); 425 | } else { 426 | // normal html builders 427 | listItem.append($('').attr('href', 428 | item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + 429 | highlightstring + item[2]).html(item[1])); 430 | } 431 | if (item[3]) { 432 | listItem.append($(' (' + item[3] + ')')); 433 | Search.output.append(listItem); 434 | listItem.slideDown(5, function() { 435 | displayNextItem(); 436 | }); 437 | } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { 438 | $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + item[0] + '.txt', 439 | dataType: "text", 440 | complete: function(jqxhr, textstatus) { 441 | var data = jqxhr.responseText; 442 | if (data !== '') { 443 | listItem.append(Search.makeSearchSummary(data, searchterms, hlterms)); 444 | } 445 | Search.output.append(listItem); 446 | listItem.slideDown(5, function() { 447 | displayNextItem(); 448 | }); 449 | }}); 450 | } else { 451 | // no source available, just display title 452 | Search.output.append(listItem); 453 | listItem.slideDown(5, function() { 454 | displayNextItem(); 455 | }); 456 | } 457 | } 458 | // search finished, update title and status message 459 | else { 460 | Search.stopPulse(); 461 | Search.title.text(_('Search Results')); 462 | if (!resultCount) 463 | Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); 464 | else 465 | Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); 466 | Search.status.fadeIn(500); 467 | } 468 | } 469 | displayNextItem(); 470 | }, 471 | 472 | /** 473 | * search for object names 474 | */ 475 | performObjectSearch : function(object, otherterms) { 476 | var filenames = this._index.filenames; 477 | var objects = this._index.objects; 478 | var objnames = this._index.objnames; 479 | var titles = this._index.titles; 480 | 481 | var i; 482 | var results = []; 483 | 484 | for (var prefix in objects) { 485 | for (var name in objects[prefix]) { 486 | var fullname = (prefix ? prefix + '.' : '') + name; 487 | if (fullname.toLowerCase().indexOf(object) > -1) { 488 | var score = 0; 489 | var parts = fullname.split('.'); 490 | // check for different match types: exact matches of full name or 491 | // "last name" (i.e. last dotted part) 492 | if (fullname == object || parts[parts.length - 1] == object) { 493 | score += Scorer.objNameMatch; 494 | // matches in last name 495 | } else if (parts[parts.length - 1].indexOf(object) > -1) { 496 | score += Scorer.objPartialMatch; 497 | } 498 | var match = objects[prefix][name]; 499 | var objname = objnames[match[1]][2]; 500 | var title = titles[match[0]]; 501 | // If more than one term searched for, we require other words to be 502 | // found in the name/title/description 503 | if (otherterms.length > 0) { 504 | var haystack = (prefix + ' ' + name + ' ' + 505 | objname + ' ' + title).toLowerCase(); 506 | var allfound = true; 507 | for (i = 0; i < otherterms.length; i++) { 508 | if (haystack.indexOf(otherterms[i]) == -1) { 509 | allfound = false; 510 | break; 511 | } 512 | } 513 | if (!allfound) { 514 | continue; 515 | } 516 | } 517 | var descr = objname + _(', in ') + title; 518 | 519 | var anchor = match[3]; 520 | if (anchor === '') 521 | anchor = fullname; 522 | else if (anchor == '-') 523 | anchor = objnames[match[1]][1] + '-' + fullname; 524 | // add custom score for some objects according to scorer 525 | if (Scorer.objPrio.hasOwnProperty(match[2])) { 526 | score += Scorer.objPrio[match[2]]; 527 | } else { 528 | score += Scorer.objPrioDefault; 529 | } 530 | results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]); 531 | } 532 | } 533 | } 534 | 535 | return results; 536 | }, 537 | 538 | /** 539 | * search for full-text terms in the index 540 | */ 541 | performTermsSearch : function(searchterms, excluded, terms, score) { 542 | var filenames = this._index.filenames; 543 | var titles = this._index.titles; 544 | 545 | var i, j, file, files; 546 | var fileMap = {}; 547 | var results = []; 548 | 549 | // perform the search on the required terms 550 | for (i = 0; i < searchterms.length; i++) { 551 | var word = searchterms[i]; 552 | // no match but word was a required one 553 | if ((files = terms[word]) === undefined) 554 | break; 555 | if (files.length === undefined) { 556 | files = [files]; 557 | } 558 | // create the mapping 559 | for (j = 0; j < files.length; j++) { 560 | file = files[j]; 561 | if (file in fileMap) 562 | fileMap[file].push(word); 563 | else 564 | fileMap[file] = [word]; 565 | } 566 | } 567 | 568 | // now check if the files don't contain excluded terms 569 | for (file in fileMap) { 570 | var valid = true; 571 | 572 | // check if all requirements are matched 573 | if (fileMap[file].length != searchterms.length) 574 | continue; 575 | 576 | // ensure that none of the excluded terms is in the search result 577 | for (i = 0; i < excluded.length; i++) { 578 | if (terms[excluded[i]] == file || 579 | $u.contains(terms[excluded[i]] || [], file)) { 580 | valid = false; 581 | break; 582 | } 583 | } 584 | 585 | // if we have still a valid result we can add it to the result list 586 | if (valid) { 587 | results.push([filenames[file], titles[file], '', null, score]); 588 | } 589 | } 590 | return results; 591 | }, 592 | 593 | /** 594 | * helper function to return a node containing the 595 | * search summary for a given text. keywords is a list 596 | * of stemmed words, hlwords is the list of normal, unstemmed 597 | * words. the first one is used to find the occurance, the 598 | * latter for highlighting it. 599 | */ 600 | makeSearchSummary : function(text, keywords, hlwords) { 601 | var textLower = text.toLowerCase(); 602 | var start = 0; 603 | $.each(keywords, function() { 604 | var i = textLower.indexOf(this.toLowerCase()); 605 | if (i > -1) 606 | start = i; 607 | }); 608 | start = Math.max(start - 120, 0); 609 | var excerpt = ((start > 0) ? '...' : '') + 610 | $.trim(text.substr(start, 240)) + 611 | ((start + 240 - text.length) ? '...' : ''); 612 | var rv = $('
    ').text(excerpt); 613 | $.each(hlwords, function() { 614 | rv = rv.highlightText(this, 'highlighted'); 615 | }); 616 | return rv; 617 | } 618 | }; 619 | 620 | $(document).ready(function() { 621 | Search.init(); 622 | }); -------------------------------------------------------------------------------- /docs/_build/html/_static/sidebar.js: -------------------------------------------------------------------------------- 1 | /* 2 | * sidebar.js 3 | * ~~~~~~~~~~ 4 | * 5 | * This script makes the Sphinx sidebar collapsible. 6 | * 7 | * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds 8 | * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton 9 | * used to collapse and expand the sidebar. 10 | * 11 | * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden 12 | * and the width of the sidebar and the margin-left of the document 13 | * are decreased. When the sidebar is expanded the opposite happens. 14 | * This script saves a per-browser/per-session cookie used to 15 | * remember the position of the sidebar among the pages. 16 | * Once the browser is closed the cookie is deleted and the position 17 | * reset to the default (expanded). 18 | * 19 | * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. 20 | * :license: BSD, see LICENSE for details. 21 | * 22 | */ 23 | 24 | $(function() { 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | // global elements used by the functions. 34 | // the 'sidebarbutton' element is defined as global after its 35 | // creation, in the add_sidebar_button function 36 | var bodywrapper = $('.bodywrapper'); 37 | var sidebar = $('.sphinxsidebar'); 38 | var sidebarwrapper = $('.sphinxsidebarwrapper'); 39 | 40 | // for some reason, the document has no sidebar; do not run into errors 41 | if (!sidebar.length) return; 42 | 43 | // original margin-left of the bodywrapper and width of the sidebar 44 | // with the sidebar expanded 45 | var bw_margin_expanded = bodywrapper.css('margin-left'); 46 | var ssb_width_expanded = sidebar.width(); 47 | 48 | // margin-left of the bodywrapper and width of the sidebar 49 | // with the sidebar collapsed 50 | var bw_margin_collapsed = '.8em'; 51 | var ssb_width_collapsed = '.8em'; 52 | 53 | // colors used by the current theme 54 | var dark_color = $('.related').css('background-color'); 55 | var light_color = $('.document').css('background-color'); 56 | 57 | function sidebar_is_collapsed() { 58 | return sidebarwrapper.is(':not(:visible)'); 59 | } 60 | 61 | function toggle_sidebar() { 62 | if (sidebar_is_collapsed()) 63 | expand_sidebar(); 64 | else 65 | collapse_sidebar(); 66 | } 67 | 68 | function collapse_sidebar() { 69 | sidebarwrapper.hide(); 70 | sidebar.css('width', ssb_width_collapsed); 71 | bodywrapper.css('margin-left', bw_margin_collapsed); 72 | sidebarbutton.css({ 73 | 'margin-left': '0', 74 | 'height': bodywrapper.height() 75 | }); 76 | sidebarbutton.find('span').text('»'); 77 | sidebarbutton.attr('title', _('Expand sidebar')); 78 | document.cookie = 'sidebar=collapsed'; 79 | } 80 | 81 | function expand_sidebar() { 82 | bodywrapper.css('margin-left', bw_margin_expanded); 83 | sidebar.css('width', ssb_width_expanded); 84 | sidebarwrapper.show(); 85 | sidebarbutton.css({ 86 | 'margin-left': ssb_width_expanded-12, 87 | 'height': bodywrapper.height() 88 | }); 89 | sidebarbutton.find('span').text('«'); 90 | sidebarbutton.attr('title', _('Collapse sidebar')); 91 | document.cookie = 'sidebar=expanded'; 92 | } 93 | 94 | function add_sidebar_button() { 95 | sidebarwrapper.css({ 96 | 'float': 'left', 97 | 'margin-right': '0', 98 | 'width': ssb_width_expanded - 28 99 | }); 100 | // create the button 101 | sidebar.append( 102 | '
    «
    ' 103 | ); 104 | var sidebarbutton = $('#sidebarbutton'); 105 | light_color = sidebarbutton.css('background-color'); 106 | // find the height of the viewport to center the '<<' in the page 107 | var viewport_height; 108 | if (window.innerHeight) 109 | viewport_height = window.innerHeight; 110 | else 111 | viewport_height = $(window).height(); 112 | sidebarbutton.find('span').css({ 113 | 'display': 'block', 114 | 'margin-top': (viewport_height - sidebar.position().top - 20) / 2 115 | }); 116 | 117 | sidebarbutton.click(toggle_sidebar); 118 | sidebarbutton.attr('title', _('Collapse sidebar')); 119 | sidebarbutton.css({ 120 | 'color': '#FFFFFF', 121 | 'border-left': '1px solid ' + dark_color, 122 | 'font-size': '1.2em', 123 | 'cursor': 'pointer', 124 | 'height': bodywrapper.height(), 125 | 'padding-top': '1px', 126 | 'margin-left': ssb_width_expanded - 12 127 | }); 128 | 129 | sidebarbutton.hover( 130 | function () { 131 | $(this).css('background-color', dark_color); 132 | }, 133 | function () { 134 | $(this).css('background-color', light_color); 135 | } 136 | ); 137 | } 138 | 139 | function set_position_from_cookie() { 140 | if (!document.cookie) 141 | return; 142 | var items = document.cookie.split(';'); 143 | for(var k=0; k 4 | 5 | 6 | 7 | 8 | 9 | 10 | Index — medusa 2.7.3 documentation 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 |
    32 |

    Navigation

    33 |     39 |
    40 | 41 |
    42 |
    43 |
    44 |
    45 | 46 | 47 |

    Index

    48 | 49 |
    50 | 51 |
    52 | 53 | 54 |
    55 |
    56 |
    57 |
    58 |
    59 | 60 | 61 | 62 | 74 | 75 |
    76 |
    77 |
    78 |
    79 |
    80 |

    Navigation

    81 | 87 |
    88 |
    89 | © Copyright 2014, Rahul De'. 90 | Created using Sphinx 1.2.2. 91 |
    92 | 93 | -------------------------------------------------------------------------------- /docs/_build/html/index.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Welcome to medusa’s documentation! — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 |
    32 |

    Navigation

    33 | 42 |
    43 | 44 |
    45 |
    46 |
    47 |
    48 | 49 |
    50 |

    Welcome to medusa’s documentation!

    51 |

    Contents:

    52 |
    53 | 76 |
    77 |
    78 |
    79 |

    Indices and tables

    80 | 85 |
    86 | 87 | 88 |
    89 |
    90 |
    91 |
    92 |
    93 |

    Table Of Contents

    94 | 98 | 99 |

    Next topic

    100 |

    Introduction

    102 |

    This Page

    103 | 107 | 119 | 120 |
    121 |
    122 |
    123 |
    124 |
    125 |

    Navigation

    126 | 135 |
    136 |
    137 | © Copyright 2014, Rahul De'. 138 | Created using Sphinx 1.2.2. 139 |
    140 | 141 | -------------------------------------------------------------------------------- /docs/_build/html/installation.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Installation — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 |
    33 |

    Navigation

    34 | 46 |
    47 | 48 |
    49 |
    50 |
    51 |
    52 | 53 |
    54 |

    Installation

    55 |

    Medusa is currently supported only on debian. Windows and Mac builds will soon be available

    56 |
    57 |

    Debian Users

    58 |
    59 |
    Simply run ./INSTALL after cloning this repo on your Debian
    60 |
    based Linux distro.
    61 |
    62 |

    Thats it. All dependencies are installed, code compiled and paths setup automatically.

    63 |
    64 |
    65 |

    Mac OSX Users (building from source)

    66 |
    67 |
      68 |
    • Install XCode if not installed (Sorry for the bandwidth hogging...)
      • 69 |
    • Install python 2.7.x if not installed and add it to PATH
      • 70 |
    • Download and Install latest Qt5 for Mac from here and add qmake and moc to PATH
      • 71 |
    • Download the latest Dart SDK from here, unzip and add the dart executable to PATH
      • 72 |
    • Clone this repo and simply run ./INSTALL.mac
      • 73 |
    • After a successful compile medusavm binary is available in /usr/bin/ for use
      • 74 |
    • For updates and subsequent builds, fetch changes and just run ./INSTALL.mac
      • 75 |
    76 |
    77 |
    78 |
    79 |

    Others

    80 |
    81 |
      82 |
    • Install C++ compilers and Make tools
      • 83 |
    • Install Qt5 build tools and libs
      • 84 |
    • Install Dart SDK
      • 85 |
    • Install Python 2.7.x
      • 86 |
    • Rum moc on inc/transform.h to inc/transform_moc.h
      • 87 |
    • Run qmake on medusa.pro
      • 88 |
    • Run make
      • 89 |
    • Use the medusavm executable
      • 90 |
    91 |
    92 |
    93 |
    94 |

    Using Medusa

    95 |
    96 |
      97 |
    • Medusa is available as medusavm after a successful buid and install
      • 98 |
    • Python programs can be run by passing them as parameters: medusavm hello.py
      • 99 |
    • Medusa can be stopped after the Dart compile phase by passing a -c switch: medusavm -c hello.py. The Dart code is obtained in hello.dart in the same directory.
      • 100 |
    • Python files can be globally installed into Medusa for imports by other files: medusavm -install python_file
      • 101 |
    • Help is at: medusavm –help
      • 102 |
    103 |
    104 |
    105 |
    106 | 107 | 108 |
    109 |
    110 |
    111 |
    112 |
    113 |

    Table Of Contents

    114 | 123 | 124 |

    Previous topic

    125 |

    Introduction

    127 |

    Next topic

    128 |

    Developers Corner

    130 |

    This Page

    131 | 135 | 147 | 148 |
    149 |
    150 |
    151 |
    152 |
    153 |

    Navigation

    154 | 166 |
    167 |
    168 | © Copyright 2014, Rahul De'. 169 | Created using Sphinx 1.2.2. 170 |
    171 | 172 | -------------------------------------------------------------------------------- /docs/_build/html/objects.inv: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_build/html/objects.inv -------------------------------------------------------------------------------- /docs/_build/html/search.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Search — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 32 | 33 | 34 | 35 | 36 | 37 | 38 |
    39 |

    Navigation

    40 | 46 |
    47 | 48 |
    49 |
    50 |
    51 |
    52 | 53 |

    Search

    54 |
    55 | 56 |

    57 | Please activate JavaScript to enable the search 58 | functionality. 59 |

    60 |
    61 |

    62 | From here you can search these documents. Enter your search 63 | words into the box below and click "search". Note that the search 64 | function will automatically search for all of the words. Pages 65 | containing fewer words won't appear in the result list. 66 |

    67 |
    68 | 69 | 70 | 71 |
    72 | 73 |
    74 | 75 |
    76 | 77 |
    78 |
    79 |
    80 |
    81 |
    82 |
    83 |
    84 |
    85 |
    86 |
    87 |

    Navigation

    88 | 94 |
    95 |
    96 | © Copyright 2014, Rahul De'. 97 | Created using Sphinx 1.2.2. 98 |
    99 | 100 | -------------------------------------------------------------------------------- /docs/_build/html/searchindex.js: -------------------------------------------------------------------------------- 1 | Search.setIndex({envversion:42,terms:{osx:[],all:[2,3,4],code:[5,3],forget:4,global:2,follow:[3,4],decid:4,procur:3,depend:2,sorri:2,send:4,easiest:4,program:2,aris:3,neglig:3,merchant:3,sourc:3,fall:4,veri:4,brows:4,akash:1,gui:4,list:3,phase:2,team:[],impli:3,direct:3,pass:2,download:[2,4],even:3,index:0,compar:[5,4],invok:4,apoorv:[1,3],current:[2,4],pratik:1,"new":4,deriv:3,gener:4,here:2,disclaim:3,met:3,modif:3,path:[2,4],sinc:[],convert:[],prior:3,permit:3,chang:[2,4],love:4,modul:0,prefer:4,apt:4,brought:4,vit:3,from:3,zip:[],univers:3,call:[],usr:2,peopl:[],claus:3,notic:3,prototyp:4,particular:3,cach:4,must:3,join:4,setup:2,work:[],can:[2,4],purpos:3,fetch:2,process:[],challeng:[],sudo:4,india:[],buid:2,unzip:2,hog:2,end:[],anoth:[],six:4,how:[],yum:4,simpl:4,distro:2,product:3,rebas:4,clone:[],after:2,befor:4,mac:[],mahajan:1,mai:[3,4],multipl:[],data:3,github:4,caus:3,"switch":2,environ:[],transform_moc:2,help:[2,4],endors:3,upstream:4,soon:2,hell:4,still:4,paramet:2,fit:3,fix:4,better:4,tort:3,window:[2,4],persist:4,them:2,good:3,python:[5,2,4],"break":4,qmake:2,interrupt:3,discuss:4,nor:3,name:3,aakash:3,token:4,each:4,mayuresh:1,updat:2,compil:2,idea:4,procedur:4,redistribut:3,event:3,special:3,out:3,stitch:[],profit:3,content:0,workflow:[],base:[2,4],theori:3,releas:5,org:4,place:4,retain:3,hyderabad:[],major:[],done:4,fast:4,mahajan92:[],stabl:[],convent:[],script:4,system:4,termin:4,option:4,tool:[2,4],sync:4,"short":4,pars:4,dartsdk:[],holder:3,wide:4,cpython:5,provid:[3,4],tree:4,project:1,frankli:4,toward:1,ia32:[],pro:2,ani:[3,4],packag:4,have:4,need:4,lib:2,note:4,also:4,take:4,which:4,channel:[],sure:4,distribut:3,shall:3,who:1,most:4,maco:[],python_fil:2,request:4,doe:4,part:4,came:5,xcode:2,verbos:4,syntax:4,permiss:3,onli:2,submit:[],execut:2,copyright:3,enough:4,should:4,busi:3,rahul:[1,3],local:4,contribut:[1,4],get:4,express:3,stop:2,becaus:4,repo:[2,4],nativ:4,liabl:3,patch:[],where:4,wrote:4,set:4,reserv:3,gmail:[],flexibl:4,databas:4,review:4,written:3,"import":2,neither:3,qt5:2,incident:3,joi:4,come:[],howev:3,contract:3,etc:4,tutori:4,com:4,comment:4,simpli:2,walk:4,exemplari:3,linux:[2,4],damag:3,liabil:3,aditi:1,been:[],search:0,servic:3,"while":4,waykol:1,abov:3,error:4,everyon:[1,4],succes:[],archiv:[],develop:[],suggest:4,make:[2,4],same:[2,4],binari:[2,3],sqlite3:4,shah:1,http:4,optim:4,build:[],implement:4,travers:[],equival:4,without:3,command:4,thi:[1,2,3,4],choos:4,latest:2,just:2,obtain:2,googleapi:[],bandwidth:2,languag:4,add:[2,4],other:3,subsequ:2,rahul080327:4,bin:2,advis:3,dart:[5,2,4],moc:2,dartlang:[],recurs:[],like:4,loss:3,medusavm:2,specif:3,success:2,output:4,manag:4,"function":[],www:[],right:3,spring:1,some:4,indirect:3,scale:4,deploy:4,substitut:3,larg:4,condit:3,speak:4,reproduc:3,machin:4,encourag:4,run:[5,2,4],power:5,rum:2,step:4,promot:3,repositori:4,simpler:4,shine:[],about:[],materi:3,page:0,commit:4,softwar:[3,4],disabl:4,primarili:4,automat:2,warranti:3,bsd:3,contributor:3,storag:[],your:[2,4],wai:[3,4],support:2,transform:2,dartvm:5,avail:2,start:[1,4],interfac:4,includ:3,lot:4,strict:3,fork:4,form:3,hiccup:4,line:4,bug:4,sdk:2,pull:4,possibl:3,whether:3,below:4,limit:3,otherwis:3,emit:4,featur:4,creat:[],alumni:[],"abstract":4,file:[2,4],check:4,inc:2,googl:5,when:4,virtual:4,valid:4,immens:4,you:4,giri:[1,3],nice:4,node:4,intend:4,consequenti:3,faster:[5,4],directori:2,agarw:[1,3],push:4,hello:2},objtypes:{},objnames:{},filenames:["index","About","installation","License","DevDocs","Intro"],titles:["Welcome to medusa’s documentation!","About","Installation","License","Developers Corner","Introduction"],objects:{},titleterms:{osx:2,code:[],medusa:[0,5,2,4],creat:4,process:[],indic:0,concept:4,glanc:5,tabl:0,corner:4,what:[],git:4,from:2,welcom:0,convent:[],licens:3,submit:4,how:4,other:2,build:2,document:0,instal:[2,4],sourc:2,workflow:4,clone:4,mac:2,user:2,develop:[1,4],debian:2,introduct:[5,4],about:1,work:4,patch:4,environ:4,team:1}}) -------------------------------------------------------------------------------- /docs/_build/html/workflow.html: -------------------------------------------------------------------------------- 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Development Introduction — medusa 2.7.3 documentation 10 | 11 | 12 | 13 | 14 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 |
    31 |

    Navigation

    32 | 38 |
    39 | 40 |
    41 |
    42 |
    43 |
    44 | 45 |
    46 |

    Development Introduction

    47 |
    48 | 49 | 50 |
    51 |
    52 |
    53 |
    54 |
    55 |

    This Page

    56 | 60 | 72 | 73 |
    74 |
    75 |
    76 |
    77 |
    78 |

    Navigation

    79 | 85 |
    86 |
    87 | © Copyright 2014, Rahul De'. 88 | Created using Sphinx 1.2.2. 89 |
    90 | 91 | -------------------------------------------------------------------------------- /docs/_static/image1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/_static/image1.png -------------------------------------------------------------------------------- /docs/autodoc: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/docs/autodoc -------------------------------------------------------------------------------- /docs/conf.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # 3 | # medusa documentation build configuration file, created by 4 | # sphinx-quickstart on Mon Sep 1 22:57:23 2014. 5 | # 6 | # This file is execfile()d with the current directory set to its 7 | # containing dir. 8 | # 9 | # Note that not all possible configuration values are present in this 10 | # autogenerated file. 11 | # 12 | # All configuration values have a default; values that are commented out 13 | # serve to show the default. 14 | 15 | import sys 16 | import os 17 | 18 | # If extensions (or modules to document with autodoc) are in another directory, 19 | # add these directories to sys.path here. If the directory is relative to the 20 | # documentation root, use os.path.abspath to make it absolute, like shown here. 21 | 22 | sys.path.insert(0, os.path.abspath('transform.py')) 23 | 24 | # -- General configuration ------------------------------------------------ 25 | 26 | # If your documentation needs a minimal Sphinx version, state it here. 27 | #needs_sphinx = '1.0' 28 | 29 | # Add any Sphinx extension module names here, as strings. They can be 30 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom 31 | # ones. 32 | extensions = [ 33 | 'sphinx.ext.autodoc', 34 | 'sphinx.ext.doctest', 35 | 'sphinx.ext.intersphinx', 36 | 'sphinx.ext.todo', 37 | 'sphinx.ext.coverage', 38 | 'sphinx.ext.mathjax', 39 | ] 40 | 41 | 42 | # Add any paths that contain templates here, relative to this directory. 43 | templates_path = ['_templates'] 44 | 45 | # The suffix of source filenames. 46 | source_suffix = '.rst' 47 | 48 | # The encoding of source files. 49 | #source_encoding = 'utf-8-sig' 50 | 51 | # The master toctree document. 52 | master_doc = 'index' 53 | 54 | # General information about the project. 55 | project = u'medusa' 56 | copyright = u'2014, Rahul De\'' 57 | 58 | # The version info for the project you're documenting, acts as replacement for 59 | # |version| and |release|, also used in various other places throughout the 60 | # built documents. 61 | # 62 | # The short X.Y version. 63 | version = '2.7' 64 | # The full version, including alpha/beta/rc tags. 65 | release = '2.7.3' 66 | 67 | # The language for content autogenerated by Sphinx. Refer to documentation 68 | # for a list of supported languages. 69 | #language = None 70 | 71 | # There are two options for replacing |today|: either, you set today to some 72 | # non-false value, then it is used: 73 | #today = '' 74 | # Else, today_fmt is used as the format for a strftime call. 75 | #today_fmt = '%B %d, %Y' 76 | 77 | # List of patterns, relative to source directory, that match files and 78 | # directories to ignore when looking for source files. 79 | exclude_patterns = ['_build'] 80 | 81 | # The reST default role (used for this markup: `text`) to use for all 82 | # documents. 83 | #default_role = None 84 | 85 | # If true, '()' will be appended to :func: etc. cross-reference text. 86 | #add_function_parentheses = True 87 | 88 | # If true, the current module name will be prepended to all description 89 | # unit titles (such as .. function::). 90 | #add_module_names = True 91 | 92 | # If true, sectionauthor and moduleauthor directives will be shown in the 93 | # output. They are ignored by default. 94 | #show_authors = False 95 | 96 | # The name of the Pygments (syntax highlighting) style to use. 97 | pygments_style = 'sphinx' 98 | 99 | # A list of ignored prefixes for module index sorting. 100 | #modindex_common_prefix = [] 101 | 102 | # If true, keep warnings as "system message" paragraphs in the built documents. 103 | #keep_warnings = False 104 | 105 | 106 | # -- Options for HTML output ---------------------------------------------- 107 | 108 | # The theme to use for HTML and HTML Help pages. See the documentation for 109 | # a list of builtin themes. 110 | html_theme = 'default' 111 | 112 | # Theme options are theme-specific and customize the look and feel of a theme 113 | # further. For a list of options available for each theme, see the 114 | # documentation. 115 | #html_theme_options = {} 116 | 117 | # Add any paths that contain custom themes here, relative to this directory. 118 | #html_theme_path = [] 119 | 120 | # The name for this set of Sphinx documents. If None, it defaults to 121 | # " v documentation". 122 | #html_title = None 123 | 124 | # A shorter title for the navigation bar. Default is the same as html_title. 125 | #html_short_title = None 126 | 127 | # The name of an image file (relative to this directory) to place at the top 128 | # of the sidebar. 129 | #html_logo = None 130 | 131 | # The name of an image file (within the static path) to use as favicon of the 132 | # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 133 | # pixels large. 134 | #html_favicon = None 135 | 136 | # Add any paths that contain custom static files (such as style sheets) here, 137 | # relative to this directory. They are copied after the builtin static files, 138 | # so a file named "default.css" will overwrite the builtin "default.css". 139 | html_static_path = ['_static'] 140 | 141 | # Add any extra paths that contain custom files (such as robots.txt or 142 | # .htaccess) here, relative to this directory. These files are copied 143 | # directly to the root of the documentation. 144 | #html_extra_path = [] 145 | 146 | # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, 147 | # using the given strftime format. 148 | #html_last_updated_fmt = '%b %d, %Y' 149 | 150 | # If true, SmartyPants will be used to convert quotes and dashes to 151 | # typographically correct entities. 152 | #html_use_smartypants = True 153 | 154 | # Custom sidebar templates, maps document names to template names. 155 | #html_sidebars = {} 156 | 157 | # Additional templates that should be rendered to pages, maps page names to 158 | # template names. 159 | #html_additional_pages = {} 160 | 161 | # If false, no module index is generated. 162 | #html_domain_indices = True 163 | 164 | # If false, no index is generated. 165 | #html_use_index = True 166 | 167 | # If true, the index is split into individual pages for each letter. 168 | #html_split_index = False 169 | 170 | # If true, links to the reST sources are added to the pages. 171 | #html_show_sourcelink = True 172 | 173 | # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. 174 | #html_show_sphinx = True 175 | 176 | # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. 177 | #html_show_copyright = True 178 | 179 | # If true, an OpenSearch description file will be output, and all pages will 180 | # contain a tag referring to it. The value of this option must be the 181 | # base URL from which the finished HTML is served. 182 | #html_use_opensearch = '' 183 | 184 | # This is the file name suffix for HTML files (e.g. ".xhtml"). 185 | #html_file_suffix = None 186 | 187 | # Output file base name for HTML help builder. 188 | htmlhelp_basename = 'medusadoc' 189 | 190 | 191 | # -- Options for LaTeX output --------------------------------------------- 192 | 193 | latex_elements = { 194 | # The paper size ('letterpaper' or 'a4paper'). 195 | #'papersize': 'letterpaper', 196 | 197 | # The font size ('10pt', '11pt' or '12pt'). 198 | #'pointsize': '10pt', 199 | 200 | # Additional stuff for the LaTeX preamble. 201 | #'preamble': '', 202 | } 203 | 204 | # Grouping the document tree into LaTeX files. List of tuples 205 | # (source start file, target name, title, 206 | # author, documentclass [howto, manual, or own class]). 207 | latex_documents = [ 208 | ('index', 'medusa.tex', u'medusa Documentation', 209 | u'Rahul De\'', 'manual'), 210 | ] 211 | 212 | # The name of an image file (relative to this directory) to place at the top of 213 | # the title page. 214 | #latex_logo = None 215 | 216 | # For "manual" documents, if this is true, then toplevel headings are parts, 217 | # not chapters. 218 | #latex_use_parts = False 219 | 220 | # If true, show page references after internal links. 221 | #latex_show_pagerefs = False 222 | 223 | # If true, show URL addresses after external links. 224 | #latex_show_urls = False 225 | 226 | # Documents to append as an appendix to all manuals. 227 | #latex_appendices = [] 228 | 229 | # If false, no module index is generated. 230 | #latex_domain_indices = True 231 | 232 | 233 | # -- Options for manual page output --------------------------------------- 234 | 235 | # One entry per manual page. List of tuples 236 | # (source start file, name, description, authors, manual section). 237 | man_pages = [ 238 | ('index', 'medusa', u'medusa Documentation', 239 | [u'Rahul De\''], 1) 240 | ] 241 | 242 | # If true, show URL addresses after external links. 243 | #man_show_urls = False 244 | 245 | 246 | # -- Options for Texinfo output ------------------------------------------- 247 | 248 | # Grouping the document tree into Texinfo files. List of tuples 249 | # (source start file, target name, title, author, 250 | # dir menu entry, description, category) 251 | texinfo_documents = [ 252 | ('index', 'medusa', u'medusa Documentation', 253 | u'Rahul De\'', 'medusa', 'One line description of project.', 254 | 'Miscellaneous'), 255 | ] 256 | 257 | # Documents to append as an appendix to all manuals. 258 | #texinfo_appendices = [] 259 | 260 | # If false, no module index is generated. 261 | #texinfo_domain_indices = True 262 | 263 | # How to display URL addresses: 'footnote', 'no', or 'inline'. 264 | #texinfo_show_urls = 'footnote' 265 | 266 | # If true, do not generate a @detailmenu in the "Top" node's menu. 267 | #texinfo_no_detailmenu = False 268 | 269 | 270 | # Example configuration for intersphinx: refer to the Python standard library. 271 | intersphinx_mapping = {'http://docs.python.org/': None} 272 | -------------------------------------------------------------------------------- /docs/index.rst: -------------------------------------------------------------------------------- 1 | .. medusa documentation master file, created by 2 | sphinx-quickstart on Mon Sep 1 22:57:23 2014. 3 | You can adapt this file completely to your liking, but it should at least 4 | contain the root `toctree` directive. 5 | 6 | Welcome to medusa's documentation! 7 | ================================== 8 | 9 | Contents: 10 | 11 | .. toctree:: 12 | :maxdepth: 2 13 | 14 | Intro.rst 15 | installation.rst 16 | DevDocs.rst 17 | About.rst 18 | License.rst 19 | 20 | 21 | 22 | Indices and tables 23 | ================== 24 | 25 | * :ref:`genindex` 26 | * :ref:`modindex` 27 | * :ref:`search` 28 | -------------------------------------------------------------------------------- /docs/installation.rst: -------------------------------------------------------------------------------- 1 | ============= 2 | Installation 3 | ============= 4 | 5 | Medusa is currently supported only on debian. Windows and Mac builds will soon be available 6 | 7 | Debian Users 8 | ============ 9 | 10 | Simply run ./INSTALL after cloning this `repo `_ on your Debian 11 | based Linux distro. 12 | Thats it. All dependencies are installed, code compiled and paths setup automatically. 13 | 14 | Mac OSX Users (building from source) 15 | ==================================== 16 | 17 | * Install XCode if not installed (Sorry for the bandwidth hogging...) 18 | * Install python 2.7.x if not installed and add it to PATH 19 | * Download and Install latest Qt5 for Mac from `here `_ and add qmake and moc to PATH 20 | * Download the latest Dart SDK from `here `_, unzip and add the dart executable to PATH 21 | * Clone this repo and simply run ./INSTALL.mac 22 | * After a successful compile medusavm binary is available in /usr/bin/ for use 23 | * For updates and subsequent builds, fetch changes and just run ./INSTALL.mac 24 | 25 | Others 26 | ====== 27 | * Install C++ compilers and Make tools 28 | * Install Qt5 build tools and libs 29 | * Install Dart SDK 30 | * Install Python 2.7.x 31 | * Rum moc on inc/transform.h to inc/transform_moc.h 32 | * Run qmake on medusa.pro 33 | * Run make 34 | * Use the medusavm executable 35 | 36 | Using Medusa 37 | ============ 38 | * Medusa is available as medusavm after a successful buid and install 39 | * Python programs can be run by passing them as parameters: medusavm hello.py 40 | * Medusa can be stopped after the Dart compile phase by passing a -c switch: medusavm -c hello.py. The Dart code is obtained in hello.dart in the same directory. 41 | * Python files can be globally installed into Medusa for imports by other files: medusavm -install python_file 42 | * Help is at: medusavm --help 43 | -------------------------------------------------------------------------------- /docs/make.bat: -------------------------------------------------------------------------------- 1 | @ECHO OFF 2 | 3 | REM Command file for Sphinx documentation 4 | 5 | if "%SPHINXBUILD%" == "" ( 6 | set SPHINXBUILD=sphinx-build 7 | ) 8 | set BUILDDIR=_build 9 | set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% . 10 | set I18NSPHINXOPTS=%SPHINXOPTS% . 11 | if NOT "%PAPER%" == "" ( 12 | set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS% 13 | set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS% 14 | ) 15 | 16 | if "%1" == "" goto help 17 | 18 | if "%1" == "help" ( 19 | :help 20 | echo.Please use `make ^` where ^ is one of 21 | echo. html to make standalone HTML files 22 | echo. dirhtml to make HTML files named index.html in directories 23 | echo. singlehtml to make a single large HTML file 24 | echo. pickle to make pickle files 25 | echo. json to make JSON files 26 | echo. htmlhelp to make HTML files and a HTML help project 27 | echo. qthelp to make HTML files and a qthelp project 28 | echo. devhelp to make HTML files and a Devhelp project 29 | echo. epub to make an epub 30 | echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter 31 | echo. text to make text files 32 | echo. man to make manual pages 33 | echo. texinfo to make Texinfo files 34 | echo. gettext to make PO message catalogs 35 | echo. changes to make an overview over all changed/added/deprecated items 36 | echo. xml to make Docutils-native XML files 37 | echo. pseudoxml to make pseudoxml-XML files for display purposes 38 | echo. linkcheck to check all external links for integrity 39 | echo. doctest to run all doctests embedded in the documentation if enabled 40 | goto end 41 | ) 42 | 43 | if "%1" == "clean" ( 44 | for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i 45 | del /q /s %BUILDDIR%\* 46 | goto end 47 | ) 48 | 49 | 50 | %SPHINXBUILD% 2> nul 51 | if errorlevel 9009 ( 52 | echo. 53 | echo.The 'sphinx-build' command was not found. Make sure you have Sphinx 54 | echo.installed, then set the SPHINXBUILD environment variable to point 55 | echo.to the full path of the 'sphinx-build' executable. Alternatively you 56 | echo.may add the Sphinx directory to PATH. 57 | echo. 58 | echo.If you don't have Sphinx installed, grab it from 59 | echo.http://sphinx-doc.org/ 60 | exit /b 1 61 | ) 62 | 63 | if "%1" == "html" ( 64 | %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html 65 | if errorlevel 1 exit /b 1 66 | echo. 67 | echo.Build finished. The HTML pages are in %BUILDDIR%/html. 68 | goto end 69 | ) 70 | 71 | if "%1" == "dirhtml" ( 72 | %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml 73 | if errorlevel 1 exit /b 1 74 | echo. 75 | echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml. 76 | goto end 77 | ) 78 | 79 | if "%1" == "singlehtml" ( 80 | %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml 81 | if errorlevel 1 exit /b 1 82 | echo. 83 | echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml. 84 | goto end 85 | ) 86 | 87 | if "%1" == "pickle" ( 88 | %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle 89 | if errorlevel 1 exit /b 1 90 | echo. 91 | echo.Build finished; now you can process the pickle files. 92 | goto end 93 | ) 94 | 95 | if "%1" == "json" ( 96 | %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json 97 | if errorlevel 1 exit /b 1 98 | echo. 99 | echo.Build finished; now you can process the JSON files. 100 | goto end 101 | ) 102 | 103 | if "%1" == "htmlhelp" ( 104 | %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp 105 | if errorlevel 1 exit /b 1 106 | echo. 107 | echo.Build finished; now you can run HTML Help Workshop with the ^ 108 | .hhp project file in %BUILDDIR%/htmlhelp. 109 | goto end 110 | ) 111 | 112 | if "%1" == "qthelp" ( 113 | %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp 114 | if errorlevel 1 exit /b 1 115 | echo. 116 | echo.Build finished; now you can run "qcollectiongenerator" with the ^ 117 | .qhcp project file in %BUILDDIR%/qthelp, like this: 118 | echo.^> qcollectiongenerator %BUILDDIR%\qthelp\medusa.qhcp 119 | echo.To view the help file: 120 | echo.^> assistant -collectionFile %BUILDDIR%\qthelp\medusa.ghc 121 | goto end 122 | ) 123 | 124 | if "%1" == "devhelp" ( 125 | %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp 126 | if errorlevel 1 exit /b 1 127 | echo. 128 | echo.Build finished. 129 | goto end 130 | ) 131 | 132 | if "%1" == "epub" ( 133 | %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub 134 | if errorlevel 1 exit /b 1 135 | echo. 136 | echo.Build finished. The epub file is in %BUILDDIR%/epub. 137 | goto end 138 | ) 139 | 140 | if "%1" == "latex" ( 141 | %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex 142 | if errorlevel 1 exit /b 1 143 | echo. 144 | echo.Build finished; the LaTeX files are in %BUILDDIR%/latex. 145 | goto end 146 | ) 147 | 148 | if "%1" == "latexpdf" ( 149 | %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex 150 | cd %BUILDDIR%/latex 151 | make all-pdf 152 | cd %BUILDDIR%/.. 153 | echo. 154 | echo.Build finished; the PDF files are in %BUILDDIR%/latex. 155 | goto end 156 | ) 157 | 158 | if "%1" == "latexpdfja" ( 159 | %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex 160 | cd %BUILDDIR%/latex 161 | make all-pdf-ja 162 | cd %BUILDDIR%/.. 163 | echo. 164 | echo.Build finished; the PDF files are in %BUILDDIR%/latex. 165 | goto end 166 | ) 167 | 168 | if "%1" == "text" ( 169 | %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text 170 | if errorlevel 1 exit /b 1 171 | echo. 172 | echo.Build finished. The text files are in %BUILDDIR%/text. 173 | goto end 174 | ) 175 | 176 | if "%1" == "man" ( 177 | %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man 178 | if errorlevel 1 exit /b 1 179 | echo. 180 | echo.Build finished. The manual pages are in %BUILDDIR%/man. 181 | goto end 182 | ) 183 | 184 | if "%1" == "texinfo" ( 185 | %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo 186 | if errorlevel 1 exit /b 1 187 | echo. 188 | echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo. 189 | goto end 190 | ) 191 | 192 | if "%1" == "gettext" ( 193 | %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale 194 | if errorlevel 1 exit /b 1 195 | echo. 196 | echo.Build finished. The message catalogs are in %BUILDDIR%/locale. 197 | goto end 198 | ) 199 | 200 | if "%1" == "changes" ( 201 | %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes 202 | if errorlevel 1 exit /b 1 203 | echo. 204 | echo.The overview file is in %BUILDDIR%/changes. 205 | goto end 206 | ) 207 | 208 | if "%1" == "linkcheck" ( 209 | %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck 210 | if errorlevel 1 exit /b 1 211 | echo. 212 | echo.Link check complete; look for any errors in the above output ^ 213 | or in %BUILDDIR%/linkcheck/output.txt. 214 | goto end 215 | ) 216 | 217 | if "%1" == "doctest" ( 218 | %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest 219 | if errorlevel 1 exit /b 1 220 | echo. 221 | echo.Testing of doctests in the sources finished, look at the ^ 222 | results in %BUILDDIR%/doctest/output.txt. 223 | goto end 224 | ) 225 | 226 | if "%1" == "xml" ( 227 | %SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml 228 | if errorlevel 1 exit /b 1 229 | echo. 230 | echo.Build finished. The XML files are in %BUILDDIR%/xml. 231 | goto end 232 | ) 233 | 234 | if "%1" == "pseudoxml" ( 235 | %SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml 236 | if errorlevel 1 exit /b 1 237 | echo. 238 | echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml. 239 | goto end 240 | ) 241 | 242 | :end 243 | -------------------------------------------------------------------------------- /icon.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/icon.jpg -------------------------------------------------------------------------------- /icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lispyclouds/medusa/cf069800eb607fe25d4dafa5332cceda5a7c7c8b/icon.png -------------------------------------------------------------------------------- /inc/cache.h: -------------------------------------------------------------------------------- 1 | #ifndef CACHE_H 2 | #define CACHE_H 3 | 4 | #include 5 | #include 6 | 7 | using namespace std; 8 | 9 | #define BUFFER_SIZE 512 10 | 11 | class Cache { 12 | public: 13 | Cache(); 14 | ~Cache(); 15 | bool isCached(QString path, QString &code); 16 | private: 17 | QSqlDatabase db; 18 | inline QString hashFile(QString path); 19 | inline bool changed(QString path, QString hash, QString &code); 20 | inline bool tryInsert(QString path, QString hash); 21 | }; 22 | 23 | #endif 24 | -------------------------------------------------------------------------------- /inc/exec.h: -------------------------------------------------------------------------------- 1 | #ifndef EXEC_H 2 | #define EXEC_H 3 | 4 | #include 5 | 6 | using namespace std; 7 | 8 | class Exec { 9 | public: 10 | void run(QString code, QString fileName, bool cStop); 11 | }; 12 | 13 | #endif 14 | -------------------------------------------------------------------------------- /inc/sha256.h: -------------------------------------------------------------------------------- 1 | #ifndef SHA256_H 2 | #define SHA256_H 3 | 4 | #define UNROLL_LOOPS 5 | 6 | #define SHA256_DIGEST_SIZE (256 / 8) 7 | #define SHA256_BLOCK_SIZE (512 / 8) 8 | 9 | #ifndef SHA2_TYPES 10 | #define SHA2_TYPES 11 | typedef unsigned char uint8; 12 | typedef unsigned int uint32; 13 | typedef unsigned long long uint64; 14 | #endif 15 | 16 | typedef struct { 17 | unsigned int tot_len; 18 | unsigned int len; 19 | unsigned char block[2 * SHA256_BLOCK_SIZE]; 20 | uint32 h[8]; 21 | } sha256_ctx; 22 | 23 | #define SHFR(x, n) (x >> n) 24 | #define ROTR(x, n) ((x >> n) | (x << ((sizeof(x) << 3) - n))) 25 | #define ROTL(x, n) ((x << n) | (x >> ((sizeof(x) << 3) - n))) 26 | #define CH(x, y, z) ((x & y) ^ (~x & z)) 27 | #define MAJ(x, y, z) ((x & y) ^ (x & z) ^ (y & z)) 28 | 29 | #define SHA256_F1(x) (ROTR(x, 2) ^ ROTR(x, 13) ^ ROTR(x, 22)) 30 | #define SHA256_F2(x) (ROTR(x, 6) ^ ROTR(x, 11) ^ ROTR(x, 25)) 31 | #define SHA256_F3(x) (ROTR(x, 7) ^ ROTR(x, 18) ^ SHFR(x, 3)) 32 | #define SHA256_F4(x) (ROTR(x, 17) ^ ROTR(x, 19) ^ SHFR(x, 10)) 33 | 34 | #define UNPACK32(x, str) \ 35 | { \ 36 | *((str) + 3) = (uint8) ((x) ); \ 37 | *((str) + 2) = (uint8) ((x) >> 8); \ 38 | *((str) + 1) = (uint8) ((x) >> 16); \ 39 | *((str) + 0) = (uint8) ((x) >> 24); \ 40 | } 41 | 42 | #define PACK32(str, x) \ 43 | { \ 44 | *(x) = ((uint32) *((str) + 3) ) \ 45 | | ((uint32) *((str) + 2) << 8) \ 46 | | ((uint32) *((str) + 1) << 16) \ 47 | | ((uint32) *((str) + 0) << 24); \ 48 | } 49 | 50 | #define UNPACK64(x, str) \ 51 | { \ 52 | *((str) + 7) = (uint8) ((x) ); \ 53 | *((str) + 6) = (uint8) ((x) >> 8); \ 54 | *((str) + 5) = (uint8) ((x) >> 16); \ 55 | *((str) + 4) = (uint8) ((x) >> 24); \ 56 | *((str) + 3) = (uint8) ((x) >> 32); \ 57 | *((str) + 2) = (uint8) ((x) >> 40); \ 58 | *((str) + 1) = (uint8) ((x) >> 48); \ 59 | *((str) + 0) = (uint8) ((x) >> 56); \ 60 | } 61 | 62 | #define PACK64(str, x) \ 63 | { \ 64 | *(x) = ((uint64) *((str) + 7) ) \ 65 | | ((uint64) *((str) + 6) << 8) \ 66 | | ((uint64) *((str) + 5) << 16) \ 67 | | ((uint64) *((str) + 4) << 24) \ 68 | | ((uint64) *((str) + 3) << 32) \ 69 | | ((uint64) *((str) + 2) << 40) \ 70 | | ((uint64) *((str) + 1) << 48) \ 71 | | ((uint64) *((str) + 0) << 56); \ 72 | } 73 | 74 | #define SHA256_SCR(i) \ 75 | { \ 76 | w[i] = SHA256_F4(w[i - 2]) + w[i - 7] \ 77 | + SHA256_F3(w[i - 15]) + w[i - 16]; \ 78 | } 79 | 80 | #define SHA256_SCR(i) \ 81 | { \ 82 | w[i] = SHA256_F4(w[i - 2]) + w[i - 7] \ 83 | + SHA256_F3(w[i - 15]) + w[i - 16]; \ 84 | } 85 | 86 | #define SHA256_EXP(a, b, c, d, e, f, g, h, j) \ 87 | { \ 88 | t1 = wv[h] + SHA256_F2(wv[e]) + CH(wv[e], wv[f], wv[g]) \ 89 | + sha256_k[j] + w[j]; \ 90 | t2 = SHA256_F1(wv[a]) + MAJ(wv[a], wv[b], wv[c]); \ 91 | wv[d] += t1; \ 92 | wv[h] = t1 + t2; \ 93 | } 94 | 95 | void sha256_init(sha256_ctx * ctx); 96 | void sha256_update(sha256_ctx *ctx, const unsigned char *message, unsigned int len); 97 | void sha256_final(sha256_ctx *ctx, unsigned char *digest); 98 | 99 | #endif 100 | -------------------------------------------------------------------------------- /inc/static_data.h: -------------------------------------------------------------------------------- 1 | char help[] = "\nMessers Heisenberg, AppuDB and Giri, The Purveyors of Speed\n" 2 | "\n" 3 | "<< PRESENTS >>\n" 4 | "\n" 5 | "Medusa 2.7.3 beta\n" 6 | "Copyright (c) 2013-2014, Rahul De, Apoorv Agarwal and Aakash Giri, VIT University\n" 7 | "Licensed under BSD 3-Clause\n" 8 | "\n" 9 | "Usage: medusa [options] file\n" 10 | "\n" 11 | "Options:\n" 12 | "-install Install External Python module\n" 13 | "-h, --help Display this information\n" 14 | "-v, --version Display the Program Version\n" 15 | "-c Compile to Dart only\n"; 16 | 17 | char version[] = "2.7.3b"; 18 | -------------------------------------------------------------------------------- /inc/transform.h: -------------------------------------------------------------------------------- 1 | #ifndef TRANSFORM_H 2 | #define TRANSFORM_H 3 | 4 | #include 5 | #include 6 | #include 7 | 8 | class Transform : public QObject { 9 | Q_OBJECT 10 | 11 | public: 12 | Transform(); 13 | ~Transform(); 14 | bool transform(QString path, QString &code); 15 | private slots: 16 | void pythonFinished(int exitCode, QProcess::ExitStatus exitStatus); 17 | void readStandardError(); 18 | void readStandardOutput(); 19 | void shitHappened(QProcess::ProcessError); 20 | private: 21 | QSqlDatabase db; 22 | QProcess *python; 23 | QString path, reply; 24 | int exitCode; 25 | }; 26 | 27 | #endif 28 | -------------------------------------------------------------------------------- /medusa.pro: -------------------------------------------------------------------------------- 1 | QT += core sql 2 | QT -= gui 3 | 4 | TARGET = medusavm 5 | 6 | CONFIG += console release 7 | CONFIG -= app_bundle 8 | 9 | TEMPLATE = app 10 | 11 | INCLUDEPATH += inc 12 | 13 | SOURCES += src/main.cpp \ 14 | src/cache.cpp \ 15 | src/sha256.cpp \ 16 | src/transform.cpp \ 17 | src/exec.cpp 18 | 19 | INSTALLS += target 20 | 21 | QMAKE_CXXFLAGS_RELEASE -= -O 22 | QMAKE_CXXFLAGS_RELEASE -= -O1 23 | QMAKE_CXXFLAGS_RELEASE -= -O2 24 | 25 | win32 { 26 | target.path = . 27 | QMAKE_CXXFLAGS -= -FS 28 | QMAKE_CXXFLAGS += -D "_CRT_SECURE_NO_WARNINGS" 29 | QMAKE_CXXFLAGS_RELEASE *= /O2 30 | QMAKE_LFLAGS += /MACHINE:x64 31 | } 32 | 33 | linux { 34 | target.path = /usr/bin 35 | QMAKE_CXXFLAGS += -m64 36 | QMAKE_CXXFLAGS_RELEASE *= -O3 37 | } 38 | 39 | macx { 40 | target.path = /usr/bin 41 | QMAKE_CXXFLAGS_RELEASE *= -O3 42 | } 43 | -------------------------------------------------------------------------------- /src/cache.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | #include 4 | #include 5 | #include 6 | #include 7 | #include 8 | 9 | Cache::Cache() { 10 | QString medusaHome = QDir::homePath() + "/.medusa/"; 11 | 12 | if (!QFile(medusaHome).exists()) { 13 | cerr << "\x1b[31m[Medusa Error] What?! Medusa Home folder not found or unreadable. Please Reinstall.\x1b[0m" << endl; 14 | exit(-1); 15 | } 16 | 17 | db = QSqlDatabase::addDatabase("QSQLITE"); 18 | db.setDatabaseName(medusaHome + "medusa.cache"); 19 | 20 | if (!QFile(medusaHome + "medusa.cache").exists()) { 21 | db.open(); 22 | QSqlQuery query(db); 23 | query.exec("CREATE TABLE MedusaCache (InFile TEXT UNIQUE, Hash VARCHAR(64) UNIQUE, GenCode TEXT)"); 24 | } 25 | else 26 | db.open(); 27 | } 28 | 29 | Cache::~Cache() { 30 | db.close(); 31 | } 32 | 33 | QString Cache::hashFile(QString path) { 34 | sha256_ctx ctx; 35 | FILE *inFile; 36 | char buffer[BUFFER_SIZE], output[2 * SHA256_DIGEST_SIZE + 1]; 37 | unsigned char digest[SHA256_DIGEST_SIZE]; 38 | int bytes; 39 | 40 | if (!(inFile = fopen(path.toStdString().c_str(), "rb"))) { 41 | cerr << "\x1b[31m[Medusa Error]: Couldn't read " + path.toStdString() + ". Please check if it exists and is readable.\x1b[0m" << endl; 42 | exit(-1); 43 | } 44 | 45 | sha256_init(&ctx); 46 | while ((bytes = fread(buffer, 1, BUFFER_SIZE, inFile)) != 0) 47 | sha256_update(&ctx, (const unsigned char *) buffer, bytes); 48 | sha256_final(&ctx, digest); 49 | 50 | fclose(inFile); 51 | output[2 * SHA256_DIGEST_SIZE] = 0; 52 | 53 | for (int i = 0; i < SHA256_DIGEST_SIZE ; i++) 54 | sprintf(output + 2 * i, "%02X", digest[i]); 55 | 56 | return QString(output); 57 | } 58 | 59 | bool Cache::tryInsert(QString path, QString hash) { 60 | QSqlQuery query(db); 61 | return query.exec("INSERT INTO MedusaCache VALUES ('" + path + "', '" + hash + "', '')"); 62 | } 63 | 64 | bool Cache::changed(QString path, QString hash, QString &code) { 65 | QSqlQuery query(db); 66 | 67 | query.exec("SELECT Hash, GenCode FROM MedusaCache WHERE InFile='" + path + "'"); 68 | query.next(); 69 | 70 | if (query.value(0).toString() != hash) 71 | return query.exec("UPDATE MedusaCache SET Hash='" + hash + "' WHERE InFile='" + path + "'"); 72 | 73 | code = query.value(1).toString(); 74 | return false; 75 | } 76 | 77 | bool Cache::isCached(QString path, QString &code) { 78 | QString hash = hashFile(path); 79 | QSqlQuery query(db); 80 | 81 | if (!tryInsert(path, hash)) { 82 | query.exec("SELECT GenCode FROM MedusaCache WHERE Hash='" + hash + "'"); 83 | query.next(); 84 | 85 | if (query.isValid()) { 86 | code = query.value(0).toString(); 87 | return true; 88 | } 89 | else 90 | return changed(path, hash, code) ? false : true; 91 | } 92 | else 93 | return false; 94 | } 95 | -------------------------------------------------------------------------------- /src/exec.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | #include 4 | 5 | void Exec::run(QString code, QString fileName, bool cStop) { 6 | QFile out(fileName); 7 | QString command = "dart " + fileName; 8 | 9 | out.open(QIODevice::WriteOnly | QIODevice::Text); 10 | out.write(code.toStdString().c_str()); 11 | out.close(); 12 | 13 | if (cStop) 14 | return; 15 | 16 | if (system(command.toStdString().c_str()) == 32512) 17 | cerr << "\x1b[31m[Medusa Error] Dart not found in PATH. Make sure its installed and is accesible via PATH\x1b[0m" << endl; 18 | 19 | out.remove(); 20 | } 21 | -------------------------------------------------------------------------------- /src/main.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | #include 4 | #include 5 | #include 6 | #include 7 | #include 8 | #include 9 | #include 10 | 11 | using namespace std; 12 | 13 | int main(int argc, char **argv) { 14 | QCoreApplication app(argc, argv); 15 | Cache cache; 16 | Transform transformer; 17 | Exec exec; 18 | QStringList args = app.arguments(); 19 | bool cStop = false, install = false; 20 | QString path, name, code; 21 | 22 | if (app.arguments().size() == 1) { 23 | cout << help; 24 | return 0; 25 | } 26 | 27 | foreach (QString arg, args) { 28 | if (arg == "--help" || arg == "-h") { 29 | cout << help; 30 | return 0; 31 | } 32 | else if (arg == "-c") 33 | cStop = true; 34 | else if (arg == "-install") 35 | install = true; 36 | else if (arg == "--version" || arg == "-v") { 37 | cout << version << " running on Qt " << qVersion() << endl; 38 | return 0; 39 | } 40 | else { 41 | QFileInfo pyFile(arg); 42 | path = pyFile.absoluteFilePath(); 43 | name = pyFile.completeBaseName(); 44 | } 45 | } 46 | 47 | if (install) { 48 | if (QFile::copy(path, QDir::homePath() + "/.medusa/lib/" + name + ".py")) 49 | cout << QString(name + ".py").toStdString() + " successfully Installed into Medusa!" << endl; 50 | else 51 | cerr << "\x1b[31mCouldn't Install: " + QString(name + ".py").toStdString() + "\x1b[0m" << endl; 52 | return 0; 53 | } 54 | 55 | if (cache.isCached(path, code) || transformer.transform(path, code)) 56 | exec.run(code, name + ".dart", cStop); 57 | 58 | return 0; 59 | } 60 | -------------------------------------------------------------------------------- /src/sha256.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | 4 | uint32 sha256_h0[8] = { 5 | 0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 6 | 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19 7 | }; 8 | 9 | uint32 sha256_k[64] = { 10 | 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 11 | 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, 12 | 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 13 | 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 14 | 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 15 | 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, 16 | 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 17 | 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, 18 | 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 19 | 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 20 | 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 21 | 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, 22 | 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 23 | 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, 24 | 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 25 | 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2 26 | }; 27 | 28 | void sha256_transf(sha256_ctx *ctx, const unsigned char *message, unsigned int block_nb) { 29 | uint32 w[64], wv[8], t1, t2; 30 | const unsigned char *sub_block; 31 | int i; 32 | #ifndef UNROLL_LOOPS 33 | int j; 34 | #endif 35 | for (i = 0; i < (int) block_nb; i++) { 36 | sub_block = message + (i << 6); 37 | #ifndef UNROLL_LOOPS 38 | for (j = 0; j < 16; j++) { 39 | PACK32(&sub_block[j << 2], &w[j]); 40 | } 41 | 42 | for (j = 16; j < 64; j++) { 43 | SHA256_SCR(j); 44 | } 45 | 46 | for (j = 0; j < 8; j++) { 47 | wv[j] = ctx->h[j]; 48 | } 49 | 50 | for (j = 0; j < 64; j++) { 51 | t1 = wv[7] + SHA256_F2(wv[4]) + CH(wv[4], wv[5], wv[6]) 52 | + sha256_k[j] + w[j]; 53 | t2 = SHA256_F1(wv[0]) + MAJ(wv[0], wv[1], wv[2]); 54 | wv[7] = wv[6]; 55 | wv[6] = wv[5]; 56 | wv[5] = wv[4]; 57 | wv[4] = wv[3] + t1; 58 | wv[3] = wv[2]; 59 | wv[2] = wv[1]; 60 | wv[1] = wv[0]; 61 | wv[0] = t1 + t2; 62 | } 63 | 64 | for (j = 0; j < 8; j++) { 65 | ctx->h[j] += wv[j]; 66 | } 67 | #else 68 | PACK32(&sub_block[ 0], &w[ 0]); 69 | PACK32(&sub_block[ 4], &w[ 1]); 70 | PACK32(&sub_block[ 8], &w[ 2]); 71 | PACK32(&sub_block[12], &w[ 3]); 72 | PACK32(&sub_block[16], &w[ 4]); 73 | PACK32(&sub_block[20], &w[ 5]); 74 | PACK32(&sub_block[24], &w[ 6]); 75 | PACK32(&sub_block[28], &w[ 7]); 76 | PACK32(&sub_block[32], &w[ 8]); 77 | PACK32(&sub_block[36], &w[ 9]); 78 | PACK32(&sub_block[40], &w[10]); 79 | PACK32(&sub_block[44], &w[11]); 80 | PACK32(&sub_block[48], &w[12]); 81 | PACK32(&sub_block[52], &w[13]); 82 | PACK32(&sub_block[56], &w[14]); 83 | PACK32(&sub_block[60], &w[15]); 84 | SHA256_SCR(16); 85 | SHA256_SCR(17); 86 | SHA256_SCR(18); 87 | SHA256_SCR(19); 88 | SHA256_SCR(20); 89 | SHA256_SCR(21); 90 | SHA256_SCR(22); 91 | SHA256_SCR(23); 92 | SHA256_SCR(24); 93 | SHA256_SCR(25); 94 | SHA256_SCR(26); 95 | SHA256_SCR(27); 96 | SHA256_SCR(28); 97 | SHA256_SCR(29); 98 | SHA256_SCR(30); 99 | SHA256_SCR(31); 100 | SHA256_SCR(32); 101 | SHA256_SCR(33); 102 | SHA256_SCR(34); 103 | SHA256_SCR(35); 104 | SHA256_SCR(36); 105 | SHA256_SCR(37); 106 | SHA256_SCR(38); 107 | SHA256_SCR(39); 108 | SHA256_SCR(40); 109 | SHA256_SCR(41); 110 | SHA256_SCR(42); 111 | SHA256_SCR(43); 112 | SHA256_SCR(44); 113 | SHA256_SCR(45); 114 | SHA256_SCR(46); 115 | SHA256_SCR(47); 116 | SHA256_SCR(48); 117 | SHA256_SCR(49); 118 | SHA256_SCR(50); 119 | SHA256_SCR(51); 120 | SHA256_SCR(52); 121 | SHA256_SCR(53); 122 | SHA256_SCR(54); 123 | SHA256_SCR(55); 124 | SHA256_SCR(56); 125 | SHA256_SCR(57); 126 | SHA256_SCR(58); 127 | SHA256_SCR(59); 128 | SHA256_SCR(60); 129 | SHA256_SCR(61); 130 | SHA256_SCR(62); 131 | SHA256_SCR(63); 132 | wv[0] = ctx->h[0]; 133 | wv[1] = ctx->h[1]; 134 | wv[2] = ctx->h[2]; 135 | wv[3] = ctx->h[3]; 136 | wv[4] = ctx->h[4]; 137 | wv[5] = ctx->h[5]; 138 | wv[6] = ctx->h[6]; 139 | wv[7] = ctx->h[7]; 140 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 0); 141 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 1); 142 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 2); 143 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 3); 144 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 4); 145 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 5); 146 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 6); 147 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 7); 148 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 8); 149 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 9); 150 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 10); 151 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 11); 152 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 12); 153 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 13); 154 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 14); 155 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 15); 156 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 16); 157 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 17); 158 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 18); 159 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 19); 160 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 20); 161 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 21); 162 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 22); 163 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 23); 164 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 24); 165 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 25); 166 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 26); 167 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 27); 168 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 28); 169 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 29); 170 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 30); 171 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 31); 172 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 32); 173 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 33); 174 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 34); 175 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 35); 176 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 36); 177 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 37); 178 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 38); 179 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 39); 180 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 40); 181 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 41); 182 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 42); 183 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 43); 184 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 44); 185 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 45); 186 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 46); 187 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 47); 188 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 48); 189 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 49); 190 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 50); 191 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 51); 192 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 52); 193 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 53); 194 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 54); 195 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 55); 196 | SHA256_EXP(0, 1, 2, 3, 4, 5, 6, 7, 56); 197 | SHA256_EXP(7, 0, 1, 2, 3, 4, 5, 6, 57); 198 | SHA256_EXP(6, 7, 0, 1, 2, 3, 4, 5, 58); 199 | SHA256_EXP(5, 6, 7, 0, 1, 2, 3, 4, 59); 200 | SHA256_EXP(4, 5, 6, 7, 0, 1, 2, 3, 60); 201 | SHA256_EXP(3, 4, 5, 6, 7, 0, 1, 2, 61); 202 | SHA256_EXP(2, 3, 4, 5, 6, 7, 0, 1, 62); 203 | SHA256_EXP(1, 2, 3, 4, 5, 6, 7, 0, 63); 204 | ctx->h[0] += wv[0]; 205 | ctx->h[1] += wv[1]; 206 | ctx->h[2] += wv[2]; 207 | ctx->h[3] += wv[3]; 208 | ctx->h[4] += wv[4]; 209 | ctx->h[5] += wv[5]; 210 | ctx->h[6] += wv[6]; 211 | ctx->h[7] += wv[7]; 212 | #endif 213 | } 214 | } 215 | 216 | void sha256_init(sha256_ctx *ctx) { 217 | #ifndef UNROLL_LOOPS 218 | for (int i = 0; i < 8; i++) { 219 | ctx->h[i] = sha256_h0[i]; 220 | } 221 | #else 222 | ctx->h[0] = sha256_h0[0]; 223 | ctx->h[1] = sha256_h0[1]; 224 | ctx->h[2] = sha256_h0[2]; 225 | ctx->h[3] = sha256_h0[3]; 226 | ctx->h[4] = sha256_h0[4]; 227 | ctx->h[5] = sha256_h0[5]; 228 | ctx->h[6] = sha256_h0[6]; 229 | ctx->h[7] = sha256_h0[7]; 230 | #endif 231 | ctx->len = 0; 232 | ctx->tot_len = 0; 233 | } 234 | 235 | void sha256_update(sha256_ctx *ctx, const unsigned char *message, unsigned int len) { 236 | unsigned int block_nb; 237 | unsigned int new_len, rem_len, tmp_len; 238 | const unsigned char *shifted_message; 239 | 240 | tmp_len = SHA256_BLOCK_SIZE - ctx->len; 241 | rem_len = len < tmp_len ? len : tmp_len; 242 | memcpy(&ctx->block[ctx->len], message, rem_len); 243 | 244 | if (ctx->len + len < SHA256_BLOCK_SIZE) { 245 | ctx->len += len; 246 | return; 247 | } 248 | 249 | new_len = len - rem_len; 250 | block_nb = new_len / SHA256_BLOCK_SIZE; 251 | shifted_message = message + rem_len; 252 | sha256_transf(ctx, ctx->block, 1); 253 | sha256_transf(ctx, shifted_message, block_nb); 254 | rem_len = new_len % SHA256_BLOCK_SIZE; 255 | memcpy(ctx->block, &shifted_message[block_nb << 6], rem_len); 256 | ctx->len = rem_len; 257 | ctx->tot_len += (block_nb + 1) << 6; 258 | } 259 | 260 | void sha256_final(sha256_ctx *ctx, unsigned char *digest) { 261 | unsigned int block_nb; 262 | unsigned int pm_len; 263 | unsigned int len_b; 264 | #ifndef UNROLL_LOOPS 265 | int i; 266 | #endif 267 | block_nb = (1 + ((SHA256_BLOCK_SIZE - 9) < (ctx->len % SHA256_BLOCK_SIZE))); 268 | len_b = (ctx->tot_len + ctx->len) << 3; 269 | pm_len = block_nb << 6; 270 | memset(ctx->block + ctx->len, 0, pm_len - ctx->len); 271 | ctx->block[ctx->len] = 0x80; 272 | UNPACK32(len_b, ctx->block + pm_len - 4); 273 | sha256_transf(ctx, ctx->block, block_nb); 274 | #ifndef UNROLL_LOOPS 275 | for (i = 0; i < 8; i++) { 276 | UNPACK32(ctx->h[i], &digest[i << 2]); 277 | } 278 | #else 279 | UNPACK32(ctx->h[0], &digest[ 0]); 280 | UNPACK32(ctx->h[1], &digest[ 4]); 281 | UNPACK32(ctx->h[2], &digest[ 8]); 282 | UNPACK32(ctx->h[3], &digest[12]); 283 | UNPACK32(ctx->h[4], &digest[16]); 284 | UNPACK32(ctx->h[5], &digest[20]); 285 | UNPACK32(ctx->h[6], &digest[24]); 286 | UNPACK32(ctx->h[7], &digest[28]); 287 | #endif 288 | } 289 | -------------------------------------------------------------------------------- /src/transform.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | #include 4 | #include 5 | #include 6 | 7 | using namespace std; 8 | 9 | Transform::Transform() { 10 | reply = ""; 11 | db.setDatabaseName(QDir::homePath() + "/.medusa/medusa.cache"); 12 | db.open(); 13 | python = new QProcess(this); 14 | } 15 | 16 | Transform::~Transform() { 17 | delete python; 18 | db.close(); 19 | } 20 | 21 | void Transform::readStandardOutput() { 22 | reply += python->readAllStandardOutput(); 23 | } 24 | 25 | void Transform::readStandardError() { 26 | reply += python->readAllStandardError(); 27 | } 28 | 29 | void Transform::pythonFinished(int exitCode, QProcess::ExitStatus) { 30 | this->exitCode = exitCode; 31 | QSqlQuery query(db); 32 | 33 | if (exitCode == 0) { 34 | query.prepare("UPDATE MedusaCache SET GenCode=? WHERE InFile=?"); 35 | query.addBindValue(reply); 36 | query.addBindValue(path); 37 | query.exec(); 38 | } else { 39 | query.exec("DELETE FROM MedusaCache WHERE InFile='" + path + "'"); 40 | cerr << "\x1b[31m" + reply.toStdString() + "\x1b[0m" << endl; 41 | } 42 | } 43 | 44 | void Transform::shitHappened(QProcess::ProcessError error) { 45 | if (error == QProcess::FailedToStart) { 46 | QSqlQuery query(db); 47 | query.exec("DELETE FROM MedusaCache WHERE InFile='" + path + "'"); 48 | cerr << "\x1b[31m[Medusa Error] Python not found in PATH. Make sure its installed and is accesible via PATH\x1b[0m" << endl; 49 | exitCode = -1; 50 | } 51 | } 52 | 53 | bool Transform::transform(QString path, QString &code) { 54 | QStringList args; 55 | 56 | if (!QFile(QDir::homePath() + "/.medusa/transform.py").exists()) { 57 | QSqlQuery query(db); 58 | query.exec("DELETE FROM MedusaCache WHERE InFile='" + path + "'"); 59 | cerr << "\x1b[31m[Medusa Error] What?! FPT Transformer not found. Please Reinstall.\x1b[0m" << endl; 60 | exit(-1); 61 | } 62 | 63 | args << QDir::homePath() + "/.medusa/transform.py" << path; 64 | this->path = path; 65 | 66 | connect(python, SIGNAL(finished(int, QProcess::ExitStatus)), this, SLOT(pythonFinished(int, QProcess::ExitStatus))); 67 | connect(python, SIGNAL(readyReadStandardError()), this, SLOT(readStandardError())); 68 | connect(python, SIGNAL(readyReadStandardOutput()), this, SLOT(readStandardOutput())); 69 | connect(python, SIGNAL(error(QProcess::ProcessError)), this, SLOT(shitHappened(QProcess::ProcessError))); 70 | 71 | python->start("python", args); 72 | python->waitForFinished(); 73 | code = reply; 74 | 75 | return exitCode ? false : true; 76 | } 77 | --------------------------------------------------------------------------------