feat: add time_tools example with tests

Author: NA-V10

examples/time_tools/__init__.py

@@ -0,0 +1 @@
+# Init file for time_tools example module.

examples/time_tools/time_tools.py

@@ -0,0 +1,53 @@
+# Copyright (C) 2018 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Simple time utilities Fire CLI.
+
+This example demonstrates exposing simple time helper functions using Fire.
+Fire() is called with no target component so all functions in this module
+become CLI commands.
+
+Example usage:
+  time_tools now
+  time_tools to-seconds 1 30
+  time_tools add-seconds "2024-01-01 10:00:00" 120
+"""
+
+import fire
+import datetime
+
+
+def now():
+  """Return the current datetime as a string."""
+  return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+
+def to_seconds(minutes=0, seconds=0):
+  """Return minutes + seconds converted to total seconds."""
+  return minutes * 60 + seconds
+
+
+def add_seconds(time_string="", seconds=0):
+  """Add seconds to a datetime string."""
+  dt = datetime.datetime.strptime(time_string, "%Y-%m-%d %H:%M:%S")
+  new_dt = dt + datetime.timedelta(seconds=seconds)
+  return new_dt.strftime("%Y-%m-%d %H:%M:%S")
+
+
+def main():
+  fire.Fire(name="time_tools")
+
+
+if __name__ == "__main__":
+  main()

examples/time_tools/time_tools_test.py

@@ -0,0 +1,33 @@
+# Copyright (C) 2018 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tests for the time_tools module."""
+
+from fire import testutils
+from examples.time_tools import time_tools
+
+
+class TimeToolsTest(testutils.BaseTestCase):
+
+  def testToSeconds(self):
+    self.assertEqual(time_tools.to_seconds(1, 30), 90)
+    self.assertEqual(time_tools.to_seconds(0, 45), 45)
+
+  def testAddSeconds(self):
+    result = time_tools.add_seconds("2024-01-01 10:00:00", 120)
+    self.assertEqual(result, "2024-01-01 10:02:00")
+
+
+if __name__ == "__main__":
+  testutils.main()