require("strict")

--------------------------------------------------------------------------
-- Lmod License
--------------------------------------------------------------------------
--
--  Lmod is licensed under the terms of the MIT license reproduced below.
--  This means that Lmod is free software and can be used for both academic
--  and commercial purposes at absolutely no cost.
--
--  ----------------------------------------------------------------------
--
--  Copyright (C) 2008-2025 Robert McLay
--
--  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, sublicense, and/or sell copies of the Software, and to
--  permit persons to whom the Software is furnished to do so, subject
--  to the following conditions:
--
--  The above copyright notice and this permission notice shall be
--  included in all copies or substantial portions of the Software.
--
--  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.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
--  BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
--  ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
--  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
--  THE SOFTWARE.
--
--------------------------------------------------------------------------

require("parseVersion")
require("collectionFileA")
require("serializeTbl")
require("string_utils")
require("utils")

local DirTree     = require("DirTree")
local FrameStk    = require("FrameStk")
local LocationT   = require("LocationT")
local M           = {}
local MRC         = require("MRC")
local cosmic      = require("Cosmic"):singleton()
local dbg         = require("Dbg"):dbg()
local getenv      = os.getenv
local s_moduleA   = false
local sort        = table.sort

-- print(__FILE__() .. ':' .. __LINE__())
----------------------------------------------------------------------
-- We use the trick of penalizing the parsed version string to mark defaults
-- The order is as follows based on the ascii table:
--     *     -> Words like beta start with an asterisk
--   [0-9]   -> Numbers are zero patted to nine places
--     M     -> A module with no version (meta-module)
--     ^     -> Versions marked by default or .version or .modulerc
--     s     -> Versions marked by System .modulerc
--     u     -> Versions marked by User   .modulerc
--     ~     -> All files are less than tilde (~)


local function l_addPV(sn, v, pV, wV)
   if (next(v.fileT) ~= nil) then
      for fullName, vv in pairs(v.fileT) do
         local pattern = '^' .. sn:escape() .. '/'
         local version = fullName:gsub(pattern,"")
         local bn      = barefilename(fullName)
         local pV1     = parseVersion(bn)
         local value   = false
         local wV1     = pV1

         if (v.defaultT and next(v.defaultT) ~= nil) then
            value = v.defaultT.value
         end
         if (value == bn or value == fullName) then
            wV1 = '^' .. pV1:sub(2,-1)
         end

         vv.pV = (pV == "") and pV1 or pV .. '/'.. pV1
         vv.wV = (wV == "") and wV1 or wV .. '/'.. wV1
      end
   end
   if (next(v.dirT) ~= nil) then
      for fullName, vv in pairs(v.dirT) do
         local dirN   = barefilename(fullName)
         local pV1    = parseVersion(dirN):gsub("%.%*zfinal$","")
         local wV1    = pV1
         local value  = false

         if (v.defaultT and next(v.defaultT) ~= nil) then
            value = v.defaultT.value
         end

         if (value == dirN or value == fullName) then
            wV1 = '^' .. pV1:sub(2,-1)
         end
         local new_pV = (pV == "") and pV1  or pV .. '/' .. pV1
         local new_wV = (wV == "") and wV1  or wV .. '/' .. wV1
         l_addPV(sn, vv, new_pV, new_wV)
      end
   end
   return v
end

local function l_GroupIntoModules(self, level, maxdepth, mpath, dirT, T)
   if (next(dirT.fileT) ~= nil) then
      for fullName, v in pairs(dirT.fileT) do
         local defaultT = {}
         local defaultA = {}
         if (next(dirT.defaultT) ~= nil and (dirT.defaultT.value == fullName)) then
            defaultT = dirT.defaultT
         end
         if (next(dirT.defaultA) ~= nil) then
            defaultA = dirT.defaultA
         end
         local fileT = {}
         fileT[fullName] = {Version = false, canonical = "", fn = v.fn, luaExt = v.luaExt, mpath = mpath,
                            pV = "M.*zfinal", wV = "M.*zfinal", propT = v.propT}
         T[fullName] = { fileT = fileT, defaultT = defaultT, defaultA = defaultA, dirT = {}}
      end
   end
   for path, v in pairs(dirT.dirT) do
      local prefix = extractFullName(mpath, path)
      if (next(v.defaultT) ~= nil or next(v.dirT) == nil or level == maxdepth) then
         if (next(v.dirT) ~= nil) then
            self.__isNVV = true
         end
         T[prefix] = l_addPV(prefix,v,"","")
      else
         l_GroupIntoModules(self, level+1, maxdepth, mpath, v, T)
      end
   end
