.idea/aura.iml

+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="TestRunnerService">
+    <option name="PROJECT_TEST_RUNNER" value="Unittests" />
+  </component>
+</module>
\ No newline at end of file

.idea/dictionaries/gg.xml

+<component name="ProjectDictionaryState">
+  <dictionary name="gg" />
+</component>
\ No newline at end of file

.idea/inspectionProfiles/Project_Default.xml

+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="SpellCheckingInspection" enabled="false" level="TYPO" enabled_by_default="false">
+      <option name="processCode" value="true" />
+      <option name="processLiterals" value="true" />
+      <option name="processComments" value="true" />
+    </inspection_tool>
+  </profile>
+</component>
\ No newline at end of file

.idea/misc.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.5.3 (/usr/bin/python3.5)" project-jdk-type="Python SDK" />
+</project>
\ No newline at end of file

.idea/modules.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/aura.iml" filepath="$PROJECT_DIR$/.idea/aura.iml" />
+    </modules>
+  </component>
+</project>
\ No newline at end of file

.idea/preferred-vcs.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PreferredVcsStorage">
+    <preferredVcsName>ApexVCS</preferredVcsName>
+  </component>
+</project>
\ No newline at end of file

.idea/vcs.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file

README.md

+# AURA Engine
+
+This piece of Software is part of 'AURA - AUtomated RAdio'. 
+
+AURA Engine does:
+ * requesting the programme from an external Source
+ * switches the soundserver at the correct time to a given source for a specific show 
+ * records what is broadcasted
+
+## Installation
+
+### Software
+
+#### Operating System
+
+Any sound supporting linux system should work. It is tested and coded on a **debian stretch**
+
+#### Packages
+
+On a debian machine:
+
+```bash
+sudo apt install python3 python3-pip \ 
+    liquidsoap liquidsoap-plugin-alsa liquidsoap-plugin-ao liquidsoap-plugin-faad \ 
+    liquidsoap-plugin-flac liquidsoap-plugin-icecast liquidsoap-plugin-lame \
+    liquidsoap-plugin-mad liquidsoap-plugin-ogg liquidsoap-plugin-pulseaudio \
+    liquidsoap-plugin-samplerate liquidsoap-plugin-taglib liquidsoap-plugin-voaacenc \
+    liquidsoap-plugin-vorbis
+```
+
+#### Python Packages
+
+```
+sudo pip3 install Flask Flask-Babel flask-babel-utclocal-utils \
+    flask-mongoengine Flask-RESTful Flask-SQLAlchemy Flask-WTF \
+    mysqlclient redis simplejson
+```
+
+#### aura.py
+
+It is the server which is connected to the external programme source, to liquidsoap and is listening for redis pubsub messages.
+
+#### Guru
+
+The commandline tool for interacting with the server.
+
+#### Liquidsoap
+
+The heart of AURA Engine. It uses the built in mixer, to switch between different sources. A source can be a stream, the filesystem or linein 
+
+### Hardware
+
+#### Soundcard
+AURA Engine ist tested with an ASUS Xonar DGX. It should work with every by ALSA supported soundcard. PulseAudio support is planned.
+
+#### Hard/Soft
+When you use ALSA, you will have to play around with ALSA settings. In the folder ./modules/liquidsoap is a scipt called alsa_settings_tester.liq. You can start it with 'liquidsoap -v --debug alsa_settings_tester.liq'. Changing and playing with settings can help you to find correct ALSA settings. 
\ No newline at end of file

aura.py

