You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

CommandBuilder.cs 4.9 kB

9 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. using System;
  2. using System.Linq;
  3. using System.Threading.Tasks;
  4. using System.Collections.Generic;
  5. using Microsoft.Extensions.DependencyInjection;
  6. namespace Discord.Commands.Builders
  7. {
  8. public class CommandBuilder
  9. {
  10. private readonly List<PreconditionAttribute> _preconditions;
  11. private readonly List<ParameterBuilder> _parameters;
  12. private readonly List<string> _aliases;
  13. public ModuleBuilder Module { get; }
  14. internal Func<ICommandContext, object[], IServiceProvider, Task> Callback { get; set; }
  15. public string Name { get; set; }
  16. public string Summary { get; set; }
  17. public string Remarks { get; set; }
  18. public string PrimaryAlias { get; set; }
  19. public RunMode RunMode { get; set; }
  20. public int Priority { get; set; }
  21. public IReadOnlyList<PreconditionAttribute> Preconditions => _preconditions;
  22. public IReadOnlyList<ParameterBuilder> Parameters => _parameters;
  23. public IReadOnlyList<string> Aliases => _aliases;
  24. //Automatic
  25. internal CommandBuilder(ModuleBuilder module)
  26. {
  27. Module = module;
  28. _preconditions = new List<PreconditionAttribute>();
  29. _parameters = new List<ParameterBuilder>();
  30. _aliases = new List<string>();
  31. }
  32. //User-defined
  33. internal CommandBuilder(ModuleBuilder module, string primaryAlias, Func<ICommandContext, object[], IServiceProvider, Task> callback)
  34. : this(module)
  35. {
  36. Discord.Preconditions.NotNull(primaryAlias, nameof(primaryAlias));
  37. Discord.Preconditions.NotNull(callback, nameof(callback));
  38. Callback = callback;
  39. PrimaryAlias = primaryAlias;
  40. _aliases.Add(primaryAlias);
  41. }
  42. public CommandBuilder WithName(string name)
  43. {
  44. Name = name;
  45. return this;
  46. }
  47. public CommandBuilder WithSummary(string summary)
  48. {
  49. Summary = summary;
  50. return this;
  51. }
  52. public CommandBuilder WithRemarks(string remarks)
  53. {
  54. Remarks = remarks;
  55. return this;
  56. }
  57. public CommandBuilder WithRunMode(RunMode runMode)
  58. {
  59. RunMode = runMode;
  60. return this;
  61. }
  62. public CommandBuilder WithPriority(int priority)
  63. {
  64. Priority = priority;
  65. return this;
  66. }
  67. public CommandBuilder AddAliases(params string[] aliases)
  68. {
  69. for (int i = 0; i < aliases.Length; i++)
  70. {
  71. var alias = aliases[i] ?? "";
  72. if (!_aliases.Contains(alias))
  73. _aliases.Add(alias);
  74. }
  75. return this;
  76. }
  77. public CommandBuilder AddPrecondition(PreconditionAttribute precondition)
  78. {
  79. _preconditions.Add(precondition);
  80. return this;
  81. }
  82. public CommandBuilder AddParameter<T>(string name, Action<ParameterBuilder> createFunc)
  83. {
  84. var param = new ParameterBuilder(this, name, typeof(T));
  85. createFunc(param);
  86. _parameters.Add(param);
  87. return this;
  88. }
  89. public CommandBuilder AddParameter(string name, Type type, Action<ParameterBuilder> createFunc)
  90. {
  91. var param = new ParameterBuilder(this, name, type);
  92. createFunc(param);
  93. _parameters.Add(param);
  94. return this;
  95. }
  96. internal CommandBuilder AddParameter(Action<ParameterBuilder> createFunc)
  97. {
  98. var param = new ParameterBuilder(this);
  99. createFunc(param);
  100. _parameters.Add(param);
  101. return this;
  102. }
  103. internal CommandInfo Build(ModuleInfo info, CommandService service)
  104. {
  105. //Default name to primary alias
  106. if (Name == null)
  107. Name = PrimaryAlias;
  108. if (_parameters.Count > 0)
  109. {
  110. var lastParam = _parameters[_parameters.Count - 1];
  111. var firstMultipleParam = _parameters.FirstOrDefault(x => x.IsMultiple);
  112. if ((firstMultipleParam != null) && (firstMultipleParam != lastParam))
  113. throw new InvalidOperationException($"Only the last parameter in a command may have the Multiple flag. Parameter: {firstMultipleParam.Name} in {PrimaryAlias}");
  114. var firstRemainderParam = _parameters.FirstOrDefault(x => x.IsRemainder);
  115. if ((firstRemainderParam != null) && (firstRemainderParam != lastParam))
  116. throw new InvalidOperationException($"Only the last parameter in a command may have the Remainder flag. Parameter: {firstRemainderParam.Name} in {PrimaryAlias}");
  117. }
  118. return new CommandInfo(this, info, service);
  119. }
  120. }
  121. }