#region Apache License
//
// Licensed to the Apache Software Foundation (ASF) under one or more 
// contributor license agreements. See the NOTICE file distributed with
// this work for additional information regarding copyright ownership. 
// The ASF licenses this file to you 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.
//
#endregion

using System;
using System.Diagnostics.CodeAnalysis;

namespace log4net.Config;

/// <summary>
/// Assembly level attribute that specifies the logging repository for the assembly.
/// </summary>
/// <remarks>
/// <para>
/// Assemblies are mapped to logging repository. This attribute specified 
/// on the assembly controls
/// the configuration of the repository. The <see cref="Name"/> property specifies the name
/// of the repository that this assembly is a part of. The <see cref="RepositoryType"/>
/// specifies the type of the <see cref="Repository.ILoggerRepository"/> object 
/// to create for the assembly. If this attribute is not specified or a <see cref="Name"/> 
/// is not specified then the assembly will be part of the default shared logging repository.
/// </para>
/// <para>
/// This attribute can only be specified on the assembly and may only be used
/// once per assembly.
/// </para>
/// </remarks>
/// <author>Nicko Cadell</author>
/// <author>Gert Driesen</author>
[AttributeUsage(AttributeTargets.Assembly)]
[Log4NetSerializable]
public sealed class RepositoryAttribute : Attribute
{
  /// <summary>
  /// Initializes a new instance of the <see cref="RepositoryAttribute" /> class.
  /// </summary>
  /// <remarks>
  /// <para>
  /// Default constructor.
  /// </para>
  /// </remarks>
  public RepositoryAttribute()
  { }

  /// <summary>
  /// Initialize a new instance of the <see cref="RepositoryAttribute" /> class 
  /// with the name of the repository.
  /// </summary>
  /// <param name="name">The name of the repository.</param>
  /// <remarks>
  /// <para>
  /// Initialize the attribute with the name for the assembly's repository.
  /// </para>
  /// </remarks>
  public RepositoryAttribute(string name) => Name = name;

  /// <summary>
  /// Gets or sets the name of the logging repository.
  /// </summary>
  /// <value>
  /// The string name to use as the name of the repository associated with this
  /// assembly.
  /// </value>
  /// <remarks>
  /// <para>
  /// This value does not have to be unique. Several assemblies can share the
  /// same repository. They will share the logging configuration of the repository.
  /// </para>
  /// </remarks>
  [System.Diagnostics.CodeAnalysis.SuppressMessage("Design", "CA1019:Define accessors for attribute arguments")]
  public string? Name { get; set; }

  /// <summary>
  /// Gets or sets the type of repository to create for this assembly.
  /// </summary>
  /// <value>
  /// The type of repository to create for this assembly.
  /// </value>
  /// <remarks>
  /// <para>
  /// The type of the repository to create for the assembly.
  /// The type must implement the <see cref="Repository.ILoggerRepository"/>
  /// interface.
  /// </para>
  /// <para>
  /// This will be the type of repository created when 
  /// the repository is created. If multiple assemblies reference the
  /// same repository then the repository is only created once using the
  /// <see cref="RepositoryType" /> of the first assembly to call into the 
  /// repository.
  /// </para>
  /// </remarks>
  [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)] 
  public Type? RepositoryType { get; set; }
}