TruxtonUSB - Revision history

Sam: /* Sample */

2024-01-27T19:15:04Z

Sample

Sam: /* Sample */

2023-05-03T08:18:00Z

Sample

Sam: /* Sample */

2023-05-03T08:17:45Z

Sample

Sam at 22:55, 2 May 2023

2023-05-02T22:55:33Z

Sam at 11:51, 1 October 2022

2022-10-01T11:51:52Z

Sam at 17:08, 22 September 2022

2022-09-22T17:08:07Z

Sam at 10:08, 29 July 2022

2022-07-29T10:08:23Z

Sam: /* Sample */

2021-02-09T14:56:11Z

Sample

Sam: /* Sample */

2020-12-08T11:16:34Z

Sample

Sam: /* devicetype */

2020-12-08T11:07:25Z

devicetype

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

@@ Line 63: / Line 63: @@
 =Sample=
-<source lang="Python" line highlight="39-43">
+<source lang="Python" highlight="39-43">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')

@@ Line 63: / Line 63: @@
 =Sample=
-<source lang="Python" highlight="48-52">
+<source lang="Python" line highlight="39-43">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')
@@ Line 72: / Line 72: @@
 from calendar import timegm
 from pathlib import Path
 def add_file(parent_truxton_file, filename):
@@ Line 114: / Line 105: @@
    thumbdrive.vid = 1921
    thumbdrive.pid = 21808
-   thumbdrive.when = ticks("2016-12-20T11:00:00-05:00")
+   thumbdrive.when = datetime.fromisoformat("2016-12-20T11:00:00-05:00")
    thumbdrive.save()

@@ Line 58: / Line 58: @@
 This corresponds to the <code>[VID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
-==<code>when: int</code>==
+==<code>when: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-The time associated with this device in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+The time associated with this device.
 =Sample=

@@ Line 1: / Line 1: @@
 This class lets you add to the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table in Truxton.
 =Attributes and Methods=
 ==<code>deviceid: str</code>==

@@ Line 35: / Line 35: @@
 The revision of the device.
-==<code>save() -> bool</code>==
+==<code>save() -> boolean</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<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 device 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 109: / Line 109: @@
    thumbdrive.save()
-   return
+   return None
 def main():
@@ Line 120: / Line 120: @@
    add_cs(root_file)
 if __name__ == "__main__":
    main()
 </source>

@@ Line 2: / Line 2: @@
 =Attributes and Methods=
-==<code>deviceid</code>==
+==<code>deviceid: str</code>==
 A [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] assigned to the device by Windows.
-==<code>devicetype</code>==
+==<code>devicetype: int</code>==
 This corresponds to the <code>[USBDeviceTypeID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
 It should be a value from the <code>[ID]</code> column of the <code>[USBDeviceType]</code> table.
 Not used at this time.
-==<code>fileid</code>==
+==<code>fileid: str</code>==
 The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file this device came from.
 This corresponds to the <code>[FileID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
-==<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.
 This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
-==<code>mediaid</code>==
+==<code>mediaid: str</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this device came from.
 This corresponds to the <code>[MediaID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
-==<code>offset</code>==
+==<code>offset: int</code>==
 The offset into the file where this device was found.
 This corresponds to the <code>[Offset]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
-==<code>productid</code>==
+==<code>productid: int</code>==
 The product id of the device.
 This corresponds to the <code>[PID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
 This may contain a value in the <code>[PID]</code> column of the <code>[USBPIDVID]</code> table.
-==<code>revision</code>==
+==<code>revision: int</code>==
 The revision of the device.
-==<code>save()</code>==
+==<code>save() -> bool</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<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 device 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 47: / Line 47: @@
 [https://docs.python.org/3.8/library/constants.html?highlight=false#True True] if the tag was associated with the device, [https://docs.python.org/3.8/library/constants.html?highlight=false#False False] on failure.
-==<code>vendorid</code>==
+==<code>vendorid: int</code>==
 The [https://en.wikipedia.org/wiki/USB_Implementers_Forum#Obtaining_a_vendor_ID vendor id] (VID) of the device.
 This corresponds to the <code>[VID]</code> column of the <code><nowiki>[</nowiki>[[USBDevice Table|USBDevice]]<nowiki>]</nowiki></code> table.
-==<code>when</code>==
+==<code>when: int</code>==
 The time associated with this device in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.

@@ Line 55: / Line 55: @@
 =Sample=
-<source lang="Python" highlight="46-50">
+<source lang="Python" highlight="48-52">
 import truxton
 import shutil

@@ Line 55: / Line 55: @@
 =Sample=
-<source lang="Python" highlight="41-47">
+<source lang="Python" highlight="46-50">
 import truxton
 import shutil
@@ Line 68: / Line 68: @@
 def date_to_filetime(dt):
    return EPOCH_AS_FILETIME + (timegm(dt.timetuple()) * HUNDREDS_OF_NANOSECONDS)
 def add_file(parent_truxton_file, filename):
@@ Line 94: / Line 97: @@
 def add_cs(parent_file ):
-   child_file = add_file(parent_file, "device.db")
+   child_file = add_file(parent_file, "480057685-2020-10-13-Submission-SJC-SSCI-Part-2-of-2.pdf")
-   thumbdrive = child_file.newlocation()
+   return
 def main():