+import signal
+import sys
+import threading
+
+from libraries.base.config import ConfigReader
+#from libraries.reporting.messenger import RedisListener
+from modules.controller.controller import AuraController
+#from modules.communication.zmq.zmqadapter import ServerZMQAdapter
+from modules.communication.redis.adapter import ServerRedisAdapter
+
+
+class Aura():
+    server = None
+    config = None
+    messenger = None
+    controller = None
+
+    # ------------------------------------------------------------------------------------------ #
+    def __init__(self):
+        self.config = ConfigReader()
+        self.config.loadConfig()
+
+        server = object
+
+        self.controller = AuraController(self.config, debug=False)
+        #self.server = ServerZMQAdapter(self.controller, self.config, debug=True)
+        #self.redislistener =
+
+        self.messenger = ServerRedisAdapter()
+        self.messenger.set_controller(self.controller)
+        self.messenger.set_config(self.config)
+
+        def receive_signal(signum, stack):
+            print("received signal")
+            server.reload()
+
+        signal.signal(signal.SIGUSR1, receive_signal)
+
+    def join_comm(self):
+        # start listener thread
+        self.messenger.start()
+
+# # ## ## ## ## ## # #
+# # ENTRY FUNCTION # #
+# # ## ## ## ## ## # #
+def main():
+    aura = Aura()
+    aura.join_comm()
+
+# # ## ## ## ## ## ## # #
+# # End ENTRY FUNCTION # #
+# # ## ## ## ## ## ## # #
+
+if __name__ == "__main__":
+    main()
\ No newline at end of file

configuration/aura.ini

+station_name="Radio FRO"
+station_logo="/etc/aura/stationlogo.jpg"
+station_fallback_pool="/var/audio/station_fallback_pool"
+
+#Change this settings
+daemongroup="gg"
+daemonuser="gg"
+
+scheduler_config_file="/etc/aura/scheduler.xml"
+
+# SOUND CARD SETTINGS
+line_in_count=1
+line_out_count=1
+input_device[0]="hw:0" # make it comma separated!!
+output_device[0]="hw:0"
+
+# DATABASE SETTINGS
+db_user="aura"
+db_name="aura"
+db_pass="aura"
+db_host="localhost"
+
+# ALSA SETTINGS
+# if you have no idea what to do here => set use_alsa to "n", then pulseaudio is used
+use_alsa="y"
+# alsa_buffer => int
+alsa_buffer="16000"
+# alsa_buffer_length => int
+alsa_buffer_length="5"
+# alsa_periods => int
+alsa_periods="0"
+# frame_duration => double
+frame_duration="0.4"
+# frame_size => int
+frame_size=""
+
+socketdir="/home/gg/PycharmProjects/aura/modules/liquidsoap"
+logdir="/var/log/aura"
+
+# channelnames for mixing
+# leave this alone if you do not know what you are doing
+http_channels="http,http2"
+line_in_channels="live,live2"
+filesystem_channels="filesystem"
+
+
+adminmail="gogo@servus.at"
+playlistdir="/var/audio/playlists/"
+#calendarurl="http://localhost/index.php?option=com_jimtawl&view=calendar&format=json&from=#datefrom#&to=#dateto#"
+calendarurl="http://bermudafunk-kalender.critmass.de/index.php?option=com_jimtawl&view=calendar&format=json&from=#datefrom#&to=#dateto#"
+
+# how many days in future should the calendar be stored in database - default=7
+#calendar_precache_days=7
+
+audiobase="/var/audio/rec"
+altaudiobase="/var/audio/preprod"
+
+# hardware settings
+# SOUNDCARD FROM STWST:
+
+# HOME CARD
+# was player_input_device:
+# recinput="soundcard"
+# altrecinput="soundcard"
+# altrecorder_device="soundcard"
+# recorder_device="soundcard"
+
+# track_sensitive => fallback_folder track sensitivity
+# max_blank => maximum time of blank from source
+# min_noise => minimum duration of noise on source to switch back over
+# threshold => power in dB under which the stream is considered silent
+fallback_audio_folder="/var/audio/fallback/NightmaresOnWax/Smokers Delight"
+fallback_max_blank="5"
+fallback_min_noise="30"
+fallback_threshold="-40"
+
+stream="y"
+stream_type="harbor"
+#stream_type="icecast"
+stream_bitrate="128"
+stream_port="8000"
+stream_mountpoint="aura"
+stream_user="source"
+stream_password="eegah5Hi"
+stream_host="localhost"
+stream_url="http://www.fro.at"
+stream_name="Comba Test Stream"
+stream_genre="mixed"
+stream_description="Test Stream"
+stream_admin_user="admin"
+stream_admin_password="ahZ4caeg"
+
+# ZeroMessagingQueue SETTINGS
+communication="zmq"
+zmqhostip="127.0.0.1"
+zmqport="9099"
+loglevel="info"
+webservice_mode="apache"
+#servername=""
+#serviceport=""
+
+install_dir="/home/gg/PycharmProjects/aura"
+
+debug="y"

