Simply Datetime Redesign Update

.clang-format

@@ -1,140 +1,189 @@
 ---
 Language:        Cpp
+# BasedOnStyle:  Microsoft
 
 DisableFormat:   false
 
-# GENERAL INDENTATION
-UseTab: Never
-TabWidth: 4
-IndentWidth: 4
-
 AccessModifierOffset: -2
-
 AlignAfterOpenBracket: BlockIndent
 AlignArrayOfStructures: Right
+
 AlignConsecutiveAssignments:
-  Enabled: true
-  AcrossEmptyLines: true
-  AcrossComments: false
-  AlignCompound: false
+  Enabled:         true
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
   AlignFunctionPointers: false
-  PadOperators: true
+  PadOperators:    true
+
+AlignConsecutiveBitFields:
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
+  AlignFunctionPointers: false
+  PadOperators:    false
+
+AlignConsecutiveDeclarations:
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
+  AlignFunctionPointers: false
+  PadOperators:    false
+
 AlignConsecutiveMacros:
-  Enabled: true
-  AcrossEmptyLines: true
-  AcrossComments: false
-  AlignCompound: false
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
   AlignFunctionPointers: false
-  PadOperators: false
+  PadOperators:    false
+
+AlignConsecutiveShortCaseStatements:
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCaseColons: false
+
 AlignEscapedNewlines: Right
-AlignOperands: Align
+AlignOperands:   Align
+
 AlignTrailingComments:
-  Kind: Always
-  OverEmptyLines: 2
+  Kind:            Always
+  OverEmptyLines:  2
 
 AllowAllArgumentsOnNextLine: true
 AllowAllParametersOfDeclarationOnNextLine: true
-AllowBreakBeforeNoexceptSpecifier: Always
-AllowShortBlocksOnASingleLine: Never
+AllowBreakBeforeNoexceptSpecifier: Never
+AllowShortBlocksOnASingleLine: Empty
 AllowShortCaseLabelsOnASingleLine: false
-AllowShortCompoundRequirementOnASingleLine: false
+AllowShortCompoundRequirementOnASingleLine: true
 AllowShortEnumsOnASingleLine: true
-AllowShortFunctionsOnASingleLine: InlineOnly
+AllowShortFunctionsOnASingleLine: None
 AllowShortIfStatementsOnASingleLine: Never
-AllowShortLambdasOnASingleLine: All
+AllowShortLambdasOnASingleLine: Empty
 AllowShortLoopsOnASingleLine: false
-
-AlwaysBreakAfterReturnType: None
+#AllowShortNamespacesOnASingleLine: true
 AlwaysBreakAfterDefinitionReturnType: None
-AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
 AlwaysBreakTemplateDeclarations: true
 
+# AttributeMacros:
+#   - __capability
+
 BinPackArguments: false
-BinPackParameters: false
+BinPackParameters: true
+BitFieldColonSpacing: Both
 
 BreakBeforeBraces: Custom
 BraceWrapping:
-  AfterCaseLabel: true
-  AfterClass: false
+  AfterCaseLabel:  true
+  AfterClass:      false
   AfterControlStatement: false
-  AfterEnum: false
+  AfterEnum:       false
   AfterExternBlock: true
-  AfterFunction: true
-  AfterNamespace: true
-  AfterStruct: false
-  AfterUnion: false
-  BeforeCatch: false
-  BeforeElse: false
+  AfterFunction:   true
+  AfterNamespace:  true
+  AfterStruct:     false
+  AfterUnion:      false
+  BeforeCatch:     false
+  BeforeElse:      false
   BeforeLambdaBody: true
-  BeforeWhile: false
-  IndentBraces: false
+  BeforeWhile:     false
+  IndentBraces:    false
   SplitEmptyFunction: false
   SplitEmptyRecord: false
-  SplitEmptyNamespace: true
+  SplitEmptyNamespace: false
+
 BreakAdjacentStringLiterals: true
-BreakAfterAttributes: Never
-#BreakAfterReturnType: Automatic
+BreakAfterAttributes: Leave
+BreakArrays:     true
 BreakBeforeBinaryOperators: None
 BreakBeforeConceptDeclarations: Always
