dately 1.0.9__tar.gz → 2.0.0__tar.gz

dately-2.0.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.1
+Name: dately
+Version: 2.0.0
+Summary: A library for manipulating datetime strings.
+Home-page: https://github.com/cedricmoorejr/dately
+Author: Cedric Moore Jr.
+Author-email: cedric@doydl.tech
+License: MIT
+Project-URL: Source Code, https://github.com/cedricmoorejr/dately/tree/main/dately
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/cedricmoorejr/dately/main/dately/assets/dately_logo.png" alt="Dately Logo" width="500"/>
+</p>
+
+
+### Dately Library: Comprehensive Date and Time Handling in Python
+
+The `dately` module is a comprehensive library designed for advanced date and time manipulation. It offers extensive capabilities to handle various date and time formats, ensuring compatibility across different systems and data structures. The module provides tools for validating, extracting, and transforming date and time information with a focus on performance and accuracy.
+
+#### Why Choose Dately?
+
+- **Windows Optimized**: Specifically addresses inconsistencies in Python's date formatting on the Windows operating system.
+- **Comprehensive Functionalities**: Supports date parsing, detection, extraction, and conversion for various input types, including date strings, datetime objects, pandas Series, and NumPy arrays.
+- **High Performance**: Leverages both high-level Python and low-level C code (via Cython) for efficient operations.
+
+#### Key Features
+
+1. **Date and Time Format Detection**:
+   - Automatically detect various date and time formats from strings, ensuring seamless parsing and conversion.
+   - Supports a wide range of date formats, including standard and unique custom formats.
+
+2. **Timezone Management**:
+   - Provides detailed information for specific time zones.
+   - Converts time from one time zone to another.
+   - Retrieves the current time for specific time zones.
+   - Categorizes time zones by country, offset, and daylight saving time observance.
+
+3. **String Manipulation and Validation**:
+   - Extract specific components (year, month, day, hour, minute, second, timezone) from datetime strings.
+   - Validate and replace parts of datetime strings to ensure accuracy and consistency.
+   - Strip time and timezone information from datetime strings when needed.
+
+4. **Performance Optimizations**:
+   - Utilizes Cython to enhance performance for computationally intensive tasks.
+   - Interfaces with underlying C code to perform high-speed string operations and date validations.
+
+#### Solving Windows Date Formatting Issues
+
+A key aspect of this module is addressing inconsistencies in Python's date formatting on the Windows operating system. The module specifically targets the handling of the hyphen-minus (-) in date format specifiers. This flag, used to remove leading zeros from formatted output (e.g., turning '01' into '1' for January), works reliably on Unix-like systems but does not function as intended on Windows.
+
+To solve this problem on Windows, the `dately` module introduces a workaround using regular expressions. It utilizes a detection function to determine the format string and then examines each date component for leading zeros through an extract_date_component function and a subsequent has_leading_zero check. Depending on the presence of leading zeros, the module adjusts the format string-replacing `%m` with `%-m` where applicable-to emulate the behavior expected from the hyphen-minus on Unix-like systems.
+
+This method ensures that users on Windows achieve consistent date formatting, effectively compensating for the lack of native support for the hyphen-minus in date specifiers on this system.
+
+Overall, `dately` is a powerful utility for anyone needing precise and flexible date and time handling in their applications, making it easier to manage, format, and validate date and time data consistently and efficiently.

dately-2.0.0/README.md

