Add script for reporting current second

Author: Danstiv

addon/globalPlugins/devBox/__init__.py

@@ -1,3 +1,4 @@
+import datetime
 from pathlib import Path
 
 import addonHandler
@@ -122,3 +123,10 @@ def script_report_current_line_length(self, gesture):
         text_info.expand(textInfos.UNIT_LINE)
         line = text_info.text.rstrip("\r\n")
         ui.message(str(len(line)))
+
+    @scriptHandler.script(
+        description=_("Report current second in a minute"),
+        gesture="kb:nvda+control+f12",
+    )
+    def script_report_current_second(self, gesture):
+        ui.message(str(datetime.datetime.now().second))

readme.md

@@ -15,6 +15,7 @@ You can see that there are 12 spaces in the middle, and nvda will skip them when
 Pressing nvda+up or nvda+numpad8 twice will read all the spaces one by one, which is usually not very convenient.
 
 This addon detects 2 or more consecutive spaces, and folds them into a short sequence.
+
 For example "space space space space space" becomes "5 space".
 
 ### Diff indication
@@ -28,5 +29,26 @@ The sounds are taken from vscode, they are also slightly modified (a small amoun
 This feature allows to find out the length of the line under cursor, it can be useful when formatting code or any other text.
 Gesture is unassigned by default.
 
+### Get second in the current minute
+Can be useful for an approximate measurement of time intervals from a few seconds to a couple of minutes.
+
+For example, you can debug a non-optimized program, the execution of a part of which takes a long time.
+
+Suppose you launched the process and checked the second, you received the number 5.
+
+When the process ended, you again requested the value of a second: 30.
+
+Thus, the program hung for about 25 seconds, you can improve the code and take similar measurements again.
+
+Also could be used for more accurate setting of the clock, which resets seconds to zero when applying settings.
+
+Of course, you can simply enable the display of seconds in Windows settings, but in some cases it is convenient to immediately get the most actual value without listening information about the hour and minute.
+
+nvda+ctrl+f12 is bound by default.
+
 ---
 All passive features, like space folding, is disabled by default, they could be enabled in addon settings.
+
+## Change log
+### 0.2.0
+Script for reporting current second was added.