TruxtonEvent - Revision history

Sam: /* Sample */

2024-01-27T19:08:43Z

Sample

Sam: /* Sample */

2023-05-03T08:21:39Z

Sample

Sam at 22:17, 2 May 2023

2023-05-02T22:17:15Z

Sam at 11:24, 7 November 2022

2022-11-07T11:24:44Z

Sam at 11:16, 1 October 2022

2022-10-01T11:16:10Z

Sam at 20:58, 16 September 2022

2022-09-16T20:58:20Z

Sam at 10:13, 29 July 2022

2022-07-29T10:13:00Z

Sam: /* save() */

2021-03-05T14:50:43Z

save()

Sam: /* Sample */

2021-02-09T14:48:55Z

Sample

Sam at 11:32, 8 December 2020

2020-12-08T11:32:58Z

@@ Line 140: / Line 140: @@
 if __name__ == "__main__":
-   main()
+   sys.exit(main())
 </source>

@@ Line 55: / Line 55: @@
 =Sample=
-<source lang="Python" highlight="34-40">
+<source lang="Python" highlight="28-34">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')
@@ Line 64: / Line 64: @@
 from calendar import timegm
 from pathlib import Path
 EVENT_TYPE_FBI = 20001
 def create_event_type(t, id, name):
@@ Line 90: / Line 84: @@
 def add_event(parent_file, start, end, title, description, type):
    event = parent_file.newevent()
-   event.start = date_to_filetime(datetime.fromisoformat(start))
+   event.start = datetime.fromisoformat(start)
-   event.end = date_to_filetime(datetime.fromisoformat(end))
+   event.end = datetime.fromisoformat(end)
    event.title = title
    event.description = description
@@ Line 126: / Line 120: @@
    url.method = truxton.URL_METHOD_TYPE_CLICKED_ON_A_LINK
    url.format = truxton.URL_FORMAT_ASCII
-   url.when = date_to_filetime(datetime.fromisoformat("2020-05-20T00:00:00-05:00"))
+   url.when = datetime.fromisoformat("2020-05-20T00:00:00-05:00")
    url.save()

@@ Line 17: / Line 17: @@
 This corresponds to the <code>[Description]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
-==<code>end: int</code>==
+==<code>end: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-When the event ended in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+When the event ended.
 This corresponds to the <code>[End]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
@@ Line 33: / Line 34: @@
 It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3.10/library/constants.html#False False] if there was an error.
-==<code>start: int</code>==
+==<code>start: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-When the event began in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+When the event began.
 This corresponds to the <code>[Start]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.

@@ Line 32: / Line 32: @@
 This will commit the information to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3.10/library/constants.html#False False] if there was an error.
 ==<code>tag(tag: str, reason: str, origin: int) -> boolean</code>==
@@ Line 40: / Line 44: @@
 It will return
 [https://docs.python.org/3.10/library/constants.html?highlight=false#True True] if the tag was associated with the file, [https://docs.python.org/3.10/library/constants.html?highlight=false#False False] on failure.
 ==<code>title: str</code>==

@@ Line 1: / Line 1: @@
 This class lets you add to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table in Truxton.
 =Attributes and Methods=
 ==<code>id: str</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the event.
@@ Line 24: / Line 31: @@
 ==<code>save() -> boolean</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
-It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
+It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3.10/library/constants.html#False False] if there was an error.
 ==<code>tag(tag: str, reason: str, origin: int) -> boolean</code>==
@@ Line 32: / Line 39: @@
 The <code>origin</code> is either <code>TAG_ORIGIN_AUTOMATIC</code> (1) or <code>TAG_ORIGIN_HUMAN</code> (2).
 It will return
-[https://docs.python.org/3.8/library/constants.html?highlight=false#True True] if the tag was associated with the file, [https://docs.python.org/3.8/library/constants.html?highlight=false#False False] on failure.
+[https://docs.python.org/3.10/library/constants.html?highlight=false#True True] if the tag was associated with the file, [https://docs.python.org/3.10/library/constants.html?highlight=false#False False] on failure.
 ==<code>start: int</code>==

@@ Line 22: / Line 22: @@
 This identifier corresponds to the <code>[MediaID]</code> of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
-==<code>save() -> bool</code>==
+==<code>save() -> boolean</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
-==<code>tag(tag: str, reason: str, origin: int) -> bool</code>==
+==<code>tag(tag: str, reason: str, origin: int) -> boolean</code>==
 This creates a tag associated with this event in Truxton.
 The <code>tag</code> parameter is a short, one or two word, bit of text that will be displayed in the UI.

@@ Line 24: / Line 24: @@
 ==<code>save()</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>tag(tag, reason, origin)</code>==

@@ Line 45: / Line 45: @@
 =Sample=
-<source lang="Python" highlight="32-38">
+<source lang="Python" highlight="34-40">
 import truxton
 import shutil

@@ Line 1: / Line 1: @@
-This class lets you add to the Event table in Truxton.
+This class lets you add to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table in Truxton.
 =Attributes and Methods=
 ==<code>id</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the event.
 It becomes non-zero after <code>save()</code> has been called.
 ==<code>description</code>==
 The longer description of the event.
 ==<code>end</code>==
 When the event ended in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-This corresponds to the <code>End</code> column of the <code>Event</code> table.
+This corresponds to the <code>[End]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>fileid</code>==
 The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file this event came from.
-This corresponds to the <code>FileID</code> column of the <code>Event</code> table.
+This corresponds to the <code>[FileID]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>mediaid</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this event came from.
-This identifier corresponds to the <code>MediaID</code> of the <code>Event</code> table.
+This identifier corresponds to the <code>[MediaID]</code> of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>save()</code>==
-This will commit the information to the <code>Event</code> table.
+This will commit the information to the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>tag(tag, reason, origin)</code>==
 This creates a tag associated with this event in Truxton.
 The <code>tag</code> parameter is a short, one or two word, bit of text that will be displayed in the UI.
-The <code>reason</code> a sentence explaining why this event was tagged.
+The <code>reason</code> is a sentence explaining why this event was tagged.
 The <code>origin</code> is either <code>TAG_ORIGIN_AUTOMATIC</code> (1) or <code>TAG_ORIGIN_HUMAN</code> (2).
 It will return
@@ Line 33: / Line 35: @@
 ==<code>start</code>==
 When the event began in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-This corresponds to the <code>Start</code> column of the <code>Event</code> table.
+This corresponds to the <code>[Start]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>title</code>==
-This corresponds to the <code>Title</code> column of the <code>Event</code> table.
+This corresponds to the <code>[Title]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
 ==<code>type</code>==
-This corresponds to the <code>EventTypeID</code> column of the <code>Event</code> table.
+This corresponds to the <code>[EventTypeID]</code> column of the <code><nowiki>[</nowiki>[[Event Table|Event]]<nowiki>]</nowiki></code> table.
-It should contain a value from the <code>ID</code> column of the <code>EventType</code> table.
+It should contain a value from the <code>[ID]</code> column of the <code>[EventType]</code> table.
 =Sample=
+<source lang="Python" highlight="32-38">
 import truxton
 import shutil
@@ Line 134: / Line 135: @@
 if __name__ == "__main__":
    main()
-</syntaxhighlight>
+</source>