/// <summary>
/// Determine whether the journal entry affects the supported minor faction's influence in the system.
/// </summary>
/// <param name="supportedMinorFaction">
/// The name of the supported minor faction. This cannot be null.
/// </param>
/// <param name="journalEntryFaction">
/// The faction affeted by the journal entry. For example, it was a mission supplier or the payer of combat bonds. If null or empty, assumed to be the station controlling faction.
/// </param>
/// <param name="stationControllingFaction">
/// The faction controlling the station. This cannot be null.
/// </param>
/// <param name="stationMinorFactions">
/// The minor factions present but not controlling the station. This cannot be null.
/// </param>
/// <returns>
/// A <see cref="FactionInfluence"/> indicating what affect it had on minor faction influence.
/// </returns>
public static FactionInfluence GetFactionInfluence(string supportedMinorFaction, string journalEntryFaction, string stationControllingFaction, IEnumerable <string> stationMinorFactions)
{
if (supportedMinorFaction is null)
{
throw new ArgumentNullException(nameof(supportedMinorFaction));
}
if (string.IsNullOrEmpty(journalEntryFaction))
{
journalEntryFaction = stationControllingFaction;
}
if (string.IsNullOrEmpty(stationControllingFaction))
{
throw new ArgumentException($"'{nameof(stationControllingFaction)}' cannot be null or empty", nameof(stationControllingFaction));
}
if (stationMinorFactions is null)
{
throw new ArgumentNullException(nameof(stationMinorFactions));
}
FactionInfluence result = FactionInfluence.None;
if (supportedMinorFaction == journalEntryFaction)
{
result = FactionInfluence.Increase;
}
else
{
IEnumerable <string> factions = stationMinorFactions.Concat(new[] { stationControllingFaction });
if (factions.Contains(supportedMinorFaction) && factions.Contains(journalEntryFaction))
{
result = FactionInfluence.Decrease;
}
}
return(result);
}
/// <summary>
/// Add the bounty if it is relevant to the minor faction.
/// </summary>
/// <param name="pilotState">
/// A <see cref="PilotState"/> representing data associated with the pilot, such as the current station or system.
/// </param>
/// <param name="galaxyState">
/// A <see cref="GalaxyState"/> reoresenting the Elite: Dangerous universe the pilot plays in.
/// </param>
/// <param name="supportedMinorFaction">
/// The supported minor faction name. This must <b>exactly</b> match the name in the journal.
/// </param>
/// <param name="entry">
/// A <see cref="JObject"/> representing the journal entry.
/// </param>
/// <returns>
/// Will never return <see cref="SummaryEntry"/> objects.
/// </returns>
/// <exception cref="ArgumentNullException">
/// No argument can be null.
/// </exception>
public override IEnumerable <SummaryEntry> Process(PilotState pilotState, GalaxyState galaxyState, string supportedMinorFaction, JObject entry)
{
if (supportedMinorFaction is null)
{
throw new ArgumentNullException(nameof(supportedMinorFaction));
}
if (entry is null)
{
throw new ArgumentNullException(nameof(entry));
}
if (pilotState.LastDockedStation == null)
{
throw new InvalidOperationException("Has not docked at a station");
}
if (!galaxyState.Systems.ContainsKey(pilotState.LastDockedStation.SystemAddress))
{
throw new InvalidOperationException($"System address { pilotState.LastDockedStation.SystemAddress } not found");
}
string systemName = galaxyState.GetSystemName(pilotState.LastDockedStation.SystemAddress);
Station station = pilotState.LastDockedStation;
List <SummaryEntry> result = new List <SummaryEntry>();
if (entry.Value <string>(TypePropertyName) == BountyValue)
{
var categorizedEntries = entry.Value <JArray>(FactionsPropertyName)
.Select(e => (JObject)e)
.Select(e => new { Entry = e, FactionInfluence = GetFactionInfluence(supportedMinorFaction, e.Value <string>(FactionPropertyName), station.ControllingMinorFaction, galaxyState.Systems[pilotState.LastDockedStation.SystemAddress].MinorFactions) });
result.AddRange(categorizedEntries
.Where(e => e.FactionInfluence == FactionInfluence.Increase)
.Select(e => new RedeemVoucherSummaryEntry(GetTimeStamp(entry), systemName, true, entry.Value <string>(TypePropertyName), e.Entry.Value <int>(AmountPropertyName))));
result.AddRange(categorizedEntries
.Where(e => e.FactionInfluence == FactionInfluence.Decrease)
.Select(e => new RedeemVoucherSummaryEntry(GetTimeStamp(entry), systemName, false, entry.Value <string>(TypePropertyName), e.Entry.Value <int>(AmountPropertyName))));
}
else
{
FactionInfluence factionInfluence = GetFactionInfluence(supportedMinorFaction, entry.Value <string>(FactionPropertyName), station.ControllingMinorFaction, galaxyState.Systems[pilotState.LastDockedStation.SystemAddress].MinorFactions);
if (factionInfluence != FactionInfluence.None)
{
result.Add(new RedeemVoucherSummaryEntry(GetTimeStamp(entry), systemName, factionInfluence == FactionInfluence.Increase, entry.Value <string>(TypePropertyName), entry.Value <int>(AmountPropertyName)));
}
}
return(result);
}