configuration/scheduler.xml

+<Config>
+  <Jobs multiple="true">
+    <job>
+      <time>00:00</time>
+      <until>23:00</until>
+      <job>play_playlist</job>
+      <params>no_stop</params>
+    </job>
+    <job>
+      <job>start_recording</job>
+      <until>00:00</until>
+      <day>all</day>
+      <time>00:00</time>
+      <params>no_stop</params>
+    </job>
+    <job>
+      <daysolder>4</daysolder>
+      <job>clean_cached</job>
+      <day>1</day>
+      <time>00:03</time>
+      <params></params>
+    </job>
+    <job>
+      <time>01:00</time>
+      <day>all</day>
+      <job>precache</job>
+      <params></params>
+    </job>
+  </Jobs>
+</Config>
+

errormessages/controller_error.js

+{
+	"allData":        {
+		  	    "id": "01",
+		  	    "00": "Global Metadata delivered",
+			     "01": "Could not get Data from Sound Engine"
+		          },
+	"channel_insert": {
+		   	    "id": "02",
+		   	    "00": "On Channel ::channel:: insert ::uri:: at position ::pos::",
+			     "02": "On Channel ::channel:: could not insert ::uri:: at position ::pos::"
+		          },
+	"channel_move":   {
+			     "id": "03",
+			     "00": "On Channel ::channel:: moved Item from ::fromPos:: to position ::toPos::",
+			     "01": "Warning: Position ::fromPos:: out of range",
+			     "02": "Warning: Cannot move to same position",
+			     "03": "On Channel ::channel:: could not move from position ::fromPos:: to  position ::toPos::"
+		          },
+	"channel_off":    {
+			     "id": "04",
+			     "00": "Channel ::channel:: off",
+			     "01": "Could not activate Channel ::channel::"
+		          },
+	"channel_on":     {
+                             "id": "05",
+			     "00": "Channel ::channel:: on",
+			     "01": "Could not deactivate Channel ::channel::"
+		          },
+	"channel_queue":  {
+			     "id": "06",
+			     "00": "Channel Queue for ::channel:: delivered",
+			     "01": "Could not get channel queue from channel ::channel::",
+			     "02": "Could not get channel queue from channel ::channel::",
+			     "03": "Could not get channel queue from channel ::channel::"
+		          },
+	"channel_remove": {
+			     "id": "07",
+			     "00": "Removed item on position ::pos:: from channel ::channel::",
+			     "01": "Could not remove item on position ::pos:: from channel ::channel::",
+			     "02": "Warning: position ::pos:: out of range'"
+		          },
+	"channel_seek":   {
+			     "id": "08",
+			     "00": "Seeked channel ::channel:: ::duration:: seconds",
+			     "01": "Could not seek channel ::channel:: ::duration:: seconds"
+		          },
+	"channel_skip":   {
+			     "id": "09",
+			     "00": "Skipped channel ::channel::",
+			     "01": "0 Channels listed",
+			     "02": "Could not get channels from sound engine",
+			     "03": "Could not skip ::channel::"
+		          },
+	"channel_volume": {
+			     "id": "10",
+			     "00": "Volume ::volume::% set on channel ::channel::",
+			     "01": "Could not set volume to ::volume::% on channel ::channel::",
+			     "02": "0 Channels listed",
+			     "03": "Could not get channels from sound engine"
+		          },
+	"currentData":    {
+			     "id": "11",
+			     "00": "Current track metadata delivered",
+			     "01": "Nothing seems to be on air",
+			     "02": "Could not detect metadata"
+		          },
+	"help":  {
+			     "id": "12",
+			     "00": "none",
+			     "01": "Could not open help file"
+		          },
+	"listChannels":   {
+			     "id": "13",
+			     "00": "Listed Channels",
+			     "01": "0 Channels listed",
+			     "02": "Could not get channels from sound engine"
+		          },
+	"message":        {
+			     "id": "14",
+			     "00": "none"
+		          },
+	"playlist_data":  {
+			     "id": "15",
+			     "00": "Playlist data delivered"
+
+		          },
+	"playlist_flush": {
+			     "id": "16",
+			     "00": "Flushed playlist",
+			     "01": "Could not flush playlist"
+		          },
+	"playlist_insert":{
+			     "id": "17",
+			     "00": "Insert track ::uri:: on position ::pos::"
+		          },
+	"playlist_load":  {
+			     "id": "18",
+			     "00": "Load Playlist ::uri::",
+			     "01": "Could not load Playlist ::uri::",
+                 "02": "Playlist is not well formed XML"
+		          },
+	"playlist_move":  {
+			     "id": "19",
+			     "00": "Moved playlist track from position ::fromPos:: to ::toPos::"
+		          },
+	"playlist_pause": {
+			     "id": "20",
+			     "00": "Playlist paused",
+			     "01": "Playlist already paused"
+		          },
+	"playlist_stop": {
+			     "id": "21",
+			     "00": "Playlist stopped",
+			     "01": "Playlist already stopped"
+		          },
+	"playlist_play":  {
+			     "id": "22",
+			     "00": "Playlist started",
+			     "01": "Playlist already playing",
+			     "02": "0 Channels listed",
+			     "03": "Could not get channels from sound engine"
+		          },
+	"playlist_push":  {
+			     "id": "23",
+			     "00": "Playlist: pushed ::uri::",
+			     "01": "Could not push ::uri::"
+		          },
+	"playlist_remove":{
+			     "id": "24",
+			     "00": "Removed track on position ::pos:: from playlist",
+			     "01": "Could not remove track on position ::pos:: from playlist"
+		          },
+	"playlist_seek":  {
+			     "id": "25",
+			     "00": "Seeked playlist ::duration:: seconds",
+			     "01": "Could not seek playlist ::duration:: seconds"
+		          },
+	"playlist_skip":  {
+			     "id": "26",
+			     "00": "Skipped playlist",
+			     "00": "Could not skip playlist"
+		          },
+	"recorder_data":  {
+			     "id": "27",
+			     "00": "Delivered recorder data",
+			     "01": "Could not deliver recorder data"
+		          },
+	"recorder_start": {
+			     "id": "28",
+			     "00": "Recorder started",
+			     "01": "Could not start recorder"
+		          },
+	"recorder_stop":  {
+			     "id": "29",
+			     "00": "Recorder stopped",
+			     "01": "Could not stop recorder"
+		          },
+	"scheduler_reload":  {
+			     "id": "30",
+			     "00": "Reload signal was sent to scheduler",
+			     "01": "Could not find the scheduler process"
+		          },
+	"sendLqcCommand":  {
+			     "id": "31",
+			     "01": "Soundengine not running",
+			     "02": "Recorder not running"
+		          },
+	"get_channel_state" : {
+				 "id": "32",
+			     "00": "Channels ::channel:: state",
+			     "01": "Could not get channel state from channel ::channel::"
+				  },
+	"setPassword":  {
+			     "id": "33",
+			     "00": "Successfull set password",
+			     "01": "Not enough access rights for this operation"
+		          },
+	"addUser":  {
+			     "id": "34",
+			     "00": "Successfull add user ::username::",
+			     "01": "Not enough access rights for this operation"
+		          },
+	"delUser":  {
+			     "id": "35",
+			     "00": "Successfull removed user ::username::",
+			     "01": "Not enough access rights for this operation"
+		          },
+	"scheduler_data":  {
+			     "id": "36",
+			     "00": "Successfull delivered scheduler config",
+			     "01": "Scheduler config seems to be broken"
+		          },
+	"scheduler_store":  {
+			     "id": "37",
+			     "00": "Successfull stored scheduler config",
+			     "01": "Not enough access rights for this operation",
+			     "02": "Could not store a valid scheduler XML"
+	},
+	"getUserlist":  {
+        "id": "38",
+        "00": "Userlist was successfully delivered",
+        "01": "Not enough access rights for this operation"
+    },
+    "get_act_programme": {
+        "id": "39",
+        "00": "Successfully fetched the program",
+        "01": "Cannot fetch actual program"
+    }
+}

