ENH: Added NO_MODULE and COMPONENTS options to improve flexibility of the command. Re-implemented argument parsing to be simpler and more robust.

Source/cmFindPackageCommand.cxx

@@ -54,44 +54,40 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args)
     return false;
     }
 
+  // Record options.
   this->Name = args[0];
-
-  // Build a list of required components.
-  std::string components;
-  const char* components_sep = "";
   bool quiet = false;
   bool required = false;
-  if(args.size() > 1)
+  bool no_module = false;
-    {
+  std::string components;
+  const char* components_sep = "";
+
+  // Parse the arguments.
+  bool doing_components = false;
   cmsys::RegularExpression version("^[0-9.]+$");
   bool haveVersion = false;
   for(unsigned int i=1; i < args.size(); ++i)
     {
-      if(!haveVersion && version.find(args[i].c_str()))
+    if(args[i] == "QUIET")
-        {
-        haveVersion = true;
-        }
-      else if(args[i] == "QUIET")
       {
       quiet = true;
+      doing_components = false;
+      }
+    else if(args[i] == "NO_MODULE")
+      {
+      no_module = true;
+      doing_components = false;
       }
     else if(args[i] == "REQUIRED")
       {
-        // The package is required.
       required = true;
-
+      doing_components = true;
-        // Look for a list of required components.
-        while(++i < args.size())
-          {
-          // Stop looking when a known keyword argument is
-          // encountered.
-          if((args[i] == "QUIET") ||
-             (args[i] == "REQUIRED"))
-            {
-            --i;
-            break;
       }
-          else
+    else if(args[i] == "COMPONENTS")
+      {
+      doing_components = true;
+      }
+    else if(doing_components)
       {
       // Set a variable telling the find script this component
       // is required.
@@ -103,7 +99,9 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args)
       components += args[i];
       components_sep = ";";
       }
-          }
+    else if(!haveVersion && version.find(args[i].c_str()))
+      {
+      haveVersion = true;
       }
     else
       {
@@ -117,9 +115,10 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args)
   // Store the list of components.
   std::string components_var = Name + "_FIND_COMPONENTS";
   this->Makefile->AddDefinition(components_var.c_str(), components.c_str());
-    }
 
   // See if there is a Find<name>.cmake module.
+  if(!no_module)
+    {
     bool foundModule = false;
     if(!this->FindModule(foundModule, quiet, required))
       {
@@ -129,6 +128,7 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args)
       {
       return true;
       }
+    }
 
   // No find module.  Assume the project has a CMake config file.  Use
   // a <NAME>_DIR cache variable to locate it.

Source/cmFindPackageCommand.h

@@ -65,8 +65,8 @@ public:
   virtual const char* GetFullDocumentation()
     {
     return
-      "  FIND_PACKAGE(<name> [major.minor] [QUIET]\n"
+      "  FIND_PACKAGE(<name> [major.minor] [QUIET] [NO_MODULE]\n"
-      "               [REQUIRED [componets...]])\n"
+      "               [[REQUIRED|COMPONENTS] [componets...]])\n"
       "Finds and loads settings from an external project.  <name>_FOUND will "
       "be set to indicate whether the package was found.  Settings that "
       "can be used when <name>_FOUND is true are package-specific.  The "
@@ -74,6 +74,7 @@ public:
       "Directories listed in CMAKE_MODULE_PATH are searched for files called "
       "\"Find<name>.cmake\".  If such a file is found, it is read and "
       "processed by CMake, and is responsible for finding the package.  "
+      "This first step may be skipped by using the NO_MODULE option.  "
       "If no such file is found, it is expected that the package is another "
       "project built by CMake that has a \"<name>Config.cmake\" file.  "
       "A cache entry called <name>_DIR is created and is expected to be set "
@@ -86,7 +87,8 @@ public:
       "generated.  If REQUIRED is specified and the package is not found, "
       "a FATAL_ERROR is generated and the configure step stops executing.  "
       "A package-specific list of components may be listed after the "
-      "REQUIRED option.";
+      "REQUIRED option, or after the COMPONENTS option if no REQUIRED "
+      "option is given.";
     }
   
   cmTypeMacro(cmFindPackageCommand, cmCommand);