@@ -0,0 +1,45 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/cedricmoorejr/dately/main/dately/assets/dately_logo.png" alt="Dately Logo" width="500"/>
+</p>
+
+
+### Dately Library: Comprehensive Date and Time Handling in Python
+
+The `dately` module is a comprehensive library designed for advanced date and time manipulation. It offers extensive capabilities to handle various date and time formats, ensuring compatibility across different systems and data structures. The module provides tools for validating, extracting, and transforming date and time information with a focus on performance and accuracy.
+
+#### Why Choose Dately?
+
+- **Windows Optimized**: Specifically addresses inconsistencies in Python's date formatting on the Windows operating system.
+- **Comprehensive Functionalities**: Supports date parsing, detection, extraction, and conversion for various input types, including date strings, datetime objects, pandas Series, and NumPy arrays.
+- **High Performance**: Leverages both high-level Python and low-level C code (via Cython) for efficient operations.
+
+#### Key Features
+
+1. **Date and Time Format Detection**:
+   - Automatically detect various date and time formats from strings, ensuring seamless parsing and conversion.
+   - Supports a wide range of date formats, including standard and unique custom formats.
+
+2. **Timezone Management**:
+   - Provides detailed information for specific time zones.
+   - Converts time from one time zone to another.
+   - Retrieves the current time for specific time zones.
+   - Categorizes time zones by country, offset, and daylight saving time observance.
+
+3. **String Manipulation and Validation**:
+   - Extract specific components (year, month, day, hour, minute, second, timezone) from datetime strings.
+   - Validate and replace parts of datetime strings to ensure accuracy and consistency.
+   - Strip time and timezone information from datetime strings when needed.
+
+4. **Performance Optimizations**:
+   - Utilizes Cython to enhance performance for computationally intensive tasks.
+   - Interfaces with underlying C code to perform high-speed string operations and date validations.
+
+#### Solving Windows Date Formatting Issues
+
+A key aspect of this module is addressing inconsistencies in Python's date formatting on the Windows operating system. The module specifically targets the handling of the hyphen-minus (-) in date format specifiers. This flag, used to remove leading zeros from formatted output (e.g., turning '01' into '1' for January), works reliably on Unix-like systems but does not function as intended on Windows.
+
+To solve this problem on Windows, the `dately` module introduces a workaround using regular expressions. It utilizes a detection function to determine the format string and then examines each date component for leading zeros through an extract_date_component function and a subsequent has_leading_zero check. Depending on the presence of leading zeros, the module adjusts the format string-replacing `%m` with `%-m` where applicable-to emulate the behavior expected from the hyphen-minus on Unix-like systems.
+
+This method ensures that users on Windows achieve consistent date formatting, effectively compensating for the lack of native support for the hyphen-minus in date specifiers on this system.
+
+Overall, `dately` is a powerful utility for anyone needing precise and flexible date and time handling in their applications, making it easier to manage, format, and validate date and time data consistently and efficiently.

{dately-1.0.9 → dately-2.0.0}/dately/core.py

@@ -1,8 +1,8 @@
 import threading
 
 def import_specific_parts():
-    global tz
-    from .timezone import tz
+    global TimeZoner
+    from .timezone import TimeZoner
 
 thread = threading.Thread(target=import_specific_parts)
 thread.start()
@@ -12,7 +12,6 @@ import numpy as np
 import pandas as pd
 from copy import deepcopy
 
-# Import all functions and classes from custom utility modules using relative imports
 from .mold.pyd.cdatetime.whichformat import *
 from .utils import *
 from .timeutils import *
@@ -505,5 +504,5 @@ dt = DatelyDate()
 # Define public interface
 __all__ = [
     "dt",
-    "tz"
+    "TimeZoner"
 ]

dately-2.0.0/dately/mskutils.py

@@ -0,0 +1,77 @@
+import base64
+import re
+
+# Define public interface
+__all__ = ['Shift']
+
+class Shift:
+    class bool:
+        @staticmethod
+        def bytes(s):
+            """ base64 """
+            if len(s) % 4 != 0:
+                return False
+            if not re.match(r'^[A-Za-z0-9+/]*={0,2}$', s):
+                return False
+            try:
+                decoded_bytes = base64.b64decode(s, validate=True)
+                decoded_str = decoded_bytes.decode('utf-8')
+                return True
+            except (base64.binascii.Error, UnicodeDecodeError):
+                return False
+        @staticmethod
+        def bin(s):
+            """ Binary """
+            if not all(c in '01' for c in s):
+                return False
+            if len(s) % 8 != 0:
+                return False
+            try:
+                bytes_list = [s[i:i+8] for i in range(0, len(s), 8)]
+                decoded_chars = [chr(int(byte, 2)) for byte in bytes_list]
+                decoded_str = ''.join(decoded_chars)
+                return True
+            except ValueError:
+                return False
+	
+    class format:
+        @staticmethod
+        def chr(data, call):
+            """ base64 """
+            if call == "unformat":
+                if not Shift.bool.bytes(data):
+                    return base64.b64encode(data.encode('utf-8')).decode('utf-8')
+            elif call == "format":
+                if Shift.bool.bytes(data):
+                    try:
+                        return base64.b64decode(data).decode('utf-8')
+                    except (base64.binascii.Error, UnicodeDecodeError):
+                        raise ValueError("Invalid base64 input.")
+            else:
+                raise ValueError("Invalid call. Use 'unformat' or 'format'.")
+        @staticmethod
+        def str(data, call):
+            """ Binary """
+            if call == "unformat":
+                if not Shift.bool.bin(data):
+                    return ''.join(format(ord(char), '08b') for char in data)
+            elif call == "format":
+                if Shift.bool.bin(data):
+                    try:
+                        chars = [chr(int(data[i:i+8], 2)) for i in range(0, len(data), 8)]
+                        return ''.join(chars)
+                    except ValueError:
+                        raise ValueError("Invalid binary input.")
+            else:
+                raise ValueError("Invalid call. Use 'unformat' or 'format'.")               
+
+    class type:
+        @staticmethod
+        def map(s, add, ret=False):
+            formatted = Shift.format.chr(s, "format")
+            str_formatted = f'{formatted}{add}'
+            unformatted = Shift.format.chr(str_formatted, "unformat")
+            if ret:
+                return Shift.format.chr(unformatted, "format")
+            return unformatted
+

