Introduction of 'offline' parameter

Adds a boolean parameter to the createEvent() method which specifies whether the event was found by an offline (True) or online/low-latency search (False). Default is set to offline=False so that in the worst-case scenario, an offline event is marked as online, which is the same as the current behavior.

Note that this branch is based off of !15 (merged), so that should be merged first (hence why this is marked as WIP). Currently the changes shown below feature those changes as well. This requires a server code update as well, which is shown here: gracedb!4.

ligo/gracedb/test/test.py

@@ -316,6 +316,18 @@ class TestGracedb(unittest.TestCase):
         r = gracedb.writeFile(eventId, uploadFile)
         self.assertEqual(r.status, 201) # CREATED
 
+    def test_offline_param(self):
+        """
+        Tests whether offline parameter is transmitted to database
+        properly or not. Creates an event with offline=True and checks it;
+        also checks createdEvent, which uses offline=False.
+        """
+        self.assertEqual(createdEvent['offline'], offline)
+        r = gracedb.createEvent("Test", "gstlal", eventFile,
+            search="LowMass",offline=True)
+        temp = r.json()
+        self.assertEqual(temp['offline'], True)
+
     def test_logger(self):
         import logging
         import ligo.gracedb.rest
@@ -388,7 +400,7 @@ class TestGracedb(unittest.TestCase):
 
 if __name__ == "__main__":
 
-    global gracedb, testdatadir, createdEvent, eventId, labelName
+    global gracedb, testdatadir, createdEvent, eventId, labelName, offline
 
     # Hacky "global" fixture.
     # Do not want to create a million events
@@ -402,12 +414,13 @@ if __name__ == "__main__":
 
     gracedb = GraceDb(service)
     labelName = "DQV"
+    offline = False
     #gracedb = GraceDbBasic(service)
     print("Using service", service)
 
     eventFile = os.path.join(testdatadir, "cbc-lm.xml")
-    createdEvent = gracedb.createEvent(
-            "Test", "gstlal", eventFile, "LowMass").json()
+    createdEvent = gracedb.createEvent("Test", "gstlal", eventFile, 
+        "LowMass", offline=offline).json()
     eventId = createdEvent["graceid"]
 
     unittest.main()