# Dpkg::Deps::Simple - phpMan

## NAME
    [Dpkg::Deps::Simple] - represents a single dependency statement

## DESCRIPTION
    This class represents a single dependency statement. It has several
    interesting properties:

    package
        The package name (can be undef if the dependency has not been
        initialized or if the simplification of the dependency lead to its
        removal).

    relation
        The relational operator: "=", "<<", "<=", ">=" or ">>". It can be
        undefined if the dependency had no version restriction. In that case
        the following field is also undefined.

    version
        The version.

    arches
        The list of architectures where this dependency is applicable. It is
        undefined when there's no restriction, otherwise it is an array ref.
        It can contain an exclusion list, in that case each architecture is
        prefixed with an exclamation mark.

    archqual
        The arch qualifier of the dependency (can be undef if there is
        none). In the dependency "python:any (>= 2.6)", the arch qualifier
        is "any".

    restrictions
        The restrictions formula for this dependency. It is undefined when
        there is no restriction formula. Otherwise it is an array ref.

## METHODS
    $dep = [Dpkg::Deps::Simple]->new([$dep[, %opts]]);
        Creates a new object. Some options can be set through %opts:

        host_arch
            Sets the host architecture.

        build_arch
            Sets the build architecture.

        build_dep
            Specifies whether the parser should consider it a build
            dependency. Defaults to 0.

        tests_dep
            Specifies whether the parser should consider it a tests
            dependency. Defaults to 0.

    $dep->reset()
        Clears any dependency information stored in $dep so that
        $dep->is_empty() returns true.

    $dep->parse_string($dep_string)
        Parses the dependency string and modifies internal properties to
        match the parsed dependency.

    $dep->parse($fh, $desc)
        Parse a dependency line from a filehandle.

    $dep->load($filename)
        Parse a dependency line from $filename.

    $dep->output([$fh])
    "$dep"
        Returns a string representing the dependency. If $fh is set, it
        prints the string to the filehandle.

    $dep->save($filename)
        Save the dependency into the given $filename.

    $dep->implies($other_dep)
        Returns 1 when $dep implies $other_dep. Returns 0 when $dep implies
        NOT($other_dep). Returns undef when there is no implication. $dep
        and $other_dep do not need to be of the same type.

    $dep->get_deps()
        Returns a list of sub-dependencies, which for this object it means
        it returns itself.

    $dep->sort()
        This method is a no-op for this object.

    $dep->arch_is_concerned($arch)
        Returns true if the dependency applies to the indicated
        architecture.

    $dep->reduce_arch($arch)
        Simplifies the dependency to contain only information relevant to
        the given architecture. This object can be left empty after this
        operation. This trims off the architecture restriction list of these
        objects.

    $dep->has_arch_restriction()
        Returns the package name if the dependency applies only to a subset
        of architectures.

    $dep->profile_is_concerned()
        Returns true if the dependency applies to the indicated profile.

    $dep->reduce_profiles()
        Simplifies the dependency to contain only information relevant to
        the given profile. This object can be left empty after this
        operation. This trims off the profile restriction list of this
        object.

    $dep->get_evaluation($facts)
        Evaluates the dependency given a list of installed packages and a
        list of virtual packages provided. These lists are part of the
        [Dpkg::Deps::KnownFacts] object given as parameters.

        Returns 1 when it's true, 0 when it's false, undef when some
        information is lacking to conclude.

    $dep->simplify_deps($facts, @assumed_deps)
        Simplifies the dependency as much as possible given the list of
        facts (see class [Dpkg::Deps::KnownFacts]) and a list of other
        dependencies that are known to be true.

    $dep->is_empty()
        Returns true if the dependency is empty and doesn't contain any
        useful information. This is true when the object has not yet been
        initialized.

    $dep->merge_union($other_dep)
        Returns true if $dep could be modified to represent the union of
        both dependencies. Otherwise returns false.

## CHANGES
  Version 1.02 (dpkg 1.17.10)
    New methods: Add $dep->profile_is_concerned() and
    $dep->reduce_profiles().

  Version 1.01 (dpkg 1.16.1)
    New method: Add $dep->reset().

    New property: recognizes the arch qualifier "any" and stores it in the
    "archqual" property when present.

  Version 1.00 (dpkg 1.15.6)
    Mark the module as public.