====== Creating a simple BPQ Application ======
This tutorial shows you how to set up a simple python script [[https://www.cantab.net/users/john.wiseman/Documents/LinBPQ%20Applications%20Interface.html|connected to linbpq as a telnet application]].

===== Writing the program =====
I chose to write this in Python to be a //little// more clear than the Perl application provided in the link above.

This program, called ''ROLL'' uses a file called ''messages.json'' to provide it a welcome message and the blocks of text.  

I saved both of these to ''~/.local/bpq-apps/roll''

==== Program Code ====
This program was adapted from the [[https://pypi.org/project/telnetlib3/|example for the ''telnetlib3'' Python module]]

<code>
import asyncio, telnetlib3, json
from optparse import OptionParser

parser = OptionParser()
parser.add_option("-f", "--file", dest="filename", help="which json file with message and welcome", metavar="FILE")
parser.add_option("-p", "--port", dest="port", help="on which port?", metavar="PORT")
(options, args) = parser.parse_args()

messages = json.load(open(options.filename,'r'))

async def shell(reader, writer):
    incall = await reader.readline()
    print("%s connected" % incall)
    writer.write("\r\nWelcome %s" % incall)
    writer.write("\r\n%s" % messages["welcome"])
    textblocks = messages["text"].copy()
    inp = await reader.readline()
    leave = inp[0].upper() in ["Q", "B"]
    while inp and not leave and len(textblocks) > 0:
        print("writing next block")
        writer.write(textblocks.pop())
        await writer.drain()
        inp = await reader.readline()
        leave = inp[0].upper() in ["Q", "B"]
    writer.close()

loop = asyncio.get_event_loop()
coro = telnetlib3.create_server(port=options.port, shell=shell)
server = loop.run_until_complete(coro)
loop.run_until_complete(server.wait_closed())

</code>

==== ''messages.json'' file ====
<code>
{
	"welcome": "We're no strangers to love\r\nYou know the rules and so do I (Do I)\r\nA full commitment's what I'm thinking of\r\nYou wouldn't get this from any other guy\r\nI just wanna tell you how I'm feeling\r\nGotta make you understand\r\n",
	"text": ["Never gonna give you up\r\nNever gonna let you down\r\nNever gonna run around and desert you\r\nNever gonna make you cry\r\nNever gonna say goodbye\r\nNever gonna tell a lie and hurt you\r\n",
		 "\r\nWe've known each other for so long\r\nYour heart's been aching, but you're too shy to say it (To say it)\r\nInside, we both know what's been going on (Going on)\r\nWe know the game, and we're gonna play it\r\n\r\nAnd if you ask me how I'm feeling\r\nDon't tell me you're too blind to see\r\n",
		 "\r\nNever gonna give you up\r\nNever gonna let you down\r\nNever gonna run around and desert you\r\nNever gonna make you cry\r\nNever gonna say goodbye\r\nNever gonna tell a lie and hurt you\r\n",
		 "\r\nNever gonna give you up\r\nNever gonna let you down\r\nNever gonna run around and desert you\r\nNever gonna make you cry\r\nNever gonna say goodbye\r\nNever gonna tell a lie and hurt you\r\n",
		 "\r\nOoh (Give you up)\r\nOoh-ooh (Give you up)\r\nOoh-ooh\r\nNever gonna give, never gonna give (Give you up)\r\nOoh-ooh\r\nNever gonna give, never gonna give (Give you up)\r\n\r\nWe've known each other for so long\r\nYour heart's been aching, but you're too shy to say it (To say it)\r\n",
		 "\r\nInside, we both know what's been going on (Going on)\r\nWe know the game, and we're gonna play it\r\n\r\nI just wanna tell you how I'm feeling\r\nGotta make you understand\r\n",
		 "\r\nNever gonna give you up\r\nNever gonna let you down\r\nNever gonna run around and desert you\r\nNever gonna make you cry\r\nNever gonna say goodbye\r\nNever gonna tell a lie and hurt you\r\n",
		 "\r\nNever gonna give you up\r\nNever gonna let you down\r\nNever gonna run around and desert you\r\nNever gonna make you cry\r\nNever gonna say goodbye\r\nNever gonna tell a lie and hurt you\r\n",
		 "\r\nNever gonna give you up\r\nNever gonna let you down\r\nNever gonna run around and desert you\r\nNever gonna make you cry\r\nNever gonna say goodbye\r\nNever gonna tell a lie and hurt you\r\n"
	]
}

</code>

===== BPQ configuration =====
In my ''bpq32.cfg'' file, I added the port number to the telnet port, where the fourth entry, ''10001'' is the port for my new application:
<code>
CMDPORT=8005 63001 4565 10001
</code>
and in the application list, I added a new entry, where ''3'' is the 0th-indexed 4th entry above.
<code>
APPLICATION 4,ROLL,C 1 HOST 3 S
</code>

===== Configuring this as a service =====
Next we'll configure a ''systemd'' service to make sure this script is always running and ready to accept connections.
//todo write block describing adding a service to run this script//