dately 1.0.2__tar.gz → 1.0.4__tar.gz

dately-1.0.4/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.1
+Name: dately
+Version: 1.0.4
+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://github.com/cedricmoorejr/dately/blob/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.
+
+This module, currently available only for the Windows operating system, provides comprehensive functionalities for date parsing, detection, extraction, and conversion. It efficiently handles both individual dates and large arrays of dates, offering robust support for various input types, including date strings, datetime objects, pandas Series, and NumPy arrays. The core functionalities include converting dates to specified formats or datetime objects, as well as parsing, detecting, and extracting date components. Leveraging regular expressions and NumPy, it processes dates with high speed and accuracy, ensuring consistent date handling, specifically optimized for Windows environments.
+
+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 '-' flag 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. This discrepancy arises from the differing implementations of the underlying C libraries that Python relies on. For example, using a date format like '%Y-%-m-%d' on Windows results in Python not recognizing the specifier, leading to unexpected behaviors.
+
+On Windows, where the feature to omit leading zeros using %-m in the strftime() and strptime() functions is unsupported, attempts to use such formats with inputs like '2024-3-01' can lead to misinterpretations, defaulting to '%Y-%m-%d', which retains the leading zero.
+
+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 '-' flag 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 '-' flag in date specifiers on this system.
+
+Additionally, dately leverages both high-level Python and low-level C code (via Cython) to achieve efficient and high-performance operations.
+
+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.
+
+
+#### 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**:
+   - Fetches users current timezone information on import.
+
+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.

dately-1.0.4/README.md

@@ -0,0 +1,40 @@
+<p align="center">
+  <img src="https://github.com/cedricmoorejr/dately/blob/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.
+
+This module, currently available only for the Windows operating system, provides comprehensive functionalities for date parsing, detection, extraction, and conversion. It efficiently handles both individual dates and large arrays of dates, offering robust support for various input types, including date strings, datetime objects, pandas Series, and NumPy arrays. The core functionalities include converting dates to specified formats or datetime objects, as well as parsing, detecting, and extracting date components. Leveraging regular expressions and NumPy, it processes dates with high speed and accuracy, ensuring consistent date handling, specifically optimized for Windows environments.
+
+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 '-' flag 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. This discrepancy arises from the differing implementations of the underlying C libraries that Python relies on. For example, using a date format like '%Y-%-m-%d' on Windows results in Python not recognizing the specifier, leading to unexpected behaviors.
+
+On Windows, where the feature to omit leading zeros using %-m in the strftime() and strptime() functions is unsupported, attempts to use such formats with inputs like '2024-3-01' can lead to misinterpretations, defaulting to '%Y-%m-%d', which retains the leading zero.
+
+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 '-' flag 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 '-' flag in date specifiers on this system.
+
+Additionally, dately leverages both high-level Python and low-level C code (via Cython) to achieve efficient and high-performance operations.
+
+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.
+
+
+#### 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**:
+   - Fetches users current timezone information on import.
+
+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.

{dately-1.0.2 → dately-1.0.4}/dately/core.py

@@ -469,7 +469,7 @@ class DatelyDate:
                 return True
         return False
 
-    def sequence(self, start_date, end_date, to_format='%b %-d, %Y'):
+    def sequence(start_date, end_date, to_format=None):
         """
         Generate a sequence of formatted dates between two dates.
 
@@ -477,21 +477,23 @@ class DatelyDate:
             start_date (any): The start date of the sequence, which can be a datetime object or convertible to one.
             end_date (any): The end date of the sequence, which can be a datetime object or convertible to one.
             to_format (str, optional): The format string to use for formatting the dates.
-                Defaults to '%b %-d, %Y'.
+                Defaults to None.
 
         Returns:
             list of str: List of formatted date strings from start to end date inclusive.
         """
+        # Check if the start_date and end_date are valid datetime objects
         if not self._is_datetime(start_date):
-            start_date = self.convert_date(start_date)
+            start_date = self.convert_date(start_date, to_format=to_format)
+        
         if not self._is_datetime(end_date):