end

local function l_build(self, maxdepthT, dirA)
   dbg.start{"ModuleA l_build()"}
   local moduleA = {}
   local sz      = #dirA
   --dbg.print{"#dirA: ",sz,"\n"}
   for i = 1,sz do
      local mpath    = dirA[i].mpath
      dbg.print{"mpath: ",mpath,"\n"}
      local dirT     = dirA[i].dirT
      local T        = {}
      local maxdepth = maxdepthT[mpath] or -1
      local level    = 1
      l_GroupIntoModules(self, level, maxdepth, mpath, dirT, T)
      moduleA[#moduleA + 1] = {mpath = mpath, brokenA = dirA[i].brokenA, T = T}
   end
   dbg.fini("ModuleA l_build")
   return moduleA
end

local function l_check_depth(searchA, idx, fileT, dirT)
   dbg.print{"ModuleA l_check_depth: idx: ",idx,"\n"}
   if (not dirT or idx < 1 or next(dirT) == nil) then
      return true, idx, nil
   end
   local name       = searchA[idx][1]
   dbg.print{"ModuleA l_check_depth: name: ",name,"\n"}
   
   if (dirT[name]) then
      idx           = idx - 1
      return l_check_depth(searchA, idx, dirT.fileT, dirT.dirT)
   end

   if (cosmic:value("LMOD_DOT_HIDDEN_LOAD_ALIAS") == "yes" and (not name:find("/"))) then
      local dotName = "." .. name
      if (dirT[dotName]) then
         idx          = idx - 1
         local vv     = dirT[dotName]
         return l_check_depth(searchA, idx, vv.fileT, vv.dirT)
      end
   end

   if (fileT[name]) then
      dbg.print{"ModuleA l_check_depth: found fileT[name]: ",name,"\n"}
      return true, idx, nil
   end

   if (cosmic:value("LMOD_DOT_HIDDEN_LOAD_ALIAS") == "yes" and (not name:find("/"))) then
      local dotName = "." .. name
      if (fileT[dotName]) then
         dbg.print{"ModuleA l_check_depth: found fileT[dotName]: ",dotName,"\n"}
         return true, idx, nil
      end
   end

   local extra = ""
   local bndPat = "[-+_.=a-zA-Z]"
   if (not name:sub(-1):find(bndPat)) then
      extra = "[-+_.=]"
   end
   local keyPat = name:escape() .. extra .. ".*"
   dbg.print{"keyPat: ", keyPat,"\n"}
   for k, v in pairs(fileT) do
      dbg.print{"k: ", k,", name:",name,"\n"}
      if (k:find(keyPat)) then
         dbg.print{"ModuleA l_check_depth: found fileT[name]: ",name,"\n"}
         return true, idx, nil
      end
   end

   dbg.print{"ModuleA l_check_depth: did not find name: ",name,"\n"}
   -- Did not find name so return false
   return false, idx, nil
end


local function l_find_vA(name, moduleA)
   -- First find sn and collect all v's into vA
   dbg.start{"ModuleA: l_find_vA(name:\"",name,"\", moduleA"}
   local versionStr = false
   local vA         = {}
   local sn         = name
   local sz
   local idx
   local dirT

   -- Build searchA to contain the list of module names.
   -- So "intel/arm64/17/17.0.1" becomes:
   -- searchA : 
   -- { 
   --    {"intel/arm64/17/17.0.1",false}, 
   --    {"intel/arm64/17","17.0.1"}, 
   --    {"intel/arm64","17/17.0.1"},
   --    {"intel","arm64/17/17.0.1"}
   -- }
   
   local searchA    = {}
   searchA[#searchA + 1] = {sn, false}
   while (true) do
      sn = sn:match("(.*/).*")
      if (not sn) then break end
      sn                    = sn:sub(1,-2)  -- strip trailing slash
      searchA[#searchA + 1] = {sn, name:sub(sn:len()+2, -1)}
   end

   dbg.printT("searchA",searchA)


   local done        = false
   local found       = false

   sz = #searchA
   for j = #searchA, 1, -1 do
      sn = searchA[j][1]
      dbg.print{"j: ",j,", sn: ",sn,"\n"}
      for i = 1, #moduleA do
         local v = moduleA[i].T[sn]
      
         if (v) then
            dbg.print{"found sn in moduleA\n"}
            dbg.printT("v",v)
            -- We have match the top level name.  Now we have to match
            -- the keys in dirT to keep this "v"
         
            versionStr = searchA[j][2]
            found, idx, dirT = l_check_depth(searchA, j-1, v.fileT, v.dirT)
            dbg.print{"found: ",found,"\n"}
            if (found) then
               vA[#vA + 1] = v
               done = true
            end
         end
      end
      if (done) then break end
      sz = sz - 1
   end
            
   -- If there is nothing in vA then the name is not in moduleA.
   if (next(vA) == nil) then
      dbg.print{"next(vA) == nil\n"}
      dbg.fini("l_find_vA")
      return nil
   end

   dbg.print{"sn: ",sn,", versionStr: ",versionStr,"\n"}
   dbg.printT("l_find_vA: vA",vA)
   dbg.fini("l_find_vA")
   return sn, versionStr, vA
end

local function l_find_vB(sn, versionStr, vA)
   dbg.start{"l_find_vB(sn: ",sn,", versionStr: ",versionStr,", vA"}
   local fullStr = versionStr
   local vB      = {}

   dbg.print{"l_find_vB: #vA: ",type(vA) == "table" and #vA or 0,"\n"}
   dbg.printT("vA", vA)
   for i = 1,#vA do
      local v
      local vv   = vA[i]
      local done = (versionStr == false)
      local idx  = 1
      local vStr = versionStr
      local jdx  = idx
      while (not done) do
         idx = versionStr:find("/",jdx)
         if (idx == nil) then
            done = true
            vStr = versionStr
         else
            vStr = versionStr:sub(1,idx-1)
            jdx  = idx + 1
         end
         local key   = pathJoin(sn, vStr)
         local value = vv.dirT[key]
         dbg.print{"key: ",key,", has value: ", (not (not value)),"\n"}
         if (value) then
            v = value
            --if (vStr == versionStr) then
            --   fullStr = nil
            --end
         else
            done = true
         end
      end
      if (versionStr == false or next{v} == nil) then
         vB[#vB + 1] = vv
      elseif (v) then
         vB[#vB + 1] = v
      end
   end
   dbg.print{"fullStr: ",fullStr,"\n"}
   dbg.printT("l_find_vB: vB",vB)
   dbg.fini("l_find_vB")
   return fullStr, vB
end

local function l_search(name, moduleA)
   dbg.start{"ModuleA l_search(\"",name,"\", moduleA)"}
   -- First find sn and collect all v's into vA

   local sn, versionStr, vA = l_find_vA(name, moduleA)
   if (sn == nil) then return nil end
   dbg.print{"sn: ",sn,", versionStr: ",versionStr,"\n"}
   local fullStr, vB        = l_find_vB(sn, versionStr, vA)

   dbg.print{"name: ",name,", sn: ",sn,", versionStr: ",versionStr, " fullStr: ",fullStr,"\n"}

   local extended_default = cosmic:value("LMOD_EXTENDED_DEFAULT")

   local fileA = {}
   for i = 1,#vB do
      fileA[i] = {}
      collectFileA(sn, fullStr, extended_default, vB[i], fileA[i])
   end
   dbg.printT("fileA",fileA)
   dbg.print{"sn: ",sn,", versionStr: ",versionStr,"\n"}
   dbg.fini("ModuleA l_search")
   return sn, versionStr, fileA
end

function M.applyWeights(self,fullNameDfltT)
   dbg.start{"ModuleA:applyWeights(fullNameDfltT)"}
   for fullName, weight in pairs(fullNameDfltT) do
      repeat
         local sn, versionStr, vA = l_find_vA(fullName, self.__moduleA)
         if (sn == nil) then break end
         local fullStr, vB        = l_find_vB(sn,  versionStr, vA)

         for i = 1, #vB do
            local v = vB[i]
            if (next(v.fileT) ~= nil) then
               if (fullStr) then
                  local k = pathJoin(sn, fullStr)
                  local vv = v.fileT[k]
                  if (vv) then
                     local idx = vv.wV:match("^.*()/")
                     if (idx) then
                        vv.wV = vv.wV:sub(1,idx) .. weight .. vv.wV:sub(idx+2,-1)
                     else
                        vv.wV = weight .. vv.wV:sub(2,-1)
                     end
                  end
               end
            end
         end
      until true
   end
   dbg.fini("ModuleA:applyWeights")
end


function M.__find_all_defaults(self)
   dbg.start{"ModuleA:__find_all_defaults()"}
   local moduleA     = self.__moduleA
   local defaultT    = self.__defaultT
   local mrc         = MRC:singleton()
   local show_hidden = MRC:show_hidden()

   dbg.printT("defaultT",defaultT)

   local function l_find_all_defaults_helper(level,isNVV, mpath, sn, v)
      local weight, keepLooking, fn, idx
      local ext, count, myfullName
      local found = false

      if (defaultT[sn]) then
         weight      = defaultT[sn].weight
         count       = defaultT[sn].count
         keepLooking = true
         if ( level == 1 and isNVV) then
            keepLooking = false
         end
      else
         weight      = " "
         keepLooking = true
         count       = 0
      end

      if (keepLooking) then
         if (next(v.fileT) ~= nil) then
            for fullName, vv in pairs(v.fileT) do
               local wV      = mrc:find_wght_for_fullName(fullName, vv.wV)
               local resultT = mrc:isVisible{fullName=fullName, sn=sn, fn=vv.fn, visibleT = {soft=true}, mpath=vv.mpath}
               local vis     = (resultT.isVisible or isMarked(wV))

               dbg.print{"l_find_all_defaults_helper: fullName: ",fullName, ", vis: ",vis,", resultT.kind: ",resultT.kind,"\n"}
               ------------------------------------------------------------
               -- When hidden modules are shown (show_hidden=true) then
               -- the count goes up.  However only visible modules can have
               -- the (D) marking (i.e. default) unless they are marked defaults.

               if (show_hidden or vis) then
                  count = count + ((resultT.count) and 1 or 0)
                  if (vis and (wV > weight) and (resultT.moduleKindT.kind ~= "hidden" or isMarked(wV)))  then
                     found      = true
                     weight     = wV
                     ext        = vv.luaExt and ".lua" or ""
                     fn         = pathJoin(mpath, fullName .. ext)
                     myfullName = fullName
                  end
               end
            end
            if (found) then
               defaultT[sn] = { weight = weight, fullName = myfullName,
                                fn = fn, count = count}
            end
            if (defaultT[sn]) then
               defaultT[sn].count = count
            end
         end
      end
      if (next(v.dirT) ~= nil) then
         for name, vv in pairs(v.dirT) do
            l_find_all_defaults_helper(level+1,isNVV, mpath, sn, vv)
         end
      end
   end

   local isNVV      = self.__isNVV
   local level      = 0
   for i = 1, #moduleA do
      local T      = moduleA[i].T
      local mpath  = moduleA[i].mpath
      for sn, v in pairs(T) do
         l_find_all_defaults_helper(level+1,isNVV, mpath, sn, v)
      end
   end

   local t = {}
   for k,v in pairs(defaultT) do
      t[v.fn] = { sn = k, count = v.count, fullName = v.fullName, weight = v.weight }
   end
   self.__defaultT = t
   dbg.fini("ModuleA:__find_all_defaults")
end


function M.build_availA(self)
   dbg.start{"ModuleA:build_availA()"}
   local mrc         = MRC:singleton()

   local function l_build_availA_helper(mpath, sn, v, A)
      local icnt = #A
      if (next(v.fileT) ~= nil) then
         for fullName, vv in pairs(v.fileT) do
            dbg.print{"fullName: ",fullName,"\n"}
            local resultT = mrc:isVisible{fullName=fullName, sn=sn, fn=vv.fn, mpath=vv.mpath}
            if (resultT.isVisible) then
               icnt    = icnt + 1
               dbg.print{"saving fullName: ",fullName,"\n"}
               A[icnt] = { fullName = fullName, pV = pathJoin(sn,vv.pV), fn = vv.fn, sn = sn,
                           propT = vv.propT, provides = vv.provides, moduleKindT = resultT.moduleKindT,
                           forbiddenT = mrc:isForbidden{fullName=fullName, sn = sn, fn = vv.fn, mpath=vv.mpath},
                         }
            end
         end
      end
      if (next(v.dirT) ~= nil) then
         for name, vv in pairs(v.dirT) do
            l_build_availA_helper(mpath, sn, vv, A)
         end
      end
   end


   local moduleA = self.__moduleA
   local availA  = {}
   local cmp     = (cosmic:value("LMOD_CASE_INDEPENDENT_SORTING") == "yes") and
                    case_independent_cmp or regular_cmp

   for i = 1, #moduleA do
      local T         = moduleA[i].T
      local mpath     = moduleA[i].mpath
      availA[i]       = {mpath = mpath, A= {}}
      for sn, v in pairs(T) do
         l_build_availA_helper(mpath, sn, v, availA[i].A)
      end
      sort(availA[i].A, cmp)
   end
   dbg.fini("ModuleA:build_availA")
   return availA
end

function M.inherited_search(self, search_fullName, orig_fn)
   --dbg.start{"ModuleA:inherited_search(",search_fullName,",",orig_fn,")"}

   local function l_inherited_search_helper(key, count, v)
      --dbg.start{"l_inherited_search_helper(",key,",", count,",v)"}
      local fn = false
      if (next(v.fileT) ~= nil) then
         local entryT = v.fileT[search_fullName]
         if (entryT) then
            if (count == 0) then
               if (entryT.fn == orig_fn) then
                  fn    = entryT.fn
                  count = 1
               end
            elseif (count == 1) then
               fn    = entryT.fn
               count = 2
            end
            --dbg.print{"found matching v.fileT\n"}
            --dbg.fini("l_inherited_search_helper")
            return fn , count
         end
      end
      if (next(v.dirT) ~= nil) then
         for name, vv in pairs(v.dirT) do
            fn, count = l_inherited_search_helper(name, count, vv)
            if (fn) then
               --dbg.fini("l_inherited_search_helper")
               return fn, count
            end
         end
      end

      --dbg.fini("l_inherited_search_helper")
      return fn, count
   end

   local moduleA = self.__moduleA
   local count   = 0
   local fn      = false
   for i = 1, #moduleA do
      local T     = moduleA[i].T
      local mpath = moduleA[i].mpath
      --dbg.print{"mpath: ",mpath,"\n"}
      for key, v in pairs(T) do
         fn, count = l_inherited_search_helper(key, count, v)
         if (count == 2) then
            --dbg.print{"found fn: ",fn,"\n"}
            --dbg.fini("ModuleA:inherited_search")
            return fn
         end
      end
   end
   --dbg.fini("ModuleA:inherited_search")
   return fn
end

function M.search(self, name)
   dbg.start{"ModuleA:search(\"",name,"\")"}
   if (self.__isNVV) then
      local sn, versionStr, fileA = l_search(name, self.__moduleA)
      dbg.fini("ModuleA:search")
      return sn, versionStr, fileA
   end

   if (not self.__locationT) then
      self.__locationT = LocationT:new(self.__moduleA)
   end

   local sn, versionStr, fileA = self.__locationT:search(name)
   dbg.fini("ModuleA:search")
   return sn, versionStr, fileA
end

local function l_checkforNV(T)
   for sn, vv in pairs(T) do
      if (next(vv.dirT) ~= nil) then
         return false
      end
   end
   return true
end

local function l_build_from_spiderT(spiderT, brokenT)
   dbg.start{"ModuleA l_build_from_spiderT(spiderT)"}
   local find_first = cosmic:value("LMOD_TMOD_FIND_FIRST")
   local frameStk   = FrameStk:singleton()
   local mt         = frameStk:mt()
   local mpathA     = mt:modulePathA()
   local moduleA    = {}
   local isNV       = find_first == "no"
   
   for i = 1, #mpathA do
      local mpath = mpathA[i]
      if (isDir(mpath)) then
         local T = spiderT[mpath]
         local B = nil
         if (brokenT and next(brokenT) ~= nil) then
            B = deepcopy(brokenT[mpath])
         end
         if (T and next(T) ~= nil) then
            dbg.print{"found mpath: ", mpath, "in spiderT\n"}
            moduleA[#moduleA+1] = { mpath = mpath, T = deepcopy(T), brokenA = B}
            if (isNV) then
               isNV = l_checkforNV(T)
            end
         end
      end
   end
   dbg.fini("ModuleA l_build_from_spiderT")
   return moduleA, not isNV
end

------------------------------------------------------------
-- This routine updates the self.__moduleA array when
-- MODULEPATH changes.  It has to know about how the Ctor
-- works so any changes there might be reflected here.

function M.update(self, t)
   t                   = t or {}
   dbg.start{"ModuleA:update(spider_cache = ",t.spider_cache,")"}
   local frameStk      = FrameStk:singleton()
   local mt            = frameStk:mt()
   local varT          = frameStk:varT()
   local currentMPATH  = varT[ModulePath]:expand()
   local clearDblSlash = true
   local mpathA        = path2pathA(currentMPATH,':', clearDblSlash)
   local terse         = optionTbl().terse

   ------------------------------------------------------------
   -- Store away the old moduleA entries in T (hash table).
   -- They will be reused as request by the new module path
   -- array.

   local T = {}
   local moduleA = self.__moduleA
   for i = 1,#moduleA do
      local mpath = moduleA[i].mpath
      T[mpath]    = moduleA[i].T
   end

   ------------------------------------------------------------
   -- Loop over new mpathA and either build or reuse from
   -- before.

   moduleA = {}
   for i = 1,#mpathA do
      repeat
         local mpath = mpathA[i]
         if (not isDir(mpath)) then break end
         local entry = T[mpath]
         if (entry) then
            --dbg.print{"Reusing mpath: ",mpath,"\n"}
            moduleA[#moduleA + 1] = { mpath = mpath, T = entry }
         else
            --dbg.print{"building mpath: ",mpath,"\n"}
            local spiderT = false
            local brokenT = false
            local dbT     = false
            if (t.spider_cache) then
               local cache = require("Cache"):singleton{quiet=terse, buildCache=true}
               spiderT, dbT, brokenT = cache:build()
            end
            local mA_obj = self:__new( {mpath}, mt:maxDepthT(), getModuleRCT(), spiderT)
            local mA     = mA_obj:moduleA()
            local idx = false
            for i = 1,#mA do
               if (mA[i].mpath == mpath) then
                  idx = i
                  break;
               end
            end
            if (not idx) then
               -- Only fall back to DirTree rebuild if we were using cached spider data.
               -- This indicates a dynamic MODULEPATH change after cache was built,
               -- not a normal cache building scenario.
               local spiderCacheActive = (next(spiderT) ~= nil)
               if (spiderCacheActive) then
                  dbg.print{"mpath not in cache, rebuilding: ",mpath,"\n"}
                  local mA_obj = self:__new( {mpath}, mt:maxDepthT(), getModuleRCT(), {})
                  local mA     = mA_obj:moduleA()
                  for i = 1,#mA do
                     if (mA[i].mpath == mpath) then
                        idx = i
                        break;
                     end
                  end
               end
            end
            
            if (not idx) then
               local spiderUsed = (next(spiderT) ~= nil) and "yes" or "no"
               local errMsg = "Did not find mpath '" .. mpath .. "' in moduleA data (spider_cache=" ..
                             spiderUsed .. "). This may indicate a filesystem issue or invalid MODULEPATH entry."
               LmodError{msg="e_Unable_2_Load",name=errMsg}
            end
            moduleA[#moduleA + 1] = { mpath = mA[idx].mpath, T = mA[idx].T}

            ------------------------------------------------------------------
            -- must transfer isNVV state over from new mpath entry.
            if (not self.__isNVV) then
               self.__isNVV = mA_obj:isNVV()
            end
         end
      until true
   end
   self.__defaultT  = {}
   self.__locationT = false
   self.__moduleA   = moduleA
   mt:updateMPathA(mpathA)
   dbg.fini("ModuleA:update")
end


function M.__new(self, mpathA, maxdepthT, moduleRCT, spiderT, brokenT)
   dbg.start{"ModuleA:__new()"}
   local o          = {}
   local find_first = cosmic:value("LMOD_TMOD_FIND_FIRST")
   setmetatable(o,self)

   local dirTree   = false
   self.__index    = self
   o.__isNVV       = (find_first ~= "no")
   spiderT         = spiderT or {}
   if (next(spiderT) ~= nil) then
      o.__spiderBuilt        = true
      dbg.print{"calling l_build_from_spiderT()\n"}
      o.__moduleA, o.__isNVV = l_build_from_spiderT(spiderT, brokenT)
   else
      dbg.print{"calling DirTree:new()\n"}
      dirTree         = DirTree:new(mpathA)
      dbg.printT("dirTree",dirTree:dirA())
      o.__spiderBuilt = false
      o.__moduleA     = l_build(o, maxdepthT, dirTree:dirA())
      dbg.printT("moduleA",o.__moduleA)
      dbg.print{"isNVV: ",o.__isNVV,"\n"}
   end

   o.__locationT   = false
   o.__defaultT    = {}


   dbg.fini("ModuleA:__new")
   return o
end

function M.moduleA(self)
   return self.__moduleA
end

function M.isNVV(self)
   return self.__isNVV
end

function M.setSpiderBuilt(self, value)
   self.__spiderBuilt = value
end

function M.spiderBuilt(self)
   return self.__spiderBuilt
end

function M.locationT(self)
   if (self.__isNVV) then
      return {}
   end
   if (not self.__locationT) then
      self.__locationT = LocationT:new(self.__moduleA)
   end
   return self.__locationT:locationT()
end

function M.defaultT(self)
   local exact_match = cosmic:value("LMOD_EXACT_MATCH")
   if (exact_match == "yes") then
      return self.__defaultT
   end

   if (next(self.__defaultT) == nil) then
      self:__find_all_defaults()
   end
   return self.__defaultT
end

function M.singleton(self, t)
   dbg.start{"ModuleA:singleton(t)"}
   t               = t or {}
   local resetFlag = t.resetFlag or false
   dbg.print{"resetFlag: ",resetFlag,"\n"}
   if (t.reset or (s_moduleA and s_moduleA:spiderBuilt())) then
      dbg.print{"Wiping out old value of s_moduleA, t.reset: ",t.reset,", s_moduleA:spiderBuilt(): ",(s_moduleA and s_moduleA:spiderBuilt()),"\n"}
      resetFlag = true
      self:__clear{testing=t.reset}
   end
   if (not s_moduleA) then
      local frameStk = FrameStk:singleton()
      local mt       = frameStk:mt()
      local spiderT  = false
      local dbT      = false
      local brokenT  = false

      if (t.spider_cache) then
         local cache           = require("Cache"):singleton{quiet=optionTbl().terse, buildCache=true}
         spiderT, dbT, brokenT = cache:build()
         dbg.printT("spiderT",spiderT)
         dbg.printT("brokenT",brokenT)
      end
      s_moduleA = self:__new(mt:modulePathA(), mt:maxDepthT(), getModuleRCT(), spiderT, brokenT)
      if (resetFlag) then
         s_moduleA:setSpiderBuilt(false)
      end
      dbg.print{"After ModuleA:__new: s_moduleA:spiderBuilt(): ",(s_moduleA and s_moduleA:spiderBuilt()),"\n"}
   end

   dbg.fini("ModuleA:singleton")
   return s_moduleA
end



function M.__clear(self, t)
   dbg.start{"ModuleA:__clear()"}
   t = t or {}
   local MT = require("MT")
   s_moduleA = false
   if (t.testing) then
      FrameStk:__clear{testing=true}
      local Cache = require("Cache")
      Cache:__clear()
   end
   MT:__clearMT{testing=true}
   dbg.fini("ModuleA:__clear")
end

return M
