getDepList               package:tools               R Documentation

_F_u_n_c_t_i_o_n_s _t_o _R_e_t_r_i_e_v_e _D_e_p_e_n_d_e_n_c_y _I_n_f_o_r_m_a_t_i_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     Given a dependency matrix, will create a 'DependsList' object for
     that package which will include the dependencies for that matrix,
     which ones are installed, which unresolved dependencies were found
     online, which unresolved dependencies were not found online, and
     any R dependencies.

_U_s_a_g_e:

     getDepList(depMtrx, instPkgs, recursive = TRUE, local = TRUE,
                reduce = TRUE, lib.loc = NULL)

     pkgDepends(pkg, recursive = TRUE, local = TRUE, reduce = TRUE,
                lib.loc = NULL)

_A_r_g_u_m_e_n_t_s:

 depMtrx: A dependency matrix as from 'package.dependencies'

     pkg: The name of the package

instPkgs: A matrix specifying all packages installed on the local
          system, as from 'installed.packages'

recursive: Whether or not to include indirect dependencies

   local: Whether or not to search only locally

  reduce: Whether or not to collapse all sets of dependencies to a
          minimal value

 lib.loc: What libraries to use when looking for installed packages. 
          'NULL' indicates all library directories in the user's
          '.libPaths()'.

_D_e_t_a_i_l_s:

     The function 'pkgDepends' is a convenience function which wraps
     'getDepList' and takes as input a package name.  It will then
     query 'installed.packages' and also generate a dependency matrix,
     calling 'getDepList' with this information and returning the
     result.

     These functions will retrieve information about the dependencies
     of the matrix, resulting in a 'DependsList' object.  This is a
     list with four elements:

     _D_e_p_e_n_d_s A vector of the dependencies for this package.

     _I_n_s_t_a_l_l_e_d A vector of the dependencies which have been satisfied
          by the currently installed packages.

     _F_o_u_n_d A list representing the dependencies which are not in
          'Installed' but were found online.  This list has element
          names which are the URLs for the repositories in which
          packages were found and the elements themselves are vectors
          of package names which were found in the respective
          repositories.  If 'local=TRUE', the 'Found' element will
          always be empty.

     _R Any R version dependencies.

     If 'recursive' is 'TRUE', any package that is specified as a
     dependency will in turn have its dependencies included (and so
     on), these are known as indirect dependencies.  If 'recursive' is 
     'FALSE', only the dependencies directly stated by the package will
      be used.

     If 'local' is 'TRUE', the system will only look at the user's
     local install and not online to find unresolved dependencies.

     If 'reduce' is 'TRUE', the system will collapse the fields in the
     'DependsList' object such that a minimal set of dependencies are
     specified (for instance if there was 'foo, foo (>= 1.0.0), foo (>=
     1.3.0', it would only return 'foo (>= 1.3.0)').

_V_a_l_u_e:

     An object of class '"DependsList"'.

_A_u_t_h_o_r(_s):

     Jeff Gentry

_S_e_e _A_l_s_o:

     'installFoundDepends'

_E_x_a_m_p_l_e_s:

     pkgDepends("tools", local = FALSE)