-            end_date = self.convert_date(end_date)
-
+            end_date = self.convert_date(end_date, to_format=to_format)
+        
         # Calculate the number of days between the start and end dates
         delta = end_date - start_date
         
         # Generate the list of dates and format them
-        date_list = [(start_date + datetime.timedelta(days=i)).strftime(to_format) for i in range(delta.days + 1)]
+        date_list = [self.convert_date(start_date + datetime.timedelta(days=i), to_format=to_format) for i in range(delta.days + 1)]
         
         return date_list
 

dately-1.0.4/dately.egg-info/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.1
+Name: dately
+Version: 1.0.4
+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://github.com/cedricmoorejr/dately/blob/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.
+
+This module, currently available only for the Windows operating system, provides comprehensive functionalities for date parsing, detection, extraction, and conversion. It efficiently handles both individual dates and large arrays of dates, offering robust support for various input types, including date strings, datetime objects, pandas Series, and NumPy arrays. The core functionalities include converting dates to specified formats or datetime objects, as well as parsing, detecting, and extracting date components. Leveraging regular expressions and NumPy, it processes dates with high speed and accuracy, ensuring consistent date handling, specifically optimized for Windows environments.
+
+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 '-' flag 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. This discrepancy arises from the differing implementations of the underlying C libraries that Python relies on. For example, using a date format like '%Y-%-m-%d' on Windows results in Python not recognizing the specifier, leading to unexpected behaviors.
+
+On Windows, where the feature to omit leading zeros using %-m in the strftime() and strptime() functions is unsupported, attempts to use such formats with inputs like '2024-3-01' can lead to misinterpretations, defaulting to '%Y-%m-%d', which retains the leading zero.
+
+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 '-' flag 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 '-' flag in date specifiers on this system.
+
+Additionally, dately leverages both high-level Python and low-level C code (via Cython) to achieve efficient and high-performance operations.
+
+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.
+
+
+#### 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**:
+   - Fetches users current timezone information on import.
+
+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.

{dately-1.0.2 → dately-1.0.4}/setup.py

