Release 1.0.0 with multiplication optimization

.github/workflows/Build.yml

@@ -146,18 +146,22 @@ jobs:
         uses: actions/setup-java@v3
         with:
           distribution: 'adopt'
-          java-version: '8'
+          java-version: '19'
       - name: build
         run: |
           ./gradlew jar
           ./gradlew javadocJar
+          ./gradlew copyTestJars
       - uses: actions/upload-artifact@v3
         with:
           name: java-jars
           path: |
             ./*java/dfp/build/libs/*
             ./*java/dfp-math/build/libs/*
-            ./*java/decimalDemo/build/libs/*
+            ./*java/dfp/testLibs/*
+            ./*java/dfp-math/testLibs/*
+            ./*java/dfpNativeTests/testLibs/*
+            ./*java/vtaTest/testLibs/*
           retention-days: 7
 
   build-dotnet:
@@ -190,20 +194,20 @@ jobs:
 
   test-java:
     runs-on: ${{ matrix.os }}
-    needs: [compress-native]
+    needs: [build-java]
     strategy:
       fail-fast: false
       matrix:
         os: [ 'ubuntu-latest', 'windows-2019', 'macos-latest']
-        java: [ '8', '11', '15']
+        java: [ '8', '11', '19']
     steps:
       - uses: actions/checkout@v3
         with:
           submodules: 'recursive'
-      - name: Download compress-native artifacts
+      - name: Download java-jars artifacts
         uses: actions/download-artifact@v3
         with:
-          name: compress-native
+          name: java-jars
       - name: Setup java
         uses: actions/setup-java@v3
         with:
@@ -214,15 +218,7 @@ jobs:
           ./gradlew :java:systemInfo:runSystemInfo
       - name: test
         run: |
-          ./gradlew check
-      - name: Upload test results on failure
-        uses: actions/upload-artifact@v3
-        if: ${{ failure() }}
-        with:
-          path: |
-            java/dfp/build/reports/*
-            java/dfp-math/build/reports/*
-          name: Java-{{ matrix.java }}-${{ matrix.os }}-TestReports
+          ./gradlew runTestJars
 
   test-dotnet:
     runs-on: ${{ matrix.os }}

.github/workflows/CI.yml

@@ -190,18 +190,22 @@ jobs:
         uses: actions/setup-java@v3
         with:
           distribution: 'adopt'
-          java-version: '8'
+          java-version: '19'
       - name: build
         run: |
           ./gradlew jar
           ./gradlew javadocJar
+          ./gradlew copyTestJars
       - uses: actions/upload-artifact@v3
         with:
           name: java-jars
           path: |
             ./*java/dfp/build/libs/*
             ./*java/dfp-math/build/libs/*
-            ./*java/decimalDemo/build/libs/*
+            ./*java/dfp/testLibs/*
+            ./*java/dfp-math/testLibs/*
+            ./*java/dfpNativeTests/testLibs/*
+            ./*java/vtaTest/testLibs/*
           retention-days: 7
 
 
@@ -236,15 +240,15 @@ jobs:
 
   test-java:
     runs-on: ubuntu-latest
-    needs: [compress-native]
+    needs: [build-java]
     steps:
       - uses: actions/checkout@v3
         with:
           submodules: 'recursive'
-      - name: Download compress-native artifacts
+      - name: Download java-jars artifacts
         uses: actions/download-artifact@v3
         with:
-          name: compress-native
+          name: java-jars
       - name: Setup java
         uses: actions/setup-java@v3
         with:
@@ -255,7 +259,7 @@ jobs:
           ./gradlew :java:systemInfo:runSystemInfo
       - name: test
         run: |
-          ./gradlew check
+          ./gradlew runTestJars
 
 
   test-dotnet:

README.md

@@ -43,23 +43,14 @@ DFP was inspired on [Intel Decimal Floating-Point Math Library](https://software
 
 ## Supported platforms
 
-The Java DFP library does not contain native code, so all the JRE platforms must be supported.
+DFP for Java runs on all platforms where Java is supported.
 
-The Java DFP-Math library supports next platforms:
+DFP for .NET supports the following platforms:
 * x86-64 (Windows, Linux, Mac)
 * x86 (Windows, Linux)
 * arm64 (Linux, Mac)
 * arm7 (Linux)
 
-The .NET DFP and DFP-Math libraries supports next platforms:
-* x86-64 (Windows, Linux, Mac)
-* x86 (Windows, Linux)
-* arm64 (Linux, Mac)
-* arm7 (Linux)
-
-Linux Note: The Alpine Linux and other Linux distributions for the x86-64 platform are supported out of the box because the musl libc is statically linked with the native library. Other platforms require glibc.
-
-Mac Note: The Mac on the Apple M1 platform for now is supported through Rosetta application compatibility layer. We plan to support native arm64 platform in the future releases.
 
 ## Credits
 

csharp/EPAM.Deltix.DFP/Decimal64.cs

@@ -314,26 +314,51 @@ public static explicit operator Decimal64(Decimal value)
 
 		#region Classification
 
+		/// <summary>
+		/// Returns <code>true</code> if the supplied <code>DFP</code> value equals dedicated <code>NULL</code> constant
+		/// (in the range of the NaN values) that imply null reference of type <see cref="Decimal64"/>.
+		/// </summary>
+		/// <returns><code>true</code> for dedicated <code>NULL</code> constant</returns>
 		public Boolean IsNull()
 		{
 			return DotNetImpl.IsNull(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is Not-a-Number.
+		/// If you need check for all abnormal values use negation of the <see cref="IsFinite"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for Not-a-Number values.</returns>
 		public Boolean IsNaN()
 		{
 			return DotNetImpl.IsNaN(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is positive or negative infinity.
+		/// If you need check for all abnormal values use negation of the <see cref="IsFinite"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for positive or negative infinity.</returns>
 		public Boolean IsInfinity()
 		{
 			return DotNetImpl.IsInfinity(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is positive infinity.
+		/// If you need check for all abnormal values use negation of the <see cref="IsFinite"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for positive infinity.</returns>
 		public Boolean IsPositiveInfinity()
 		{
 			return DotNetImpl.IsPositiveInfinity(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is negative infinity.
+		/// If you need check for all abnormal values use negation of the <see cref="IsFinite"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for negative infinity.</returns>
 		public Boolean IsNegativeInfinity()
 		{
 			return DotNetImpl.IsNegativeInfinity(Bits);
@@ -345,6 +370,10 @@ public Boolean IsSigned()
 			return DotNetImpl.SignBit(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is a finite value: not a NaN, not a positive infinity, not a negative infinity.
+		/// </summary>
+		/// <returns><code>true</code> for finite values.</returns>
 		public Boolean IsFinite()
 		{
 			return DotNetImpl.IsFinite(Bits);
@@ -426,31 +455,59 @@ public Boolean IsLessOrEqual(Decimal64 that)
 			return NativeImpl.isLessOrEqual(a.Bits, b.Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is zero.
+		/// </summary>
+		/// <returns><code>true</code> for zero.</returns>
 		public Boolean IsZero()
 		{
 			return DotNetImpl.IsZero(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is not a zero or abnormal: NaN or positive infinity or negative infinity.
+		/// </summary>
+		/// <returns><code>true</code> for not a zero or abnormal.</returns>
 		public Boolean IsNonZero()
 		{
 			return !DotNetImpl.IsZero(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is greater than zero.
+		/// If you need check for values greater or equal to zero use <see cref="IsNonNegative"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for values greater than zero.</returns>
 		public Boolean IsPositive()
 		{
 			return DotNetImpl.IsPositive(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is less than zero.
+		/// If you need check for values less or equal to zero use <see cref="IsNonPositive"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for values less than zero.</returns>
 		public Boolean IsNegative()
 		{
 			return DotNetImpl.IsNegative(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is less or equal to zero.
+		/// If you need check for values strictly less than zero use <see cref="IsNegative"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for values less or equal to zero.</returns>
 		public Boolean IsNonPositive()
 		{
 			return DotNetImpl.IsNonPositive(Bits);
 		}
 
+		/// <summary>
+		/// Checks is the <code>DFP</code> value is greater or equal to zero.
+		/// If you need check for values strictly greater than zero use <see cref="IsPositive"/> function.
+		/// </summary>
+		/// <returns><code>true</code> for values greater or equal to zero.</returns>
 		public Boolean IsNonNegative()
 		{
 			return DotNetImpl.IsNonNegative(Bits);

docs/FAQ.md

@@ -25,4 +25,33 @@ So, key points:
 The *Checked functions in Java are not intended to be used directly.
 These special functions are required just for ValueTypeAgent support.
 
+## How to quickly check a sign?
+There are many `is*` functions in the DFP library for the fast sign check.
+The output values of these functions are presented in the next table.
+
+| Function | -Infinity | -1 | 0 | 1 | Infinity | NaN |
+| :--- | ---: | ---: | ---: | ---: | ---: | ---: |
+| isPositive | false | false | false | **TRUE** | **TRUE** | false |
+| isNonNegative | false | false | **TRUE** | **TRUE** | **TRUE** | false |
+| isNegative | **TRUE** | **TRUE** | false | false | false | false |
+| isNonPositive | **TRUE** | **TRUE** | **TRUE** | false | false | false |
+| isInfinity | **TRUE** | false | false | false | **TRUE** | false |
+| isPositiveInfinity | false | false | false | false | **TRUE** | false |
+| isNegativeInfinity | **TRUE** | false | false | false | false | false |
+| isNaN | false | false | false | false | false | **TRUE** |
+| isFinite | false | **TRUE** | **TRUE** | **TRUE** | false | false |
+| isNonFinite | **TRUE** | false | false | false | **TRUE** | **TRUE** |
+| isZero | false | false | **TRUE** | false | false | false |
+| isNonZero | **TRUE** | **TRUE** | false | **TRUE** | **TRUE** | **TRUE** |
+
+# Do we have a method of parsing value like "1.703E-5"?
+
+All the parse() and tryParse() methods supports this scientific notation.
+Use the method you like best
+
+```
+Decimal64Utils.parse() or Decimal64Utils.tryParse()
+Decimal64.parse() or Decimal64.tryParse()
+```
+
 

gradle.properties

@@ -1 +1,2 @@
-version=0.12.11-SNAPSHOT
+version=1.0.0-SNAPSHOT
+valueTypesVersion=0.9.4

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

java/dfp-math/build.gradle

@@ -9,11 +9,7 @@ if (isReleaseVersion) {
 
 group = 'com.epam.deltix'
 
-sourceCompatibility = 1.7
-compileTestJava {
-    sourceCompatibility = "1.8"
-    targetCompatibility = "1.8"
-}
+sourceCompatibility = 8
 
 repositories {
     mavenCentral()
@@ -134,3 +130,30 @@ jar {
 sourcesJar {
     duplicatesStrategy = DuplicatesStrategy.EXCLUDE
 }
+
+task testsJar(type: Jar, dependsOn: [jar, testClasses, processTestResources]) {
+    archiveClassifier = 'tests'
+    from sourceSets.test.output
+}
+
+task copyTestDeps(type: Copy) {
+    from(sourceSets.test.runtimeClasspath) { include '*.jar' }
+    into('testLibs')
+}
+
+task copyTestJars(type: Copy, dependsOn: [testsJar, copyTestDeps]) {
+    from(jar.outputs.files)
+    from(testsJar.outputs.files)
+    into('testLibs')
+}
+
+task runTestJars(type: JavaExec) {
+    mainClass = 'org.junit.runner.JUnitCore'
+    classpath = files { file('testLibs').listFiles() }
+
+    def testClassesRoot = file('src/test/java').absolutePath
+    fileTree(dir: testClassesRoot, include: '**/*Test.java').each { File file ->
+        def ap = file.absolutePath
+        args += ap.substring(testClassesRoot.length() + 1, ap.length() - 5).replace(File.separator, '.')
+    }
+}