spack-tutorial/outputs/scripting/spack-python-db-query-help.out at d11832fc33a4e0df3a894f159b979ca66c8d7100 · scheibelp/spack-tutorial · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
>>> import spack.store
>>> help(spack.store.STORE.db.query)
Help on method query in module spack.database:

query(query_spec: Union[str, ForwardRef('spack.spec.Spec'), NoneType] = None, *, predicate_fn: Optional[Callable[[spack.database.InstallRecord], bool]] = None, installed: Union[bool, spack.enums.InstallRecordStatus] = True, explicit: Optional[bool] = None, start_date: Optional[datetime.datetime] = None, end_date: Optional[datetime.datetime] = None, in_buildcache: Optional[bool] = None, hashes: Optional[List[str]] = None, origin: Optional[str] = None, install_tree: str = 'all') -> List[ForwardRef('spack.spec.Spec')] method of spack.database.Database instance
    Queries the Spack database including all upstream databases.

    Args:
        query_spec:  if query_spec is ``None``, match all specs in the database.
            If it is a spec, return all specs matching ``spec.satisfies(query_spec)``.

        predicate_fn: optional predicate taking an InstallRecord as argument, and returning
            whether that record is selected for the query. It can be used to craft criteria
            that need some data for selection not provided by the Database itself.

        installed: if ``True``, includes only installed specs in the search. If ``False`` only
            missing specs, and if ``any``, all specs in database. If an InstallStatus or
            iterable of InstallStatus, returns specs whose install status matches at least
            one of the InstallStatus.

        explicit: a spec that was installed following a specific user request is marked as
            explicit. If instead it was pulled-in as a dependency of a user requested spec
            it's considered implicit.

        start_date: if set considers only specs installed from the starting date.

        end_date: if set considers only specs installed until the ending date.

        in_buildcache: specs that are marked in this database as part of an associated binary
            cache are ``in_buildcache``. All other specs are not. This field is used for
            querying mirror indices. By default, it does not check this status.

        hashes: list of hashes used to restrict the search

        install_tree: query 'all' (default), 'local', 'upstream', or upstream path

        origin: origin of the spec
(END)