xref: /aosp_15_r20/external/bazel-skylib/docs/directory_providers_doc.md (revision bcb5dc7965af6ee42bf2f21341a2ec00233a8c8a)
1<!-- Generated with Stardoc: http://skydoc.bazel.build -->
2
3Skylib module containing providers for directories.
4
5<a id="DirectoryInfo"></a>
6
7## DirectoryInfo
8
9<pre>
10DirectoryInfo(<a href="#DirectoryInfo-entries">entries</a>, <a href="#DirectoryInfo-transitive_files">transitive_files</a>, <a href="#DirectoryInfo-path">path</a>, <a href="#DirectoryInfo-human_readable">human_readable</a>, <a href="#DirectoryInfo-get_path">get_path</a>, <a href="#DirectoryInfo-get_file">get_file</a>, <a href="#DirectoryInfo-get_subdirectory">get_subdirectory</a>,
11              <a href="#DirectoryInfo-glob">glob</a>)
12</pre>
13
14Information about a directory
15
16**FIELDS**
17
18
19| Name  | Description |
20| :------------- | :------------- |
21| <a id="DirectoryInfo-entries"></a>entries |  (Dict[str, Either[File, DirectoryInfo]]) The entries contained directly within. Ordered by filename    |
22| <a id="DirectoryInfo-transitive_files"></a>transitive_files |  (depset[File]) All files transitively contained within this directory.    |
23| <a id="DirectoryInfo-path"></a>path |  (string) Path to all files contained within this directory.    |
24| <a id="DirectoryInfo-human_readable"></a>human_readable |  (string) A human readable identifier for a directory. Useful for providing error messages to a user.    |
25| <a id="DirectoryInfo-get_path"></a>get_path |  (Function(str) -> DirectoryInfo\|File) A function to return the entry corresponding to the joined path.    |
26| <a id="DirectoryInfo-get_file"></a>get_file |  (Function(str) -> File) A function to return the entry corresponding to the joined path.    |
27| <a id="DirectoryInfo-get_subdirectory"></a>get_subdirectory |  (Function(str) -> DirectoryInfo) A function to return the entry corresponding to the joined path.    |
28| <a id="DirectoryInfo-glob"></a>glob |  (Function(include, exclude, allow_empty=False)) A function that works the same as native.glob.    |
29
30
31<a id="create_directory_info"></a>
32
33## create_directory_info
34
35<pre>
36create_directory_info(<a href="#create_directory_info-kwargs">kwargs</a>)
37</pre>
38
39
40
41**PARAMETERS**
42
43
44| Name  | Description | Default Value |
45| :------------- | :------------- | :------------- |
46| <a id="create_directory_info-kwargs"></a>kwargs |  <p align="center"> - </p>   |  none |
47
48
49