In vain have I struggled. It will not do. My feelings will not be rep…

…ressed. You must allow me to tell you how ardently I admire and love you.

.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+/.build
+/Packages
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+*.pyc
+default.profraw
+
+# Links to important Intel files
+/intel-lib

.swift-version

@@ -0,0 +1 @@
+5.0

.swiftlint.yml

@@ -0,0 +1,245 @@
+included:
+  - Sources
+  - Tests
+
+excluded:
+  - Tests/DecimalTests/Generated
+  - Tests/DecimalTests/Intel - generated
+  - Tests/DecimalTests/Speleotrove - generated
+
+# Try to stay below 80
+line_length:
+  warning: 100
+  error: 120
+
+# We will list all of the SwiftLint rules deciding on a case-by-case basis
+# whether we want to enable them or not. Otherwise people with newer SwiftLint
+# version may be flooded with errors from rules that we have not checked against.
+only_rules:
+  # =============
+  # === Rules ===
+  # =============
+
+  # Here we are listing all of the non-optional rules.
+  # If some rule should be disabled then the line should be commented.
+
+  - block_based_kvo
+  - class_delegate_protocol
+  - closing_brace
+  - closure_parameter_position
+  - comma
+  - comment_spacing
+  - compiler_protocol_init
+  - computed_accessors_order
+  - control_statement
+  - custom_rules
+  - deployment_target
+  - discouraged_direct_init
+  - duplicate_enum_cases
+  - duplicate_imports
+  - dynamic_inline
+  - empty_enum_arguments
+  - empty_parameters
+  - empty_parentheses_with_trailing_closure
+  - for_where
+  - force_cast
+  - force_try
+  - generic_type_name
+  - implicit_getter
+  - inclusive_language
+  - inert_defer
+  - is_disjoint
+  - leading_whitespace
+  - legacy_cggeometry_functions
+  - legacy_constant
+  - legacy_constructor
+  - legacy_hashing
+  - legacy_nsgeometry_functions
+  - line_length
+  - mark
+  - multiple_closures_with_trailing_closure
+  - nesting
+  - no_fallthrough_only
+  - no_space_in_method_call
+  - notification_center_detachment
+  - nsobject_prefer_isequal
+  - opening_brace
+  - operator_whitespace
+  - orphaned_doc_comment
+  - private_over_fileprivate
+  - private_unit_test
+  - protocol_property_accessors_order
+  - reduce_boolean
+  - redundant_discardable_let
+  - redundant_objc_attribute
+  - redundant_optional_initialization
+  - redundant_set_access_control
+  - redundant_string_enum_value
+  - redundant_void_return
+  - return_arrow_whitespace
+  - shorthand_operator
+  - statement_position
+  - superfluous_disable_command
+  - switch_case_alignment
+  - syntactic_sugar
+  - todo
+  - trailing_newline
+  - trailing_semicolon
+  - trailing_whitespace
+  - unneeded_break_in_switch
+  - unused_capture_list
+  - unused_closure_parameter
+  - unused_control_flow_label
+  - unused_enumerated
+  - unused_optional_binding
+  - unused_setter_value
+  - valid_ibinspectable
+  - vertical_parameter_alignment
+  - vertical_whitespace
+  - void_return
+  - weak_delegate
+  - xctfail_message
+
+  # ==============================
+  # === Enabled optional rules ===
+  # ==============================
+
+  # This may seem like a lot, but basically we enable all of the optional rules
+  # that do not break existing code.
+
+  - anyobject_protocol
+  - array_init
+  - attributes
+  - closure_body_length
+  - closure_end_indentation
+  - closure_spacing
+  - collection_alignment
+  - contains_over_filter_count
+  - contains_over_filter_is_empty
+  - contains_over_first_not_nil
+  - contains_over_range_nil_comparison
+  - convenience_type
+  - discouraged_assert
+  - discouraged_object_literal
+  - discouraged_optional_boolean
+  - discouraged_optional_collection
+  - empty_collection_literal
+  - empty_count
+  - empty_string
+  - empty_xctest_method
+  - enum_case_associated_values_count
+  - explicit_init
+  - explicit_self
+  - fallthrough
+  - fatal_error_message
+  - file_header
+  - first_where
+  - flatmap_over_map_reduce
+  - force_unwrapping
+  - function_default_parameter_at_end
+  - identical_operands
+  - implicitly_unwrapped_optional
+  - joined_default_parameter
+  - last_where
+  - legacy_multiple
+  - legacy_objc_type # we don't use Objective-C, but why not?
+  - legacy_random
+  - let_var_whitespace
+  - literal_expression_end_indentation
+  - lower_acl_than_parent
+  - modifier_order
+  - multiline_arguments
+  - multiline_arguments_brackets # we sometimes put '(' at the same line as call
+  - multiline_function_chains
+  - multiline_literal_brackets
+  - multiline_parameters
+  - multiline_parameters_brackets # we sometimes put '(' at the same line as 'func' declaration
+  - nimble_operator
+  - no_extension_access_modifier
+  - object_literal
+  - operator_usage_whitespace
+  - optional_enum_case_matching
+  - overridden_super_call
+  - override_in_extension
+  - pattern_matching_keywords
+  - prefer_self_type_over_type_of_self
+  - prefer_zero_over_explicit_init
+  - private_action
+  - private_outlet
+  - prohibited_interface_builder
+  - prohibited_super_call
+  - quick_discouraged_call
+  - quick_discouraged_focused_test
+  - quick_discouraged_pending_test
+  - raw_value_for_camel_cased_codable_enum # we don't use 'Codable', but why not
+  - reduce_into
+  - redundant_nil_coalescing
+  - redundant_type_annotation
+  - required_enum_case
+  - single_test_class
+  - sorted_first_last
+  - static_operator
+  - toggle_bool
+  - trailing_closure
+  - unavailable_function
+  - unneeded_parentheses_in_closure_argument
+  - unowned_variable_capture
+  - untyped_error_in_catch
+  - unused_declaration
+  - unused_import
+  - vertical_parameter_alignment_on_call
+  - vertical_whitespace_closing_braces
+  - xct_specific_matcher
+  - yoda_condition
+
+  # ===================
+  # === Maybe later ===
+  # ===================
+
+  # - missing_docs
+
+  # ===============================
+  # === Disabled optional rules ===
+  # ===============================
+
+  # - balanced_xctest_lifecycle # this does not make sense for us
+  # - colon # align properties
+  # - conditional_returns_on_newline # Very often we do 'if X { return Y }'
+  # - cyclomatic_complexity # too annoying
+  # - discarded_notification_center_observer # we do not use NotificationCenter
+  # - expiring_todo # just use TODO, we do not have deadlines
+  # - explicit_acl # we don't need acl in tests
+  # - explicit_enum_raw_value # 'String' enums do not need explicit value
+  # - explicit_top_level_acl # this one requires us to put acl before 'extension XXX'
+  # - explicit_type_interface # this is weird
+  # - extension_access_modifier
+  # - file_length # too limiting
+  # - file_name # we heavily use extensions for single type
+  # - file_name_no_space # we have tons of those
+  # - file_types_order # declare helper type near usage
+  # - function_body_length # too limiting
+  # - function_parameter_count # too limiting
+  # - ibinspectable_in_extension # only for iOS
+  # - identifier_name # annoying
+  # - implicit_return # Cool for properties, not cool for functions
+  # - indentation_width # breaks when we have arguments/parameters in multiple lines
+  # - large_tuple
+  # - no_grouping_extension
+  # - nslocalizedstring_key # only for iOS
+  # - nslocalizedstring_require_bundle # only for iOS
+  # - number_separator # We have SwiftFormat for this
+  # - prefer_nimble # We are using 'XCTAssert'
+  # - prefixed_toplevel_constant
+  # - private_subject # we do not use 'Combine'
+  # - required_deinit
+  # - sorted_imports # use 'Scripts/sort_swift_imports'
+  # - strict_fileprivate # this one does not work properly?
+  # - strong_iboutlet  # only for iOS
+  # - switch_case_on_newline # 'case let .error(e): return .error(e)' is an Violet idiom
+  # - test_case_accessibility # We sometimes create class hierarchy
+  # - trailing_comma # avoid git blame when adding new value
+  # - type_body_length # too limiting
+  # - type_contents_order
+  # - type_name
+  # - vertical_whitespace_between_cases
+  # - vertical_whitespace_opening_braces

