blob: 3b836a219312c262ba14bc606a728f6d1a493dbb (
plain)
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
// Test to enforce rules over re-exports inlining from
// <https://github.com/rust-lang/rust/issues/109449>.
#![crate_name = "foo"]
mod private_module {
#[doc(hidden)]
pub struct Public;
#[doc(hidden)]
pub type Bar = ();
}
#[doc(hidden)]
mod module {
pub struct Public2;
pub type Bar2 = ();
}
#[doc(hidden)]
pub type Bar3 = ();
#[doc(hidden)]
pub struct FooFoo;
// Checking that re-exporting a `#[doc(hidden)]` item will NOT inline it.
pub mod single_reexport {
// @has 'foo/single_reexport/index.html'
// First we check that we have 4 type aliases.
// @count - '//*[@id="main-content"]/*[@class="item-table"]//code' 4
// Then we check that we have the correct link for each re-export.
// @!has - '//*[@href="struct.Foo.html"]' 'Foo'
// @has - '//*[@id="reexport.Foo"]/code' 'pub use crate::private_module::Public as Foo;'
pub use crate::private_module::Public as Foo;
// @!has - '//*[@href="type.Foo2.html"]' 'Foo2'
// @has - '//*[@id="reexport.Foo2"]/code' 'pub use crate::private_module::Bar as Foo2;'
pub use crate::private_module::Bar as Foo2;
// @!has - '//*[@href="type.Yo.html"]' 'Yo'
// @has - '//*[@id="reexport.Yo"]/code' 'pub use crate::Bar3 as Yo;'
pub use crate::Bar3 as Yo;
// @!has - '//*[@href="struct.Yo2.html"]' 'Yo2'
// @has - '//*[@id="reexport.Yo2"]/code' 'pub use crate::FooFoo as Yo2;'
pub use crate::FooFoo as Yo2;
// Checking that each file is also created as expected.
// @!has 'foo/single_reexport/struct.Foo.html'
// @!has 'foo/single_reexport/type.Foo2.html'
// @!has 'foo/single_reexport/type.Yo.html'
// @!has 'foo/single_reexport/struct.Yo2.html'
}
// However, re-exporting an item inheriting `#[doc(hidden)]` will inline it.
pub mod single_reexport_inherit_hidden {
// @has 'foo/single_reexport_inherit_hidden/index.html'
// @has - '//*[@href="struct.Foo3.html"]' 'Foo3'
pub use crate::module::Public2 as Foo3;
// @has - '//*[@href="type.Foo4.html"]' 'Foo4'
pub use crate::module::Bar2 as Foo4;
// @has 'foo/single_reexport_inherit_hidden/struct.Foo3.html'
// @has 'foo/single_reexport_inherit_hidden/type.Foo4.html'
}
pub mod single_reexport_no_inline {
// First we ensure that we only have re-exports and no inlined items.
// @has 'foo/single_reexport_no_inline/index.html'
// @count - '//*[@id="main-content"]/*[@class="small-section-header"]' 1
// @has - '//*[@id="main-content"]/*[@class="small-section-header"]' 'Re-exports'
// Now we check that we don't have links to the items, just `pub use`.
// @has - '//*[@id="main-content"]//*' 'pub use crate::private_module::Public as XFoo;'
// @!has - '//*[@id="main-content"]//a' 'XFoo'
#[doc(no_inline)]
pub use crate::private_module::Public as XFoo;
// @has - '//*[@id="main-content"]//*' 'pub use crate::private_module::Bar as Foo2;'
// @!has - '//*[@id="main-content"]//a' 'Foo2'
#[doc(no_inline)]
pub use crate::private_module::Bar as Foo2;
// @has - '//*[@id="main-content"]//*' 'pub use crate::Bar3 as Yo;'
// @!has - '//*[@id="main-content"]//a' 'Yo'
#[doc(no_inline)]
pub use crate::Bar3 as Yo;
// @has - '//*[@id="main-content"]//*' 'pub use crate::FooFoo as Yo2;'
// @!has - '//*[@id="main-content"]//a' 'Yo2'
#[doc(no_inline)]
pub use crate::FooFoo as Yo2;
// @has - '//*[@id="main-content"]//*' 'pub use crate::module::Public2 as Foo3;'
// @!has - '//*[@id="main-content"]//a' 'Foo3'
#[doc(no_inline)]
pub use crate::module::Public2 as Foo3;
// @has - '//*[@id="main-content"]//*' 'pub use crate::module::Bar2 as Foo4;'
// @!has - '//*[@id="main-content"]//a' 'Foo4'
#[doc(no_inline)]
pub use crate::module::Bar2 as Foo4;
}
// Checking that glob re-exports don't inline `#[doc(hidden)]` items.
pub mod glob_reexport {
// With glob re-exports, we don't inline `#[doc(hidden)]` items so only `module` items
// should be inlined.
// @has 'foo/glob_reexport/index.html'
// @count - '//*[@id="main-content"]/*[@class="small-section-header"]' 3
// @has - '//*[@id="main-content"]/*[@class="small-section-header"]' 'Re-exports'
// @has - '//*[@id="main-content"]/*[@class="small-section-header"]' 'Structs'
// @has - '//*[@id="main-content"]/*[@class="small-section-header"]' 'Type Aliases'
// Now we check we have 1 re-export and 2 inlined items.
// If not item from a glob re-export is visible, we don't show the re-export.
// @!has - '//*[@id="main-content"]//*' 'pub use crate::private_module::*;'
pub use crate::private_module::*;
// @has - '//*[@id="main-content"]//*' 'pub use crate::*;'
pub use crate::*;
// This one should be inlined.
// @!has - '//*[@id="main-content"]//*' 'pub use crate::module::*;'
// @has - '//*[@id="main-content"]//a[@href="struct.Public2.html"]' 'Public2'
// @has - '//*[@id="main-content"]//a[@href="type.Bar2.html"]' 'Bar2'
// And we check that the two files were created too.
// @has 'foo/glob_reexport/struct.Public2.html'
// @has 'foo/glob_reexport/type.Bar2.html'
pub use crate::module::*;
}
mod private {
/// Original.
pub struct Bar3;
}
// Checking that `#[doc(hidden)]` re-exports documentation isn't generated.
pub mod doc_hidden_reexport {
// @has 'foo/doc_hidden_reexport/index.html'
// Ensure there is only one item in this page and that it's a struct.
// @count - '//*[@class="item-name"]' 1
// @has - '//a[@class="struct"]' 'Reexport'
// Check that the `#[doc(hidden)]` re-export's attributes are not taken into account.
// @has - '//*[@class="desc docblock-short"]' 'Visible. Original.'
/// Visible.
pub use self::Bar3 as Reexport;
/// Hidden.
#[doc(hidden)]
pub use crate::private::Bar3;
}
|