ENH: improve controls for Time (issue #910)

- relocate some standard functionality to TimePaths to allow a lighter
  means of managing time directories without using the entire Time
  mechanism.

- optional enableLibs for Time construction (default is on)
  and a corresponding argList::noLibs() and "-no-libs" option

STYLE:

- mark Time::outputTime() as deprecated MAY-2016

- use pre-increment for runTime, although there is no difference in
  behaviour or performance.

applications/test/GAMGAgglomeration/Test-GAMGAgglomeration.C

@@ -70,7 +70,7 @@ int main(int argc, char *argv[])
     labelList cellToCoarse(identity(mesh.nCells()));
     labelListList coarseToCell(invertOneToMany(mesh.nCells(), cellToCoarse));
 
-    runTime++;
+    ++runTime;
 
     // Write initial agglomeration
     {
@@ -103,7 +103,7 @@ int main(int argc, char *argv[])
 
     for (label level = 0; level < agglom.size(); level++)
     {
-        runTime++;
+        ++runTime;
 
         Info<< "Time = " << runTime.timeName() << nl << endl;
 

applications/test/parallelOverset/laplacianDyMFoam.C

@@ -73,7 +73,7 @@ int main(int argc, char *argv[])
 
     Info<< "\nCorrecting boundary conditions on " << T.name() << nl << endl;
 
-    runTime++;
+    ++runTime;
 
     Info<< "Time = " << runTime.timeName() << nl << endl;
 

applications/test/parallelOverset/write.H

@@ -1,4 +1,4 @@
-    if (runTime.outputTime())
+    if (runTime.writeTime())
     {
         volVectorField gradT(fvc::grad(T));
 

applications/test/passiveParticle/Test-passiveParticle.C

@@ -67,7 +67,7 @@ int main(int argc, char *argv[])
 
         runTime.printExecutionTime(Info);
 
-        runTime++;
+        ++runTime;
         Pout<< "Writing particles to time " << runTime.timeName() << endl;
         particles.write();
     }

applications/test/timeSelector/Make/files

@@ -0,0 +1,3 @@
+Test-timeSelector.C
+
+EXE = $(FOAM_USER_APPBIN)/Test-timeSelector

applications/test/timeSelector/Make/options

@@ -0,0 +1 @@
+/* EXE_INC = */

applications/test/timeSelector/Test-timeSelector.C

@@ -0,0 +1,86 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2018 OpenCFD Ltd.
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+Description
+    Test TimePaths and timeSelectop
+\*---------------------------------------------------------------------------*/
+
+#include "argList.H"
+#include "IOstreams.H"
+#include "TimePaths.H"
+#include "timeSelector.H"
+
+using namespace Foam;
+
+bool print(const instantList& instants)
+{
+    if (instants.empty())
+    {
+        Info<<"    none" << nl << nl;
+        return false;
+    }
+
+    Info <<"(" << nl;
+
+    for (const instant& t : instants)
+    {
+        Info<<"    " << t << nl;
+    }
+
+    Info<<")" << nl << nl;
+
+    return true;
+}
+
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+//  Main program:
+
+int main(int argc, char *argv[])
+{
+    argList::addNote("Test timeSelector");
+
+    timeSelector::addOptions(true, true);
+    argList::noLibs();
+    argList::noFunctionObjects();
+
+    #include "setRootCase.H"
+
+    autoPtr<TimePaths> timePaths;
+
+    instantList times(TimePaths(args).times());
+
+    Info<<"Available times" << nl;
+
+    if (print(times))
+    {
+        times = timeSelector::select(times, args);
+
+        Info<< "Selected times" << nl;
+        print(times);
+    }
+
+    return 0;
+}
+
+// ************************************************************************* //

applications/test/wallDist/Test-wallDist.C

@@ -57,7 +57,7 @@ int main(int argc, char *argv[])
     const volScalarField& y = wallDist::New(mesh).y();
     y.write();
 
-    runTime++;
+    ++runTime;
 
     Info<< "Time now = " << runTime.timeName() << endl;