.vscode/launch.json

@@ -0,0 +1,24 @@
+{
+  "configurations": [
+    {
+      "type": "lldb",
+      "request": "launch",
+      "sourceLanguages": ["swift"],
+      "name": "Debug test-hossam-fahmy",
+      "program": "${workspaceFolder:oh-my-decimal}/.build/debug/test-hossam-fahmy",
+      "args": ["Test-suites/Hossam-Fahmy-tests", "Test-suites/Oh-my-decimal-tests"],
+      "cwd": "${workspaceFolder:oh-my-decimal}",
+      "preLaunchTask": "swift: Build Debug test-hossam-fahmy"
+    },
+    {
+      "type": "lldb",
+      "request": "launch",
+      "sourceLanguages": ["swift"],
+      "name": "Release test-hossam-fahmy",
+      "program": "${workspaceFolder:oh-my-decimal}/.build/release/test-hossam-fahmy",
+      "args": ["Test-suites/Hossam-Fahmy-tests", "Test-suites/Oh-my-decimal-tests"],
+      "cwd": "${workspaceFolder:oh-my-decimal}",
+      "preLaunchTask": "swift: Build Release test-hossam-fahmy"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "files.exclude": {
+    "IntelRDFPMathLib20U2/LIBRARY/*.o": true
+  },
+  "cSpell.words": ["libbid", "significand", "Speleotrove"],
+  "python.formatting.provider": "none",
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter"
+  }
+}

LICENSE-Hossam-Fahmy-tests

@@ -0,0 +1 @@
+The files provided below with test vectors for the decimal FP operations are copyrighted to Amr Sayed-Ahmed and Hossam A. H. Fahmy. They are provided as is without any implied warranties. The persons who download the files are free to use them for any purpose under their own responsibilities. The copyright owners provide the files in the hope that they will be useful to others but give no guarantees. We would appreciate if you reference our work and give us credit for it.

LICENSE-Intel

@@ -0,0 +1,28 @@
+Copyright (c) 2018, Intel Corp.
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, 
+are permitted provided that the following conditions are met:
+
+   * Redistributions of source code must retain the above copyright notice, this
+     list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above copyright notice, 
+     his list of conditions and the following disclaimer in the documentation 
+     and/or other materials provided with the distribution.
+   * Neither the name of Intel Corporation nor the names of its contributors 
+     may be used to endorse or promote products derived from this software 
+     without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. 
+IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

LICENSE-speleotrove-dectest

@@ -0,0 +1,33 @@
+ICU License - ICU 1.8.1 and later
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright (c) 1995-2005 International Business Machines Corporation and others
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, and/or sell copies of the Software, and to permit persons
+to whom the Software is furnished to do so, provided that the above
+copyright notice(s) and this permission notice appear in all copies of
+the Software and that both the above copyright notice(s) and this
+permission notice appear in supporting documentation.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
+INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
+FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
+WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder
+shall not be used in advertising or otherwise to promote the sale, use
+or other dealings in this Software without prior written authorization
+of the copyright holder.
+
+--------------------------------------------------------------------------------
+All trademarks and registered trademarks mentioned herein are the property of their respective owners.