+BreakBeforeInlineASMColon: OnlyMultiline
 BreakBeforeTernaryOperators: false
 BreakConstructorInitializers: BeforeColon
 BreakInheritanceList: AfterColon
 BreakStringLiterals: true
-
-ColumnLimit: 95
+ColumnLimit:     95
+CommentPragmas:  '^ IWYU pragma:'
 CompactNamespaces: false
 ConstructorInitializerIndentWidth: 4
 ContinuationIndentWidth: 4
-Cpp11BracedListStyle: false
-
+Cpp11BracedListStyle: true
 DerivePointerAlignment: false
-
 EmptyLineAfterAccessModifier: Never
-EmptyLineBeforeAccessModifier: Always
-ExperimentalAutoDetectBinPacking: true
-
+EmptyLineBeforeAccessModifier: LogicalBlock
+ExperimentalAutoDetectBinPacking: false
 FixNamespaceComments: true
 
-IncludeBlocks: Preserve
+# ForEachMacros:
+#   - foreach
+#   - Q_FOREACH
+#   - BOOST_FOREACH
+# IfMacros:
+#   - KJ_IF_MAYBE
+
+IncludeCategories:
+  - Regex:           '^"(llvm|llvm-c|clang|clang-c)/'
+    Priority:        2
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '^(<|"(gtest|gmock|isl|json)/)'
+    Priority:        3
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '.*'
+    Priority:        1
+    SortPriority:    0
+    CaseSensitive:   false
+
+IncludeIsMainRegex: '(Test)?$'
+IncludeIsMainSourceRegex: ''
+IncludeBlocks:   Preserve
 IndentAccessModifiers: false
 IndentCaseBlocks: false
 IndentCaseLabels: false
 IndentExternBlock: NoIndent
-IndentGotoLabels: false
-IndentPPDirectives: BeforeHash
-IndentRequiresClause: false
+IndentGotoLabels: true
+IndentPPDirectives: AfterHash
+IndentRequiresClause: true
+IndentWidth:     4
 IndentWrappedFunctionNames: false
-InsertBraces: false
+InsertBraces:    false
+InsertNewlineAtEOF: false
 InsertTrailingCommas: None
+
 IntegerLiteralSeparator:
-  Binary: 0
-  Decimal: 3
-  Hex: 4
+  Binary:          0
+  Decimal:         3
+  Hex:             4
 
+KeepEmptyLinesAtTheStartOfBlocks: false
+KeepEmptyLinesAtEOF: true
 LambdaBodyIndentation: Signature
-
+LineEnding:      DeriveLF
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
 MaxEmptyLinesToKeep: 2
-
-NamespaceIndentation: All
-
+NamespaceIndentation: None
 PackConstructorInitializers: BinPack
 PointerAlignment: Left
-PPIndentWidth: -1
-
+PPIndentWidth:   -1
 QualifierAlignment: Leave
-
 ReferenceAlignment: Pointer
-ReflowComments: true
+ReflowComments:  true
+RemoveBracesLLVM: false
 RemoveParentheses: Leave
 RemoveSemicolon: false
-#RequiresClausePosition: OwnLineWithBrace
+RequiresClausePosition: OwnLine
 RequiresExpressionIndentation: OuterScope
-
 SeparateDefinitionBlocks: Always
-ShortNamespaceLines: 3
-#SortIncludes:
-#  Enabled: true
-#  IgnoreCase: false
+ShortNamespaceLines: 1
+SkipMacroDefinitionBody: false
+SortIncludes:    CaseSensitive
 SortUsingDeclarations: LexicographicNumeric
 SpaceAfterCStyleCast: false
 SpaceAfterLogicalNot: false
@@ -145,35 +194,67 @@ SpaceBeforeCaseColon: false
 SpaceBeforeCpp11BracedList: false
 SpaceBeforeCtorInitializerColon: true
 SpaceBeforeInheritanceColon: true
+SpaceBeforeJsonColon: false
+
 SpaceBeforeParens: Custom
 SpaceBeforeParensOptions:
   AfterControlStatements: true
   AfterForeachMacros: true
   AfterFunctionDefinitionName: false
   AfterFunctionDeclarationName: false
