diff options
author | Sean Hall <r.sean.hall@gmail.com> | 2022-11-10 22:48:05 -0600 |
---|---|---|
committer | Sean Hall <r.sean.hall@gmail.com> | 2022-11-10 23:49:10 -0600 |
commit | 209c92111928a98972d7f0f9d6d620ab566564d9 (patch) | |
tree | fd13d81105b02e63cc61c7819dba6f5c6c7e936e | |
parent | 3f6a633769a9c732db765411ef9b810133ad3957 (diff) | |
download | wix-209c92111928a98972d7f0f9d6d620ab566564d9.tar.gz wix-209c92111928a98972d7f0f9d6d620ab566564d9.tar.bz2 wix-209c92111928a98972d7f0f9d6d620ab566564d9.zip |
Automate the test for GetRelatedBundleVariable.
15 files changed, 97 insertions, 59 deletions
diff --git a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.cpp b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.cpp index 5da7b170..01750b4b 100644 --- a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.cpp +++ b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.cpp | |||
@@ -4,20 +4,9 @@ | |||
4 | #include "BalBaseBAFunctions.h" | 4 | #include "BalBaseBAFunctions.h" |
5 | #include "BalBaseBAFunctionsProc.h" | 5 | #include "BalBaseBAFunctionsProc.h" |
6 | 6 | ||
7 | const DWORD VARIABLE_GROW_FACTOR = 80; | ||
8 | const LPCWSTR STRING_VARIABLE = L"AString"; | 7 | const LPCWSTR STRING_VARIABLE = L"AString"; |
9 | const LPCWSTR NUMBER_VARIABLE = L"ANumber"; | 8 | const LPCWSTR NUMBER_VARIABLE = L"ANumber"; |
10 | 9 | ||
11 | static void CALLBACK BafRelatedBundleVariableTestingTraceError( | ||
12 | __in_z LPCSTR szFile, | ||
13 | __in int iLine, | ||
14 | __in REPORT_LEVEL rl, | ||
15 | __in UINT source, | ||
16 | __in HRESULT hrError, | ||
17 | __in_z __format_string LPCSTR szFormat, | ||
18 | __in va_list args | ||
19 | ); | ||
20 | |||
21 | class CBafRelatedBundleVariableTesting : public CBalBaseBAFunctions | 10 | class CBafRelatedBundleVariableTesting : public CBalBaseBAFunctions |
22 | { | 11 | { |
23 | public: // IBAFunctions | 12 | public: // IBAFunctions |
@@ -32,7 +21,7 @@ public: //IBootstrapperApplication | |||
32 | __in LPCWSTR wzVersion, | 21 | __in LPCWSTR wzVersion, |
33 | __in BOOL fMissingFromCache, | 22 | __in BOOL fMissingFromCache, |
34 | __inout BOOL* pfCancel | 23 | __inout BOOL* pfCancel |
35 | ) | 24 | ) |
36 | { | 25 | { |
37 | 26 | ||
38 | HRESULT hr = S_OK; | 27 | HRESULT hr = S_OK; |
@@ -44,14 +33,14 @@ public: //IBootstrapperApplication | |||
44 | 33 | ||
45 | if (wzValue) | 34 | if (wzValue) |
46 | { | 35 | { |
47 | BalLog(BOOTSTRAPPER_LOG_LEVEL_STANDARD, "AString = %ws", wzValue); | 36 | BalLog(BOOTSTRAPPER_LOG_LEVEL_STANDARD, "Retrieved related bundle variable with BAFunctions: AString = %ws", wzValue); |
48 | } | 37 | } |
49 | 38 | ||
50 | hr = BalGetRelatedBundleVariable(wzBundleId, NUMBER_VARIABLE, &wzValue); | 39 | hr = BalGetRelatedBundleVariable(wzBundleId, NUMBER_VARIABLE, &wzValue); |
51 | 40 | ||
52 | if (wzValue) | 41 | if (wzValue) |
53 | { | 42 | { |
54 | BalLog(BOOTSTRAPPER_LOG_LEVEL_STANDARD, "ANumber = %ws", wzValue); | 43 | BalLog(BOOTSTRAPPER_LOG_LEVEL_STANDARD, "Retrieved related bundle variable with BAFunctions: ANumber = %ws", wzValue); |
55 | } | 44 | } |
56 | 45 | ||
57 | hr = __super::OnDetectRelatedBundle(wzBundleId, relationType, wzBundleTag, fPerMachine, wzVersion, fMissingFromCache, pfCancel); | 46 | hr = __super::OnDetectRelatedBundle(wzBundleId, relationType, wzBundleTag, fPerMachine, wzVersion, fMissingFromCache, pfCancel); |
@@ -95,8 +84,6 @@ HRESULT WINAPI CreateBAFunctions( | |||
95 | CBafRelatedBundleVariableTesting* pBAFunctions = NULL; | 84 | CBafRelatedBundleVariableTesting* pBAFunctions = NULL; |
96 | IBootstrapperEngine* pEngine = NULL; | 85 | IBootstrapperEngine* pEngine = NULL; |
97 | 86 | ||
98 | DutilInitialize(&BafRelatedBundleVariableTestingTraceError); | ||
99 | |||
100 | hr = BalInitializeFromCreateArgs(pArgs->pBootstrapperCreateArgs, &pEngine); | 87 | hr = BalInitializeFromCreateArgs(pArgs->pBootstrapperCreateArgs, &pEngine); |
101 | ExitOnFailure(hr, "Failed to initialize Bal."); | 88 | ExitOnFailure(hr, "Failed to initialize Bal."); |
102 | 89 | ||
@@ -113,21 +100,3 @@ LExit: | |||
113 | 100 | ||
114 | return hr; | 101 | return hr; |
115 | } | 102 | } |
116 | |||
117 | static void CALLBACK BafRelatedBundleVariableTestingTraceError( | ||
118 | __in_z LPCSTR /*szFile*/, | ||
119 | __in int /*iLine*/, | ||
120 | __in REPORT_LEVEL /*rl*/, | ||
121 | __in UINT source, | ||
122 | __in HRESULT hrError, | ||
123 | __in_z __format_string LPCSTR szFormat, | ||
124 | __in va_list args | ||
125 | ) | ||
126 | { | ||
127 | // BalLogError currently uses the Exit... macros, | ||
128 | // so if expanding the scope need to ensure this doesn't get called recursively. | ||
129 | if (DUTIL_SOURCE_THMUTIL == source) | ||
130 | { | ||
131 | BalLogErrorArgs(hrError, szFormat, args); | ||
132 | } | ||
133 | } | ||
diff --git a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.def b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.def index 6e016dad..6e016dad 100644 --- a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.def +++ b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.def | |||
diff --git a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.vcxproj b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.vcxproj index 94d44ac3..94d44ac3 100644 --- a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.vcxproj +++ b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/BafRelatedBundleVariableTesting.vcxproj | |||
diff --git a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/precomp.cpp b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/precomp.cpp index fc9d1177..fc9d1177 100644 --- a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/precomp.cpp +++ b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/precomp.cpp | |||
diff --git a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/precomp.h b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/precomp.h index 2e14786a..2e14786a 100644 --- a/src/test/burn/TestData/Manual/BafRelatedBundleVariableTesting/precomp.h +++ b/src/test/burn/TestData/BAFunctionsTests/BafRelatedBundleVariableTesting/precomp.h | |||
diff --git a/src/test/burn/TestData/Manual/BundleD/BundleD.wixproj b/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleA.props index 1df1f895..e6cc34cd 100644 --- a/src/test/burn/TestData/Manual/BundleD/BundleD.wixproj +++ b/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleA.props | |||
@@ -1,22 +1,14 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | 1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> |
2 | <Project Sdk="WixToolset.Sdk"> | 2 | <Project> |
3 | <PropertyGroup> | 3 | <PropertyGroup> |
4 | <OutputType>Bundle</OutputType> | 4 | <OutputType>Bundle</OutputType> |
5 | <BA>customHyperlinkLicense</BA> | 5 | <BA>hyperlinkLicense</BA> |
6 | <UpgradeCode>{98ACBCF6-B54A-46AF-8990-DFB8795B965B}</UpgradeCode> | 6 | <UpgradeCode>{98ACBCF6-B54A-46AF-8990-DFB8795B965B}</UpgradeCode> |
7 | <Version Condition=" '$(Version)' == '' ">1.0.0.0</Version> | ||
8 | </PropertyGroup> | 7 | </PropertyGroup> |
9 | <ItemGroup> | 8 | <ItemGroup> |
10 | <Compile Include="..\..\Templates\Bundle.wxs" Link="Bundle.wxs" /> | 9 | <Compile Include="..\..\Templates\Bundle.wxs" Link="Bundle.wxs" /> |
11 | </ItemGroup> | 10 | </ItemGroup> |
12 | <ItemGroup> | 11 | <ItemGroup> |
13 | <ProjectReference Include="..\BafRelatedBundleVariableTesting\BafRelatedBundleVariableTesting.vcxproj" Properties="Platform=x86" ReferenceOutputAssembly="false" /> | 12 | <ProjectReference Include="..\BafRelatedBundleVariableTesting\BafRelatedBundleVariableTesting.vcxproj" Properties="Platform=x86" ReferenceOutputAssembly="false" /> |
14 | <ProjectReference Include="..\PackageA\PackageA.wixproj" /> | ||
15 | </ItemGroup> | 13 | </ItemGroup> |
16 | <ItemGroup> | ||
17 | <PackageReference Include="WixToolset.Bal.wixext" /> | ||
18 | </ItemGroup> | ||
19 | <Target Name="CopyManualInstructions" AfterTargets="AfterBuild"> | ||
20 | <Copy SourceFiles="ManualTests.txt" DestinationFiles="$(OutputPath)ManualTests.txt" /> | ||
21 | </Target> | ||
22 | </Project> | 14 | </Project> |
diff --git a/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleAv1.wixproj b/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleAv1.wixproj new file mode 100644 index 00000000..b2045deb --- /dev/null +++ b/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleAv1.wixproj | |||
@@ -0,0 +1,10 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | ||
2 | <Project Sdk="WixToolset.Sdk"> | ||
3 | <Import Project="BundleA.props" /> | ||
4 | <ItemGroup> | ||
5 | <ProjectReference Include="..\PackageAv1\PackageAv1.wixproj" /> | ||
6 | </ItemGroup> | ||
7 | <ItemGroup> | ||
8 | <PackageReference Include="WixToolset.Bal.wixext" /> | ||
9 | </ItemGroup> | ||
10 | </Project> \ No newline at end of file | ||
diff --git a/src/test/burn/TestData/Manual/BundleD/BundleD.wxs b/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleAv1.wxs index a877e214..4aba7a2f 100644 --- a/src/test/burn/TestData/Manual/BundleD/BundleD.wxs +++ b/src/test/burn/TestData/BAFunctionsTests/BundleAv1/BundleAv1.wxs | |||
@@ -1,15 +1,13 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | 1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> |
2 | 2 | ||
3 | 3 | ||
4 | <Wix xmlns="http://wixtoolset.org/schemas/v4/wxs" xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal"> | 4 | <Wix xmlns="http://wixtoolset.org/schemas/v4/wxs" xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal"> |
5 | <Fragment> | 5 | <Fragment> |
6 | <BootstrapperApplication Id="customHyperlinkLicense"> | 6 | <BootstrapperApplication> |
7 | <!-- WixStandardBootstrapperApplication.RtfLicense --> | ||
8 | <bal:WixStandardBootstrapperApplication LicenseUrl="" Theme="hyperlinkLicense" /> | ||
9 | <Payload SourceFile="$(var.BafRelatedBundleVariableTesting.TargetPath)" bal:BAFunctions="yes" /> | 7 | <Payload SourceFile="$(var.BafRelatedBundleVariableTesting.TargetPath)" bal:BAFunctions="yes" /> |
10 | </BootstrapperApplication> | 8 | </BootstrapperApplication> |
11 | <PackageGroup Id="BundlePackages"> | 9 | <PackageGroup Id="BundlePackages"> |
12 | <MsiPackage Id="PackageA" SourceFile="$(var.PackageA.TargetPath)" /> | 10 | <MsiPackage Id="PackageA" SourceFile="$(var.PackageAv1.TargetPath)" /> |
13 | </PackageGroup> | 11 | </PackageGroup> |
14 | <Variable Name="ANumber" bal:Overridable="yes" Value="42" Persisted="yes" /> | 12 | <Variable Name="ANumber" bal:Overridable="yes" Value="42" Persisted="yes" /> |
15 | <Variable Name="AString" bal:Overridable="yes" Value="This is a test" Persisted="yes" /> | 13 | <Variable Name="AString" bal:Overridable="yes" Value="This is a test" Persisted="yes" /> |
diff --git a/src/test/burn/TestData/BAFunctionsTests/BundleAv2/BundleAv2.wixproj b/src/test/burn/TestData/BAFunctionsTests/BundleAv2/BundleAv2.wixproj new file mode 100644 index 00000000..dee120d7 --- /dev/null +++ b/src/test/burn/TestData/BAFunctionsTests/BundleAv2/BundleAv2.wixproj | |||
@@ -0,0 +1,13 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | ||
2 | <Project Sdk="WixToolset.Sdk"> | ||
3 | <Import Project="..\BundleAv1\BundleA.props" /> | ||
4 | <PropertyGroup> | ||
5 | <Version>2.0.0.0</Version> | ||
6 | </PropertyGroup> | ||
7 | <ItemGroup> | ||
8 | <ProjectReference Include="..\PackageAv2\PackageAv2.wixproj" /> | ||
9 | </ItemGroup> | ||
10 | <ItemGroup> | ||
11 | <PackageReference Include="WixToolset.Bal.wixext" /> | ||
12 | </ItemGroup> | ||
13 | </Project> \ No newline at end of file | ||
diff --git a/src/test/burn/TestData/BAFunctionsTests/BundleAv2/BundleAv2.wxs b/src/test/burn/TestData/BAFunctionsTests/BundleAv2/BundleAv2.wxs new file mode 100644 index 00000000..8608512c --- /dev/null +++ b/src/test/burn/TestData/BAFunctionsTests/BundleAv2/BundleAv2.wxs | |||
@@ -0,0 +1,15 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | ||
2 | |||
3 | |||
4 | <Wix xmlns="http://wixtoolset.org/schemas/v4/wxs" xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal"> | ||
5 | <Fragment> | ||
6 | <BootstrapperApplication> | ||
7 | <Payload SourceFile="$(var.BafRelatedBundleVariableTesting.TargetPath)" bal:BAFunctions="yes" /> | ||
8 | </BootstrapperApplication> | ||
9 | <PackageGroup Id="BundlePackages"> | ||
10 | <MsiPackage Id="PackageA" SourceFile="$(var.PackageAv2.TargetPath)" /> | ||
11 | </PackageGroup> | ||
12 | <Variable Name="ANumber" bal:Overridable="yes" Value="4242" Persisted="yes" /> | ||
13 | <Variable Name="AString" bal:Overridable="yes" Value="This is a test v2" Persisted="yes" /> | ||
14 | </Fragment> | ||
15 | </Wix> | ||
diff --git a/src/test/burn/TestData/BAFunctionsTests/PackageAv1/PackageA.props b/src/test/burn/TestData/BAFunctionsTests/PackageAv1/PackageA.props new file mode 100644 index 00000000..ded7f36b --- /dev/null +++ b/src/test/burn/TestData/BAFunctionsTests/PackageAv1/PackageA.props | |||
@@ -0,0 +1,9 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | ||
2 | <Project> | ||
3 | <PropertyGroup> | ||
4 | <UpgradeCode>{F5E0E236-395D-4E7F-BE0A-00B20F7EAF4B}</UpgradeCode> | ||
5 | </PropertyGroup> | ||
6 | <ItemGroup> | ||
7 | <Compile Include="..\..\Templates\Package.wxs" Link="Package.wxs" /> | ||
8 | </ItemGroup> | ||
9 | </Project> \ No newline at end of file | ||
diff --git a/src/test/burn/TestData/BAFunctionsTests/PackageAv1/PackageAv1.wixproj b/src/test/burn/TestData/BAFunctionsTests/PackageAv1/PackageAv1.wixproj new file mode 100644 index 00000000..45d3b2c8 --- /dev/null +++ b/src/test/burn/TestData/BAFunctionsTests/PackageAv1/PackageAv1.wixproj | |||
@@ -0,0 +1,4 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | ||
2 | <Project Sdk="WixToolset.Sdk"> | ||
3 | <Import Project="PackageA.props" /> | ||
4 | </Project> \ No newline at end of file | ||
diff --git a/src/test/burn/TestData/BAFunctionsTests/PackageAv2/PackageAv2.wixproj b/src/test/burn/TestData/BAFunctionsTests/PackageAv2/PackageAv2.wixproj new file mode 100644 index 00000000..b419f663 --- /dev/null +++ b/src/test/burn/TestData/BAFunctionsTests/PackageAv2/PackageAv2.wixproj | |||
@@ -0,0 +1,7 @@ | |||
1 | <!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. --> | ||
2 | <Project Sdk="WixToolset.Sdk"> | ||
3 | <Import Project="..\PackageAv1\PackageA.props" /> | ||
4 | <PropertyGroup> | ||
5 | <Version>2.0.0.0</Version> | ||
6 | </PropertyGroup> | ||
7 | </Project> \ No newline at end of file | ||
diff --git a/src/test/burn/TestData/Manual/BundleD/ManualTests.txt b/src/test/burn/TestData/Manual/BundleD/ManualTests.txt deleted file mode 100644 index 309338cc..00000000 --- a/src/test/burn/TestData/Manual/BundleD/ManualTests.txt +++ /dev/null | |||
@@ -1,10 +0,0 @@ | |||
1 | BafRelatedBundleVariableTesting | ||
2 | # Building, Run initial build w/ no parameters, run a second (re)build w/ a /p:Version=1.1.0.0 (ensure it actually builds, as CLI params aren't accounted in the build optimization) | ||
3 | 1. Run BundleD.exe (v1.0). | ||
4 | 2. Click Install. | ||
5 | 3. Verify that the Bundle installs successfully. | ||
6 | 4. Run BundleD.exe (v1.1). | ||
7 | 5. Check the log file in %TEMP% There should be lines reporting: | ||
8 | [0708:04B4]i000: AString = This is a test | ||
9 | [0708:04B4]i000: ANumber = 42 | ||
10 | |||
diff --git a/src/test/burn/WixToolsetTest.BurnE2E/BAFunctionsTests.cs b/src/test/burn/WixToolsetTest.BurnE2E/BAFunctionsTests.cs new file mode 100644 index 00000000..5ca3d452 --- /dev/null +++ b/src/test/burn/WixToolsetTest.BurnE2E/BAFunctionsTests.cs | |||
@@ -0,0 +1,31 @@ | |||
1 | // Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. | ||
2 | |||
3 | namespace WixToolsetTest.BurnE2E | ||
4 | { | ||
5 | using WixTestTools; | ||
6 | using Xunit; | ||
7 | using Xunit.Abstractions; | ||
8 | |||
9 | public class BAFunctionsTests : BurnE2ETests | ||
10 | { | ||
11 | public BAFunctionsTests(ITestOutputHelper testOutputHelper) : base(testOutputHelper) { } | ||
12 | |||
13 | [RuntimeFact] | ||
14 | public void LogsPersistedRelatedBundleVariables() | ||
15 | { | ||
16 | this.CreatePackageInstaller("PackageAv1"); | ||
17 | this.CreatePackageInstaller("PackageAv2"); | ||
18 | var bundleAv1 = this.CreateBundleInstaller("BundleAv1"); | ||
19 | var bundleAv2 = this.CreateBundleInstaller("BundleAv2"); | ||
20 | |||
21 | bundleAv1.Install(); | ||
22 | bundleAv1.VerifyRegisteredAndInPackageCache(); | ||
23 | |||
24 | var bundleAv2InstallLogFilePath = bundleAv2.Install(); | ||
25 | bundleAv2.VerifyRegisteredAndInPackageCache(); | ||
26 | |||
27 | Assert.True(LogVerifier.MessageInLogFileRegex(bundleAv2InstallLogFilePath, @"Retrieved related bundle variable with BAFunctions: ANumber = 42")); | ||
28 | Assert.True(LogVerifier.MessageInLogFileRegex(bundleAv2InstallLogFilePath, @"Retrieved related bundle variable with BAFunctions: AString = This is a test")); | ||
29 | } | ||
30 | } | ||
31 | } | ||