limit docs.rs to 5 API tags (#679)

Co-authored-by: Cameron Taggart <[email protected]>

services/CHANGELOG.md

@@ -1,6 +1,8 @@
 # 0.2 (2022-03)
 
-- generated from azure-rest-api-specs [commit from 2022-03-02](https://github.com/Azure/azure-rest-api-specs/commit/c56b44b794ff17caad4d31c6ab64b07e28253504)
+- [#672](https://github.com/Azure/azure-sdk-for-rust/pull/672) generated from azure-rest-api-specs [commit from 2022-03-02](https://github.com/Azure/azure-rest-api-specs/commit/c56b44b794ff17caad4d31c6ab64b07e28253504)
+- [#675](https://github.com/Azure/azure-sdk-for-rust/pull/675) use Basic Information tag for default version
+- [#634](https://github.com/Azure/azure-sdk-for-rust/issues/634) limit docs.rs to 5 API tags
 
 # 0.1 (2022-01)
 

services/autorust/codegen/examples/gen_svc.rs

@@ -1,6 +1,10 @@
 // cargo run --example gen_svc --release
 // https://github.com/Azure/azure-rest-api-specs/blob/master/specification/batch/data-plane
-use autorust_codegen::{self, cargo_toml, get_svc_readmes, lib_rs, path, Config, PropertyName, SpecReadme};
+use autorust_codegen::{
+    self,
+    cargo_toml::{self},
+    get_svc_readmes, lib_rs, path, Config, PropertyName, SpecReadme,
+};
 use std::{collections::HashSet, fs, path::PathBuf};
 
 const OUTPUT_FOLDER: &str = "../svc";

services/autorust/codegen/examples/mgmt_tags.rs

@@ -9,9 +9,9 @@ fn main() -> Result<()> {
     for (i, spec) in get_mgmt_readmes()?.iter().enumerate() {
         println!("{} {}", i + 1, spec.spec());
         for tag in spec.config()?.tags() {
-            println!("  {}", &tag.tag);
-            for input_file in &tag.input_files {
-                println!("    {}", input_file);
+            println!("  {}", &tag.name());
+            for input_file in &tag.input_files() {
+                println!("    {}", input_file.display());
             }
             tag_count += 1;
         }

services/autorust/codegen/examples/svc_tags.rs

@@ -9,9 +9,9 @@ fn main() -> Result<()> {
     for (i, spec) in get_svc_readmes()?.iter().enumerate() {
         println!("{} {}", i + 1, spec.spec());
         for tag in spec.config()?.tags() {
-            println!("  {}", &tag.tag);
-            for input_file in &tag.input_files {
-                println!("    {}", input_file);
+            println!("  {}", &tag.name());
+            for input_file in &tag.input_files() {
+                println!("    {}", input_file.display());
             }
             tag_count += 1;
         }

services/autorust/codegen/src/cargo_toml.rs

@@ -15,7 +15,13 @@ pub enum Error {
 pub fn create(crate_name: &str, tags: &[&Tag], default_tag: Option<&str>, path: &Path) -> Result<()> {
     let file = File::create(path).map_err(|source| Error::IoError { source })?;
     let mut file = LineWriter::new(file);
-    let default = get_default_feature(tags, default_tag);
+    let default_feature = get_default_feature(tags, default_tag);
+
+    // https://docs.rs/about/metadata
+    let docs_rs_features = docs_rs_features(tags, &default_feature);
+    let docs_rs_features: Vec<_> = docs_rs_features.iter().map(|s| format!("\"{}\"", s)).collect();
+    let docs_rs_features = docs_rs_features.join(", ");
+
     file.write_all(
         format!(
             r#"# generated by AutoRust
@@ -41,15 +47,15 @@ azure_identity = {{ path = "../../../sdk/identity", version = "0.1" }}
 tokio = {{ version = "1.0", features = ["macros"] }}
 
 [package.metadata.docs.rs]
-all-features = true
+features = [{}]
 
 [features]
 default = ["{}", "enable_reqwest"]
 enable_reqwest = ["azure_core/enable_reqwest"]
 enable_reqwest_rustls = ["azure_core/enable_reqwest_rustls"]
 no-default-version = []
 "#,
-            crate_name, default
+            crate_name, docs_rs_features, default_feature
         )
         .as_bytes(),
     )
@@ -77,3 +83,24 @@ fn get_default_feature(tags: &[&Tag], default_tag: Option<&str>) -> String {
         None => tags[0].rust_feature_name(),
     }
 }
+
+const MAX_DOCS_RS_FEATURES: usize = 4;
+const NO_DEFAULT_VERSION: &str = "no-default-version";
+
+/// Get a list of features to document at docs.rs in addition the default
+fn docs_rs_features(tags: &[&Tag], default_feature: &str) -> Vec<String> {
+    let mut features: Vec<_> = tags
+        .iter()
+        .filter_map(|tag| {
+            let feature = tag.rust_feature_name();
+            if feature == default_feature {
+                None
+            } else {
+                Some(feature)
+            }
+        })
+        .collect();
+    features.truncate(MAX_DOCS_RS_FEATURES);
+    features.insert(0, NO_DEFAULT_VERSION.to_owned());
+    features
+}