-  AfterIfMacros: true
+  AfterIfMacros:   true
   AfterOverloadedOperator: false
   AfterPlacementOperator: true
   AfterRequiresInClause: false
   AfterRequiresInExpression: false
   BeforeNonEmptyParentheses: false
+
 SpaceBeforeRangeBasedForLoopColon: true
 SpaceBeforeSquareBrackets: false
 SpaceInEmptyBlock: true
 SpacesBeforeTrailingComments: 1
+SpacesInAngles:  Never
+SpacesInContainerLiterals: true
 
-# PENALTIES:
-PenaltyReturnTypeOnItsOwnLine: 10000
-PenaltyBreakTemplateDeclaration: 10000
-#PenaltyBreakBeforeMemberAccess: 10000
-PenaltyBreakAssignment: 800
-PenaltyBreakScopeResolution: 500
+SpacesInLineCommentPrefix:
+  Minimum:         1
+  Maximum:         -1
+
+SpacesInParens:  Never
+SpacesInParensOptions:
+  InCStyleCasts:   false
+  InConditionalStatements: false
+  InEmptyParentheses: false
+  Other:           false
+
+SpacesInSquareBrackets: false
+Standard:        Latest
+TabWidth:        4
+UseTab:          Never
+VerilogBreakBetweenInstancePorts: true
+
+# StatementAttributeLikeMacros:
+#   - Q_EMIT
+
+# StatementMacros:
+#   - Q_UNUSED
+#   - QT_REQUIRE_VERSION
+
+# WhitespaceSensitiveMacros:
+#   - BOOST_PP_STRINGIZE
+#   - CF_SWIFT_NAME
+#   - NS_SWIFT_NAME
+#   - PP_STRINGIZE
+#   - STRINGIZE
+
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 10
 PenaltyBreakComment: 500
 PenaltyBreakFirstLessLess: 120
-PenaltyExcessCharacter: 100
-PenaltyBreakBeforeFirstCallParameter: 10
-PenaltyBreakString: 10
-PenaltyBreakOpenParenthesis: 10
+PenaltyBreakOpenParenthesis: 0
+PenaltyBreakScopeResolution: 500
+PenaltyBreakString: 100
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
 PenaltyIndentedWhitespace: 0
-
-...
+PenaltyReturnTypeOnItsOwnLine: 10000

CMakeLists.txt

@@ -20,7 +20,7 @@ set(PRJ_CXX_STANDARD 20)
 
 project(
     ${PRJ_NAME}
-    VERSION 0.0.0.0
+    VERSION 0.1.0.0
     LANGUAGES C CXX ASM
 )
 
@@ -96,7 +96,18 @@ include(linker/config)
 
 # Sources
 add_subdirectory(lib)
-add_subdirectory(src)
+
+include(utility/project_tools)
+
+# Set library-wide C++ standard
+use_project_cxx_standard(GLOBAL_CXX_OPTIONS INTERFACE)
+
+target_link_options(
+    GLOBAL_CXX_OPTIONS
+
+    INTERFACE
+    ${GLOBAL_LINK_FLAGS}
+)
 
 # C Interface Source
 if(CFFI_BUILD)

README.md

@@ -6,7 +6,7 @@
 
 <div>
     <a href="https://github.com/InfinSys/simply-datetime/releases">
-        <img src="https://img.shields.io/badge/version-0.0.0-blue">
+        <img src="https://img.shields.io/badge/version-0.1.0-blue">
     </a>
 </div></br>
 

cffi/CMakeLists.txt

@@ -11,6 +11,8 @@
 #
 #====================================
 
+# TODO: Major changes needed here in due time...
+
 set(
     PRJ_CFFI_INCLUDE_DIRS
     "${CMAKE_CURRENT_SOURCE_DIR}/include"

cffi/include/simplydt/common/c_datetime_defs.h

@@ -1,5 +1,5 @@
 
-// Copyright (C) 2023-2025 by Jamon T. Bailey and Infinity Systems, LLC. All rights reserved.
+// Copyright (C) 2026 by Jamon T. Bailey and Infinity Systems, LLC. All rights reserved.
 // Released under the terms of the GNU Affero General Public License version 3.
 
 // [ISJTB-CXX-XL20230401-000001]