@@ -8,7 +8,7 @@ if sys.platform != 'win32':
 
 setup(
     name="dately",
-    version="1.0.2",
+    version="1.0.4",
     author="Cedric Moore Jr.",
     author_email="cedric@doydl.tech",
     description="A library for manipulating datetime strings.",
@@ -16,7 +16,7 @@ setup(
     long_description_content_type="text/markdown",
     url="https://github.com/cedricmoorejr/dately",
     project_urls={
-        "Source Code": "https://github.com/cedricmoorejr/dately",
+        "Source Code": "https://github.com/cedricmoorejr/dately/tree/main/dately",
     },
     packages=find_packages(),
     package_data={
@@ -38,4 +38,4 @@ setup(
         "requests",
     ],
     license="MIT",
-)
+)

dately-1.0.2/PKG-INFO

@@ -1,28 +0,0 @@
-Metadata-Version: 2.1
-Name: dately
-Version: 1.0.2
-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
-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
-
-# Date Parsing and Component Extraction Module
-
-This module, currently available only for the Windows operating system, provides comprehensive functionalities for date parsing, detection, extraction, and conversion. It efficiently handles both individual dates and large arrays of dates, offering robust support for various input types including date strings, datetime objects, pandas Series, and NumPy arrays. The core functionalities include converting dates to specified formats or datetime objects, as well as parsing, detecting, and extracting date components. Leveraging regular expressions and NumPy, it processes dates with high speed and accuracy, ensuring consistent date handling across different platforms, specifically optimized for Windows environments.
-
-## Key Feature:
-
-A key part of this module is to address inconsistencies in Python's date formatting specifically for the Windows operating system. The module targets the handling of the '-' flag in date format specifiers. While the '-' flag, used to remove leading zeros from formatted output (e.g., turning '01' into '1' for January), works reliably on Unix-like systems, it does not function as intended on Windows. This discrepancy arises from the differing implementations of the underlying C libraries that Python relies on. For example, using a date format like '%Y-%-m-%d' on Windows results in Python not recognizing the specifier, leading to unexpected behaviors.
-
-On Windows, where the feature to omit leading zeros using `%-m` in the `strftime()` and `strptime()` functions is unsupported, attempts to use such formats with inputs like '2024-3-01' can lead to misinterpretations, defaulting to '%Y-%m-%d', which retains the leading zero.
-
-To solve this problem on Windows, this module introduces a workaround using regular expressions. It utilizes a detect 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 '-' flag 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 '-' flag in date specifiers on this system.

dately-1.0.2/README.md

@@ -1,13 +0,0 @@
-# Date Parsing and Component Extraction Module
-
-This module, currently available only for the Windows operating system, provides comprehensive functionalities for date parsing, detection, extraction, and conversion. It efficiently handles both individual dates and large arrays of dates, offering robust support for various input types including date strings, datetime objects, pandas Series, and NumPy arrays. The core functionalities include converting dates to specified formats or datetime objects, as well as parsing, detecting, and extracting date components. Leveraging regular expressions and NumPy, it processes dates with high speed and accuracy, ensuring consistent date handling across different platforms, specifically optimized for Windows environments.
-
-## Key Feature:
-
-A key part of this module is to address inconsistencies in Python's date formatting specifically for the Windows operating system. The module targets the handling of the '-' flag in date format specifiers. While the '-' flag, used to remove leading zeros from formatted output (e.g., turning '01' into '1' for January), works reliably on Unix-like systems, it does not function as intended on Windows. This discrepancy arises from the differing implementations of the underlying C libraries that Python relies on. For example, using a date format like '%Y-%-m-%d' on Windows results in Python not recognizing the specifier, leading to unexpected behaviors.
-
-On Windows, where the feature to omit leading zeros using `%-m` in the `strftime()` and `strptime()` functions is unsupported, attempts to use such formats with inputs like '2024-3-01' can lead to misinterpretations, defaulting to '%Y-%m-%d', which retains the leading zero.
-
-To solve this problem on Windows, this module introduces a workaround using regular expressions. It utilizes a detect 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 '-' flag 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 '-' flag in date specifiers on this system.

dately-1.0.2/dately.egg-info/PKG-INFO

@@ -1,28 +0,0 @@
-Metadata-Version: 2.1
-Name: dately
-Version: 1.0.2
-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
-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
-
-# Date Parsing and Component Extraction Module
-
-This module, currently available only for the Windows operating system, provides comprehensive functionalities for date parsing, detection, extraction, and conversion. It efficiently handles both individual dates and large arrays of dates, offering robust support for various input types including date strings, datetime objects, pandas Series, and NumPy arrays. The core functionalities include converting dates to specified formats or datetime objects, as well as parsing, detecting, and extracting date components. Leveraging regular expressions and NumPy, it processes dates with high speed and accuracy, ensuring consistent date handling across different platforms, specifically optimized for Windows environments.
-
-## Key Feature:
-
-A key part of this module is to address inconsistencies in Python's date formatting specifically for the Windows operating system. The module targets the handling of the '-' flag in date format specifiers. While the '-' flag, used to remove leading zeros from formatted output (e.g., turning '01' into '1' for January), works reliably on Unix-like systems, it does not function as intended on Windows. This discrepancy arises from the differing implementations of the underlying C libraries that Python relies on. For example, using a date format like '%Y-%-m-%d' on Windows results in Python not recognizing the specifier, leading to unexpected behaviors.
-
-On Windows, where the feature to omit leading zeros using `%-m` in the `strftime()` and `strptime()` functions is unsupported, attempts to use such formats with inputs like '2024-3-01' can lead to misinterpretations, defaulting to '%Y-%m-%d', which retains the leading zero.
-
-To solve this problem on Windows, this module introduces a workaround using regular expressions. It utilizes a detect 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 '-' flag 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 '-' flag in date specifiers on this system.