Release 0.8.1-β

Minor release with mainly visual improvements.

Code
* Pins now align themselves automatically.
* Blocks are round and transparent.
* Connections are bèzier curves instead of straight line.
* Added direction indicators.
* Connections go behind the blocks.
* Backgrounds looks good in all sizes.

Documentation
* Added image with new visual aspect.
* Added directions for use.

Package
* Added minimum python version.

Author: AlvarBer

README.md

@@ -18,6 +18,10 @@ If you have pip (Python 3.5+) you can simply type
 
 `$> pip install persimmon`
 
+To execute use.
+
+`$> python -m persimmon`
+
 For windows self-contained executables can be found on the [releases page].
 
 

docs/images/final_aspect.png

@@ -5,7 +5,7 @@ On this chapter Persimmon is introduced, along its main objectives and
 motivations.
 It also includes a section about topics that are related but beyond the scope
 of this project.
-Finally, it includes an overviewof the project report structure.
+Finally, it includes an overview of the project report structure.
 
 
 Description

docs/src/introduction.md

@@ -216,11 +216,10 @@
 $endif$
 
 % Make sections great again
-\usepackage{titlesec}
-
-\titleformat*{\section}{\sffamily\LARGE\bfseries}
-\titleformat*{\subsection}{\sffamily\Large\bfseries}
-\titleformat*{\subsubsection}{\sffamily\large\bfseries}
+%\usepackage{titlesec}
+%\titleformat*{\section}{\sffamily\LARGE\bfseries}
+%\titleformat*{\subsection}{\sffamily\Large\bfseries}
+%\titleformat*{\subsubsection}{\sffamily\large\bfseries}
 
 % Better abstract
 \renewenvironment{abstract}{

docs/template.tex

@@ -1,33 +1,29 @@
 <Block>:
-    # Fixed options
-    size_hint: None, None
-    size: '200dp', '75dp'
-    drag_rectangle: self.x, self.y, self.width, self.height
-    drag_timeout: 10000000
-    drag_distance: 0
+	# Fixed options
+	size_hint: None, None
+	width: '200dp'
+	drag_rectangle: self.x, self.y, self.width, self.height
+	drag_timeout: 10000000
+	drag_distance: 0
+	label: label
 	canvas:
 		Color:
-			rgb: .2, .2, .2
-		Rectangle:
+			rgba: .15, .15, .15, .8
+		RoundedRectangle:
 			pos: self.pos
 			size: self.size
-	#canvas.before:
-		#Color:
-			#rgb: 1, 1, 1
-		#BorderImage:
-			#pos: self.x - 5, self.y - 5
-			#size: self.width + 10, self.height + 10
-			#source: 'tex2.png'
-    # Children
-    Label:
-        pos: root.x, root.y + root.height - 20
-        size_hint: None, None
-        height: '20dp'
+	# Children
+	Label:
+		id: label
+		pos: root.x, root.y + root.height - 20
+		size_hint: None, None
+		height: '20dp'
 		width: root.width
 		text: root.title
-        canvas.before:
-            Color:
-                rgb: root.block_color
-            Rectangle:
-                pos: self.pos
-                size: self.size
+		canvas.before:
+			Color:
+				rgba: [*root.block_color, 0.8]
+			RoundedRectangle:
+				pos: self.pos
+				size: self.size
+				radius: [(10, 10), (10, 10), (0, 0), (0, 0)]

persimmon/background.png

@@ -5,18 +5,20 @@
 from kivy.uix.behaviors import DragBehavior
 from kivy.properties import ListProperty, StringProperty, ObjectProperty
 from kivy.lang import Builder
-from kivy.graphics import BorderImage, Color
+from kivy.graphics import BorderImage, Color, RoundedRectangle
 from kivy.uix.image import Image
 # Types are fun
 from typing import Optional
 from abc import abstractmethod
+from functools import partial
 
 
 Builder.load_file('view/blocks/block.kv')
 
 class Block(DragBehavior, FloatLayout, metaclass=AbstractWidget):
     block_color = ListProperty([1, 1, 1])
     title = StringProperty()
+    label = ObjectProperty()
     inputs = ObjectProperty()
     outputs = ObjectProperty()
     input_pins = ListProperty()
@@ -26,18 +28,32 @@ class Block(DragBehavior, FloatLayout, metaclass=AbstractWidget):
 
     def __init__(self, **kwargs):
         super().__init__(**kwargs)
+
         if self.inputs:
             for pin in self.inputs.children:
                 self.input_pins.append(pin)
                 pin.block = self
+                self.gap = pin.width * 2
         if self.outputs:
             for pin in self.outputs.children:
                 self.output_pins.append(pin)
                 pin.block = self
+                self.gap = pin.width * 2
         self.tainted_msg = 'Block {} has unconnected inputs'.format(self.title)
         self._tainted = False
         self.kindled = None
         self.border_texture = Image(source='border.png').texture
+        # Make block taller if necessary
+        self.height = (max(len(self.output_pins), len(self.input_pins), 3) *
+                       self.gap + self.label.height)
+        # Position pins nicely
+        y_origin = self.y + (self.height - self.label.height)
+        for i, in_pin in enumerate(list(self.input_pins[::-1]), 1):
+            self._bind_pin(self, (in_pin.x, in_pin.y), in_pin, i, False)
+            self.fbind('pos', self._bind_pin, pin=in_pin, i=i, output=False)
+        for i, out_pin in enumerate(list(self.output_pins[::-1]), 1):
+            self._bind_pin(self, (out_pin.x, out_pin.y), out_pin, i, True)
+            self.fbind('pos', self._bind_pin, pin=out_pin, i=i, output=True)
 
     @property
     def tainted(self):
@@ -72,14 +88,14 @@ def function(self):
         raise NotImplementedError
 
     # Kivy touch events override
-    def on_touch_down(self, touch):
+    def on_touch_down(self, touch) -> bool:
         pin = self.in_pin(*touch.pos)
         if pin:  # if touch is on pin let them handle
             return pin.on_touch_down(touch)
         else:  # else default behavior (drag if collide)
             return super().on_touch_down(touch)
 
-    def on_touch_up(self, touch):
+    def on_touch_up(self, touch) -> bool:
         pin = self.in_pin(*touch.pos)
         if pin:
             result = pin.on_touch_up(touch)
@@ -91,9 +107,9 @@ def kindle(self):
         """ Praise the sun \[T]/ """
         with self.canvas.before:
             Color(1, 1, 1)
-            self.kindled = BorderImage(pos=(self.x - 5, self.y - 5),
-                                       size=(self.width + 10,
-                                             self.height + 10),
+            self.kindled = BorderImage(pos=(self.x - 2, self.y - 2),
+                                       size=(self.width + 4,
+                                             self.height + 4),
                                        texture=self.border_texture)
             self.fbind('pos', self._bind_border)
 
@@ -109,4 +125,14 @@ def unkindle(self):
     # Auxiliary functions
     def _bind_border(self, block, new_pos):
         """ Bind border to position. """
-        self.kindled.pos = new_pos[0] - 5, new_pos[1] - 5
+        self.kindled.pos = new_pos[0] - 2, new_pos[1] - 2
+
+    def _bind_pin(self, block, new_pos, pin, i, output):
+        """ Keep pins on their respective places. """
+        pin.y = (block.y + (block.height - block.label.height) - i * self.gap +
+                 pin.height / 2)
+        if output:
+            pin.x = block.x + block.width - self.gap
+        else:
+            pin.x = block.x + 5
+