static void ReleaseMain(string[] args)
        {
            Console.Write("Text> ");
            string text;

            string input = Console.ReadLine().ToUpper().Replace(" ", "").ToUpper();

            if (input[0] == '\\')
            {
                text = GetTextFromFile(input.Substring(1)).ToUpper();
            }
            else
            {
                text = input;
            }

            foreach (char c in text)
            {
                if (!validCharacters.Contains(c))
                {
                    Console.WriteLine($"Error: Invalid character in text ({c})");
                    return;
                }
            }

            int keyLengthSelection = KeyLengthSelection(text);

            Console.Write("Automatically decipher text (0/1)?> ");
            bool autoDecipher = int.Parse(Console.ReadLine()) != 0;

            if (autoDecipher)
            {
                string[] offsetTextSelections = FrequencyAnalysis.SplitTextByOffset(text, keyLengthSelection);

                string[] decipheredStrings = new string[offsetTextSelections.Length];
                int[]    shiftAmounts      = new int[offsetTextSelections.Length];

                for (int i = 0; i < decipheredStrings.Length; i++)
                {
                    string selection = offsetTextSelections[i];

                    double _;
                    Dictionary <char, double> selectionProportions = FrequencyAnalysis.CharFrequencyToCharProportion(FrequencyAnalysis.GetTextCharFrequency(selection));
                    Dictionary <char, char>   optimalMapping       = FrequencyAnalysis.GetOptimalCharacterMapping(selectionProportions,
                                                                                                                  EnglishLetterFrequency.GetLetterProportions(),
                                                                                                                  out _,
                                                                                                                  out shiftAmounts[i]);

                    decipheredStrings[i] = FrequencyAnalysis.DecipherTextByMapping(selection, optimalMapping);
                }

                string fullDeciphering = FrequencyAnalysis.ReconstructTextFromOffsetSelections(decipheredStrings);

                Console.WriteLine("Keyword: " + ProgramMath.GetKeywordFromOffsets(shiftAmounts));
                Console.WriteLine("Deciphered Text:");
                Console.WriteLine(fullDeciphering);
            }
            else
            {
                string keyword;
                string fullDeciphering = ManualMappingDeciphering.RunDeciphering(text,
                                                                                 keyLengthSelection,
                                                                                 out keyword);

                Console.WriteLine("Keyword: " + keyword);
                Console.WriteLine("Deciphered Text:");
                Console.WriteLine(fullDeciphering);
            }
        }
        public static string RunDeciphering(string originalText,
                                            int keyLength,
                                            out string keyword)
        {
            //TODO: allow for keyLength bigger than seperateKeyColors.Length
            Debug.Assert(keyLength < seperateKeyColors.Length);

            string[] originalSelections = FrequencyAnalysis.SplitTextByOffset(originalText, keyLength);

            int[] selectionShifts = new int[originalSelections.Length];
            for (int i = 0; i < originalSelections.Length; i++)
            {
                selectionShifts[i] = 0;
            }

            #region Instructions

            PrintSeperator();

            Console.WriteLine("To shift a selection with id i by n (n can be negative), use \"{i}:{n}\"");
            Console.WriteLine("To set the current mapping to a calculated optimal mapping, use SET OPTIMAL");
            Console.WriteLine("To print the text in one color, use PRINT PLAIN");

            PrintSeperator();

            for (int i = 0; i < keyLength; i++)
            {
                Console.ForegroundColor = seperateKeyColors[i];
                Console.Write(i + " ");
            }
            Console.ForegroundColor = defaultConsoleColor;
            Console.WriteLine();

            PrintSeperator();

            #endregion

            bool running = true;
            while (running)
            {
                Console.WriteLine("Current Keyword: " + ProgramMath.GetKeywordFromOffsets(selectionShifts));

                Console.WriteLine("Current Text:");
                PrintColoredTextByKey(ConstructCurrentDeciphering(originalSelections, selectionShifts),
                                      keyLength);

                Console.Write("> ");
                string inputRequest = Console.ReadLine().ToUpper();

                if (inputRequest == "" || inputRequest == "END")
                {
                    running = false;
                }
                else if (Regex.IsMatch(inputRequest, @"^\d+:-?\d+$", RegexOptions.IgnoreCase))
                {
                    string[] parts = inputRequest.Split(':');
                    Debug.Assert(parts.Length == 2);

                    int selectionId = int.Parse(parts[0]);
                    int shiftAmount = int.Parse(parts[1]);

                    if (selectionId < 0 ||
                        selectionId >= originalSelections.Length)
                    {
                        Console.WriteLine("Invalid selection id");
                    }
                    else
                    {
                        selectionShifts[selectionId] = (selectionShifts[selectionId] + shiftAmount + Program.validCharacters.Length) % Program.validCharacters.Length;
                    }
                }
                else if (inputRequest == "SET OPTIMAL" || inputRequest == "SETOPTIMAL")
                {
                    for (int selectionIndex = 0; selectionIndex < originalSelections.Length; selectionIndex++)
                    {
                        string selection = originalSelections[selectionIndex];

                        Dictionary <char, double> selectionProportions = FrequencyAnalysis.CharFrequencyToCharProportion(FrequencyAnalysis.GetTextCharFrequency(selection));

                        double _;
                        int    optimalShiftAmount;
                        FrequencyAnalysis.GetOptimalCharacterMapping(selectionProportions,
                                                                     EnglishLetterFrequency.GetLetterProportions(),
                                                                     out _,
                                                                     out optimalShiftAmount);

                        selectionShifts[selectionIndex] = optimalShiftAmount;
                    }
                }
                else if (inputRequest == "PRINT PLAIN" || inputRequest == "PRINTPLAIN")
                {
                    Console.WriteLine(ConstructCurrentDeciphering(originalSelections, selectionShifts));
                }
                else
                {
                    Console.WriteLine("Unknown Request");
                }
            }

            keyword = ProgramMath.GetKeywordFromOffsets(selectionShifts);
            return(ConstructCurrentDeciphering(originalSelections, selectionShifts));
        }
        static void DebugOptimalCharacterMappingFull()
        {
            Console.Write("Text> ");
            string text = Console.ReadLine().ToUpper();

            const bool discardSingle = true;

            Repetition[]          repetitions         = Repetition.GetTextRepetitions(text);
            Dictionary <int, int> keyLengthWeightings = KeyLengthDeduction.GetKeyLengthWeights(repetitions, discardSingle);
            Dictionary <int, int> factoredWeightings  = KeyLengthDeduction.GetFactoredKeyLengthWeights(keyLengthWeightings);

            const int topLengthsCount = 7;

            Dictionary <int, int> topLengths = ProgramMath.GetTopDictionaryKeysByValue(factoredWeightings, topLengthsCount);

            Console.WriteLine();
            Console.WriteLine("Top Key Lengths:");

            foreach (int length in topLengths.Keys)
            {
                Console.WriteLine($"{length} (weighting = {topLengths[length]})");
            }

            Console.Write("Select chosen key length> ");

            int keyLengthSelection = int.Parse(Console.ReadLine());

            string[] selections = FrequencyAnalysis.SplitTextByOffset(text, keyLengthSelection);

            Console.WriteLine();
            Console.WriteLine("Text Offset Selections:");

            for (int i = 0; i < selections.Length; i++)
            {
                Console.WriteLine(i + ") " + selections[i]);
            }

            Console.Write("Select text offset selection> ");
            int offsetSelectionIndex = int.Parse(Console.ReadLine());

            Debug.Assert(0 <= offsetSelectionIndex &&
                         offsetSelectionIndex < selections.Length);

            string selectedTextOffsetSelection = selections[offsetSelectionIndex];

            Dictionary <char, double> selectionCharacterProportion = FrequencyAnalysis.CharFrequencyToCharProportion(FrequencyAnalysis.GetTextCharFrequency(selectedTextOffsetSelection));

            Dictionary <char, double> englishCharacterProportions = EnglishLetterFrequency.GetLetterProportions();

            double mappingDifference;
            int    _;
            Dictionary <char, char> optimalMapping = FrequencyAnalysis.GetOptimalCharacterMapping(selectionCharacterProportion,
                                                                                                  englishCharacterProportions,
                                                                                                  out mappingDifference,
                                                                                                  out _);

            Console.WriteLine();
            Console.WriteLine($"Mapping Difference: {mappingDifference}");

            foreach (char textChar in optimalMapping.Keys)
            {
                Console.WriteLine($"{textChar} -> {optimalMapping[textChar]}");
            }
        }