[rustdoc] Add tests for #[doc(hidden)] handling of items.

Author: obi1kenobi

tests/rustdoc-json/attrs/doc_hidden_default.rs

@@ -0,0 +1,19 @@
+#![no_std]
+
+// Without `--document-hidden-items`,
+// none of these items are present in rustdoc JSON.
+
+//@ !has "$.index[?(@.name=='func')]"
+#[doc(hidden)]
+pub fn func() {}
+
+//@ !has "$.index[?(@.name=='Unit')]"
+#[doc(hidden)]
+pub struct Unit;
+
+//@ !has "$.index[?(@.name=='hidden')]"
+#[doc(hidden)]
+pub mod hidden {
+    //@ !has "$.index[?(@.name=='Inner')]"
+    pub struct Inner;
+}

tests/rustdoc-json/attrs/doc_hidden_documented.rs

@@ -0,0 +1,17 @@
+//@ compile-flags: --document-hidden-items
+#![no_std]
+
+//@ is "$.index[?(@.name=='func')].attrs" '["#[doc(hidden)]"]'
+#[doc(hidden)]
+pub fn func() {}
+
+//@ is "$.index[?(@.name=='Unit')].attrs" '["#[doc(hidden)]"]'
+#[doc(hidden)]
+pub struct Unit;
+
+//@ is "$.index[?(@.name=='hidden')].attrs" '["#[doc(hidden)]"]'
+#[doc(hidden)]
+pub mod hidden {
+    //@ is "$.index[?(@.name=='Inner')].attrs" '[]'
+    pub struct Inner;
+}

tests/rustdoc/attributes-doc-hidden-default.rs

@@ -0,0 +1,19 @@
+#![crate_name = "foo"]
+
+// Without `--document-hidden-items`,
+// none of these items are present in rustdoc output.
+
+//@ !has foo/fn.func.html
+#[doc(hidden)]
+pub fn func() {}
+
+//@ !has foo/struct.Unit.html
+#[doc(hidden)]
+pub struct Unit;
+
+//@ !has foo/hidden/index.html
+#[doc(hidden)]
+pub mod hidden {
+    //@ !has foo/hidden/struct.Inner.html
+    pub struct Inner;
+}

tests/rustdoc/attributes-doc-hidden-documented.rs

@@ -0,0 +1,24 @@
+//@ compile-flags: -Z unstable-options --document-hidden-items
+#![crate_name = "foo"]
+
+//@ has foo/fn.func.html
+//@ has foo/fn.func.html '//pre[@class="rust item-decl"]' '#[doc(hidden)]'
+#[doc(hidden)]
+pub fn func() {}
+
+//@ has foo/struct.Unit.html
+//@ has foo/struct.Unit.html '//pre[@class="rust item-decl"]' '#[doc(hidden)]'
+#[doc(hidden)]
+pub struct Unit;
+
+// FIXME: It isn't clear how to check if this module is marked hidden within
+//        the current XPath engine and with the current HTML structure.
+//        The module name and the hidden-ness element are siblings, not parent-child,
+//        which seems to make the XPath query run into engine limitations and fail.
+//@ has foo/hidden/index.html
+#[doc(hidden)]
+pub mod hidden {
+    //@ has foo/hidden/struct.Inner.html
+    //@ !has foo/hidden/struct.Inner.html '//pre[@class="rust item-decl"]' '#[doc(hidden)]'
+    pub struct Inner;
+}