TruxtonUrl - Revision history

Sam: /* Sample */

2024-01-27T19:14:49Z

Sample

Sam: /* Sample */

2023-05-03T08:44:57Z

Sample

Sam at 22:54, 2 May 2023

2023-05-02T22:54:34Z

Sam at 11:50, 1 October 2022

2022-10-01T11:50:23Z

Sam at 21:08, 16 September 2022

2022-09-16T21:08:51Z

Sam at 18:49, 1 August 2022

2022-08-01T18:49:42Z

Sam: /* Sample */

2021-02-09T14:55:51Z

Sample

Sam at 11:22, 8 December 2020

2020-12-08T11:22:19Z

Sam at 16:55, 28 May 2020

2020-05-28T16:55:36Z

Sam: /* tag(tag, reason, origin) */

2020-05-28T13:05:25Z

tag(tag, reason, origin)

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

@@ Line 73: / Line 73: @@
 =Sample=
-<source lang="Python" highlight="66-73">
+<source lang="Python" highlight="60-67">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')
@@ Line 82: / Line 82: @@
 from calendar import timegm
 from pathlib import Path
 EVENT_TYPE_FBI = 20001
 def create_event_type(t, id, name):
@@ Line 109: / Line 103: @@
 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 145: / Line 139: @@
    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 67: / Line 67: @@
 This corresponds to the <code>[URL]</code> column of the <code>[URL]</code> table.
-==<code>when: int</code>==
+==<code>when: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-When the URL was seen in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+When the URL was seen.
 This corresponds to the <code>[When]</code> column of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.

@@ Line 8: / Line 8: @@
 ==<code>accountoffset: int</code>==
 The offset into the parent file where the account was found.
 ==<code>fileid: str</code>==

@@ Line 38: / Line 38: @@
 It should be the offset of the first character in the URL.
-==<code>save() -> bool</code>==
+==<code>save() -> boolean</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<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 visit 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 65: / Line 65: @@
 =Sample=
-<source lang="Python" highlight="65-72">
+<source lang="Python" highlight="66-73">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')
@@ Line 88: / Line 88: @@
    event_type.name = name
    event_type.save()
 def add_file(parent_truxton_file, filename):
@@ Line 142: / Line 143: @@
    add_event( child_file, "2016-07-27T12:00:00-05:00", "2016-07-27T12:00:00-05:00", "Legat called needing to meet US ambassador", "In London", EVENT_TYPE_FBI )
    add_event( child_file, "2016-07-29T12:00:00-05:00", "2016-07-29T12:00:00-05:00", "FBI Receives Downer Info from Legat", "Probably legat London", EVENT_TYPE_FBI )
 def main():
@@ Line 154: / Line 157: @@
    add_ec(root_file)
 if __name__ == "__main__":
    main()
 </source>

@@ Line 2: / Line 2: @@
 =Attributes and Methods=
-==<code>account</code>==
+==<code>account: str</code>==
 The optional account name associated with the URL.
 Many browsers will record the operating system user that did the surfing.
-==<code>accountoffset</code>==
+==<code>accountoffset: int</code>==
 The offset into the parent file where the account was found.
-==<code>fileid</code>==
+==<code>fileid: str</code>==
 The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file this [https://en.wikipedia.org/wiki/URL URL] came from.
 This corresponds to the <code>[FileID]</code> column of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.
-==<code>format</code>==
+==<code>format: int</code>==
 The format of the raw URL.
 This can be <code>URL_FORMAT_ASCII</code> (1) or <code>URL_FORMAT_UNICODE</code> (2)
-==<code>id</code>==
+==<code>id: str</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the record.
 It becomes non-zero after <code>save()</code> has been called.
-==<code>localfilename</code>==
+==<code>localfilename: str</code>==
 The path to the file the browser uses to cache the contents of the page retrieved by the URL.
-==<code>mediaid</code>==
+==<code>mediaid: str</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this visit came from.
 This identifier corresponds to the <code>[MediaID]</code> of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.
-==<code>method</code>==
+==<code>method: int</code>==
 The reason this URL was retrieved.
 It corresponds to the <code>[WebsiteMethodID]</code> column of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.
@@ Line 34: / Line 34: @@
 You can also use one of the [[URL Methods | predefined constants.]]
-==<code>offset</code>==
+==<code>offset: int</code>==
 The offset in the file where this URL was found.
 It should be the offset of the first character in the URL.
-==<code>save()</code>==
+==<code>save() -> bool</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<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, reason, origin)</code>==
+==<code>tag(tag: str, reason: str, origin: int) -> bool</code>==
 This creates a tag associated with this visit 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 50: / Line 50: @@
 [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.
-==<code>type</code>==
+==<code>type: int</code>==
 The type of URL.
 It corresponds to the <code>[URLTypeID]</code> column of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.
@@ Line 56: / Line 56: @@
 You can also use one of the [[URL Types | predefined constants.]]
-==<code>url</code>==
+==<code>url: str</code>==
 The URL string.
 This corresponds to the <code>[URL]</code> column of the <code>[URL]</code> table.
-==<code>when</code>==
+==<code>when: int</code>==
 When the URL was seen in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
 This corresponds to the <code>[When]</code> column of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.

@@ Line 11: / Line 11: @@
 ==<code>fileid</code>==
 The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file this [https://en.wikipedia.org/wiki/URL URL] came from.
-This corresponds to the <code>FileID</code> column of the <code>WebsiteVisit</code> table.
+This corresponds to the <code>FileID</code> column of the [[WebsiteVisit Table | <code>WebsiteVisit</code>]] table.
 ==<code>format</code>==
@@ Line 26: / Line 26: @@
 ==<code>mediaid</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this visit came from.
-This identifier corresponds to the <code>MediaID</code> of the <code>WebsiteVisit</code> table.
+This identifier corresponds to the <code>MediaID</code> of the [[WebsiteVisit Table | <code>WebsiteVisit</code>]] table.
 ==<code>method</code>==
 The reason this URL was retrieved.
-It corresponds to the <code>WebsiteMethodID</code> column of the <code>WebsiteVisit</code> table.
+It corresponds to the <code>WebsiteMethodID</code> column of the [[WebsiteVisit Table | <code>WebsiteVisit</code>]] table.
 The value must match a value in the <code>ID</code> column in the <code>WebsiteMethod</code> table.
 You can also use one of the [[URL Methods | predefined constants.]]
@@ Line 52: / Line 52: @@
 ==<code>type</code>==
 The type of URL.
-It corresponds to the <code>URLTypeID</code> column of the <code>WebsiteVisit</code> table.
+It corresponds to the <code>URLTypeID</code> column of the [[WebsiteVisit Table | <code>WebsiteVisit</code>]] table.
 The value must match a value in the <code>ID</code> column in the <code>URLType</code> table.
 You can also use one of the [[URL Types | predefined constants.]]
@@ Line 62: / Line 62: @@
 ==<code>when</code>==
 When the URL was seen in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-This corresponds to the <code>When</code> column of the <code>WebsiteVisit</code> table.
+This corresponds to the <code>When</code> column of the [[WebsiteVisit Table | <code>WebsiteVisit</code>]] table.
 =Sample=

@@ Line 45: / Line 45: @@
 This creates a tag associated with this visit 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> a sentence explaining why this visit was tagged.
 The <code>origin</code> is either <code>TAG_ORIGIN_AUTOMATIC</code> (1) or <code>TAG_ORIGIN_HUMAN</code> (2).
 It will return