// Copyright 2015 The Bazel Authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.devtools.build.lib.rules.repository;

import static com.google.devtools.build.lib.packages.Attribute.attr;
import static com.google.devtools.build.lib.packages.Type.STRING;

import com.google.devtools.build.lib.analysis.BaseRuleClasses.RootRule;
import com.google.devtools.build.lib.analysis.RuleDefinition;
import com.google.devtools.build.lib.analysis.RuleDefinitionEnvironment;
import com.google.devtools.build.lib.packages.RuleClass;
import com.google.devtools.build.lib.packages.RuleClass.Builder.RuleClassType;

/**
 * Base rule for rules in the WORKSPACE file.
 */
public class WorkspaceBaseRule implements RuleDefinition {
  @Override
  public RuleClass build(RuleClass.Builder builder, RuleDefinitionEnvironment environment) {
    return builder
        .exemptFromConstraintChecking("workspace rules aren't built for target environments")
        .add(
            attr("generator_name", STRING)
                .undocumented("internal")
                .nonconfigurable("internal attributes are non-configurable"))
        .add(
            attr("generator_function", STRING)
                .undocumented("internal")
                .nonconfigurable("internal attributes are non-configurable"))
        .add(
            attr("generator_location", STRING)
                .undocumented("internal")
                .nonconfigurable("internal attributes are non-configurable"))
        .build();
  }

  @Override
  public Metadata getMetadata() {
    return RuleDefinition.Metadata.builder()
        .name("$workspace_base_rule")
        .type(RuleClassType.ABSTRACT)
        .ancestors(RootRule.class)
        .build();
  }
}

@@ -800,16 +800,87 @@
 .STRING;
+%0Aimport static com.google.devtools.build.lib.packages.Type.STRING_DICT;
 %0A%0Aimport
@@ -2079,32 +2079,727 @@
 configurable%22))%0A
+        /* %3C!-- #BLAZE_RULE($workspace_base_rule).ATTRIBUTE(repo_mapping) --%3E%0A        A dictionary from local repository name to global repository name. This allows controls over%0A        workspace dependency resolution for dependencies of this repository.%0A%0A        %3Cp%3EFor example, an entry %3Ccode%3E%22@foo%22: %22@bar%22%3C/code%3E declares that, for any time this%0A        repository depends on %3Ccode%3E%22@foo%22%3C/code%3E (such as a dependency on%0A        %3Ccode%3E%22@foo//some:target%22%3C/code%3E), it should actually resolve that dependency within%0A        globally-declared %3Ccode%3E%22@bar%22%3C/code%3E (%3Ccode%3E%22@bar//some:target%22%3C/code%3E).%0A        %3C!-- #END_BLAZE_RULE.ATTRIBUTE --%3E */%0A        .add(attr(%22repo_mapping%22, STRING_DICT))%0A
         .build()

Document `repo_mapping` for native repository rules