preparing for release 0.1.2

HISTORY.rst

@@ -2,6 +2,23 @@
 History
 =======
 
+
+0.1.2 (2019-07-08)
+------------------
+
+* Allow .send to a list of receivers.
+* Allow to receive messages with lists of lists.
+
+0.1.1 (2019-06-18)
+------------------
+
+* Moved from pyson to python-agentspeak
+* Added some helpers like pause_bdi, resume_bdi. 
+* Now the asl file in the constructor is mandatory.
+* Allow to send tell messages with no args.
+* Allow sending messages with variables.
+* Extended the examples.
+
 0.1.0 (2019-03-09)
 ------------------
 

README.rst

@@ -24,13 +24,58 @@ Implement BDI Agents based on the SPADE MAS Platform
 
 
 * Free software: GNU General Public License v3
-* Documentation: https://spade-bdi.readthedocs.io.
+* Documentation: https://spade-bdi.readthedocs.io. (to be done)
 
 
 Features
 --------
 
-* TODO
+* Create agents that parse and execute an ASL file written in AgentSpeak.
+
+Examples
+--------
+
+basic.py::
+	import argparse
+    from spade_bdi.bdi import BDIAgent
+
+    parser = argparse.ArgumentParser(description='spade bdi master-server example')
+    parser.add_argument('--server', type=str, default="localhost", help='XMPP server address.')
+    parser.add_argument('--password', type=str, default="bdipassword", help='XMPP password for the agents.')
+    args = parser.parse_args()
+
+    a = BDIAgent("BasicAgent@" + args.server, args.password, "basic.asl")
+    a.start()
+
+    a.bdi.set_belief("car", "blue", "big")
+    a.bdi.print_beliefs()
+
+    print(a.bdi.get_belief("car"))
+    a.bdi.print_beliefs()
+    
+    a.bdi.remove_belief("car", 'blue', "big")
+    a.bdi.print_beliefs()
+    
+    print(a.bdi.get_beliefs())
+    a.bdi.set_belief("car", 'yellow')
+
+
+basic.asl::
+
+    !start.
+
+    +!start <-
+        +car(red);
+        .a_function(3,W);
+        .print("w =", W);
+        literal_function(red,Y);
+        .print("Y =", Y);
+        .custom_action(8);
+        +truck(blue).
+
+    +car(Color) 
+     <- .print("The car is ",Color).
+
 
 Credits
 -------