Merge pull request #7 from luismedel/feature/add-datetime-property

Add datetime property

Author: luismedel

CHANGELOG.md

@@ -6,13 +6,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [1.1.4] - 2023-11-09
+
+### Added
+
+- `datetime` property.
+
+## [1.1.3] - 2023-10-09
+
+### Fixed
+
+- Honor Python 3.7 syntax .
+
 ## [1.1.2] - 2023-09-13
 
 ### Fixed
 
 - Properly exported symbols as per https://github.com/microsoft/pylance-release/issues/2953#issuecomment-1168408943.
 
-
 ## [1.1.1] - 2023-08-18
 
 ### Added

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tsidpy"
-version = "1.1.3"
+version = "1.1.4"
 authors = [
   { name="Luis Medel", email="luis@luismedel.com" },
 ]

src/tsidpy/tsid.py

@@ -90,6 +90,16 @@ def timestamp(self) -> float:
         """
         return self._epoch + (self.__number >> RANDOM_BITS)
 
+    @property
+    def datetime(self) -> datetime:
+        """Datetime corresponding with the tiimestamp component
+           of the TSID.
+
+        >>> TSID(0).datetime == datetime.fromtimestamp(TSID_EPOCH / 1000)
+        True
+        """
+        return datetime.fromtimestamp(self.timestamp / 1000)
+
     @property
     def random(self) -> int:
         """Returns the random component of the TSID.

tests/generator_test.py

@@ -20,7 +20,7 @@ def print_tsid(t: TSID) -> None:
 
 
 if __name__ == '__main__':
-    g: TSIDGenerator()
+    g = TSIDGenerator()
     for _ in range(10):
         print_tsid(g.create())
     time.sleep(0.1)