errormessages/scheduler_error.js

+{
+	"exec_job":        {
+		  	    "id": "01",
+		  	     "00": "Execute job ::job::",
+			     "01": "Fatal: Could not execute job ::job::. Command ::exec:: results in Exception ::Exception::. Stopped watcher"
+
+		          },
+	"schedule_job":        {
+		  	    "id": "02",
+		  	     "00": "Scheduled job ::job:: for ::scheduled_for:: at ::scheduled_at::",
+			     "01": "Could not execute job"
+
+		          },
+	"load_playlist": {
+		   	    "id": "03",
+		   	    "00": "Load playlist ::uri::",
+			    "01": "Could not load playlist ::uri::. File does not exist!",
+			    "02": "Controller failed to load playlist ::uri::. Message was '::message::'"
+		          },
+	"play_playlist":   {
+			     "id": "04",
+			     "00": "Started playlist",
+			     "01": "Controller failed to start playlist. Message was '::message::'"
+		          },
+	"stop_playlist":    {
+			     "id": "05",
+			     "00": "Started playlist",
+			     "01": "Controller failed to start playlist. Message was '::message::'"
+			  },
+	"start_recording":     {
+                             "id": "06",
+   			     "00": "Started recording",
+			     "01": "Controller failed to start recording. Message was '::message::'"
+		          },
+	"stop_recording":  {
+			     "id": "07",
+   			     "00": "Stopped recording",
+			     "01": "Controller failed to stop recording. Message was '::message::'"		          },
+	"precache": {
+			     "id": "08",
+   			     "00": "Precached playlists",
+			     "01": "Could not precache playlist."
+		          },
+	"clean_cached":   {
+			     "id": "09",
+   			     "00": "Cleaned cache",
+			     "01": "Could not clean cache"
+		          },
+	"on_start":   {
+			     "id": "10",
+   			     "00": "Do initial jobs",
+			     "01": "Could not do initial jobs"
+		          },
+    "lookup_prearranged":   {
+			     "id": "11",
+   			     "00": "Lookup for prearranged tracks",
+			     "01": "No system channel available"
+		          },
+    "start_prearranged":   {
+			     "id": "12",
+   			     "00": "Started preaarranged tracks"
+		          },
+    "end_prearranged":   {
+			     "id": "13",
+   			     "00": "Stopped preaarranged tracks"
+		          }
+}
+