dately-2.0.0/dately/sysutils.py

@@ -0,0 +1,60 @@
+import time
+
+# Define public interface
+__all__ = ['UnixTime']
+
+class UnixTime:
+    @staticmethod
+    def Timestamp(year=None, month=None, day=None, hour=None, minute=None, second=None, weekday=None, yearday=None, isdst=-1):
+        """
+        Initializes the UnixTime with specific time components or defaults to current time values.
+
+        Parameters:
+        year (int): The year (e.g., 2021). Default is the current year if not provided or invalid.
+        month (int): The month (1-12). Default is the current month if not provided or invalid.
+        day (int): The day of the month (1-31). Default is the current day if not provided or invalid.
+        hour (int): The hour (0-23). Default is the current hour if not provided or invalid.
+        minute (int): The minute (0-59). Default is the current minute if not provided or invalid.
+        second (int): The second (0-59). Default is the current second if not provided or invalid.
+        weekday (int): The day of the week (0-6, Monday is 0). Default is 0.
+        yearday (int): The day of the year (1-366). Default is 0.
+        isdst (int): Daylight Saving Time flag. Use -1 for automatic DST detection. Default is -1.
+        """
+        current_time = time.localtime()
+        
+        year = UnixTime.validate_input(year, current_time.tm_year)
+        month = UnixTime.validate_input(month, current_time.tm_mon)
+        day = UnixTime.validate_input(day, current_time.tm_mday)
+        hour = UnixTime.validate_input(hour, current_time.tm_hour)
+        minute = UnixTime.validate_input(minute, current_time.tm_min)
+        second = UnixTime.validate_input(second, current_time.tm_sec)
+        weekday = UnixTime.validate_input(weekday, 0)
+        yearday = UnixTime.validate_input(yearday, 0)
+        isdst = UnixTime.validate_input(isdst, -1)
+
+        time_tuple = (year, month, day, hour, minute, second, weekday, yearday, isdst)
+        return int(time.mktime(time_tuple))
+
+    @staticmethod
+    def Date(unix_timestamp):
+        """
+        Converts a Unix timestamp to a human-readable date.
+
+        Parameters:
+        unix_timestamp (int): The Unix timestamp to convert.
+
+        Returns:
+        str: The human-readable date in the format 'YYYY-MM-DD HH:MM:SS'.
+        """
+        time_struct = time.localtime(unix_timestamp)
+        return time.strftime('%Y-%m-%d %H:%M:%S', time_struct)
+
+    @staticmethod
+    def validate_input(value, default):
+        """
+        Validates the input to ensure it is an integer or defaults if None or invalid.
+        """
+        try:
+            return int(value) if value is not None else default
+        except (TypeError, ValueError):
+            return default

{dately-1.0.9 → dately-2.0.0}/dately/timeutils.py

@@ -4,8 +4,14 @@ import time
 
 # Import all functions and classes from custom utility modules
 from .utils import *
-from .mold.pyd.Compiled import get_time_fragment as gtf, anytime_regex, timemeridiem_regex, timeboundary_regex, time_only_regex, datetime_pattern_search
-
+from .mold.pyd.Compiled import (
+    datetime_regex as datetime_pattern_search, 
+    anytime_regex, 
+    timemeridiem_regex, 
+    timeboundary_regex, 
+    time_only_regex, 
+    get_time_fragment as gtf, 
+)
 
 
 # Define public interface