Merge branch '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
 -------

setup.cfg

 [bumpversion]
-current_version = 0.1.1
+current_version = 0.1.2
 commit = True
 tag = False
 

setup.py

@@ -48,6 +48,6 @@ setup(
     test_suite='tests',
     tests_require=test_requirements,
     url='https://github.com/sfp932705/spade_bdi',
-    version='0.1.1',
+    version='0.1.2',
     zip_safe=False,
 )

spade_bdi/__init__.py

@@ -5,6 +5,6 @@ from . import bdi
 
 __author__ = """Sergio Frayle Pérez"""
 __email__ = 'sfp932705@gmail.com'
-__version__ = '0.1.1'
+__version__ = '0.1.2'
 
 __all__ = ["bdi"]