guru.py

+#!/usr/bin/python3
+import time
+import sys
+import redis
+
+from argparse import ArgumentParser
+
+# own libs
+from libraries.base.config import ConfigReader
+from modules.tools.padavan import Padavan
+from libraries.exceptions.auraexceptions import FallbackException
+
+
+class Guru:
+    config = ConfigReader()
+    config.loadConfig()
+
+    # ------------------------------------------------------------------------------------------ #
+    def __init__(self):
+        try:
+            parser = ArgumentParser()
+
+            # commands
+            parser.add_argument("-fnp", "--fetch-new-programmes", action="store_true", dest="fetch_new_programme",
+                                default=False, help="Fetch new programmes from calendarurl in comba.ini")
+
+            # options
+            parser.add_argument("-sep", "--stop-execution-time", action="store_true", dest="stoptime", default=False,
+                                help="Prints the execution time at the end of the skript")
+            parser.add_argument("-q", "--quiet", action="store_true", dest="quiet", default=False,
+                                help="Just the result will outputed to stout")
+
+            # getter
+            parser.add_argument("-gam", "--get-active-mixer", action="store_true", dest="get_active_mixer", default=False,
+                                help="Which mixer is activated?")
+            parser.add_argument("-pms", "--print-mixer-status", action="store_true", dest="get_mixer_status", default=False,
+                                help="Prints all mixer sources and their states")
+            parser.add_argument("-pap", "--print-act-programme", action="store_true", dest="get_act_programme", default=False,
+                                help="Prints the actual Programme, the controller holds")
+
+            # liquid manipulation
+            parser.add_argument("-am", "--select-mixer", action="store", dest="select_mixer", default=-1, metavar="MIXERNUM",
+                                help="Which mixer should be activated?", type=int)
+
+            parser.add_argument("-dm", "--de-select-mixer", action="store", dest="deselect_mixer", default=-1, metavar="MIXERNUM",
+                                help="Which mixer should be activated?", type=int)
+
+            parser.add_argument("-vm", "--volume", action="store", dest="set_volume", default=0, metavar=("MIXERNUM","VOLUME"), nargs=2,
+                                help="Set volume of a mixer source", type=int)
+
+            #parser.add_argument("-as", "--add-source", action="store", dest="add_source", default=False,
+            #                    help="Add new source to LiquidSoap mixer [Experimental]")
+
+            # playlist manipulation
+            parser.add_argument("-mpe", "--move-playlist-entry", action="store", dest="move_playlist_entry", default=0, metavar=("FROM", "TO"), nargs=2,
+                                help="Move Playlistentry FROM index TO another index")
+            parser.add_argument("-dpe", "--delete-playlist-entry", action="store", dest="delete_playlist_entry", default=0, metavar=("INDEX"),
+                                help="Delete Playlistentry at INDEX")
+            parser.add_argument("-ape", "--add-playlist-entry", action="store", dest="add_playlist_entry", default=0, metavar=("INDEX", "FROMTIME", "SOURCE"), nargs=3,
+                                help="Add a new Playlistentry at a given index", type=valid_playlist_entry)
+            parser.add_argument("-pmq", "--print-message-queue", action="store_true", dest="print_message_queue", default=False,
+                                help="Prints message queue")
+
+            # send a redis message
+            parser.add_argument("-rm", "--redis-message", action="store", dest="redis_message", default=False, metavar=("CHANNEL", "MESSAGE"), nargs=2,
+                                help="Send a redis message to the Listeners")
+
+            # calls from liquidsoap
+            parser.add_argument("-gnf", "--get-next-fallback-file-for", action="store", dest="get_fallback_for", default=False, metavar="FALLBACKTYPE",
+                                help="For which type you wanna GET a next audio file?")
+            parser.add_argument("-snf", "--set-next-fallback-file-for", action="store", dest="set_fallback_for", default=False, metavar=("FALLBACKTYPE", "FILE"), nargs=2,
+                                help="For which type you wanna SET a next audio file?")
+            parser.add_argument("-ip", "--init-player", action="store_true", dest="init_player", default=False,
+                                help="Reset liquidsoap volume and mixer activations?")
+
+            args = parser.parse_args()
+
+            if len(sys.argv) == 1:
+                raise ValueError("No Argument passed!")
+
+        except ValueError as e:
+            parser.print_help()
+            print()
+            print(e)
+            exit(1)
+        except TypeError as e:
+            parser.print_help()
+            print()
+            print(e)
+            exit(2)
+
+        if args.stoptime:
+            start = time.time()
+
+        if not args.quiet:
+            print("Guru thinking...")
+        try:
+            p = Padavan(args, self.config)
+            p.meditate()
+        except FallbackException as fe:
+            print(fe)
+            exit(4)
+        except redis.exceptions.TimeoutError as te:
+            print(te)
+            print("Timeout when waiting for redis message. Is AURA daemon running? Exiting...")
+            exit(3)
+
+        if not args.quiet:
+            print("...result: ")
+
+        if p.stringreply != "":
+            if p.stringreply[len(p.stringreply)-1] == "\n":
+                print(p.stringreply[0:len(p.stringreply) - 1])
+            else:
+                print(p.stringreply[0:len(p.stringreply)])
+
+        if args.stoptime:
+            end = time.time()
+            exectime = end-start
+            print("execution time: "+str(exectime)+"s")
+
+
+def valid_playlist_entry(argument):
+    import datetime
+    import argparse
+
+    try:
+        index = int(argument[0])
+        fromtime = datetime.strptime(argument[1], "%Y-%m-%d")
+        source = argument[2]
+        return index, fromtime, source
+    except:
+        msg = "Not a valid date: '{0}'.".format(argument[0])
+        raise argparse.ArgumentTypeError(msg)
+
+
+# # ## ## ## ## ## # #
+# # ENTRY FUNCTION # #
+# # ## ## ## ## ## # #
+def main():
+    Guru()
+# # ## ## ## ## ## ## # #
+# # End ENTRY FUNCTION # #
+# # ## ## ## ## ## ## # #
+
+
+if __name__ == "__main__":
+    main()