Documents plugins

.flake8

@@ -0,0 +1,4 @@
+[flake8]
+ignore = E501
+exclude = .git,__pycache__,docs/conf.py,old,build,dist
+

docs/index.rst

@@ -58,6 +58,7 @@ Advanced
    MultiCurrencyTrade
    Quote
    spatial
+   plugins
 
 Graphical User Interface and Results
 ====================================

docs/plugins.rst

@@ -0,0 +1,35 @@
+Plugins
+=======
+
+ABCE has one plugin so far. The ABCESL accounting framework. If
+you want to author your own plugin - its dead simple. All you
+have to do is write a class that inherits from Agent in agent.py.
+This class can overwrite::
+
+    def init(self, parameter, agent_parameter)
+    def _begin_subround(self):
+    def _end_subround(self):
+    def _advance_round(self, time):
+
+For example like this::
+
+    class UselessAgent(abce.Agent):
+        def init(self, parameter, agent_parameter):
+            super().init()
+            print("Here i begin")
+
+        def _begin_subround(self):
+            super()._begin_subround()
+            print('subround begins')
+            print("its %r o'clock" % self.time)
+
+        def _end_subround(self):
+            super()._end_subround()
+            print('subround finishes')
+
+        def _advance_round(self, time):
+            super()._advance_round(time)
+            print('Super I made it to the next round')
+
+        def ability(self):
+            print("the simulation called my ability")

setup.py

@@ -60,7 +60,7 @@ def build_extension(self, ext):
                              'bokeh == 0.12.7']
 
 
-version = '0.8.2a1'
+version = '0.8.2a5'
 
 
 setup(name='abce',