blob: 5e8a2497fea41fc0a426e0ab5e0db1456213487b [file] [log] [blame]
Daniel Jasperf7935112012-12-03 18:12:45 +00001//===--- Format.cpp - Format C++ code -------------------------------------===//
2//
Chandler Carruth2946cd72019-01-19 08:50:56 +00003// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
Daniel Jasperf7935112012-12-03 18:12:45 +00006//
7//===----------------------------------------------------------------------===//
8///
9/// \file
Adrian Prantl9fc8faf2018-05-09 01:00:01 +000010/// This file implements functions declared in Format.h. This will be
Daniel Jasperf7935112012-12-03 18:12:45 +000011/// split into separate files as we go.
12///
Daniel Jasperf7935112012-12-03 18:12:45 +000013//===----------------------------------------------------------------------===//
14
Daniel Jasper85c472d2015-09-29 07:53:08 +000015#include "clang/Format/Format.h"
Eric Liu4cfb88a2016-04-25 15:09:22 +000016#include "AffectedRangeManager.h"
Daniel Jasperde0328a2013-08-16 11:20:30 +000017#include "ContinuationIndenter.h"
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +000018#include "FormatInternal.h"
Martin Probstc4a0dd42016-05-20 11:24:24 +000019#include "FormatTokenLexer.h"
Krasimir Georgiev7cb267a2017-02-27 13:28:36 +000020#include "NamespaceEndCommentsFixer.h"
Martin Probstc4a0dd42016-05-20 11:24:24 +000021#include "SortJavaScriptImports.h"
22#include "TokenAnalyzer.h"
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000023#include "TokenAnnotator.h"
Daniel Jasper0df50932014-12-10 19:00:42 +000024#include "UnwrappedLineFormatter.h"
Chandler Carruth3a022472012-12-04 09:13:33 +000025#include "UnwrappedLineParser.h"
Krasimir Georgievb03877a2017-06-21 12:03:12 +000026#include "UsingDeclarationsSorter.h"
Alexander Kornienkocb45bc12013-04-15 14:28:00 +000027#include "WhitespaceManager.h"
Daniel Jasperec04c0d2013-05-16 10:40:07 +000028#include "clang/Basic/Diagnostic.h"
Benjamin Kramerf3ca26982014-05-10 16:31:55 +000029#include "clang/Basic/DiagnosticOptions.h"
Chandler Carruth44eb4f62013-01-02 10:28:36 +000030#include "clang/Basic/SourceManager.h"
Daniel Jasperf7935112012-12-03 18:12:45 +000031#include "clang/Lex/Lexer.h"
Eric Liu44564ac2018-06-04 09:04:12 +000032#include "clang/Tooling/Inclusions/HeaderIncludes.h"
Alexander Kornienkoffd6d042013-03-27 11:52:18 +000033#include "llvm/ADT/STLExtras.h"
Ben Hamiltone2e3e672018-01-17 17:33:08 +000034#include "llvm/ADT/StringRef.h"
Manuel Klimek2ef908e2013-02-13 10:46:36 +000035#include "llvm/Support/Allocator.h"
Manuel Klimek24998102013-01-16 14:55:28 +000036#include "llvm/Support/Debug.h"
Edwin Vaned544aa72013-09-30 13:31:48 +000037#include "llvm/Support/Path.h"
Birunthan Mohanathasb001a0b2015-07-03 17:25:16 +000038#include "llvm/Support/Regex.h"
Jonas Devliegherefc514902018-10-10 13:27:25 +000039#include "llvm/Support/VirtualFileSystem.h"
Chandler Carruth5553d0d2014-01-07 11:51:46 +000040#include "llvm/Support/YAMLTraits.h"
Martin Probst081f1762016-06-01 15:19:53 +000041#include <algorithm>
Eric Liu4cfb88a2016-04-25 15:09:22 +000042#include <memory>
Eric Liubf4c41c2018-05-04 17:55:13 +000043#include <mutex>
Daniel Jasper8b529712012-12-04 13:02:32 +000044#include <string>
Eric Liubf4c41c2018-05-04 17:55:13 +000045#include <unordered_map>
Daniel Jasper8b529712012-12-04 13:02:32 +000046
Chandler Carruth10346662014-04-22 03:17:02 +000047#define DEBUG_TYPE "format-formatter"
48
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +000049using clang::format::FormatStyle;
50
NAKAMURA Takumi057a9422017-11-01 04:43:22 +000051LLVM_YAML_IS_SEQUENCE_VECTOR(clang::format::FormatStyle::RawStringFormat)
Daniel Jaspere1e43192014-04-01 12:55:11 +000052
Alexander Kornienkod6538332013-05-07 15:32:14 +000053namespace llvm {
54namespace yaml {
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +000055template <> struct ScalarEnumerationTraits<FormatStyle::LanguageKind> {
56 static void enumeration(IO &IO, FormatStyle::LanguageKind &Value) {
57 IO.enumCase(Value, "Cpp", FormatStyle::LK_Cpp);
Daniel Jasperc58c70e2014-09-15 11:21:46 +000058 IO.enumCase(Value, "Java", FormatStyle::LK_Java);
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +000059 IO.enumCase(Value, "JavaScript", FormatStyle::LK_JavaScript);
Daniel Jasper03a04fe2016-12-12 12:42:29 +000060 IO.enumCase(Value, "ObjC", FormatStyle::LK_ObjC);
Daniel Jasper7052ce62014-01-19 09:04:08 +000061 IO.enumCase(Value, "Proto", FormatStyle::LK_Proto);
Daniel Jasper498f5582015-12-25 08:53:31 +000062 IO.enumCase(Value, "TableGen", FormatStyle::LK_TableGen);
Krasimir Georgiev26b144c2017-07-03 15:05:14 +000063 IO.enumCase(Value, "TextProto", FormatStyle::LK_TextProto);
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +000064 }
65};
66
67template <> struct ScalarEnumerationTraits<FormatStyle::LanguageStandard> {
68 static void enumeration(IO &IO, FormatStyle::LanguageStandard &Value) {
69 IO.enumCase(Value, "Cpp03", FormatStyle::LS_Cpp03);
70 IO.enumCase(Value, "C++03", FormatStyle::LS_Cpp03);
71 IO.enumCase(Value, "Cpp11", FormatStyle::LS_Cpp11);
72 IO.enumCase(Value, "C++11", FormatStyle::LS_Cpp11);
73 IO.enumCase(Value, "Auto", FormatStyle::LS_Auto);
74 }
75};
76
77template <> struct ScalarEnumerationTraits<FormatStyle::UseTabStyle> {
78 static void enumeration(IO &IO, FormatStyle::UseTabStyle &Value) {
79 IO.enumCase(Value, "Never", FormatStyle::UT_Never);
80 IO.enumCase(Value, "false", FormatStyle::UT_Never);
81 IO.enumCase(Value, "Always", FormatStyle::UT_Always);
82 IO.enumCase(Value, "true", FormatStyle::UT_Always);
83 IO.enumCase(Value, "ForIndentation", FormatStyle::UT_ForIndentation);
Marianne Mailhot-Sarrasin51fe2792016-04-14 14:52:26 +000084 IO.enumCase(Value, "ForContinuationAndIndentation",
85 FormatStyle::UT_ForContinuationAndIndentation);
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +000086 }
87};
88
Daniel Jasperabd1f572016-03-02 22:44:03 +000089template <> struct ScalarEnumerationTraits<FormatStyle::JavaScriptQuoteStyle> {
90 static void enumeration(IO &IO, FormatStyle::JavaScriptQuoteStyle &Value) {
91 IO.enumCase(Value, "Leave", FormatStyle::JSQS_Leave);
92 IO.enumCase(Value, "Single", FormatStyle::JSQS_Single);
93 IO.enumCase(Value, "Double", FormatStyle::JSQS_Double);
94 }
95};
96
Daniel Jasperd74cf402014-04-08 12:46:38 +000097template <> struct ScalarEnumerationTraits<FormatStyle::ShortFunctionStyle> {
98 static void enumeration(IO &IO, FormatStyle::ShortFunctionStyle &Value) {
99 IO.enumCase(Value, "None", FormatStyle::SFS_None);
100 IO.enumCase(Value, "false", FormatStyle::SFS_None);
101 IO.enumCase(Value, "All", FormatStyle::SFS_All);
102 IO.enumCase(Value, "true", FormatStyle::SFS_All);
103 IO.enumCase(Value, "Inline", FormatStyle::SFS_Inline);
Francois Ferrandd3f0e3d2017-06-21 13:56:02 +0000104 IO.enumCase(Value, "InlineOnly", FormatStyle::SFS_InlineOnly);
Daniel Jasper9e709352014-11-26 10:43:58 +0000105 IO.enumCase(Value, "Empty", FormatStyle::SFS_Empty);
Daniel Jasperd74cf402014-04-08 12:46:38 +0000106 }
107};
108
Paul Hoad15000a12019-03-13 08:26:39 +0000109template <> struct ScalarEnumerationTraits<FormatStyle::ShortIfStyle> {
110 static void enumeration(IO &IO, FormatStyle::ShortIfStyle &Value) {
111 IO.enumCase(Value, "Never", FormatStyle::SIS_Never);
112 IO.enumCase(Value, "Always", FormatStyle::SIS_Always);
113 IO.enumCase(Value, "WithoutElse", FormatStyle::SIS_WithoutElse);
114
115 // For backward compatibility.
116 IO.enumCase(Value, "false", FormatStyle::SIS_Never);
117 IO.enumCase(Value, "true", FormatStyle::SIS_WithoutElse);
118 }
119};
120
Ben Hamilton4dc658c2018-02-02 20:15:14 +0000121template <> struct ScalarEnumerationTraits<FormatStyle::BinPackStyle> {
122 static void enumeration(IO &IO, FormatStyle::BinPackStyle &Value) {
123 IO.enumCase(Value, "Auto", FormatStyle::BPS_Auto);
124 IO.enumCase(Value, "Always", FormatStyle::BPS_Always);
125 IO.enumCase(Value, "Never", FormatStyle::BPS_Never);
126 }
127};
128
Daniel Jasperac043c92014-09-15 11:11:00 +0000129template <> struct ScalarEnumerationTraits<FormatStyle::BinaryOperatorStyle> {
130 static void enumeration(IO &IO, FormatStyle::BinaryOperatorStyle &Value) {
131 IO.enumCase(Value, "All", FormatStyle::BOS_All);
132 IO.enumCase(Value, "true", FormatStyle::BOS_All);
133 IO.enumCase(Value, "None", FormatStyle::BOS_None);
134 IO.enumCase(Value, "false", FormatStyle::BOS_None);
135 IO.enumCase(Value, "NonAssignment", FormatStyle::BOS_NonAssignment);
136 }
137};
138
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000139template <> struct ScalarEnumerationTraits<FormatStyle::BraceBreakingStyle> {
140 static void enumeration(IO &IO, FormatStyle::BraceBreakingStyle &Value) {
141 IO.enumCase(Value, "Attach", FormatStyle::BS_Attach);
142 IO.enumCase(Value, "Linux", FormatStyle::BS_Linux);
Birunthan Mohanathas305fa9c2015-07-12 03:13:54 +0000143 IO.enumCase(Value, "Mozilla", FormatStyle::BS_Mozilla);
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000144 IO.enumCase(Value, "Stroustrup", FormatStyle::BS_Stroustrup);
145 IO.enumCase(Value, "Allman", FormatStyle::BS_Allman);
Alexander Kornienko3a33f022013-12-12 09:49:52 +0000146 IO.enumCase(Value, "GNU", FormatStyle::BS_GNU);
Roman Kashitsyn291f64f2015-08-10 13:43:19 +0000147 IO.enumCase(Value, "WebKit", FormatStyle::BS_WebKit);
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000148 IO.enumCase(Value, "Custom", FormatStyle::BS_Custom);
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000149 }
150};
151
Manuel Klimek89628f62017-09-20 09:51:03 +0000152template <>
153struct ScalarEnumerationTraits<FormatStyle::BreakConstructorInitializersStyle> {
154 static void
155 enumeration(IO &IO, FormatStyle::BreakConstructorInitializersStyle &Value) {
Francois Ferranda6b6d512017-05-24 11:36:58 +0000156 IO.enumCase(Value, "BeforeColon", FormatStyle::BCIS_BeforeColon);
157 IO.enumCase(Value, "BeforeComma", FormatStyle::BCIS_BeforeComma);
158 IO.enumCase(Value, "AfterColon", FormatStyle::BCIS_AfterColon);
159 }
160};
161
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000162template <>
Francois Ferrand6bb103f2018-06-11 14:41:26 +0000163struct ScalarEnumerationTraits<FormatStyle::BreakInheritanceListStyle> {
Paul Hoad5bcf99b2019-03-01 09:09:54 +0000164 static void enumeration(IO &IO,
165 FormatStyle::BreakInheritanceListStyle &Value) {
Francois Ferrand6bb103f2018-06-11 14:41:26 +0000166 IO.enumCase(Value, "BeforeColon", FormatStyle::BILS_BeforeColon);
167 IO.enumCase(Value, "BeforeComma", FormatStyle::BILS_BeforeComma);
168 IO.enumCase(Value, "AfterColon", FormatStyle::BILS_AfterColon);
169 }
170};
171
172template <>
Krasimir Georgievad47c902017-08-30 14:34:57 +0000173struct ScalarEnumerationTraits<FormatStyle::PPDirectiveIndentStyle> {
174 static void enumeration(IO &IO, FormatStyle::PPDirectiveIndentStyle &Value) {
175 IO.enumCase(Value, "None", FormatStyle::PPDIS_None);
176 IO.enumCase(Value, "AfterHash", FormatStyle::PPDIS_AfterHash);
Paul Hoad701a0d72019-03-20 20:49:43 +0000177 IO.enumCase(Value, "BeforeHash", FormatStyle::PPDIS_BeforeHash);
Krasimir Georgievad47c902017-08-30 14:34:57 +0000178 }
179};
180
181template <>
Zachary Turner448592e2015-12-18 22:20:15 +0000182struct ScalarEnumerationTraits<FormatStyle::ReturnTypeBreakingStyle> {
183 static void enumeration(IO &IO, FormatStyle::ReturnTypeBreakingStyle &Value) {
184 IO.enumCase(Value, "None", FormatStyle::RTBS_None);
185 IO.enumCase(Value, "All", FormatStyle::RTBS_All);
186 IO.enumCase(Value, "TopLevel", FormatStyle::RTBS_TopLevel);
187 IO.enumCase(Value, "TopLevelDefinitions",
188 FormatStyle::RTBS_TopLevelDefinitions);
189 IO.enumCase(Value, "AllDefinitions", FormatStyle::RTBS_AllDefinitions);
190 }
191};
192
193template <>
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000194struct ScalarEnumerationTraits<FormatStyle::BreakTemplateDeclarationsStyle> {
Paul Hoad5bcf99b2019-03-01 09:09:54 +0000195 static void enumeration(IO &IO,
196 FormatStyle::BreakTemplateDeclarationsStyle &Value) {
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000197 IO.enumCase(Value, "No", FormatStyle::BTDS_No);
198 IO.enumCase(Value, "MultiLine", FormatStyle::BTDS_MultiLine);
199 IO.enumCase(Value, "Yes", FormatStyle::BTDS_Yes);
200
201 // For backward compatibility.
202 IO.enumCase(Value, "false", FormatStyle::BTDS_MultiLine);
203 IO.enumCase(Value, "true", FormatStyle::BTDS_Yes);
204 }
205};
206
207template <>
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000208struct ScalarEnumerationTraits<FormatStyle::DefinitionReturnTypeBreakingStyle> {
209 static void
210 enumeration(IO &IO, FormatStyle::DefinitionReturnTypeBreakingStyle &Value) {
Birunthan Mohanathasa0388a82015-06-29 15:30:42 +0000211 IO.enumCase(Value, "None", FormatStyle::DRTBS_None);
212 IO.enumCase(Value, "All", FormatStyle::DRTBS_All);
213 IO.enumCase(Value, "TopLevel", FormatStyle::DRTBS_TopLevel);
214
215 // For backward compatibility.
216 IO.enumCase(Value, "false", FormatStyle::DRTBS_None);
217 IO.enumCase(Value, "true", FormatStyle::DRTBS_All);
218 }
219};
220
Alexander Kornienkod6538332013-05-07 15:32:14 +0000221template <>
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000222struct ScalarEnumerationTraits<FormatStyle::NamespaceIndentationKind> {
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000223 static void enumeration(IO &IO,
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000224 FormatStyle::NamespaceIndentationKind &Value) {
225 IO.enumCase(Value, "None", FormatStyle::NI_None);
226 IO.enumCase(Value, "Inner", FormatStyle::NI_Inner);
227 IO.enumCase(Value, "All", FormatStyle::NI_All);
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000228 }
229};
230
Daniel Jasper6501f7e2015-10-27 12:38:37 +0000231template <> struct ScalarEnumerationTraits<FormatStyle::BracketAlignmentStyle> {
232 static void enumeration(IO &IO, FormatStyle::BracketAlignmentStyle &Value) {
233 IO.enumCase(Value, "Align", FormatStyle::BAS_Align);
234 IO.enumCase(Value, "DontAlign", FormatStyle::BAS_DontAlign);
235 IO.enumCase(Value, "AlwaysBreak", FormatStyle::BAS_AlwaysBreak);
236
237 // For backward compatibility.
238 IO.enumCase(Value, "true", FormatStyle::BAS_Align);
239 IO.enumCase(Value, "false", FormatStyle::BAS_DontAlign);
240 }
241};
242
Manuel Klimek89628f62017-09-20 09:51:03 +0000243template <>
244struct ScalarEnumerationTraits<FormatStyle::EscapedNewlineAlignmentStyle> {
245 static void enumeration(IO &IO,
246 FormatStyle::EscapedNewlineAlignmentStyle &Value) {
Daniel Jasper7fdbb3f2017-05-08 15:08:00 +0000247 IO.enumCase(Value, "DontAlign", FormatStyle::ENAS_DontAlign);
248 IO.enumCase(Value, "Left", FormatStyle::ENAS_Left);
249 IO.enumCase(Value, "Right", FormatStyle::ENAS_Right);
250
251 // For backward compatibility.
252 IO.enumCase(Value, "true", FormatStyle::ENAS_Left);
253 IO.enumCase(Value, "false", FormatStyle::ENAS_Right);
254 }
255};
256
Jacques Pienaarfc275112015-02-18 23:48:37 +0000257template <> struct ScalarEnumerationTraits<FormatStyle::PointerAlignmentStyle> {
258 static void enumeration(IO &IO, FormatStyle::PointerAlignmentStyle &Value) {
Daniel Jasper553d4872014-06-17 12:40:34 +0000259 IO.enumCase(Value, "Middle", FormatStyle::PAS_Middle);
260 IO.enumCase(Value, "Left", FormatStyle::PAS_Left);
261 IO.enumCase(Value, "Right", FormatStyle::PAS_Right);
262
Alp Toker958027b2014-07-14 19:42:55 +0000263 // For backward compatibility.
Daniel Jasper553d4872014-06-17 12:40:34 +0000264 IO.enumCase(Value, "true", FormatStyle::PAS_Left);
265 IO.enumCase(Value, "false", FormatStyle::PAS_Right);
266 }
267};
268
269template <>
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000270struct ScalarEnumerationTraits<FormatStyle::SpaceBeforeParensOptions> {
Manuel Klimeka8eb9142013-05-13 12:51:40 +0000271 static void enumeration(IO &IO,
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000272 FormatStyle::SpaceBeforeParensOptions &Value) {
273 IO.enumCase(Value, "Never", FormatStyle::SBPO_Never);
Alexander Kornienkofdca83d2013-12-10 10:18:34 +0000274 IO.enumCase(Value, "ControlStatements",
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000275 FormatStyle::SBPO_ControlStatements);
276 IO.enumCase(Value, "Always", FormatStyle::SBPO_Always);
Alexander Kornienkofdca83d2013-12-10 10:18:34 +0000277
278 // For backward compatibility.
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000279 IO.enumCase(Value, "false", FormatStyle::SBPO_Never);
280 IO.enumCase(Value, "true", FormatStyle::SBPO_ControlStatements);
Alexander Kornienkofdca83d2013-12-10 10:18:34 +0000281 }
282};
283
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000284template <> struct MappingTraits<FormatStyle> {
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000285 static void mapping(IO &IO, FormatStyle &Style) {
286 // When reading, read the language first, we need it for getPredefinedStyle.
287 IO.mapOptional("Language", Style.Language);
288
Alexander Kornienko49149672013-05-10 11:56:10 +0000289 if (IO.outputting()) {
Jacques Pienaarfc275112015-02-18 23:48:37 +0000290 StringRef StylesArray[] = {"LLVM", "Google", "Chromium",
291 "Mozilla", "WebKit", "GNU"};
Alexander Kornienko49149672013-05-10 11:56:10 +0000292 ArrayRef<StringRef> Styles(StylesArray);
293 for (size_t i = 0, e = Styles.size(); i < e; ++i) {
294 StringRef StyleName(Styles[i]);
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000295 FormatStyle PredefinedStyle;
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000296 if (getPredefinedStyle(StyleName, Style.Language, &PredefinedStyle) &&
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000297 Style == PredefinedStyle) {
Alexander Kornienko49149672013-05-10 11:56:10 +0000298 IO.mapOptional("# BasedOnStyle", StyleName);
299 break;
300 }
301 }
302 } else {
Alexander Kornienkod6538332013-05-07 15:32:14 +0000303 StringRef BasedOnStyle;
304 IO.mapOptional("BasedOnStyle", BasedOnStyle);
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000305 if (!BasedOnStyle.empty()) {
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000306 FormatStyle::LanguageKind OldLanguage = Style.Language;
307 FormatStyle::LanguageKind Language =
308 ((FormatStyle *)IO.getContext())->Language;
309 if (!getPredefinedStyle(BasedOnStyle, Language, &Style)) {
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000310 IO.setError(Twine("Unknown value for BasedOnStyle: ", BasedOnStyle));
311 return;
312 }
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000313 Style.Language = OldLanguage;
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000314 }
Alexander Kornienkod6538332013-05-07 15:32:14 +0000315 }
316
Birunthan Mohanathas50a6f912015-06-28 14:52:34 +0000317 // For backward compatibility.
318 if (!IO.outputting()) {
Daniel Jasper7fdbb3f2017-05-08 15:08:00 +0000319 IO.mapOptional("AlignEscapedNewlinesLeft", Style.AlignEscapedNewlines);
Birunthan Mohanathas50a6f912015-06-28 14:52:34 +0000320 IO.mapOptional("DerivePointerBinding", Style.DerivePointerAlignment);
321 IO.mapOptional("IndentFunctionDeclarationAfterType",
322 Style.IndentWrappedFunctionNames);
323 IO.mapOptional("PointerBindsToType", Style.PointerAlignment);
324 IO.mapOptional("SpaceAfterControlStatementKeyword",
325 Style.SpaceBeforeParens);
326 }
327
Alexander Kornienkod6538332013-05-07 15:32:14 +0000328 IO.mapOptional("AccessModifierOffset", Style.AccessModifierOffset);
Daniel Jasper3aa9a6a2014-11-18 23:55:27 +0000329 IO.mapOptional("AlignAfterOpenBracket", Style.AlignAfterOpenBracket);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000330 IO.mapOptional("AlignConsecutiveAssignments",
331 Style.AlignConsecutiveAssignments);
Daniel Jaspere12597c2015-10-01 10:06:54 +0000332 IO.mapOptional("AlignConsecutiveDeclarations",
333 Style.AlignConsecutiveDeclarations);
Daniel Jasper7fdbb3f2017-05-08 15:08:00 +0000334 IO.mapOptional("AlignEscapedNewlines", Style.AlignEscapedNewlines);
Daniel Jasper3219e432014-12-02 13:24:51 +0000335 IO.mapOptional("AlignOperands", Style.AlignOperands);
Daniel Jasper552f4a72013-07-31 23:55:15 +0000336 IO.mapOptional("AlignTrailingComments", Style.AlignTrailingComments);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000337 IO.mapOptional("AllowAllParametersOfDeclarationOnNextLine",
338 Style.AllowAllParametersOfDeclarationOnNextLine);
Daniel Jasper17605d32014-05-14 09:33:35 +0000339 IO.mapOptional("AllowShortBlocksOnASingleLine",
340 Style.AllowShortBlocksOnASingleLine);
Daniel Jasperb87899b2014-09-10 13:11:45 +0000341 IO.mapOptional("AllowShortCaseLabelsOnASingleLine",
342 Style.AllowShortCaseLabelsOnASingleLine);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000343 IO.mapOptional("AllowShortFunctionsOnASingleLine",
344 Style.AllowShortFunctionsOnASingleLine);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000345 IO.mapOptional("AllowShortIfStatementsOnASingleLine",
346 Style.AllowShortIfStatementsOnASingleLine);
Daniel Jasper3a685df2013-05-16 12:12:21 +0000347 IO.mapOptional("AllowShortLoopsOnASingleLine",
348 Style.AllowShortLoopsOnASingleLine);
Daniel Jasperca4ea1c2014-08-05 12:16:31 +0000349 IO.mapOptional("AlwaysBreakAfterDefinitionReturnType",
350 Style.AlwaysBreakAfterDefinitionReturnType);
Zachary Turner448592e2015-12-18 22:20:15 +0000351 IO.mapOptional("AlwaysBreakAfterReturnType",
352 Style.AlwaysBreakAfterReturnType);
353 // If AlwaysBreakAfterDefinitionReturnType was specified but
354 // AlwaysBreakAfterReturnType was not, initialize the latter from the
355 // former for backwards compatibility.
356 if (Style.AlwaysBreakAfterDefinitionReturnType != FormatStyle::DRTBS_None &&
357 Style.AlwaysBreakAfterReturnType == FormatStyle::RTBS_None) {
358 if (Style.AlwaysBreakAfterDefinitionReturnType == FormatStyle::DRTBS_All)
359 Style.AlwaysBreakAfterReturnType = FormatStyle::RTBS_AllDefinitions;
360 else if (Style.AlwaysBreakAfterDefinitionReturnType ==
361 FormatStyle::DRTBS_TopLevel)
362 Style.AlwaysBreakAfterReturnType =
363 FormatStyle::RTBS_TopLevelDefinitions;
364 }
365
Alexander Kornienko58611712013-07-04 12:02:44 +0000366 IO.mapOptional("AlwaysBreakBeforeMultilineStrings",
367 Style.AlwaysBreakBeforeMultilineStrings);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000368 IO.mapOptional("AlwaysBreakTemplateDeclarations",
369 Style.AlwaysBreakTemplateDeclarations);
370 IO.mapOptional("BinPackArguments", Style.BinPackArguments);
371 IO.mapOptional("BinPackParameters", Style.BinPackParameters);
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000372 IO.mapOptional("BraceWrapping", Style.BraceWrapping);
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000373 IO.mapOptional("BreakBeforeBinaryOperators",
374 Style.BreakBeforeBinaryOperators);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000375 IO.mapOptional("BreakBeforeBraces", Style.BreakBeforeBraces);
Francois Ferrand6bb103f2018-06-11 14:41:26 +0000376
377 bool BreakBeforeInheritanceComma = false;
Paul Hoad5bcf99b2019-03-01 09:09:54 +0000378 IO.mapOptional("BreakBeforeInheritanceComma", BreakBeforeInheritanceComma);
379 IO.mapOptional("BreakInheritanceList", Style.BreakInheritanceList);
Francois Ferrand6bb103f2018-06-11 14:41:26 +0000380 // If BreakBeforeInheritanceComma was specified but
381 // BreakInheritance was not, initialize the latter from the
382 // former for backwards compatibility.
383 if (BreakBeforeInheritanceComma &&
384 Style.BreakInheritanceList == FormatStyle::BILS_BeforeColon)
385 Style.BreakInheritanceList = FormatStyle::BILS_BeforeComma;
386
Daniel Jasper165b29e2013-11-08 00:57:11 +0000387 IO.mapOptional("BreakBeforeTernaryOperators",
388 Style.BreakBeforeTernaryOperators);
Francois Ferranda6b6d512017-05-24 11:36:58 +0000389
390 bool BreakConstructorInitializersBeforeComma = false;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000391 IO.mapOptional("BreakConstructorInitializersBeforeComma",
Francois Ferranda6b6d512017-05-24 11:36:58 +0000392 BreakConstructorInitializersBeforeComma);
393 IO.mapOptional("BreakConstructorInitializers",
394 Style.BreakConstructorInitializers);
395 // If BreakConstructorInitializersBeforeComma was specified but
396 // BreakConstructorInitializers was not, initialize the latter from the
397 // former for backwards compatibility.
398 if (BreakConstructorInitializersBeforeComma &&
399 Style.BreakConstructorInitializers == FormatStyle::BCIS_BeforeColon)
400 Style.BreakConstructorInitializers = FormatStyle::BCIS_BeforeComma;
401
Daniel Jaspere1a7b762016-02-01 11:21:02 +0000402 IO.mapOptional("BreakAfterJavaFieldAnnotations",
403 Style.BreakAfterJavaFieldAnnotations);
404 IO.mapOptional("BreakStringLiterals", Style.BreakStringLiterals);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000405 IO.mapOptional("ColumnLimit", Style.ColumnLimit);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000406 IO.mapOptional("CommentPragmas", Style.CommentPragmas);
Francois Ferrande56a8292017-06-14 12:29:47 +0000407 IO.mapOptional("CompactNamespaces", Style.CompactNamespaces);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000408 IO.mapOptional("ConstructorInitializerAllOnOneLineOrOnePerLine",
409 Style.ConstructorInitializerAllOnOneLineOrOnePerLine);
Daniel Jasper50d634b2014-10-28 16:53:38 +0000410 IO.mapOptional("ConstructorInitializerIndentWidth",
411 Style.ConstructorInitializerIndentWidth);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000412 IO.mapOptional("ContinuationIndentWidth", Style.ContinuationIndentWidth);
413 IO.mapOptional("Cpp11BracedListStyle", Style.Cpp11BracedListStyle);
Daniel Jasper553d4872014-06-17 12:40:34 +0000414 IO.mapOptional("DerivePointerAlignment", Style.DerivePointerAlignment);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000415 IO.mapOptional("DisableFormat", Style.DisableFormat);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000416 IO.mapOptional("ExperimentalAutoDetectBinPacking",
417 Style.ExperimentalAutoDetectBinPacking);
Krasimir Georgiev32eaa862017-03-01 15:35:39 +0000418 IO.mapOptional("FixNamespaceComments", Style.FixNamespaceComments);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000419 IO.mapOptional("ForEachMacros", Style.ForEachMacros);
Eric Liu9d92c022018-05-14 19:51:33 +0000420 IO.mapOptional("IncludeBlocks", Style.IncludeStyle.IncludeBlocks);
421 IO.mapOptional("IncludeCategories", Style.IncludeStyle.IncludeCategories);
422 IO.mapOptional("IncludeIsMainRegex", Style.IncludeStyle.IncludeIsMainRegex);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000423 IO.mapOptional("IndentCaseLabels", Style.IndentCaseLabels);
Krasimir Georgievad47c902017-08-30 14:34:57 +0000424 IO.mapOptional("IndentPPDirectives", Style.IndentPPDirectives);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000425 IO.mapOptional("IndentWidth", Style.IndentWidth);
426 IO.mapOptional("IndentWrappedFunctionNames",
427 Style.IndentWrappedFunctionNames);
Krasimir Georgiev7e91b032018-10-05 17:19:26 +0000428 IO.mapOptional("JavaImportGroups", Style.JavaImportGroups);
Martin Probst0cd74ee2016-06-13 16:39:50 +0000429 IO.mapOptional("JavaScriptQuotes", Style.JavaScriptQuotes);
430 IO.mapOptional("JavaScriptWrapImports", Style.JavaScriptWrapImports);
Daniel Jaspera26fc5c2014-03-21 13:43:14 +0000431 IO.mapOptional("KeepEmptyLinesAtTheStartOfBlocks",
432 Style.KeepEmptyLinesAtTheStartOfBlocks);
Birunthan Mohanathasb001a0b2015-07-03 17:25:16 +0000433 IO.mapOptional("MacroBlockBegin", Style.MacroBlockBegin);
434 IO.mapOptional("MacroBlockEnd", Style.MacroBlockEnd);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000435 IO.mapOptional("MaxEmptyLinesToKeep", Style.MaxEmptyLinesToKeep);
Daniel Jasper65ee3472013-07-31 23:16:02 +0000436 IO.mapOptional("NamespaceIndentation", Style.NamespaceIndentation);
Ben Hamilton4dc658c2018-02-02 20:15:14 +0000437 IO.mapOptional("ObjCBinPackProtocolList", Style.ObjCBinPackProtocolList);
Daniel Jasper50d634b2014-10-28 16:53:38 +0000438 IO.mapOptional("ObjCBlockIndentWidth", Style.ObjCBlockIndentWidth);
Daniel Jaspere9beea22014-01-28 15:20:33 +0000439 IO.mapOptional("ObjCSpaceAfterProperty", Style.ObjCSpaceAfterProperty);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000440 IO.mapOptional("ObjCSpaceBeforeProtocolList",
441 Style.ObjCSpaceBeforeProtocolList);
Manuel Klimek89628f62017-09-20 09:51:03 +0000442 IO.mapOptional("PenaltyBreakAssignment", Style.PenaltyBreakAssignment);
Daniel Jasper33b909c2013-10-25 14:29:37 +0000443 IO.mapOptional("PenaltyBreakBeforeFirstCallParameter",
444 Style.PenaltyBreakBeforeFirstCallParameter);
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000445 IO.mapOptional("PenaltyBreakComment", Style.PenaltyBreakComment);
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000446 IO.mapOptional("PenaltyBreakFirstLessLess",
447 Style.PenaltyBreakFirstLessLess);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000448 IO.mapOptional("PenaltyBreakString", Style.PenaltyBreakString);
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000449 IO.mapOptional("PenaltyBreakTemplateDeclaration",
450 Style.PenaltyBreakTemplateDeclaration);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000451 IO.mapOptional("PenaltyExcessCharacter", Style.PenaltyExcessCharacter);
452 IO.mapOptional("PenaltyReturnTypeOnItsOwnLine",
453 Style.PenaltyReturnTypeOnItsOwnLine);
Daniel Jasper553d4872014-06-17 12:40:34 +0000454 IO.mapOptional("PointerAlignment", Style.PointerAlignment);
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +0000455 IO.mapOptional("RawStringFormats", Style.RawStringFormats);
Daniel Jaspera0a50392015-12-01 13:28:53 +0000456 IO.mapOptional("ReflowComments", Style.ReflowComments);
457 IO.mapOptional("SortIncludes", Style.SortIncludes);
Krasimir Georgievac16a202017-06-23 11:46:03 +0000458 IO.mapOptional("SortUsingDeclarations", Style.SortUsingDeclarations);
Daniel Jasperdb986eb2014-09-03 07:37:29 +0000459 IO.mapOptional("SpaceAfterCStyleCast", Style.SpaceAfterCStyleCast);
Manuel Klimek89628f62017-09-20 09:51:03 +0000460 IO.mapOptional("SpaceAfterTemplateKeyword",
461 Style.SpaceAfterTemplateKeyword);
Daniel Jasperd94bff32013-09-25 15:15:02 +0000462 IO.mapOptional("SpaceBeforeAssignmentOperators",
463 Style.SpaceBeforeAssignmentOperators);
Hans Wennborgbfc34062018-06-14 08:01:09 +0000464 IO.mapOptional("SpaceBeforeCpp11BracedList",
465 Style.SpaceBeforeCpp11BracedList);
Francois Ferrand2a9ea782018-03-01 10:09:13 +0000466 IO.mapOptional("SpaceBeforeCtorInitializerColon",
467 Style.SpaceBeforeCtorInitializerColon);
468 IO.mapOptional("SpaceBeforeInheritanceColon",
469 Style.SpaceBeforeInheritanceColon);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000470 IO.mapOptional("SpaceBeforeParens", Style.SpaceBeforeParens);
Francois Ferrand2a9ea782018-03-01 10:09:13 +0000471 IO.mapOptional("SpaceBeforeRangeBasedForLoopColon",
472 Style.SpaceBeforeRangeBasedForLoopColon);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000473 IO.mapOptional("SpaceInEmptyParentheses", Style.SpaceInEmptyParentheses);
474 IO.mapOptional("SpacesBeforeTrailingComments",
475 Style.SpacesBeforeTrailingComments);
476 IO.mapOptional("SpacesInAngles", Style.SpacesInAngles);
477 IO.mapOptional("SpacesInContainerLiterals",
478 Style.SpacesInContainerLiterals);
479 IO.mapOptional("SpacesInCStyleCastParentheses",
480 Style.SpacesInCStyleCastParentheses);
481 IO.mapOptional("SpacesInParentheses", Style.SpacesInParentheses);
482 IO.mapOptional("SpacesInSquareBrackets", Style.SpacesInSquareBrackets);
483 IO.mapOptional("Standard", Style.Standard);
Francois Ferrand6f40e212018-10-02 16:37:51 +0000484 IO.mapOptional("StatementMacros", Style.StatementMacros);
Birunthan Mohanathas35cfbd72015-06-28 14:51:17 +0000485 IO.mapOptional("TabWidth", Style.TabWidth);
486 IO.mapOptional("UseTab", Style.UseTab);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000487 }
488};
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000489
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000490template <> struct MappingTraits<FormatStyle::BraceWrappingFlags> {
491 static void mapping(IO &IO, FormatStyle::BraceWrappingFlags &Wrapping) {
492 IO.mapOptional("AfterClass", Wrapping.AfterClass);
493 IO.mapOptional("AfterControlStatement", Wrapping.AfterControlStatement);
494 IO.mapOptional("AfterEnum", Wrapping.AfterEnum);
495 IO.mapOptional("AfterFunction", Wrapping.AfterFunction);
496 IO.mapOptional("AfterNamespace", Wrapping.AfterNamespace);
497 IO.mapOptional("AfterObjCDeclaration", Wrapping.AfterObjCDeclaration);
498 IO.mapOptional("AfterStruct", Wrapping.AfterStruct);
499 IO.mapOptional("AfterUnion", Wrapping.AfterUnion);
Krasimir Georgievd6ce9372017-09-15 11:23:50 +0000500 IO.mapOptional("AfterExternBlock", Wrapping.AfterExternBlock);
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000501 IO.mapOptional("BeforeCatch", Wrapping.BeforeCatch);
502 IO.mapOptional("BeforeElse", Wrapping.BeforeElse);
503 IO.mapOptional("IndentBraces", Wrapping.IndentBraces);
Francois Ferrandad722562017-06-30 20:25:55 +0000504 IO.mapOptional("SplitEmptyFunction", Wrapping.SplitEmptyFunction);
505 IO.mapOptional("SplitEmptyRecord", Wrapping.SplitEmptyRecord);
506 IO.mapOptional("SplitEmptyNamespace", Wrapping.SplitEmptyNamespace);
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000507 }
508};
509
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +0000510template <> struct MappingTraits<FormatStyle::RawStringFormat> {
511 static void mapping(IO &IO, FormatStyle::RawStringFormat &Format) {
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +0000512 IO.mapOptional("Language", Format.Language);
Krasimir Georgiev4527f132018-01-17 12:24:59 +0000513 IO.mapOptional("Delimiters", Format.Delimiters);
Krasimir Georgiev2537e222018-01-17 16:17:26 +0000514 IO.mapOptional("EnclosingFunctions", Format.EnclosingFunctions);
Krasimir Georgiev412ed092018-01-19 16:18:47 +0000515 IO.mapOptional("CanonicalDelimiter", Format.CanonicalDelimiter);
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +0000516 IO.mapOptional("BasedOnStyle", Format.BasedOnStyle);
517 }
518};
519
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000520// Allows to read vector<FormatStyle> while keeping default values.
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000521// IO.getContext() should contain a pointer to the FormatStyle structure, that
522// will be used to get default values for missing keys.
523// If the first element has no Language specified, it will be treated as the
524// default one for the following elements.
Jacques Pienaarfc275112015-02-18 23:48:37 +0000525template <> struct DocumentListTraits<std::vector<FormatStyle>> {
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000526 static size_t size(IO &IO, std::vector<FormatStyle> &Seq) {
527 return Seq.size();
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000528 }
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000529 static FormatStyle &element(IO &IO, std::vector<FormatStyle> &Seq,
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000530 size_t Index) {
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000531 if (Index >= Seq.size()) {
532 assert(Index == Seq.size());
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000533 FormatStyle Template;
Krasimir Georgiev1696bb62017-11-09 15:12:17 +0000534 if (!Seq.empty() && Seq[0].Language == FormatStyle::LK_None) {
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000535 Template = Seq[0];
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000536 } else {
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000537 Template = *((const FormatStyle *)IO.getContext());
Alexander Kornienko6d2c88e2013-12-10 10:30:34 +0000538 Template.Language = FormatStyle::LK_None;
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000539 }
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000540 Seq.resize(Index + 1, Template);
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000541 }
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000542 return Seq[Index];
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000543 }
544};
Daniel Jasperd89ae9d2015-09-23 08:30:47 +0000545} // namespace yaml
546} // namespace llvm
Alexander Kornienkod6538332013-05-07 15:32:14 +0000547
Daniel Jasperf7935112012-12-03 18:12:45 +0000548namespace clang {
549namespace format {
550
Rafael Espindola6d0d89b2014-06-12 03:31:26 +0000551const std::error_category &getParseCategory() {
Benjamin Kramerf76861c2018-03-20 21:52:19 +0000552 static const ParseErrorCategory C{};
Rafael Espindolad0136702014-06-12 02:50:04 +0000553 return C;
554}
555std::error_code make_error_code(ParseError e) {
Rafael Espindola6d0d89b2014-06-12 03:31:26 +0000556 return std::error_code(static_cast<int>(e), getParseCategory());
Rafael Espindolad0136702014-06-12 02:50:04 +0000557}
558
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +0000559inline llvm::Error make_string_error(const llvm::Twine &Message) {
560 return llvm::make_error<llvm::StringError>(Message,
561 llvm::inconvertibleErrorCode());
562}
563
Reid Kleckner6432d452016-10-19 23:39:55 +0000564const char *ParseErrorCategory::name() const noexcept {
Rafael Espindolad0136702014-06-12 02:50:04 +0000565 return "clang-format.parse_error";
566}
567
568std::string ParseErrorCategory::message(int EV) const {
569 switch (static_cast<ParseError>(EV)) {
570 case ParseError::Success:
571 return "Success";
572 case ParseError::Error:
573 return "Invalid argument";
574 case ParseError::Unsuitable:
575 return "Unsuitable";
576 }
Saleem Abdulrasoolfbfbaf62014-06-12 19:33:26 +0000577 llvm_unreachable("unexpected parse error");
Rafael Espindolad0136702014-06-12 02:50:04 +0000578}
579
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000580static FormatStyle expandPresets(const FormatStyle &Style) {
Daniel Jasper55bbe662015-10-07 04:06:10 +0000581 if (Style.BreakBeforeBraces == FormatStyle::BS_Custom)
582 return Style;
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000583 FormatStyle Expanded = Style;
Manuel Klimek89628f62017-09-20 09:51:03 +0000584 Expanded.BraceWrapping = {false, false, false, false, false,
585 false, false, false, false, false,
586 false, false, true, true, true};
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000587 switch (Style.BreakBeforeBraces) {
588 case FormatStyle::BS_Linux:
589 Expanded.BraceWrapping.AfterClass = true;
590 Expanded.BraceWrapping.AfterFunction = true;
591 Expanded.BraceWrapping.AfterNamespace = true;
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000592 break;
593 case FormatStyle::BS_Mozilla:
594 Expanded.BraceWrapping.AfterClass = true;
595 Expanded.BraceWrapping.AfterEnum = true;
596 Expanded.BraceWrapping.AfterFunction = true;
597 Expanded.BraceWrapping.AfterStruct = true;
598 Expanded.BraceWrapping.AfterUnion = true;
Krasimir Georgievd6ce9372017-09-15 11:23:50 +0000599 Expanded.BraceWrapping.AfterExternBlock = true;
Sylvestre Ledru82c9a0e2017-09-13 20:03:29 +0000600 Expanded.BraceWrapping.SplitEmptyFunction = true;
Francois Ferrandad722562017-06-30 20:25:55 +0000601 Expanded.BraceWrapping.SplitEmptyRecord = false;
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000602 break;
603 case FormatStyle::BS_Stroustrup:
604 Expanded.BraceWrapping.AfterFunction = true;
605 Expanded.BraceWrapping.BeforeCatch = true;
606 Expanded.BraceWrapping.BeforeElse = true;
607 break;
608 case FormatStyle::BS_Allman:
609 Expanded.BraceWrapping.AfterClass = true;
610 Expanded.BraceWrapping.AfterControlStatement = true;
611 Expanded.BraceWrapping.AfterEnum = true;
612 Expanded.BraceWrapping.AfterFunction = true;
613 Expanded.BraceWrapping.AfterNamespace = true;
614 Expanded.BraceWrapping.AfterObjCDeclaration = true;
615 Expanded.BraceWrapping.AfterStruct = true;
Krasimir Georgievd6ce9372017-09-15 11:23:50 +0000616 Expanded.BraceWrapping.AfterExternBlock = true;
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000617 Expanded.BraceWrapping.BeforeCatch = true;
618 Expanded.BraceWrapping.BeforeElse = true;
619 break;
620 case FormatStyle::BS_GNU:
Manuel Klimek89628f62017-09-20 09:51:03 +0000621 Expanded.BraceWrapping = {true, true, true, true, true, true, true, true,
622 true, true, true, true, true, true, true};
Daniel Jasperc1bc38e2015-09-29 14:57:55 +0000623 break;
624 case FormatStyle::BS_WebKit:
625 Expanded.BraceWrapping.AfterFunction = true;
626 break;
627 default:
628 break;
629 }
630 return Expanded;
631}
632
Jordan Rupprecht8bd97e72019-02-28 19:16:45 +0000633FormatStyle getLLVMStyle(FormatStyle::LanguageKind Language) {
Daniel Jasperf7935112012-12-03 18:12:45 +0000634 FormatStyle LLVMStyle;
Jordan Rupprecht8bd97e72019-02-28 19:16:45 +0000635 LLVMStyle.Language = Language;
Daniel Jasperf7935112012-12-03 18:12:45 +0000636 LLVMStyle.AccessModifierOffset = -2;
Daniel Jasper7fdbb3f2017-05-08 15:08:00 +0000637 LLVMStyle.AlignEscapedNewlines = FormatStyle::ENAS_Right;
Daniel Jasper6501f7e2015-10-27 12:38:37 +0000638 LLVMStyle.AlignAfterOpenBracket = FormatStyle::BAS_Align;
Daniel Jasper3219e432014-12-02 13:24:51 +0000639 LLVMStyle.AlignOperands = true;
Daniel Jasper552f4a72013-07-31 23:55:15 +0000640 LLVMStyle.AlignTrailingComments = true;
Daniel Jaspera44991332015-04-29 13:06:49 +0000641 LLVMStyle.AlignConsecutiveAssignments = false;
Daniel Jaspere12597c2015-10-01 10:06:54 +0000642 LLVMStyle.AlignConsecutiveDeclarations = false;
Daniel Jasperf7db4332013-01-29 16:03:49 +0000643 LLVMStyle.AllowAllParametersOfDeclarationOnNextLine = true;
Daniel Jasperd74cf402014-04-08 12:46:38 +0000644 LLVMStyle.AllowShortFunctionsOnASingleLine = FormatStyle::SFS_All;
Daniel Jasper17605d32014-05-14 09:33:35 +0000645 LLVMStyle.AllowShortBlocksOnASingleLine = false;
Daniel Jasperb87899b2014-09-10 13:11:45 +0000646 LLVMStyle.AllowShortCaseLabelsOnASingleLine = false;
Paul Hoad15000a12019-03-13 08:26:39 +0000647 LLVMStyle.AllowShortIfStatementsOnASingleLine = FormatStyle::SIS_Never;
Daniel Jasper3a685df2013-05-16 12:12:21 +0000648 LLVMStyle.AllowShortLoopsOnASingleLine = false;
Zachary Turner448592e2015-12-18 22:20:15 +0000649 LLVMStyle.AlwaysBreakAfterReturnType = FormatStyle::RTBS_None;
Birunthan Mohanathasa0388a82015-06-29 15:30:42 +0000650 LLVMStyle.AlwaysBreakAfterDefinitionReturnType = FormatStyle::DRTBS_None;
Alexander Kornienko58611712013-07-04 12:02:44 +0000651 LLVMStyle.AlwaysBreakBeforeMultilineStrings = false;
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000652 LLVMStyle.AlwaysBreakTemplateDeclarations = FormatStyle::BTDS_MultiLine;
Daniel Jasper18210d72014-10-09 09:52:05 +0000653 LLVMStyle.BinPackArguments = true;
Francois Ferrande56a8292017-06-14 12:29:47 +0000654 LLVMStyle.BinPackParameters = true;
Daniel Jasperac043c92014-09-15 11:11:00 +0000655 LLVMStyle.BreakBeforeBinaryOperators = FormatStyle::BOS_None;
Daniel Jasper165b29e2013-11-08 00:57:11 +0000656 LLVMStyle.BreakBeforeTernaryOperators = true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000657 LLVMStyle.BreakBeforeBraces = FormatStyle::BS_Attach;
Manuel Klimek89628f62017-09-20 09:51:03 +0000658 LLVMStyle.BraceWrapping = {false, false, false, false, false,
659 false, false, false, false, false,
660 false, false, true, true, true};
Nico Weber2cd92f12015-10-15 16:03:01 +0000661 LLVMStyle.BreakAfterJavaFieldAnnotations = false;
Francois Ferranda6b6d512017-05-24 11:36:58 +0000662 LLVMStyle.BreakConstructorInitializers = FormatStyle::BCIS_BeforeColon;
Francois Ferrand6bb103f2018-06-11 14:41:26 +0000663 LLVMStyle.BreakInheritanceList = FormatStyle::BILS_BeforeColon;
Daniel Jaspere1a7b762016-02-01 11:21:02 +0000664 LLVMStyle.BreakStringLiterals = true;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000665 LLVMStyle.ColumnLimit = 80;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000666 LLVMStyle.CommentPragmas = "^ IWYU pragma:";
Francois Ferrande56a8292017-06-14 12:29:47 +0000667 LLVMStyle.CompactNamespaces = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000668 LLVMStyle.ConstructorInitializerAllOnOneLineOrOnePerLine = false;
Daniel Jaspercdaffa42013-08-13 10:58:30 +0000669 LLVMStyle.ConstructorInitializerIndentWidth = 4;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000670 LLVMStyle.ContinuationIndentWidth = 4;
Chandler Carruthf8b72662014-03-02 12:37:31 +0000671 LLVMStyle.Cpp11BracedListStyle = true;
Daniel Jasper553d4872014-06-17 12:40:34 +0000672 LLVMStyle.DerivePointerAlignment = false;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000673 LLVMStyle.ExperimentalAutoDetectBinPacking = false;
Krasimir Georgiev32eaa862017-03-01 15:35:39 +0000674 LLVMStyle.FixNamespaceComments = true;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000675 LLVMStyle.ForEachMacros.push_back("foreach");
676 LLVMStyle.ForEachMacros.push_back("Q_FOREACH");
677 LLVMStyle.ForEachMacros.push_back("BOOST_FOREACH");
Eric Liu9d92c022018-05-14 19:51:33 +0000678 LLVMStyle.IncludeStyle.IncludeCategories = {
679 {"^\"(llvm|llvm-c|clang|clang-c)/", 2},
680 {"^(<|\"(gtest|gmock|isl|json)/)", 3},
681 {".*", 1}};
682 LLVMStyle.IncludeStyle.IncludeIsMainRegex = "(Test)?$";
683 LLVMStyle.IncludeStyle.IncludeBlocks = tooling::IncludeStyle::IBS_Preserve;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000684 LLVMStyle.IndentCaseLabels = false;
Krasimir Georgievad47c902017-08-30 14:34:57 +0000685 LLVMStyle.IndentPPDirectives = FormatStyle::PPDIS_None;
Daniel Jasperc75e1ef2014-07-09 08:42:42 +0000686 LLVMStyle.IndentWrappedFunctionNames = false;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000687 LLVMStyle.IndentWidth = 2;
Martin Probstfb2342d2016-06-13 17:50:10 +0000688 LLVMStyle.JavaScriptQuotes = FormatStyle::JSQS_Leave;
689 LLVMStyle.JavaScriptWrapImports = true;
Alexander Kornienkoebb43ca2013-09-05 14:08:34 +0000690 LLVMStyle.TabWidth = 8;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000691 LLVMStyle.MaxEmptyLinesToKeep = 1;
Daniel Jaspera26fc5c2014-03-21 13:43:14 +0000692 LLVMStyle.KeepEmptyLinesAtTheStartOfBlocks = true;
Daniel Jasper65ee3472013-07-31 23:16:02 +0000693 LLVMStyle.NamespaceIndentation = FormatStyle::NI_None;
Ben Hamilton4dc658c2018-02-02 20:15:14 +0000694 LLVMStyle.ObjCBinPackProtocolList = FormatStyle::BPS_Auto;
Daniel Jasper50d634b2014-10-28 16:53:38 +0000695 LLVMStyle.ObjCBlockIndentWidth = 2;
Daniel Jaspere9beea22014-01-28 15:20:33 +0000696 LLVMStyle.ObjCSpaceAfterProperty = false;
Nico Webera6087752013-01-10 20:12:55 +0000697 LLVMStyle.ObjCSpaceBeforeProtocolList = true;
Daniel Jasper553d4872014-06-17 12:40:34 +0000698 LLVMStyle.PointerAlignment = FormatStyle::PAS_Right;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000699 LLVMStyle.SpacesBeforeTrailingComments = 1;
Chandler Carruthf8b72662014-03-02 12:37:31 +0000700 LLVMStyle.Standard = FormatStyle::LS_Cpp11;
Alexander Kornienko3c3d09c2013-09-27 16:14:22 +0000701 LLVMStyle.UseTab = FormatStyle::UT_Never;
Daniel Jaspera0a50392015-12-01 13:28:53 +0000702 LLVMStyle.ReflowComments = true;
Daniel Jasperb55acad2013-08-20 12:36:34 +0000703 LLVMStyle.SpacesInParentheses = false;
Daniel Jasperad981f82014-08-26 11:41:14 +0000704 LLVMStyle.SpacesInSquareBrackets = false;
Daniel Jasperb55acad2013-08-20 12:36:34 +0000705 LLVMStyle.SpaceInEmptyParentheses = false;
Daniel Jasperb2e10a52014-01-15 15:09:08 +0000706 LLVMStyle.SpacesInContainerLiterals = true;
Daniel Jasperb55acad2013-08-20 12:36:34 +0000707 LLVMStyle.SpacesInCStyleCastParentheses = false;
Daniel Jasperdb986eb2014-09-03 07:37:29 +0000708 LLVMStyle.SpaceAfterCStyleCast = false;
Sylvestre Ledru83bbd572016-08-09 14:24:40 +0000709 LLVMStyle.SpaceAfterTemplateKeyword = true;
Francois Ferrand2a9ea782018-03-01 10:09:13 +0000710 LLVMStyle.SpaceBeforeCtorInitializerColon = true;
711 LLVMStyle.SpaceBeforeInheritanceColon = true;
Alexander Kornienkofdca83d2013-12-10 10:18:34 +0000712 LLVMStyle.SpaceBeforeParens = FormatStyle::SBPO_ControlStatements;
Francois Ferrand2a9ea782018-03-01 10:09:13 +0000713 LLVMStyle.SpaceBeforeRangeBasedForLoopColon = true;
Daniel Jasperd94bff32013-09-25 15:15:02 +0000714 LLVMStyle.SpaceBeforeAssignmentOperators = true;
Hans Wennborgbfc34062018-06-14 08:01:09 +0000715 LLVMStyle.SpaceBeforeCpp11BracedList = false;
Daniel Jasperdd978ae2013-10-29 14:52:02 +0000716 LLVMStyle.SpacesInAngles = false;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000717
Francois Ferrand9976efa2017-05-22 08:28:17 +0000718 LLVMStyle.PenaltyBreakAssignment = prec::Assignment;
Daniel Jasper19a541e2013-12-19 16:45:34 +0000719 LLVMStyle.PenaltyBreakComment = 300;
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000720 LLVMStyle.PenaltyBreakFirstLessLess = 120;
721 LLVMStyle.PenaltyBreakString = 1000;
722 LLVMStyle.PenaltyExcessCharacter = 1000000;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000723 LLVMStyle.PenaltyReturnTypeOnItsOwnLine = 60;
Daniel Jasper33b909c2013-10-25 14:29:37 +0000724 LLVMStyle.PenaltyBreakBeforeFirstCallParameter = 19;
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000725 LLVMStyle.PenaltyBreakTemplateDeclaration = prec::Relational;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000726
Daniel Jasperc64b09a2014-05-22 15:12:22 +0000727 LLVMStyle.DisableFormat = false;
Daniel Jasperda446772015-11-16 12:38:56 +0000728 LLVMStyle.SortIncludes = true;
Krasimir Georgievac16a202017-06-23 11:46:03 +0000729 LLVMStyle.SortUsingDeclarations = true;
Francois Ferrand6f40e212018-10-02 16:37:51 +0000730 LLVMStyle.StatementMacros.push_back("Q_UNUSED");
731 LLVMStyle.StatementMacros.push_back("QT_REQUIRE_VERSION");
Daniel Jasperc64b09a2014-05-22 15:12:22 +0000732
Jordan Rupprecht7f514162019-03-01 00:12:18 +0000733 // Defaults that differ when not C++.
734 if (Language == FormatStyle::LK_TableGen) {
735 LLVMStyle.SpacesInContainerLiterals = false;
736 }
737
Daniel Jasperf7935112012-12-03 18:12:45 +0000738 return LLVMStyle;
739}
740
Nico Weber514ecc82014-02-02 20:50:45 +0000741FormatStyle getGoogleStyle(FormatStyle::LanguageKind Language) {
Krasimir Georgiev26b144c2017-07-03 15:05:14 +0000742 if (Language == FormatStyle::LK_TextProto) {
743 FormatStyle GoogleStyle = getGoogleStyle(FormatStyle::LK_Proto);
744 GoogleStyle.Language = FormatStyle::LK_TextProto;
Krasimir Georgieveda222e2018-01-24 11:18:39 +0000745
Krasimir Georgiev26b144c2017-07-03 15:05:14 +0000746 return GoogleStyle;
747 }
748
Jordan Rupprecht8bd97e72019-02-28 19:16:45 +0000749 FormatStyle GoogleStyle = getLLVMStyle(Language);
Nico Weber514ecc82014-02-02 20:50:45 +0000750
Daniel Jasperf7935112012-12-03 18:12:45 +0000751 GoogleStyle.AccessModifierOffset = -1;
Daniel Jasper7fdbb3f2017-05-08 15:08:00 +0000752 GoogleStyle.AlignEscapedNewlines = FormatStyle::ENAS_Left;
Paul Hoad15000a12019-03-13 08:26:39 +0000753 GoogleStyle.AllowShortIfStatementsOnASingleLine =
754 FormatStyle::SIS_WithoutElse;
Daniel Jasper5bd0b9e2013-05-23 18:05:18 +0000755 GoogleStyle.AllowShortLoopsOnASingleLine = true;
Alexander Kornienko58611712013-07-04 12:02:44 +0000756 GoogleStyle.AlwaysBreakBeforeMultilineStrings = true;
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000757 GoogleStyle.AlwaysBreakTemplateDeclarations = FormatStyle::BTDS_Yes;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000758 GoogleStyle.ConstructorInitializerAllOnOneLineOrOnePerLine = true;
Daniel Jasper553d4872014-06-17 12:40:34 +0000759 GoogleStyle.DerivePointerAlignment = true;
Eric Liu9d92c022018-05-14 19:51:33 +0000760 GoogleStyle.IncludeStyle.IncludeCategories = {
Krasimir Georgieva84e7872017-09-26 14:58:29 +0000761 {"^<ext/.*\\.h>", 2}, {"^<.*\\.h>", 1}, {"^<.*", 2}, {".*", 3}};
Eric Liu9d92c022018-05-14 19:51:33 +0000762 GoogleStyle.IncludeStyle.IncludeIsMainRegex = "([-_](test|unittest))?$";
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000763 GoogleStyle.IndentCaseLabels = true;
Daniel Jaspera26fc5c2014-03-21 13:43:14 +0000764 GoogleStyle.KeepEmptyLinesAtTheStartOfBlocks = false;
Ben Hamilton3a47fdd2018-02-08 01:49:10 +0000765 GoogleStyle.ObjCBinPackProtocolList = FormatStyle::BPS_Never;
Daniel Jaspere9beea22014-01-28 15:20:33 +0000766 GoogleStyle.ObjCSpaceAfterProperty = false;
Ben Hamiltonf84f1182018-01-18 18:37:16 +0000767 GoogleStyle.ObjCSpaceBeforeProtocolList = true;
Daniel Jasper553d4872014-06-17 12:40:34 +0000768 GoogleStyle.PointerAlignment = FormatStyle::PAS_Left;
Krasimir Georgiev5559cc32018-04-25 14:56:19 +0000769 GoogleStyle.RawStringFormats = {
Krasimir Georgiev4527f132018-01-17 12:24:59 +0000770 {
Krasimir Georgiev5559cc32018-04-25 14:56:19 +0000771 FormatStyle::LK_Cpp,
772 /*Delimiters=*/
773 {
774 "cc",
775 "CC",
776 "cpp",
777 "Cpp",
778 "CPP",
779 "c++",
780 "C++",
781 },
782 /*EnclosingFunctionNames=*/
783 {},
784 /*CanonicalDelimiter=*/"",
785 /*BasedOnStyle=*/"google",
Krasimir Georgiev4527f132018-01-17 12:24:59 +0000786 },
Krasimir Georgiev5559cc32018-04-25 14:56:19 +0000787 {
788 FormatStyle::LK_TextProto,
789 /*Delimiters=*/
790 {
791 "pb",
792 "PB",
793 "proto",
794 "PROTO",
795 },
796 /*EnclosingFunctionNames=*/
Krasimir Georgiev42948e32018-06-26 12:00:14 +0000797 {
Krasimir Georgiev42948e32018-06-26 12:00:14 +0000798 "EqualsProto",
Krasimir Georgiev61f46f22018-06-29 14:25:25 +0000799 "EquivToProto",
Krasimir Georgievce0b8d62018-08-01 12:35:23 +0000800 "PARSE_PARTIAL_TEXT_PROTO",
Krasimir Georgiev61f46f22018-06-29 14:25:25 +0000801 "PARSE_TEST_PROTO",
802 "PARSE_TEXT_PROTO",
803 "ParseTextOrDie",
Krasimir Georgievce0b8d62018-08-01 12:35:23 +0000804 "ParseTextProtoOrDie",
Krasimir Georgiev42948e32018-06-26 12:00:14 +0000805 },
Krasimir Georgiev5559cc32018-04-25 14:56:19 +0000806 /*CanonicalDelimiter=*/"",
807 /*BasedOnStyle=*/"google",
808 },
809 };
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000810 GoogleStyle.SpacesBeforeTrailingComments = 2;
811 GoogleStyle.Standard = FormatStyle::LS_Auto;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000812
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000813 GoogleStyle.PenaltyReturnTypeOnItsOwnLine = 200;
Daniel Jasper33b909c2013-10-25 14:29:37 +0000814 GoogleStyle.PenaltyBreakBeforeFirstCallParameter = 1;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000815
Daniel Jasperc58c70e2014-09-15 11:21:46 +0000816 if (Language == FormatStyle::LK_Java) {
Daniel Jasper6501f7e2015-10-27 12:38:37 +0000817 GoogleStyle.AlignAfterOpenBracket = FormatStyle::BAS_DontAlign;
Daniel Jasper3219e432014-12-02 13:24:51 +0000818 GoogleStyle.AlignOperands = false;
Daniel Jasperfd4ed182015-01-04 20:40:45 +0000819 GoogleStyle.AlignTrailingComments = false;
Daniel Jasper9e709352014-11-26 10:43:58 +0000820 GoogleStyle.AllowShortFunctionsOnASingleLine = FormatStyle::SFS_Empty;
Paul Hoad15000a12019-03-13 08:26:39 +0000821 GoogleStyle.AllowShortIfStatementsOnASingleLine = FormatStyle::SIS_Never;
Daniel Jasper1cd3c712015-01-14 12:24:59 +0000822 GoogleStyle.AlwaysBreakBeforeMultilineStrings = false;
Daniel Jasperc58c70e2014-09-15 11:21:46 +0000823 GoogleStyle.BreakBeforeBinaryOperators = FormatStyle::BOS_NonAssignment;
824 GoogleStyle.ColumnLimit = 100;
825 GoogleStyle.SpaceAfterCStyleCast = true;
Daniel Jasper61d81972014-11-14 08:22:46 +0000826 GoogleStyle.SpacesBeforeTrailingComments = 1;
Daniel Jasperc58c70e2014-09-15 11:21:46 +0000827 } else if (Language == FormatStyle::LK_JavaScript) {
Daniel Jasper6501f7e2015-10-27 12:38:37 +0000828 GoogleStyle.AlignAfterOpenBracket = FormatStyle::BAS_AlwaysBreak;
Daniel Jasper41a2bf72015-12-21 13:52:19 +0000829 GoogleStyle.AlignOperands = false;
Daniel Jasper28d8a5a2016-09-07 23:01:13 +0000830 GoogleStyle.AllowShortFunctionsOnASingleLine = FormatStyle::SFS_Empty;
Daniel Jasper6501f7e2015-10-27 12:38:37 +0000831 GoogleStyle.AlwaysBreakBeforeMultilineStrings = false;
Daniel Jaspere551bb72014-11-05 17:22:31 +0000832 GoogleStyle.BreakBeforeTernaryOperators = false;
Krasimir Georgiev6a5c95b2018-07-30 08:45:45 +0000833 // taze:, triple slash directives (`/// <...`), @see, which is commonly
834 // followed by overlong URLs.
835 GoogleStyle.CommentPragmas = "(taze:|^/[ \t]*<|@see)";
Daniel Jasper8f83a902014-05-09 10:28:58 +0000836 GoogleStyle.MaxEmptyLinesToKeep = 3;
Martin Probstece8c0c2016-06-13 16:41:28 +0000837 GoogleStyle.NamespaceIndentation = FormatStyle::NI_All;
Nico Weber514ecc82014-02-02 20:50:45 +0000838 GoogleStyle.SpacesInContainerLiterals = false;
Daniel Jasperabd1f572016-03-02 22:44:03 +0000839 GoogleStyle.JavaScriptQuotes = FormatStyle::JSQS_Single;
Martin Probst0cd74ee2016-06-13 16:39:50 +0000840 GoogleStyle.JavaScriptWrapImports = false;
Nico Weber514ecc82014-02-02 20:50:45 +0000841 } else if (Language == FormatStyle::LK_Proto) {
Daniel Jasper67e65212018-08-15 19:07:55 +0000842 GoogleStyle.AllowShortFunctionsOnASingleLine = FormatStyle::SFS_Empty;
Daniel Jasper9c95dfe2018-03-12 10:32:18 +0000843 GoogleStyle.AlwaysBreakBeforeMultilineStrings = false;
Daniel Jasper783bac62014-04-15 09:54:30 +0000844 GoogleStyle.SpacesInContainerLiterals = false;
Krasimir Georgievc2091802018-01-31 10:14:10 +0000845 GoogleStyle.Cpp11BracedListStyle = false;
Krasimir Georgiev374e6de2018-02-08 10:47:12 +0000846 // This affects protocol buffer options specifications and text protos.
847 // Text protos are currently mostly formatted inside C++ raw string literals
848 // and often the current breaking behavior of string literals is not
849 // beneficial there. Investigate turning this on once proper string reflow
850 // has been implemented.
851 GoogleStyle.BreakStringLiterals = false;
Daniel Jasper03a04fe2016-12-12 12:42:29 +0000852 } else if (Language == FormatStyle::LK_ObjC) {
Ben Hamilton1ab722e2018-06-14 17:30:10 +0000853 GoogleStyle.AlwaysBreakBeforeMultilineStrings = false;
Daniel Jasper03a04fe2016-12-12 12:42:29 +0000854 GoogleStyle.ColumnLimit = 100;
Nico Weber514ecc82014-02-02 20:50:45 +0000855 }
856
Daniel Jasperf7935112012-12-03 18:12:45 +0000857 return GoogleStyle;
858}
859
Nico Weber514ecc82014-02-02 20:50:45 +0000860FormatStyle getChromiumStyle(FormatStyle::LanguageKind Language) {
861 FormatStyle ChromiumStyle = getGoogleStyle(Language);
Nico Weber450425c2014-11-26 16:43:18 +0000862 if (Language == FormatStyle::LK_Java) {
Paul Hoad15000a12019-03-13 08:26:39 +0000863 ChromiumStyle.AllowShortIfStatementsOnASingleLine =
864 FormatStyle::SIS_WithoutElse;
Nico Weber2cd92f12015-10-15 16:03:01 +0000865 ChromiumStyle.BreakAfterJavaFieldAnnotations = true;
Nico Weber450425c2014-11-26 16:43:18 +0000866 ChromiumStyle.ContinuationIndentWidth = 8;
Nico Weber2cd92f12015-10-15 16:03:01 +0000867 ChromiumStyle.IndentWidth = 4;
Krasimir Georgiev7e91b032018-10-05 17:19:26 +0000868 // See styleguide for import groups:
869 // https://chromium.googlesource.com/chromium/src/+/master/styleguide/java/java.md#Import-Order
870 ChromiumStyle.JavaImportGroups = {
Paul Hoad5bcf99b2019-03-01 09:09:54 +0000871 "android", "com", "dalvik",
872 "junit", "org", "com.google.android.apps.chrome",
873 "org.chromium", "java", "javax",
Krasimir Georgiev7e91b032018-10-05 17:19:26 +0000874 };
875 ChromiumStyle.SortIncludes = true;
Nico Weberea649692017-01-04 02:33:36 +0000876 } else if (Language == FormatStyle::LK_JavaScript) {
Paul Hoad15000a12019-03-13 08:26:39 +0000877 ChromiumStyle.AllowShortIfStatementsOnASingleLine = FormatStyle::SIS_Never;
Nico Weberea649692017-01-04 02:33:36 +0000878 ChromiumStyle.AllowShortLoopsOnASingleLine = false;
Nico Weber450425c2014-11-26 16:43:18 +0000879 } else {
880 ChromiumStyle.AllowAllParametersOfDeclarationOnNextLine = false;
881 ChromiumStyle.AllowShortFunctionsOnASingleLine = FormatStyle::SFS_Inline;
Paul Hoad15000a12019-03-13 08:26:39 +0000882 ChromiumStyle.AllowShortIfStatementsOnASingleLine = FormatStyle::SIS_Never;
Nico Weber450425c2014-11-26 16:43:18 +0000883 ChromiumStyle.AllowShortLoopsOnASingleLine = false;
884 ChromiumStyle.BinPackParameters = false;
885 ChromiumStyle.DerivePointerAlignment = false;
Nico Weber9e2bc302017-01-31 18:42:05 +0000886 if (Language == FormatStyle::LK_ObjC)
887 ChromiumStyle.ColumnLimit = 80;
Nico Weber450425c2014-11-26 16:43:18 +0000888 }
Daniel Jasper1b750ed2013-01-14 16:24:39 +0000889 return ChromiumStyle;
890}
891
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000892FormatStyle getMozillaStyle() {
893 FormatStyle MozillaStyle = getLLVMStyle();
894 MozillaStyle.AllowAllParametersOfDeclarationOnNextLine = false;
Birunthan Mohanathasa0810022015-06-29 15:18:58 +0000895 MozillaStyle.AllowShortFunctionsOnASingleLine = FormatStyle::SFS_Inline;
Manuel Klimek89628f62017-09-20 09:51:03 +0000896 MozillaStyle.AlwaysBreakAfterReturnType = FormatStyle::RTBS_TopLevel;
Birunthan Mohanathasa0388a82015-06-29 15:30:42 +0000897 MozillaStyle.AlwaysBreakAfterDefinitionReturnType =
898 FormatStyle::DRTBS_TopLevel;
Francois Ferrand58e6fe52018-05-16 08:25:03 +0000899 MozillaStyle.AlwaysBreakTemplateDeclarations = FormatStyle::BTDS_Yes;
Sylvestre Ledrudcb038d2016-12-14 16:09:29 +0000900 MozillaStyle.BinPackParameters = false;
901 MozillaStyle.BinPackArguments = false;
Birunthan Mohanathas305fa9c2015-07-12 03:13:54 +0000902 MozillaStyle.BreakBeforeBraces = FormatStyle::BS_Mozilla;
Francois Ferranda6b6d512017-05-24 11:36:58 +0000903 MozillaStyle.BreakConstructorInitializers = FormatStyle::BCIS_BeforeComma;
Francois Ferrand6bb103f2018-06-11 14:41:26 +0000904 MozillaStyle.BreakInheritanceList = FormatStyle::BILS_BeforeComma;
Birunthan Mohanathasa0810022015-06-29 15:18:58 +0000905 MozillaStyle.ConstructorInitializerIndentWidth = 2;
906 MozillaStyle.ContinuationIndentWidth = 2;
Chandler Carruthf8b72662014-03-02 12:37:31 +0000907 MozillaStyle.Cpp11BracedListStyle = false;
Krasimir Georgiev32eaa862017-03-01 15:35:39 +0000908 MozillaStyle.FixNamespaceComments = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000909 MozillaStyle.IndentCaseLabels = true;
Daniel Jaspere9beea22014-01-28 15:20:33 +0000910 MozillaStyle.ObjCSpaceAfterProperty = true;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000911 MozillaStyle.ObjCSpaceBeforeProtocolList = false;
912 MozillaStyle.PenaltyReturnTypeOnItsOwnLine = 200;
Daniel Jasper553d4872014-06-17 12:40:34 +0000913 MozillaStyle.PointerAlignment = FormatStyle::PAS_Left;
Sylvestre Ledru83bbd572016-08-09 14:24:40 +0000914 MozillaStyle.SpaceAfterTemplateKeyword = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000915 return MozillaStyle;
916}
917
Daniel Jasperffefb3d2013-07-24 13:10:59 +0000918FormatStyle getWebKitStyle() {
919 FormatStyle Style = getLLVMStyle();
Daniel Jasper65ee3472013-07-31 23:16:02 +0000920 Style.AccessModifierOffset = -4;
Daniel Jasper6501f7e2015-10-27 12:38:37 +0000921 Style.AlignAfterOpenBracket = FormatStyle::BAS_DontAlign;
Daniel Jasper3219e432014-12-02 13:24:51 +0000922 Style.AlignOperands = false;
Daniel Jasper552f4a72013-07-31 23:55:15 +0000923 Style.AlignTrailingComments = false;
Daniel Jasperac043c92014-09-15 11:11:00 +0000924 Style.BreakBeforeBinaryOperators = FormatStyle::BOS_All;
Roman Kashitsyn291f64f2015-08-10 13:43:19 +0000925 Style.BreakBeforeBraces = FormatStyle::BS_WebKit;
Francois Ferranda6b6d512017-05-24 11:36:58 +0000926 Style.BreakConstructorInitializers = FormatStyle::BCIS_BeforeComma;
Chandler Carruthf8b72662014-03-02 12:37:31 +0000927 Style.Cpp11BracedListStyle = false;
Daniel Jasper65ee3472013-07-31 23:16:02 +0000928 Style.ColumnLimit = 0;
Krasimir Georgiev32eaa862017-03-01 15:35:39 +0000929 Style.FixNamespaceComments = false;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000930 Style.IndentWidth = 4;
Daniel Jasper65ee3472013-07-31 23:16:02 +0000931 Style.NamespaceIndentation = FormatStyle::NI_Inner;
Daniel Jasper50d634b2014-10-28 16:53:38 +0000932 Style.ObjCBlockIndentWidth = 4;
Daniel Jaspere9beea22014-01-28 15:20:33 +0000933 Style.ObjCSpaceAfterProperty = true;
Daniel Jasper553d4872014-06-17 12:40:34 +0000934 Style.PointerAlignment = FormatStyle::PAS_Left;
Hans Wennborgbfc34062018-06-14 08:01:09 +0000935 Style.SpaceBeforeCpp11BracedList = true;
Daniel Jasperffefb3d2013-07-24 13:10:59 +0000936 return Style;
937}
938
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000939FormatStyle getGNUStyle() {
940 FormatStyle Style = getLLVMStyle();
Birunthan Mohanathasa0388a82015-06-29 15:30:42 +0000941 Style.AlwaysBreakAfterDefinitionReturnType = FormatStyle::DRTBS_All;
Zachary Turner448592e2015-12-18 22:20:15 +0000942 Style.AlwaysBreakAfterReturnType = FormatStyle::RTBS_AllDefinitions;
Daniel Jasperac043c92014-09-15 11:11:00 +0000943 Style.BreakBeforeBinaryOperators = FormatStyle::BOS_All;
Alexander Kornienko3a33f022013-12-12 09:49:52 +0000944 Style.BreakBeforeBraces = FormatStyle::BS_GNU;
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000945 Style.BreakBeforeTernaryOperators = true;
Chandler Carruthf8b72662014-03-02 12:37:31 +0000946 Style.Cpp11BracedListStyle = false;
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000947 Style.ColumnLimit = 79;
Krasimir Georgiev32eaa862017-03-01 15:35:39 +0000948 Style.FixNamespaceComments = false;
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000949 Style.SpaceBeforeParens = FormatStyle::SBPO_Always;
Chandler Carruthf8b72662014-03-02 12:37:31 +0000950 Style.Standard = FormatStyle::LS_Cpp03;
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000951 return Style;
952}
953
Daniel Jasperc64b09a2014-05-22 15:12:22 +0000954FormatStyle getNoStyle() {
955 FormatStyle NoStyle = getLLVMStyle();
956 NoStyle.DisableFormat = true;
Daniel Jasperda446772015-11-16 12:38:56 +0000957 NoStyle.SortIncludes = false;
Krasimir Georgievac16a202017-06-23 11:46:03 +0000958 NoStyle.SortUsingDeclarations = false;
Daniel Jasperc64b09a2014-05-22 15:12:22 +0000959 return NoStyle;
960}
961
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000962bool getPredefinedStyle(StringRef Name, FormatStyle::LanguageKind Language,
963 FormatStyle *Style) {
964 if (Name.equals_lower("llvm")) {
Jordan Rupprecht55881d52019-03-13 21:13:01 +0000965 *Style = getLLVMStyle(Language);
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000966 } else if (Name.equals_lower("chromium")) {
Nico Weber514ecc82014-02-02 20:50:45 +0000967 *Style = getChromiumStyle(Language);
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000968 } else if (Name.equals_lower("mozilla")) {
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000969 *Style = getMozillaStyle();
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000970 } else if (Name.equals_lower("google")) {
Nico Weber514ecc82014-02-02 20:50:45 +0000971 *Style = getGoogleStyle(Language);
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000972 } else if (Name.equals_lower("webkit")) {
Daniel Jasperffefb3d2013-07-24 13:10:59 +0000973 *Style = getWebKitStyle();
Alexander Kornienkofe7a57f2013-12-10 15:42:15 +0000974 } else if (Name.equals_lower("gnu")) {
975 *Style = getGNUStyle();
Daniel Jasperc64b09a2014-05-22 15:12:22 +0000976 } else if (Name.equals_lower("none")) {
977 *Style = getNoStyle();
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000978 } else {
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000979 return false;
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000980 }
Alexander Kornienkod6538332013-05-07 15:32:14 +0000981
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000982 Style->Language = Language;
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000983 return true;
Alexander Kornienkod6538332013-05-07 15:32:14 +0000984}
985
Rafael Espindolac0809172014-06-12 14:02:15 +0000986std::error_code parseConfiguration(StringRef Text, FormatStyle *Style) {
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000987 assert(Style);
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000988 FormatStyle::LanguageKind Language = Style->Language;
989 assert(Language != FormatStyle::LK_None);
Alexander Kornienko06e00332013-05-20 15:18:01 +0000990 if (Text.trim().empty())
Rafael Espindolad0136702014-06-12 02:50:04 +0000991 return make_error_code(ParseError::Error);
Krasimir Georgiev54076fe2018-01-15 12:06:16 +0000992 Style->StyleSet.Clear();
Alexander Kornienkocabdd732013-11-29 15:19:43 +0000993 std::vector<FormatStyle> Styles;
Alexander Kornienkod6538332013-05-07 15:32:14 +0000994 llvm::yaml::Input Input(Text);
Alexander Kornienkoc1637f12013-12-10 11:28:13 +0000995 // DocumentListTraits<vector<FormatStyle>> uses the context to get default
996 // values for the fields, keys for which are missing from the configuration.
997 // Mapping also uses the context to get the language to find the correct
998 // base style.
999 Input.setContext(Style);
Alexander Kornienkocabdd732013-11-29 15:19:43 +00001000 Input >> Styles;
1001 if (Input.error())
1002 return Input.error();
1003
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00001004 for (unsigned i = 0; i < Styles.size(); ++i) {
Alexander Kornienkocabdd732013-11-29 15:19:43 +00001005 // Ensures that only the first configuration can skip the Language option.
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00001006 if (Styles[i].Language == FormatStyle::LK_None && i != 0)
Rafael Espindolad0136702014-06-12 02:50:04 +00001007 return make_error_code(ParseError::Error);
Alexander Kornienkocabdd732013-11-29 15:19:43 +00001008 // Ensure that each language is configured at most once.
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00001009 for (unsigned j = 0; j < i; ++j) {
1010 if (Styles[i].Language == Styles[j].Language) {
Nicola Zaghen3538b392018-05-15 13:30:56 +00001011 LLVM_DEBUG(llvm::dbgs()
1012 << "Duplicate languages in the config file on positions "
1013 << j << " and " << i << "\n");
Rafael Espindolad0136702014-06-12 02:50:04 +00001014 return make_error_code(ParseError::Error);
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00001015 }
Alexander Kornienkocabdd732013-11-29 15:19:43 +00001016 }
1017 }
1018 // Look for a suitable configuration starting from the end, so we can
1019 // find the configuration for the specific language first, and the default
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00001020 // configuration (which can only be at slot 0) after it.
Krasimir Georgiev54076fe2018-01-15 12:06:16 +00001021 FormatStyle::FormatStyleSet StyleSet;
1022 bool LanguageFound = false;
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00001023 for (int i = Styles.size() - 1; i >= 0; --i) {
Krasimir Georgiev54076fe2018-01-15 12:06:16 +00001024 if (Styles[i].Language != FormatStyle::LK_None)
1025 StyleSet.Add(Styles[i]);
1026 if (Styles[i].Language == Language)
1027 LanguageFound = true;
Alexander Kornienkocabdd732013-11-29 15:19:43 +00001028 }
Krasimir Georgiev54076fe2018-01-15 12:06:16 +00001029 if (!LanguageFound) {
1030 if (Styles.empty() || Styles[0].Language != FormatStyle::LK_None)
1031 return make_error_code(ParseError::Unsuitable);
1032 FormatStyle DefaultStyle = Styles[0];
1033 DefaultStyle.Language = Language;
1034 StyleSet.Add(std::move(DefaultStyle));
1035 }
1036 *Style = *StyleSet.Get(Language);
1037 return make_error_code(ParseError::Success);
Alexander Kornienkod6538332013-05-07 15:32:14 +00001038}
1039
1040std::string configurationAsText(const FormatStyle &Style) {
1041 std::string Text;
1042 llvm::raw_string_ostream Stream(Text);
1043 llvm::yaml::Output Output(Stream);
1044 // We use the same mapping method for input and output, so we need a non-const
1045 // reference here.
Daniel Jasperc1bc38e2015-09-29 14:57:55 +00001046 FormatStyle NonConstStyle = expandPresets(Style);
Alexander Kornienkod6538332013-05-07 15:32:14 +00001047 Output << NonConstStyle;
Alexander Kornienko9a38ec22013-05-13 12:56:35 +00001048 return Stream.str();
Alexander Kornienkod6538332013-05-07 15:32:14 +00001049}
1050
Krasimir Georgiev54076fe2018-01-15 12:06:16 +00001051llvm::Optional<FormatStyle>
1052FormatStyle::FormatStyleSet::Get(FormatStyle::LanguageKind Language) const {
1053 if (!Styles)
1054 return None;
1055 auto It = Styles->find(Language);
1056 if (It == Styles->end())
1057 return None;
1058 FormatStyle Style = It->second;
1059 Style.StyleSet = *this;
1060 return Style;
1061}
1062
1063void FormatStyle::FormatStyleSet::Add(FormatStyle Style) {
1064 assert(Style.Language != LK_None &&
1065 "Cannot add a style for LK_None to a StyleSet");
1066 assert(
1067 !Style.StyleSet.Styles &&
1068 "Cannot add a style associated with an existing StyleSet to a StyleSet");
1069 if (!Styles)
1070 Styles = std::make_shared<MapType>();
1071 (*Styles)[Style.Language] = std::move(Style);
1072}
1073
Paul Hoad5bcf99b2019-03-01 09:09:54 +00001074void FormatStyle::FormatStyleSet::Clear() { Styles.reset(); }
Krasimir Georgiev54076fe2018-01-15 12:06:16 +00001075
1076llvm::Optional<FormatStyle>
1077FormatStyle::GetLanguageStyle(FormatStyle::LanguageKind Language) const {
1078 return StyleSet.Get(Language);
1079}
1080
Craig Topperaf35e852013-06-30 22:29:28 +00001081namespace {
1082
Daniel Jasper496c1992016-09-07 22:48:53 +00001083class JavaScriptRequoter : public TokenAnalyzer {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001084public:
Daniel Jasper496c1992016-09-07 22:48:53 +00001085 JavaScriptRequoter(const Environment &Env, const FormatStyle &Style)
1086 : TokenAnalyzer(Env, Style) {}
Eric Liu4cfb88a2016-04-25 15:09:22 +00001087
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00001088 std::pair<tooling::Replacements, unsigned>
Eric Liu4cfb88a2016-04-25 15:09:22 +00001089 analyze(TokenAnnotator &Annotator,
1090 SmallVectorImpl<AnnotatedLine *> &AnnotatedLines,
Martin Probsta9855af2016-09-02 14:29:48 +00001091 FormatTokenLexer &Tokens) override {
Manuel Klimek0dddcf72018-04-23 09:34:26 +00001092 AffectedRangeMgr.computeAffectedLines(AnnotatedLines);
Daniel Jasper496c1992016-09-07 22:48:53 +00001093 tooling::Replacements Result;
1094 requoteJSStringLiteral(AnnotatedLines, Result);
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00001095 return {Result, 0};
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001096 }
1097
1098private:
Daniel Jasper496c1992016-09-07 22:48:53 +00001099 // Replaces double/single-quoted string literal as appropriate, re-escaping
1100 // the contents in the process.
Daniel Jasper97439922016-03-17 13:03:41 +00001101 void requoteJSStringLiteral(SmallVectorImpl<AnnotatedLine *> &Lines,
Eric Liu4cfb88a2016-04-25 15:09:22 +00001102 tooling::Replacements &Result) {
Daniel Jasper97439922016-03-17 13:03:41 +00001103 for (AnnotatedLine *Line : Lines) {
1104 requoteJSStringLiteral(Line->Children, Result);
1105 if (!Line->Affected)
1106 continue;
1107 for (FormatToken *FormatTok = Line->First; FormatTok;
1108 FormatTok = FormatTok->Next) {
1109 StringRef Input = FormatTok->TokenText;
Martin Probsta1669792016-05-12 11:20:32 +00001110 if (FormatTok->Finalized || !FormatTok->isStringLiteral() ||
Daniel Jasper97439922016-03-17 13:03:41 +00001111 // NB: testing for not starting with a double quote to avoid
Daniel Jasper496c1992016-09-07 22:48:53 +00001112 // breaking `template strings`.
Eric Liu635423e2016-04-28 07:52:03 +00001113 (Style.JavaScriptQuotes == FormatStyle::JSQS_Single &&
Daniel Jasper97439922016-03-17 13:03:41 +00001114 !Input.startswith("\"")) ||
Eric Liu635423e2016-04-28 07:52:03 +00001115 (Style.JavaScriptQuotes == FormatStyle::JSQS_Double &&
Daniel Jasper97439922016-03-17 13:03:41 +00001116 !Input.startswith("\'")))
1117 continue;
1118
1119 // Change start and end quote.
Eric Liu635423e2016-04-28 07:52:03 +00001120 bool IsSingle = Style.JavaScriptQuotes == FormatStyle::JSQS_Single;
Daniel Jasper97439922016-03-17 13:03:41 +00001121 SourceLocation Start = FormatTok->Tok.getLocation();
1122 auto Replace = [&](SourceLocation Start, unsigned Length,
1123 StringRef ReplacementText) {
Eric Liu40ef2fb2016-08-01 10:16:37 +00001124 auto Err = Result.add(tooling::Replacement(
1125 Env.getSourceManager(), Start, Length, ReplacementText));
1126 // FIXME: handle error. For now, print error message and skip the
1127 // replacement for release version.
Piotr Padlewski1ec383c2016-12-23 11:40:44 +00001128 if (Err) {
Eric Liu40ef2fb2016-08-01 10:16:37 +00001129 llvm::errs() << llvm::toString(std::move(Err)) << "\n";
Piotr Padlewski1ec383c2016-12-23 11:40:44 +00001130 assert(false);
1131 }
Daniel Jasper97439922016-03-17 13:03:41 +00001132 };
1133 Replace(Start, 1, IsSingle ? "'" : "\"");
1134 Replace(FormatTok->Tok.getEndLoc().getLocWithOffset(-1), 1,
1135 IsSingle ? "'" : "\"");
1136
1137 // Escape internal quotes.
Daniel Jasper97439922016-03-17 13:03:41 +00001138 bool Escaped = false;
1139 for (size_t i = 1; i < Input.size() - 1; i++) {
1140 switch (Input[i]) {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001141 case '\\':
1142 if (!Escaped && i + 1 < Input.size() &&
1143 ((IsSingle && Input[i + 1] == '"') ||
1144 (!IsSingle && Input[i + 1] == '\''))) {
1145 // Remove this \, it's escaping a " or ' that no longer needs
1146 // escaping
Eric Liu4cfb88a2016-04-25 15:09:22 +00001147 Replace(Start.getLocWithOffset(i), 1, "");
1148 continue;
1149 }
1150 Escaped = !Escaped;
1151 break;
1152 case '\"':
1153 case '\'':
1154 if (!Escaped && IsSingle == (Input[i] == '\'')) {
1155 // Escape the quote.
1156 Replace(Start.getLocWithOffset(i), 0, "\\");
Eric Liu4cfb88a2016-04-25 15:09:22 +00001157 }
1158 Escaped = false;
1159 break;
1160 default:
1161 Escaped = false;
1162 break;
Daniel Jasper97439922016-03-17 13:03:41 +00001163 }
1164 }
Daniel Jasper97439922016-03-17 13:03:41 +00001165 }
1166 }
1167 }
Daniel Jasper496c1992016-09-07 22:48:53 +00001168};
1169
1170class Formatter : public TokenAnalyzer {
1171public:
1172 Formatter(const Environment &Env, const FormatStyle &Style,
Krasimir Georgievbcda54b2017-04-21 14:35:20 +00001173 FormattingAttemptStatus *Status)
1174 : TokenAnalyzer(Env, Style), Status(Status) {}
Daniel Jasper496c1992016-09-07 22:48:53 +00001175
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00001176 std::pair<tooling::Replacements, unsigned>
Daniel Jasper496c1992016-09-07 22:48:53 +00001177 analyze(TokenAnnotator &Annotator,
1178 SmallVectorImpl<AnnotatedLine *> &AnnotatedLines,
1179 FormatTokenLexer &Tokens) override {
1180 tooling::Replacements Result;
1181 deriveLocalStyle(AnnotatedLines);
Manuel Klimek0dddcf72018-04-23 09:34:26 +00001182 AffectedRangeMgr.computeAffectedLines(AnnotatedLines);
Daniel Jasper496c1992016-09-07 22:48:53 +00001183 for (unsigned i = 0, e = AnnotatedLines.size(); i != e; ++i) {
1184 Annotator.calculateFormattingInformation(*AnnotatedLines[i]);
1185 }
1186 Annotator.setCommentLineLevels(AnnotatedLines);
1187
1188 WhitespaceManager Whitespaces(
1189 Env.getSourceManager(), Style,
1190 inputUsesCRLF(Env.getSourceManager().getBufferData(Env.getFileID())));
1191 ContinuationIndenter Indenter(Style, Tokens.getKeywords(),
1192 Env.getSourceManager(), Whitespaces, Encoding,
1193 BinPackInconclusiveFunctions);
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00001194 unsigned Penalty =
1195 UnwrappedLineFormatter(&Indenter, &Whitespaces, Style,
1196 Tokens.getKeywords(), Env.getSourceManager(),
1197 Status)
1198 .format(AnnotatedLines, /*DryRun=*/false,
1199 /*AdditionalIndent=*/0,
1200 /*FixBadIndentation=*/false,
1201 /*FirstStartColumn=*/Env.getFirstStartColumn(),
1202 /*NextStartColumn=*/Env.getNextStartColumn(),
1203 /*LastStartColumn=*/Env.getLastStartColumn());
Daniel Jasper496c1992016-09-07 22:48:53 +00001204 for (const auto &R : Whitespaces.generateReplacements())
1205 if (Result.add(R))
Krasimir Georgieve56e9a42017-10-30 14:30:14 +00001206 return std::make_pair(Result, 0);
1207 return std::make_pair(Result, Penalty);
Daniel Jasper496c1992016-09-07 22:48:53 +00001208 }
1209
1210private:
Alexander Kornienko9e649af2013-09-11 12:25:57 +00001211 static bool inputUsesCRLF(StringRef Text) {
1212 return Text.count('\r') * 2 > Text.count('\n');
1213 }
1214
Daniel Jasper352f0df2015-07-18 16:35:30 +00001215 bool
1216 hasCpp03IncompatibleFormat(const SmallVectorImpl<AnnotatedLine *> &Lines) {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001217 for (const AnnotatedLine *Line : Lines) {
Daniel Jasper352f0df2015-07-18 16:35:30 +00001218 if (hasCpp03IncompatibleFormat(Line->Children))
1219 return true;
1220 for (FormatToken *Tok = Line->First->Next; Tok; Tok = Tok->Next) {
1221 if (Tok->WhitespaceRange.getBegin() == Tok->WhitespaceRange.getEnd()) {
1222 if (Tok->is(tok::coloncolon) && Tok->Previous->is(TT_TemplateOpener))
1223 return true;
1224 if (Tok->is(TT_TemplateCloser) &&
1225 Tok->Previous->is(TT_TemplateCloser))
1226 return true;
1227 }
1228 }
1229 }
1230 return false;
1231 }
1232
1233 int countVariableAlignments(const SmallVectorImpl<AnnotatedLine *> &Lines) {
1234 int AlignmentDiff = 0;
Eric Liu4cfb88a2016-04-25 15:09:22 +00001235 for (const AnnotatedLine *Line : Lines) {
Daniel Jasper352f0df2015-07-18 16:35:30 +00001236 AlignmentDiff += countVariableAlignments(Line->Children);
1237 for (FormatToken *Tok = Line->First; Tok && Tok->Next; Tok = Tok->Next) {
1238 if (!Tok->is(TT_PointerOrReference))
1239 continue;
1240 bool SpaceBefore =
1241 Tok->WhitespaceRange.getBegin() != Tok->WhitespaceRange.getEnd();
1242 bool SpaceAfter = Tok->Next->WhitespaceRange.getBegin() !=
1243 Tok->Next->WhitespaceRange.getEnd();
1244 if (SpaceBefore && !SpaceAfter)
1245 ++AlignmentDiff;
1246 if (!SpaceBefore && SpaceAfter)
1247 --AlignmentDiff;
1248 }
1249 }
1250 return AlignmentDiff;
1251 }
1252
Manuel Klimek71814b42013-10-11 21:25:45 +00001253 void
1254 deriveLocalStyle(const SmallVectorImpl<AnnotatedLine *> &AnnotatedLines) {
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001255 bool HasBinPackedFunction = false;
1256 bool HasOnePerLineFunction = false;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001257 for (unsigned i = 0, e = AnnotatedLines.size(); i != e; ++i) {
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001258 if (!AnnotatedLines[i]->First->Next)
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001259 continue;
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001260 FormatToken *Tok = AnnotatedLines[i]->First->Next;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001261 while (Tok->Next) {
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001262 if (Tok->PackingKind == PPK_BinPacked)
1263 HasBinPackedFunction = true;
1264 if (Tok->PackingKind == PPK_OnePerLine)
1265 HasOnePerLineFunction = true;
1266
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001267 Tok = Tok->Next;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001268 }
1269 }
Eric Liu635423e2016-04-28 07:52:03 +00001270 if (Style.DerivePointerAlignment)
1271 Style.PointerAlignment = countVariableAlignments(AnnotatedLines) <= 0
1272 ? FormatStyle::PAS_Left
1273 : FormatStyle::PAS_Right;
1274 if (Style.Standard == FormatStyle::LS_Auto)
1275 Style.Standard = hasCpp03IncompatibleFormat(AnnotatedLines)
1276 ? FormatStyle::LS_Cpp11
1277 : FormatStyle::LS_Cpp03;
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001278 BinPackInconclusiveFunctions =
1279 HasBinPackedFunction || !HasOnePerLineFunction;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001280 }
1281
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001282 bool BinPackInconclusiveFunctions;
Krasimir Georgievbcda54b2017-04-21 14:35:20 +00001283 FormattingAttemptStatus *Status;
Eric Liu4cfb88a2016-04-25 15:09:22 +00001284};
1285
1286// This class clean up the erroneous/redundant code around the given ranges in
1287// file.
1288class Cleaner : public TokenAnalyzer {
1289public:
Eric Liu635423e2016-04-28 07:52:03 +00001290 Cleaner(const Environment &Env, const FormatStyle &Style)
1291 : TokenAnalyzer(Env, Style),
Eric Liu4cfb88a2016-04-25 15:09:22 +00001292 DeletedTokens(FormatTokenLess(Env.getSourceManager())) {}
1293
1294 // FIXME: eliminate unused parameters.
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00001295 std::pair<tooling::Replacements, unsigned>
Eric Liu4cfb88a2016-04-25 15:09:22 +00001296 analyze(TokenAnnotator &Annotator,
1297 SmallVectorImpl<AnnotatedLine *> &AnnotatedLines,
Martin Probsta9855af2016-09-02 14:29:48 +00001298 FormatTokenLexer &Tokens) override {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001299 // FIXME: in the current implementation the granularity of affected range
1300 // is an annotated line. However, this is not sufficient. Furthermore,
1301 // redundant code introduced by replacements does not necessarily
1302 // intercept with ranges of replacements that result in the redundancy.
1303 // To determine if some redundant code is actually introduced by
1304 // replacements(e.g. deletions), we need to come up with a more
1305 // sophisticated way of computing affected ranges.
Manuel Klimek0dddcf72018-04-23 09:34:26 +00001306 AffectedRangeMgr.computeAffectedLines(AnnotatedLines);
Eric Liu4cfb88a2016-04-25 15:09:22 +00001307
1308 checkEmptyNamespace(AnnotatedLines);
1309
Eric Liuce5e4bc2016-05-18 08:02:56 +00001310 for (auto &Line : AnnotatedLines) {
1311 if (Line->Affected) {
1312 cleanupRight(Line->First, tok::comma, tok::comma);
1313 cleanupRight(Line->First, TT_CtorInitializerColon, tok::comma);
Eric Liu2574d152016-09-13 15:02:43 +00001314 cleanupRight(Line->First, tok::l_paren, tok::comma);
1315 cleanupLeft(Line->First, tok::comma, tok::r_paren);
Eric Liuce5e4bc2016-05-18 08:02:56 +00001316 cleanupLeft(Line->First, TT_CtorInitializerComma, tok::l_brace);
1317 cleanupLeft(Line->First, TT_CtorInitializerColon, tok::l_brace);
Malcolm Parsons5d8cdb82016-10-20 14:58:45 +00001318 cleanupLeft(Line->First, TT_CtorInitializerColon, tok::equal);
Eric Liuce5e4bc2016-05-18 08:02:56 +00001319 }
1320 }
1321
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00001322 return {generateFixes(), 0};
Eric Liu4cfb88a2016-04-25 15:09:22 +00001323 }
1324
1325private:
1326 bool containsOnlyComments(const AnnotatedLine &Line) {
1327 for (FormatToken *Tok = Line.First; Tok != nullptr; Tok = Tok->Next) {
1328 if (Tok->isNot(tok::comment))
1329 return false;
1330 }
1331 return true;
1332 }
1333
1334 // Iterate through all lines and remove any empty (nested) namespaces.
1335 void checkEmptyNamespace(SmallVectorImpl<AnnotatedLine *> &AnnotatedLines) {
Eric Liu7956c402016-10-05 15:49:01 +00001336 std::set<unsigned> DeletedLines;
Eric Liu4cfb88a2016-04-25 15:09:22 +00001337 for (unsigned i = 0, e = AnnotatedLines.size(); i != e; ++i) {
1338 auto &Line = *AnnotatedLines[i];
Sam McCall6f3778c2018-09-05 07:44:02 +00001339 if (Line.startsWithNamespace()) {
Eric Liu7956c402016-10-05 15:49:01 +00001340 checkEmptyNamespace(AnnotatedLines, i, i, DeletedLines);
Eric Liu4cfb88a2016-04-25 15:09:22 +00001341 }
1342 }
1343
1344 for (auto Line : DeletedLines) {
1345 FormatToken *Tok = AnnotatedLines[Line]->First;
1346 while (Tok) {
1347 deleteToken(Tok);
1348 Tok = Tok->Next;
1349 }
1350 }
1351 }
1352
1353 // The function checks if the namespace, which starts from \p CurrentLine, and
1354 // its nested namespaces are empty and delete them if they are empty. It also
1355 // sets \p NewLine to the last line checked.
1356 // Returns true if the current namespace is empty.
1357 bool checkEmptyNamespace(SmallVectorImpl<AnnotatedLine *> &AnnotatedLines,
Eric Liu7956c402016-10-05 15:49:01 +00001358 unsigned CurrentLine, unsigned &NewLine,
1359 std::set<unsigned> &DeletedLines) {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001360 unsigned InitLine = CurrentLine, End = AnnotatedLines.size();
Eric Liu635423e2016-04-28 07:52:03 +00001361 if (Style.BraceWrapping.AfterNamespace) {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001362 // If the left brace is in a new line, we should consume it first so that
1363 // it does not make the namespace non-empty.
1364 // FIXME: error handling if there is no left brace.
1365 if (!AnnotatedLines[++CurrentLine]->startsWith(tok::l_brace)) {
1366 NewLine = CurrentLine;
1367 return false;
1368 }
1369 } else if (!AnnotatedLines[CurrentLine]->endsWith(tok::l_brace)) {
1370 return false;
1371 }
1372 while (++CurrentLine < End) {
1373 if (AnnotatedLines[CurrentLine]->startsWith(tok::r_brace))
1374 break;
1375
Sam McCall6f3778c2018-09-05 07:44:02 +00001376 if (AnnotatedLines[CurrentLine]->startsWithNamespace()) {
Eric Liu7956c402016-10-05 15:49:01 +00001377 if (!checkEmptyNamespace(AnnotatedLines, CurrentLine, NewLine,
1378 DeletedLines))
Eric Liu4cfb88a2016-04-25 15:09:22 +00001379 return false;
1380 CurrentLine = NewLine;
1381 continue;
1382 }
1383
1384 if (containsOnlyComments(*AnnotatedLines[CurrentLine]))
1385 continue;
1386
1387 // If there is anything other than comments or nested namespaces in the
1388 // current namespace, the namespace cannot be empty.
1389 NewLine = CurrentLine;
1390 return false;
1391 }
1392
1393 NewLine = CurrentLine;
1394 if (CurrentLine >= End)
1395 return false;
1396
1397 // Check if the empty namespace is actually affected by changed ranges.
1398 if (!AffectedRangeMgr.affectsCharSourceRange(CharSourceRange::getCharRange(
1399 AnnotatedLines[InitLine]->First->Tok.getLocation(),
1400 AnnotatedLines[CurrentLine]->Last->Tok.getEndLoc())))
1401 return false;
1402
1403 for (unsigned i = InitLine; i <= CurrentLine; ++i) {
1404 DeletedLines.insert(i);
1405 }
1406
1407 return true;
1408 }
1409
Eric Liuce5e4bc2016-05-18 08:02:56 +00001410 // Checks pairs {start, start->next},..., {end->previous, end} and deletes one
1411 // of the token in the pair if the left token has \p LK token kind and the
1412 // right token has \p RK token kind. If \p DeleteLeft is true, the left token
1413 // is deleted on match; otherwise, the right token is deleted.
1414 template <typename LeftKind, typename RightKind>
1415 void cleanupPair(FormatToken *Start, LeftKind LK, RightKind RK,
1416 bool DeleteLeft) {
1417 auto NextNotDeleted = [this](const FormatToken &Tok) -> FormatToken * {
1418 for (auto *Res = Tok.Next; Res; Res = Res->Next)
1419 if (!Res->is(tok::comment) &&
1420 DeletedTokens.find(Res) == DeletedTokens.end())
1421 return Res;
1422 return nullptr;
1423 };
1424 for (auto *Left = Start; Left;) {
1425 auto *Right = NextNotDeleted(*Left);
1426 if (!Right)
1427 break;
1428 if (Left->is(LK) && Right->is(RK)) {
1429 deleteToken(DeleteLeft ? Left : Right);
Eric Liu01426ff2016-09-09 17:50:49 +00001430 for (auto *Tok = Left->Next; Tok && Tok != Right; Tok = Tok->Next)
1431 deleteToken(Tok);
Eric Liuce5e4bc2016-05-18 08:02:56 +00001432 // If the right token is deleted, we should keep the left token
1433 // unchanged and pair it with the new right token.
1434 if (!DeleteLeft)
1435 continue;
1436 }
1437 Left = Right;
1438 }
1439 }
1440
1441 template <typename LeftKind, typename RightKind>
1442 void cleanupLeft(FormatToken *Start, LeftKind LK, RightKind RK) {
1443 cleanupPair(Start, LK, RK, /*DeleteLeft=*/true);
1444 }
1445
1446 template <typename LeftKind, typename RightKind>
1447 void cleanupRight(FormatToken *Start, LeftKind LK, RightKind RK) {
1448 cleanupPair(Start, LK, RK, /*DeleteLeft=*/false);
1449 }
1450
Eric Liu4cfb88a2016-04-25 15:09:22 +00001451 // Delete the given token.
1452 inline void deleteToken(FormatToken *Tok) {
1453 if (Tok)
1454 DeletedTokens.insert(Tok);
1455 }
1456
1457 tooling::Replacements generateFixes() {
1458 tooling::Replacements Fixes;
1459 std::vector<FormatToken *> Tokens;
1460 std::copy(DeletedTokens.begin(), DeletedTokens.end(),
1461 std::back_inserter(Tokens));
1462
1463 // Merge multiple continuous token deletions into one big deletion so that
1464 // the number of replacements can be reduced. This makes computing affected
1465 // ranges more efficient when we run reformat on the changed code.
1466 unsigned Idx = 0;
1467 while (Idx < Tokens.size()) {
1468 unsigned St = Idx, End = Idx;
1469 while ((End + 1) < Tokens.size() &&
1470 Tokens[End]->Next == Tokens[End + 1]) {
1471 End++;
1472 }
1473 auto SR = CharSourceRange::getCharRange(Tokens[St]->Tok.getLocation(),
1474 Tokens[End]->Tok.getEndLoc());
Eric Liu40ef2fb2016-08-01 10:16:37 +00001475 auto Err =
1476 Fixes.add(tooling::Replacement(Env.getSourceManager(), SR, ""));
1477 // FIXME: better error handling. for now just print error message and skip
1478 // for the release version.
Piotr Padlewski1ec383c2016-12-23 11:40:44 +00001479 if (Err) {
Eric Liu40ef2fb2016-08-01 10:16:37 +00001480 llvm::errs() << llvm::toString(std::move(Err)) << "\n";
Piotr Padlewski1ec383c2016-12-23 11:40:44 +00001481 assert(false && "Fixes must not conflict!");
1482 }
Eric Liu4cfb88a2016-04-25 15:09:22 +00001483 Idx = End + 1;
1484 }
1485
1486 return Fixes;
1487 }
1488
1489 // Class for less-than inequality comparason for the set `RedundantTokens`.
1490 // We store tokens in the order they appear in the translation unit so that
1491 // we do not need to sort them in `generateFixes()`.
1492 struct FormatTokenLess {
Eric Liu635423e2016-04-28 07:52:03 +00001493 FormatTokenLess(const SourceManager &SM) : SM(SM) {}
Eric Liu4cfb88a2016-04-25 15:09:22 +00001494
Eric Liu2874ac32016-05-18 08:14:49 +00001495 bool operator()(const FormatToken *LHS, const FormatToken *RHS) const {
Eric Liu4cfb88a2016-04-25 15:09:22 +00001496 return SM.isBeforeInTranslationUnit(LHS->Tok.getLocation(),
1497 RHS->Tok.getLocation());
1498 }
Eric Liu635423e2016-04-28 07:52:03 +00001499 const SourceManager &SM;
Eric Liu4cfb88a2016-04-25 15:09:22 +00001500 };
1501
1502 // Tokens to be deleted.
1503 std::set<FormatToken *, FormatTokenLess> DeletedTokens;
Daniel Jasperf7935112012-12-03 18:12:45 +00001504};
1505
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001506class ObjCHeaderStyleGuesser : public TokenAnalyzer {
1507public:
1508 ObjCHeaderStyleGuesser(const Environment &Env, const FormatStyle &Style)
1509 : TokenAnalyzer(Env, Style), IsObjC(false) {}
1510
1511 std::pair<tooling::Replacements, unsigned>
1512 analyze(TokenAnnotator &Annotator,
1513 SmallVectorImpl<AnnotatedLine *> &AnnotatedLines,
1514 FormatTokenLexer &Tokens) override {
1515 assert(Style.Language == FormatStyle::LK_Cpp);
Ben Hamilton0675e872018-11-05 16:59:33 +00001516 IsObjC = guessIsObjC(Env.getSourceManager(), AnnotatedLines,
1517 Tokens.getKeywords());
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001518 tooling::Replacements Result;
1519 return {Result, 0};
1520 }
1521
1522 bool isObjC() { return IsObjC; }
1523
1524private:
Ben Hamilton0675e872018-11-05 16:59:33 +00001525 static bool
1526 guessIsObjC(const SourceManager &SourceManager,
1527 const SmallVectorImpl<AnnotatedLine *> &AnnotatedLines,
1528 const AdditionalKeywords &Keywords) {
Krasimir Georgiev8e216782018-01-17 20:01:02 +00001529 // Keep this array sorted, since we are binary searching over it.
1530 static constexpr llvm::StringLiteral FoundationIdentifiers[] = {
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001531 "CGFloat",
Ben Hamilton19c782d2018-03-22 03:25:22 +00001532 "CGPoint",
1533 "CGPointMake",
1534 "CGPointZero",
1535 "CGRect",
1536 "CGRectEdge",
1537 "CGRectInfinite",
1538 "CGRectMake",
1539 "CGRectNull",
1540 "CGRectZero",
1541 "CGSize",
1542 "CGSizeMake",
1543 "CGVector",
1544 "CGVectorMake",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001545 "NSAffineTransform",
1546 "NSArray",
1547 "NSAttributedString",
Ben Hamiltonb1a79192018-04-12 15:11:53 +00001548 "NSBlockOperation",
Jacek Olesiakce4f0af2018-02-15 08:47:56 +00001549 "NSBundle",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001550 "NSCache",
Jacek Olesiakce4f0af2018-02-15 08:47:56 +00001551 "NSCalendar",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001552 "NSCharacterSet",
1553 "NSCountedSet",
1554 "NSData",
1555 "NSDataDetector",
1556 "NSDecimal",
1557 "NSDecimalNumber",
1558 "NSDictionary",
1559 "NSEdgeInsets",
1560 "NSHashTable",
1561 "NSIndexPath",
1562 "NSIndexSet",
1563 "NSInteger",
Ben Hamiltonb1a79192018-04-12 15:11:53 +00001564 "NSInvocationOperation",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001565 "NSLocale",
1566 "NSMapTable",
1567 "NSMutableArray",
1568 "NSMutableAttributedString",
1569 "NSMutableCharacterSet",
1570 "NSMutableData",
1571 "NSMutableDictionary",
1572 "NSMutableIndexSet",
1573 "NSMutableOrderedSet",
1574 "NSMutableSet",
1575 "NSMutableString",
1576 "NSNumber",
1577 "NSNumberFormatter",
Jacek Olesiakce4f0af2018-02-15 08:47:56 +00001578 "NSObject",
Ben Hamiltonb1a79192018-04-12 15:11:53 +00001579 "NSOperation",
1580 "NSOperationQueue",
1581 "NSOperationQueuePriority",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001582 "NSOrderedSet",
1583 "NSPoint",
1584 "NSPointerArray",
Ben Hamiltonb1a79192018-04-12 15:11:53 +00001585 "NSQualityOfService",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001586 "NSRange",
1587 "NSRect",
1588 "NSRegularExpression",
1589 "NSSet",
1590 "NSSize",
1591 "NSString",
Jacek Olesiakce4f0af2018-02-15 08:47:56 +00001592 "NSTimeZone",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001593 "NSUInteger",
1594 "NSURL",
1595 "NSURLComponents",
1596 "NSURLQueryItem",
1597 "NSUUID",
Jacek Olesiakce4f0af2018-02-15 08:47:56 +00001598 "NSValue",
Ben Hamilton19c782d2018-03-22 03:25:22 +00001599 "UIImage",
1600 "UIView",
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001601 };
1602
Ben Hamiltonea7a27b2018-03-27 15:01:21 +00001603 for (auto Line : AnnotatedLines) {
1604 for (const FormatToken *FormatTok = Line->First; FormatTok;
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001605 FormatTok = FormatTok->Next) {
Jacek Olesiakce4f0af2018-02-15 08:47:56 +00001606 if ((FormatTok->Previous && FormatTok->Previous->is(tok::at) &&
Ben Hamiltonb1a79192018-04-12 15:11:53 +00001607 (FormatTok->Tok.getObjCKeywordID() != tok::objc_not_keyword ||
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001608 FormatTok->isOneOf(tok::numeric_constant, tok::l_square,
1609 tok::l_brace))) ||
1610 (FormatTok->Tok.isAnyIdentifier() &&
Krasimir Georgiev8e216782018-01-17 20:01:02 +00001611 std::binary_search(std::begin(FoundationIdentifiers),
1612 std::end(FoundationIdentifiers),
1613 FormatTok->TokenText)) ||
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001614 FormatTok->is(TT_ObjCStringLiteral) ||
1615 FormatTok->isOneOf(Keywords.kw_NS_ENUM, Keywords.kw_NS_OPTIONS,
1616 TT_ObjCBlockLBrace, TT_ObjCBlockLParen,
1617 TT_ObjCDecl, TT_ObjCForIn, TT_ObjCMethodExpr,
1618 TT_ObjCMethodSpecifier, TT_ObjCProperty)) {
Ben Hamilton0675e872018-11-05 16:59:33 +00001619 LLVM_DEBUG(llvm::dbgs()
1620 << "Detected ObjC at location "
1621 << FormatTok->Tok.getLocation().printToString(
1622 SourceManager)
1623 << " token: " << FormatTok->TokenText << " token type: "
1624 << getTokenTypeName(FormatTok->Type) << "\n");
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001625 return true;
1626 }
Ben Hamilton0675e872018-11-05 16:59:33 +00001627 if (guessIsObjC(SourceManager, Line->Children, Keywords))
Ben Hamilton6432afe2018-03-22 17:37:19 +00001628 return true;
1629 }
Ben Hamiltone2e3e672018-01-17 17:33:08 +00001630 }
1631 return false;
1632 }
1633
1634 bool IsObjC;
1635};
1636
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001637struct IncludeDirective {
1638 StringRef Filename;
1639 StringRef Text;
1640 unsigned Offset;
Daniel Jasperd2629dc2015-12-16 10:10:16 +00001641 int Category;
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001642};
1643
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001644struct JavaImportDirective {
1645 StringRef Identifier;
1646 StringRef Text;
1647 unsigned Offset;
1648 std::vector<StringRef> AssociatedCommentLines;
1649 bool IsStatic;
1650};
1651
Craig Topperaf35e852013-06-30 22:29:28 +00001652} // end anonymous namespace
1653
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001654// Determines whether 'Ranges' intersects with ('Start', 'End').
1655static bool affectsRange(ArrayRef<tooling::Range> Ranges, unsigned Start,
1656 unsigned End) {
1657 for (auto Range : Ranges) {
1658 if (Range.getOffset() < End &&
1659 Range.getOffset() + Range.getLength() > Start)
1660 return true;
1661 }
1662 return false;
1663}
1664
Eric Liua992afe2016-08-10 09:32:23 +00001665// Returns a pair (Index, OffsetToEOL) describing the position of the cursor
1666// before sorting/deduplicating. Index is the index of the include under the
1667// cursor in the original set of includes. If this include has duplicates, it is
1668// the index of the first of the duplicates as the others are going to be
1669// removed. OffsetToEOL describes the cursor's position relative to the end of
1670// its current line.
1671// If `Cursor` is not on any #include, `Index` will be UINT_MAX.
1672static std::pair<unsigned, unsigned>
1673FindCursorIndex(const SmallVectorImpl<IncludeDirective> &Includes,
1674 const SmallVectorImpl<unsigned> &Indices, unsigned Cursor) {
1675 unsigned CursorIndex = UINT_MAX;
1676 unsigned OffsetToEOL = 0;
1677 for (int i = 0, e = Includes.size(); i != e; ++i) {
1678 unsigned Start = Includes[Indices[i]].Offset;
1679 unsigned End = Start + Includes[Indices[i]].Text.size();
1680 if (!(Cursor >= Start && Cursor < End))
1681 continue;
1682 CursorIndex = Indices[i];
1683 OffsetToEOL = End - Cursor;
1684 // Put the cursor on the only remaining #include among the duplicate
1685 // #includes.
1686 while (--i >= 0 && Includes[CursorIndex].Text == Includes[Indices[i]].Text)
1687 CursorIndex = i;
1688 break;
1689 }
1690 return std::make_pair(CursorIndex, OffsetToEOL);
1691}
1692
1693// Sorts and deduplicate a block of includes given by 'Includes' alphabetically
1694// adding the necessary replacement to 'Replaces'. 'Includes' must be in strict
1695// source order.
1696// #include directives with the same text will be deduplicated, and only the
1697// first #include in the duplicate #includes remains. If the `Cursor` is
1698// provided and put on a deleted #include, it will be moved to the remaining
1699// #include in the duplicate #includes.
Martin Probstc4a0dd42016-05-20 11:24:24 +00001700static void sortCppIncludes(const FormatStyle &Style,
Eric Liua992afe2016-08-10 09:32:23 +00001701 const SmallVectorImpl<IncludeDirective> &Includes,
1702 ArrayRef<tooling::Range> Ranges, StringRef FileName,
1703 tooling::Replacements &Replaces, unsigned *Cursor) {
1704 unsigned IncludesBeginOffset = Includes.front().Offset;
Daniel Jasperd6a00782016-08-30 21:33:41 +00001705 unsigned IncludesEndOffset =
1706 Includes.back().Offset + Includes.back().Text.size();
1707 unsigned IncludesBlockSize = IncludesEndOffset - IncludesBeginOffset;
1708 if (!affectsRange(Ranges, IncludesBeginOffset, IncludesEndOffset))
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001709 return;
1710 SmallVector<unsigned, 16> Indices;
1711 for (unsigned i = 0, e = Includes.size(); i != e; ++i)
1712 Indices.push_back(i);
Daniel Jasper94a96fc2016-03-03 17:34:14 +00001713 std::stable_sort(
1714 Indices.begin(), Indices.end(), [&](unsigned LHSI, unsigned RHSI) {
1715 return std::tie(Includes[LHSI].Category, Includes[LHSI].Filename) <
1716 std::tie(Includes[RHSI].Category, Includes[RHSI].Filename);
1717 });
Eric Liua992afe2016-08-10 09:32:23 +00001718 // The index of the include on which the cursor will be put after
1719 // sorting/deduplicating.
1720 unsigned CursorIndex;
1721 // The offset from cursor to the end of line.
1722 unsigned CursorToEOLOffset;
1723 if (Cursor)
1724 std::tie(CursorIndex, CursorToEOLOffset) =
1725 FindCursorIndex(Includes, Indices, *Cursor);
1726
1727 // Deduplicate #includes.
1728 Indices.erase(std::unique(Indices.begin(), Indices.end(),
1729 [&](unsigned LHSI, unsigned RHSI) {
1730 return Includes[LHSI].Text == Includes[RHSI].Text;
1731 }),
1732 Indices.end());
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001733
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001734 int CurrentCategory = Includes.front().Category;
1735
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001736 // If the #includes are out of order, we generate a single replacement fixing
1737 // the entire block. Otherwise, no replacement is generated.
Eric Liua992afe2016-08-10 09:32:23 +00001738 if (Indices.size() == Includes.size() &&
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001739 std::is_sorted(Indices.begin(), Indices.end()) &&
Eric Liu9d92c022018-05-14 19:51:33 +00001740 Style.IncludeStyle.IncludeBlocks == tooling::IncludeStyle::IBS_Preserve)
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001741 return;
1742
Daniel Jasperb68aabf2015-11-23 08:36:35 +00001743 std::string result;
Daniel Jasperb68aabf2015-11-23 08:36:35 +00001744 for (unsigned Index : Indices) {
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001745 if (!result.empty()) {
Daniel Jasperb68aabf2015-11-23 08:36:35 +00001746 result += "\n";
Eric Liu9d92c022018-05-14 19:51:33 +00001747 if (Style.IncludeStyle.IncludeBlocks ==
1748 tooling::IncludeStyle::IBS_Regroup &&
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001749 CurrentCategory != Includes[Index].Category)
1750 result += "\n";
1751 }
Daniel Jasperb68aabf2015-11-23 08:36:35 +00001752 result += Includes[Index].Text;
Eric Liua992afe2016-08-10 09:32:23 +00001753 if (Cursor && CursorIndex == Index)
1754 *Cursor = IncludesBeginOffset + result.size() - CursorToEOLOffset;
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001755 CurrentCategory = Includes[Index].Category;
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001756 }
1757
Eric Liu40ef2fb2016-08-01 10:16:37 +00001758 auto Err = Replaces.add(tooling::Replacement(
Eric Liua992afe2016-08-10 09:32:23 +00001759 FileName, Includes.front().Offset, IncludesBlockSize, result));
Eric Liu40ef2fb2016-08-01 10:16:37 +00001760 // FIXME: better error handling. For now, just skip the replacement for the
1761 // release version.
Piotr Padlewski1ec383c2016-12-23 11:40:44 +00001762 if (Err) {
Eric Liu40ef2fb2016-08-01 10:16:37 +00001763 llvm::errs() << llvm::toString(std::move(Err)) << "\n";
Piotr Padlewski1ec383c2016-12-23 11:40:44 +00001764 assert(false);
1765 }
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001766}
1767
Eric Liu659afd52016-05-31 13:34:20 +00001768namespace {
1769
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001770const char CppIncludeRegexPattern[] =
Eric Liu659afd52016-05-31 13:34:20 +00001771 R"(^[\t\ ]*#[\t\ ]*(import|include)[^"<]*(["<][^">]*[">]))";
1772
1773} // anonymous namespace
1774
Martin Probstc4a0dd42016-05-20 11:24:24 +00001775tooling::Replacements sortCppIncludes(const FormatStyle &Style, StringRef Code,
1776 ArrayRef<tooling::Range> Ranges,
1777 StringRef FileName,
1778 tooling::Replacements &Replaces,
1779 unsigned *Cursor) {
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001780 unsigned Prev = 0;
1781 unsigned SearchFrom = 0;
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001782 llvm::Regex IncludeRegex(CppIncludeRegexPattern);
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001783 SmallVector<StringRef, 4> Matches;
1784 SmallVector<IncludeDirective, 16> IncludesInBlock;
Daniel Jasper85c472d2015-09-29 07:53:08 +00001785
1786 // In compiled files, consider the first #include to be the main #include of
1787 // the file if it is not a system #include. This ensures that the header
1788 // doesn't have hidden dependencies
1789 // (http://llvm.org/docs/CodingStandards.html#include-style).
1790 //
1791 // FIXME: Do some sanity checking, e.g. edit distance of the base name, to fix
1792 // cases where the first #include is unlikely to be the main header.
Eric Liu7129e632018-05-14 20:17:53 +00001793 tooling::IncludeCategoryManager Categories(Style.IncludeStyle, FileName);
Daniel Jasper32d75fa2015-12-21 13:40:49 +00001794 bool FirstIncludeBlock = true;
Daniel Jaspera252f5d2015-12-21 17:28:24 +00001795 bool MainIncludeFound = false;
Daniel Jasper9b8c7c72015-11-21 09:17:08 +00001796 bool FormattingOff = false;
1797
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001798 for (;;) {
1799 auto Pos = Code.find('\n', SearchFrom);
1800 StringRef Line =
1801 Code.substr(Prev, (Pos != StringRef::npos ? Pos : Code.size()) - Prev);
Daniel Jasper9b8c7c72015-11-21 09:17:08 +00001802
1803 StringRef Trimmed = Line.trim();
Paul Hoad9b468c02019-03-02 09:08:51 +00001804 if (Trimmed == "// clang-format off" || Trimmed == "/* clang-format off */")
Daniel Jasper9b8c7c72015-11-21 09:17:08 +00001805 FormattingOff = true;
Paul Hoad9b468c02019-03-02 09:08:51 +00001806 else if (Trimmed == "// clang-format on" ||
1807 Trimmed == "/* clang-format on */")
Daniel Jasper9b8c7c72015-11-21 09:17:08 +00001808 FormattingOff = false;
1809
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001810 const bool EmptyLineSkipped =
Eric Liu9d92c022018-05-14 19:51:33 +00001811 Trimmed.empty() &&
1812 (Style.IncludeStyle.IncludeBlocks == tooling::IncludeStyle::IBS_Merge ||
1813 Style.IncludeStyle.IncludeBlocks ==
1814 tooling::IncludeStyle::IBS_Regroup);
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001815
Daniel Jasper9b8c7c72015-11-21 09:17:08 +00001816 if (!FormattingOff && !Line.endswith("\\")) {
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001817 if (IncludeRegex.match(Line, &Matches)) {
Nico Weberff063702015-10-21 17:13:45 +00001818 StringRef IncludeName = Matches[2];
Eric Liu659afd52016-05-31 13:34:20 +00001819 int Category = Categories.getIncludePriority(
1820 IncludeName,
1821 /*CheckMainHeader=*/!MainIncludeFound && FirstIncludeBlock);
1822 if (Category == 0)
1823 MainIncludeFound = true;
Nico Weberff063702015-10-21 17:13:45 +00001824 IncludesInBlock.push_back({IncludeName, Line, Prev, Category});
Krasimir Georgiev4c2c9c32017-11-27 13:23:45 +00001825 } else if (!IncludesInBlock.empty() && !EmptyLineSkipped) {
Martin Probstc4a0dd42016-05-20 11:24:24 +00001826 sortCppIncludes(Style, IncludesInBlock, Ranges, FileName, Replaces,
1827 Cursor);
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001828 IncludesInBlock.clear();
Daniel Jasper32d75fa2015-12-21 13:40:49 +00001829 FirstIncludeBlock = false;
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00001830 }
1831 Prev = Pos + 1;
1832 }
1833 if (Pos == StringRef::npos || Pos + 1 == Code.size())
1834 break;
1835 SearchFrom = Pos + 1;
1836 }
1837 if (!IncludesInBlock.empty())
Martin Probstc4a0dd42016-05-20 11:24:24 +00001838 sortCppIncludes(Style, IncludesInBlock, Ranges, FileName, Replaces, Cursor);
1839 return Replaces;
1840}
1841
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001842// Returns group number to use as a first order sort on imports. Gives UINT_MAX
1843// if the import does not match any given groups.
1844static unsigned findJavaImportGroup(const FormatStyle &Style,
1845 StringRef ImportIdentifier) {
1846 unsigned LongestMatchIndex = UINT_MAX;
1847 unsigned LongestMatchLength = 0;
1848 for (unsigned I = 0; I < Style.JavaImportGroups.size(); I++) {
1849 std::string GroupPrefix = Style.JavaImportGroups[I];
1850 if (ImportIdentifier.startswith(GroupPrefix) &&
1851 GroupPrefix.length() > LongestMatchLength) {
1852 LongestMatchIndex = I;
1853 LongestMatchLength = GroupPrefix.length();
1854 }
1855 }
1856 return LongestMatchIndex;
1857}
1858
1859// Sorts and deduplicates a block of includes given by 'Imports' based on
1860// JavaImportGroups, then adding the necessary replacement to 'Replaces'.
1861// Import declarations with the same text will be deduplicated. Between each
1862// import group, a newline is inserted, and within each import group, a
1863// lexicographic sort based on ASCII value is performed.
1864static void sortJavaImports(const FormatStyle &Style,
1865 const SmallVectorImpl<JavaImportDirective> &Imports,
1866 ArrayRef<tooling::Range> Ranges, StringRef FileName,
Paul Hoad5bcf99b2019-03-01 09:09:54 +00001867 StringRef Code, tooling::Replacements &Replaces) {
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001868 unsigned ImportsBeginOffset = Imports.front().Offset;
1869 unsigned ImportsEndOffset =
1870 Imports.back().Offset + Imports.back().Text.size();
1871 unsigned ImportsBlockSize = ImportsEndOffset - ImportsBeginOffset;
1872 if (!affectsRange(Ranges, ImportsBeginOffset, ImportsEndOffset))
1873 return;
1874 SmallVector<unsigned, 16> Indices;
1875 SmallVector<unsigned, 16> JavaImportGroups;
1876 for (unsigned i = 0, e = Imports.size(); i != e; ++i) {
1877 Indices.push_back(i);
1878 JavaImportGroups.push_back(
1879 findJavaImportGroup(Style, Imports[i].Identifier));
1880 }
Mandeep Singh Grangd36da8a2019-01-18 18:45:26 +00001881 llvm::sort(Indices, [&](unsigned LHSI, unsigned RHSI) {
Krasimir Georgiev777bb822019-02-20 11:44:21 +00001882 // Negating IsStatic to push static imports above non-static imports.
1883 return std::make_tuple(!Imports[LHSI].IsStatic, JavaImportGroups[LHSI],
1884 Imports[LHSI].Identifier) <
1885 std::make_tuple(!Imports[RHSI].IsStatic, JavaImportGroups[RHSI],
1886 Imports[RHSI].Identifier);
1887 });
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001888
1889 // Deduplicate imports.
1890 Indices.erase(std::unique(Indices.begin(), Indices.end(),
1891 [&](unsigned LHSI, unsigned RHSI) {
1892 return Imports[LHSI].Text == Imports[RHSI].Text;
1893 }),
1894 Indices.end());
1895
1896 bool CurrentIsStatic = Imports[Indices.front()].IsStatic;
1897 unsigned CurrentImportGroup = JavaImportGroups[Indices.front()];
1898
1899 std::string result;
1900 for (unsigned Index : Indices) {
1901 if (!result.empty()) {
1902 result += "\n";
1903 if (CurrentIsStatic != Imports[Index].IsStatic ||
1904 CurrentImportGroup != JavaImportGroups[Index])
1905 result += "\n";
1906 }
1907 for (StringRef CommentLine : Imports[Index].AssociatedCommentLines) {
1908 result += CommentLine;
1909 result += "\n";
1910 }
1911 result += Imports[Index].Text;
1912 CurrentIsStatic = Imports[Index].IsStatic;
1913 CurrentImportGroup = JavaImportGroups[Index];
1914 }
1915
Krasimir Georgiev777bb822019-02-20 11:44:21 +00001916 // If the imports are out of order, we generate a single replacement fixing
1917 // the entire block. Otherwise, no replacement is generated.
1918 if (result == Code.substr(Imports.front().Offset, ImportsBlockSize))
1919 return;
1920
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001921 auto Err = Replaces.add(tooling::Replacement(FileName, Imports.front().Offset,
1922 ImportsBlockSize, result));
1923 // FIXME: better error handling. For now, just skip the replacement for the
1924 // release version.
1925 if (Err) {
1926 llvm::errs() << llvm::toString(std::move(Err)) << "\n";
1927 assert(false);
1928 }
1929}
1930
1931namespace {
1932
1933const char JavaImportRegexPattern[] =
1934 "^[\t ]*import[\t ]*(static[\t ]*)?([^\t ]*)[\t ]*;";
1935
1936} // anonymous namespace
1937
1938tooling::Replacements sortJavaImports(const FormatStyle &Style, StringRef Code,
1939 ArrayRef<tooling::Range> Ranges,
1940 StringRef FileName,
1941 tooling::Replacements &Replaces) {
1942 unsigned Prev = 0;
1943 unsigned SearchFrom = 0;
1944 llvm::Regex ImportRegex(JavaImportRegexPattern);
1945 SmallVector<StringRef, 4> Matches;
1946 SmallVector<JavaImportDirective, 16> ImportsInBlock;
1947 std::vector<StringRef> AssociatedCommentLines;
1948
1949 bool FormattingOff = false;
1950
1951 for (;;) {
1952 auto Pos = Code.find('\n', SearchFrom);
1953 StringRef Line =
1954 Code.substr(Prev, (Pos != StringRef::npos ? Pos : Code.size()) - Prev);
1955
1956 StringRef Trimmed = Line.trim();
1957 if (Trimmed == "// clang-format off")
1958 FormattingOff = true;
1959 else if (Trimmed == "// clang-format on")
1960 FormattingOff = false;
1961
1962 if (ImportRegex.match(Line, &Matches)) {
1963 if (FormattingOff) {
1964 // If at least one import line has formatting turned off, turn off
1965 // formatting entirely.
1966 return Replaces;
1967 }
1968 StringRef Static = Matches[1];
1969 StringRef Identifier = Matches[2];
1970 bool IsStatic = false;
1971 if (Static.contains("static")) {
1972 IsStatic = true;
1973 }
Paul Hoad5bcf99b2019-03-01 09:09:54 +00001974 ImportsInBlock.push_back(
1975 {Identifier, Line, Prev, AssociatedCommentLines, IsStatic});
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001976 AssociatedCommentLines.clear();
1977 } else if (Trimmed.size() > 0 && !ImportsInBlock.empty()) {
1978 // Associating comments within the imports with the nearest import below
1979 AssociatedCommentLines.push_back(Line);
1980 }
1981 Prev = Pos + 1;
1982 if (Pos == StringRef::npos || Pos + 1 == Code.size())
1983 break;
1984 SearchFrom = Pos + 1;
1985 }
1986 if (!ImportsInBlock.empty())
Krasimir Georgiev777bb822019-02-20 11:44:21 +00001987 sortJavaImports(Style, ImportsInBlock, Ranges, FileName, Code, Replaces);
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00001988 return Replaces;
1989}
1990
Martin Probstfa37b182017-01-27 09:09:11 +00001991bool isMpegTS(StringRef Code) {
1992 // MPEG transport streams use the ".ts" file extension. clang-format should
1993 // not attempt to format those. MPEG TS' frame format starts with 0x47 every
1994 // 189 bytes - detect that and return.
1995 return Code.size() > 188 && Code[0] == 0x47 && Code[188] == 0x47;
1996}
1997
Manuel Klimek89628f62017-09-20 09:51:03 +00001998bool isLikelyXml(StringRef Code) { return Code.ltrim().startswith("<"); }
Krasimir Georgieva2e7d0d2017-08-29 13:51:38 +00001999
Martin Probstc4a0dd42016-05-20 11:24:24 +00002000tooling::Replacements sortIncludes(const FormatStyle &Style, StringRef Code,
2001 ArrayRef<tooling::Range> Ranges,
2002 StringRef FileName, unsigned *Cursor) {
2003 tooling::Replacements Replaces;
2004 if (!Style.SortIncludes)
2005 return Replaces;
Krasimir Georgiev86873032017-08-29 13:57:31 +00002006 if (isLikelyXml(Code))
2007 return Replaces;
2008 if (Style.Language == FormatStyle::LanguageKind::LK_JavaScript &&
2009 isMpegTS(Code))
Martin Probstfa37b182017-01-27 09:09:11 +00002010 return Replaces;
Martin Probstc4a0dd42016-05-20 11:24:24 +00002011 if (Style.Language == FormatStyle::LanguageKind::LK_JavaScript)
2012 return sortJavaScriptImports(Style, Code, Ranges, FileName);
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00002013 if (Style.Language == FormatStyle::LanguageKind::LK_Java)
2014 return sortJavaImports(Style, Code, Ranges, FileName, Replaces);
Martin Probstc4a0dd42016-05-20 11:24:24 +00002015 sortCppIncludes(Style, Code, Ranges, FileName, Replaces, Cursor);
Daniel Jasperd89ae9d2015-09-23 08:30:47 +00002016 return Replaces;
2017}
2018
Eric Liu4cfb88a2016-04-25 15:09:22 +00002019template <typename T>
Eric Liu4f8d9942016-07-11 13:53:12 +00002020static llvm::Expected<tooling::Replacements>
Eric Liu4cfb88a2016-04-25 15:09:22 +00002021processReplacements(T ProcessFunc, StringRef Code,
2022 const tooling::Replacements &Replaces,
2023 const FormatStyle &Style) {
Manuel Klimekb12e5a52016-03-01 12:37:30 +00002024 if (Replaces.empty())
2025 return tooling::Replacements();
2026
Eric Liu4f8d9942016-07-11 13:53:12 +00002027 auto NewCode = applyAllReplacements(Code, Replaces);
2028 if (!NewCode)
2029 return NewCode.takeError();
Eric Liu40ef2fb2016-08-01 10:16:37 +00002030 std::vector<tooling::Range> ChangedRanges = Replaces.getAffectedRanges();
Manuel Klimekb12e5a52016-03-01 12:37:30 +00002031 StringRef FileName = Replaces.begin()->getFilePath();
Eric Liu4cfb88a2016-04-25 15:09:22 +00002032
Manuel Klimekb12e5a52016-03-01 12:37:30 +00002033 tooling::Replacements FormatReplaces =
Eric Liu4f8d9942016-07-11 13:53:12 +00002034 ProcessFunc(Style, *NewCode, ChangedRanges, FileName);
Manuel Klimekb12e5a52016-03-01 12:37:30 +00002035
Eric Liu40ef2fb2016-08-01 10:16:37 +00002036 return Replaces.merge(FormatReplaces);
Manuel Klimekb12e5a52016-03-01 12:37:30 +00002037}
2038
Eric Liu4f8d9942016-07-11 13:53:12 +00002039llvm::Expected<tooling::Replacements>
2040formatReplacements(StringRef Code, const tooling::Replacements &Replaces,
2041 const FormatStyle &Style) {
Eric Liu4cfb88a2016-04-25 15:09:22 +00002042 // We need to use lambda function here since there are two versions of
Eric Liubaf58c22016-05-18 13:43:48 +00002043 // `sortIncludes`.
2044 auto SortIncludes = [](const FormatStyle &Style, StringRef Code,
2045 std::vector<tooling::Range> Ranges,
2046 StringRef FileName) -> tooling::Replacements {
2047 return sortIncludes(Style, Code, Ranges, FileName);
2048 };
Eric Liu4f8d9942016-07-11 13:53:12 +00002049 auto SortedReplaces =
Eric Liubaf58c22016-05-18 13:43:48 +00002050 processReplacements(SortIncludes, Code, Replaces, Style);
Eric Liu4f8d9942016-07-11 13:53:12 +00002051 if (!SortedReplaces)
2052 return SortedReplaces.takeError();
Eric Liubaf58c22016-05-18 13:43:48 +00002053
2054 // We need to use lambda function here since there are two versions of
Eric Liu4cfb88a2016-04-25 15:09:22 +00002055 // `reformat`.
2056 auto Reformat = [](const FormatStyle &Style, StringRef Code,
2057 std::vector<tooling::Range> Ranges,
2058 StringRef FileName) -> tooling::Replacements {
2059 return reformat(Style, Code, Ranges, FileName);
2060 };
Eric Liu4f8d9942016-07-11 13:53:12 +00002061 return processReplacements(Reformat, Code, *SortedReplaces, Style);
Eric Liu4cfb88a2016-04-25 15:09:22 +00002062}
2063
Eric Liu659afd52016-05-31 13:34:20 +00002064namespace {
2065
2066inline bool isHeaderInsertion(const tooling::Replacement &Replace) {
Eric Liuc0d3a802016-09-23 15:10:56 +00002067 return Replace.getOffset() == UINT_MAX && Replace.getLength() == 0 &&
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00002068 llvm::Regex(CppIncludeRegexPattern)
2069 .match(Replace.getReplacementText());
Eric Liu659afd52016-05-31 13:34:20 +00002070}
2071
Eric Liuc0d3a802016-09-23 15:10:56 +00002072inline bool isHeaderDeletion(const tooling::Replacement &Replace) {
2073 return Replace.getOffset() == UINT_MAX && Replace.getLength() == 1;
2074}
2075
Eric Liu659afd52016-05-31 13:34:20 +00002076// FIXME: insert empty lines between newly created blocks.
2077tooling::Replacements
2078fixCppIncludeInsertions(StringRef Code, const tooling::Replacements &Replaces,
2079 const FormatStyle &Style) {
Daniel Jasper1dbc2102017-03-31 13:30:24 +00002080 if (!Style.isCpp())
Eric Liu659afd52016-05-31 13:34:20 +00002081 return Replaces;
2082
2083 tooling::Replacements HeaderInsertions;
Eric Liuc0d3a802016-09-23 15:10:56 +00002084 std::set<llvm::StringRef> HeadersToDelete;
Eric Liu40ef2fb2016-08-01 10:16:37 +00002085 tooling::Replacements Result;
Eric Liu659afd52016-05-31 13:34:20 +00002086 for (const auto &R : Replaces) {
Eric Liu40ef2fb2016-08-01 10:16:37 +00002087 if (isHeaderInsertion(R)) {
2088 // Replacements from \p Replaces must be conflict-free already, so we can
2089 // simply consume the error.
2090 llvm::consumeError(HeaderInsertions.add(R));
Eric Liuc0d3a802016-09-23 15:10:56 +00002091 } else if (isHeaderDeletion(R)) {
2092 HeadersToDelete.insert(R.getReplacementText());
Eric Liu40ef2fb2016-08-01 10:16:37 +00002093 } else if (R.getOffset() == UINT_MAX) {
Eric Liu659afd52016-05-31 13:34:20 +00002094 llvm::errs() << "Insertions other than header #include insertion are "
2095 "not supported! "
2096 << R.getReplacementText() << "\n";
Eric Liu40ef2fb2016-08-01 10:16:37 +00002097 } else {
2098 llvm::consumeError(Result.add(R));
2099 }
Eric Liu659afd52016-05-31 13:34:20 +00002100 }
Eric Liuc0d3a802016-09-23 15:10:56 +00002101 if (HeaderInsertions.empty() && HeadersToDelete.empty())
Eric Liu659afd52016-05-31 13:34:20 +00002102 return Replaces;
Eric Liu659afd52016-05-31 13:34:20 +00002103
Eric Liu659afd52016-05-31 13:34:20 +00002104 StringRef FileName = Replaces.begin()->getFilePath();
Eric Liu7129e632018-05-14 20:17:53 +00002105 tooling::HeaderIncludes Includes(FileName, Code, Style.IncludeStyle);
Eric Liu659afd52016-05-31 13:34:20 +00002106
Eric Liubf4c41c2018-05-04 17:55:13 +00002107 for (const auto &Header : HeadersToDelete) {
2108 tooling::Replacements Replaces =
Eric Liu7129e632018-05-14 20:17:53 +00002109 Includes.remove(Header.trim("\"<>"), Header.startswith("<"));
Eric Liubf4c41c2018-05-04 17:55:13 +00002110 for (const auto &R : Replaces) {
2111 auto Err = Result.add(R);
2112 if (Err) {
2113 // Ignore the deletion on conflict.
2114 llvm::errs() << "Failed to add header deletion replacement for "
2115 << Header << ": " << llvm::toString(std::move(Err))
2116 << "\n";
Eric Liuc0d3a802016-09-23 15:10:56 +00002117 }
Eric Liu659afd52016-05-31 13:34:20 +00002118 }
Eric Liu659afd52016-05-31 13:34:20 +00002119 }
2120
Krasimir Georgiev7e91b032018-10-05 17:19:26 +00002121 llvm::Regex IncludeRegex = llvm::Regex(CppIncludeRegexPattern);
Eric Liubf4c41c2018-05-04 17:55:13 +00002122 llvm::SmallVector<StringRef, 4> Matches;
Eric Liu659afd52016-05-31 13:34:20 +00002123 for (const auto &R : HeaderInsertions) {
2124 auto IncludeDirective = R.getReplacementText();
2125 bool Matched = IncludeRegex.match(IncludeDirective, &Matches);
2126 assert(Matched && "Header insertion replacement must have replacement text "
2127 "'#include ...'");
Benjamin Kramer1cb7ee12016-05-31 14:14:42 +00002128 (void)Matched;
Eric Liu659afd52016-05-31 13:34:20 +00002129 auto IncludeName = Matches[2];
Eric Liubf4c41c2018-05-04 17:55:13 +00002130 auto Replace =
Eric Liu7129e632018-05-14 20:17:53 +00002131 Includes.insert(IncludeName.trim("\"<>"), IncludeName.startswith("<"));
Eric Liubf4c41c2018-05-04 17:55:13 +00002132 if (Replace) {
2133 auto Err = Result.add(*Replace);
2134 if (Err) {
2135 llvm::consumeError(std::move(Err));
Paul Hoad5bcf99b2019-03-01 09:09:54 +00002136 unsigned NewOffset =
2137 Result.getShiftedCodePosition(Replace->getOffset());
Eric Liubf4c41c2018-05-04 17:55:13 +00002138 auto Shifted = tooling::Replacement(FileName, NewOffset, 0,
2139 Replace->getReplacementText());
2140 Result = Result.merge(tooling::Replacements(Shifted));
2141 }
Eric Liu40ef2fb2016-08-01 10:16:37 +00002142 }
Eric Liu659afd52016-05-31 13:34:20 +00002143 }
2144 return Result;
2145}
2146
2147} // anonymous namespace
2148
Eric Liu4f8d9942016-07-11 13:53:12 +00002149llvm::Expected<tooling::Replacements>
Eric Liu4cfb88a2016-04-25 15:09:22 +00002150cleanupAroundReplacements(StringRef Code, const tooling::Replacements &Replaces,
2151 const FormatStyle &Style) {
2152 // We need to use lambda function here since there are two versions of
2153 // `cleanup`.
2154 auto Cleanup = [](const FormatStyle &Style, StringRef Code,
2155 std::vector<tooling::Range> Ranges,
2156 StringRef FileName) -> tooling::Replacements {
2157 return cleanup(Style, Code, Ranges, FileName);
2158 };
Eric Liu659afd52016-05-31 13:34:20 +00002159 // Make header insertion replacements insert new headers into correct blocks.
2160 tooling::Replacements NewReplaces =
2161 fixCppIncludeInsertions(Code, Replaces, Style);
2162 return processReplacements(Cleanup, Code, NewReplaces, Style);
Eric Liu4cfb88a2016-04-25 15:09:22 +00002163}
2164
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002165namespace internal {
2166std::pair<tooling::Replacements, unsigned>
2167reformat(const FormatStyle &Style, StringRef Code,
2168 ArrayRef<tooling::Range> Ranges, unsigned FirstStartColumn,
2169 unsigned NextStartColumn, unsigned LastStartColumn, StringRef FileName,
2170 FormattingAttemptStatus *Status) {
Eric Liu4cfb88a2016-04-25 15:09:22 +00002171 FormatStyle Expanded = expandPresets(Style);
2172 if (Expanded.DisableFormat)
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002173 return {tooling::Replacements(), 0};
Krasimir Georgiev86873032017-08-29 13:57:31 +00002174 if (isLikelyXml(Code))
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002175 return {tooling::Replacements(), 0};
Krasimir Georgiev86873032017-08-29 13:57:31 +00002176 if (Expanded.Language == FormatStyle::LK_JavaScript && isMpegTS(Code))
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002177 return {tooling::Replacements(), 0};
Daniel Jasper496c1992016-09-07 22:48:53 +00002178
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002179 typedef std::function<std::pair<tooling::Replacements, unsigned>(
2180 const Environment &)>
Krasimir Georgievac16a202017-06-23 11:46:03 +00002181 AnalyzerPass;
2182 SmallVector<AnalyzerPass, 4> Passes;
Krasimir Georgiev32eaa862017-03-01 15:35:39 +00002183
Krasimir Georgievac16a202017-06-23 11:46:03 +00002184 if (Style.Language == FormatStyle::LK_Cpp) {
2185 if (Style.FixNamespaceComments)
2186 Passes.emplace_back([&](const Environment &Env) {
2187 return NamespaceEndCommentsFixer(Env, Expanded).process();
2188 });
2189
2190 if (Style.SortUsingDeclarations)
2191 Passes.emplace_back([&](const Environment &Env) {
2192 return UsingDeclarationsSorter(Env, Expanded).process();
2193 });
Krasimir Georgiev32eaa862017-03-01 15:35:39 +00002194 }
2195
2196 if (Style.Language == FormatStyle::LK_JavaScript &&
Krasimir Georgievac16a202017-06-23 11:46:03 +00002197 Style.JavaScriptQuotes != FormatStyle::JSQS_Leave)
2198 Passes.emplace_back([&](const Environment &Env) {
2199 return JavaScriptRequoter(Env, Expanded).process();
2200 });
2201
2202 Passes.emplace_back([&](const Environment &Env) {
2203 return Formatter(Env, Expanded, Status).process();
2204 });
2205
Eric Liu2e538082018-05-09 21:35:52 +00002206 auto Env =
2207 llvm::make_unique<Environment>(Code, FileName, Ranges, FirstStartColumn,
2208 NextStartColumn, LastStartColumn);
Krasimir Georgievac16a202017-06-23 11:46:03 +00002209 llvm::Optional<std::string> CurrentCode = None;
2210 tooling::Replacements Fixes;
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002211 unsigned Penalty = 0;
Krasimir Georgievac16a202017-06-23 11:46:03 +00002212 for (size_t I = 0, E = Passes.size(); I < E; ++I) {
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002213 std::pair<tooling::Replacements, unsigned> PassFixes = Passes[I](*Env);
Krasimir Georgievac16a202017-06-23 11:46:03 +00002214 auto NewCode = applyAllReplacements(
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002215 CurrentCode ? StringRef(*CurrentCode) : Code, PassFixes.first);
Krasimir Georgievac16a202017-06-23 11:46:03 +00002216 if (NewCode) {
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002217 Fixes = Fixes.merge(PassFixes.first);
2218 Penalty += PassFixes.second;
Krasimir Georgievac16a202017-06-23 11:46:03 +00002219 if (I + 1 < E) {
2220 CurrentCode = std::move(*NewCode);
Eric Liu2e538082018-05-09 21:35:52 +00002221 Env = llvm::make_unique<Environment>(
Krasimir Georgievac16a202017-06-23 11:46:03 +00002222 *CurrentCode, FileName,
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002223 tooling::calculateRangesAfterReplacements(Fixes, Ranges),
2224 FirstStartColumn, NextStartColumn, LastStartColumn);
Krasimir Georgievac16a202017-06-23 11:46:03 +00002225 }
2226 }
Daniel Jasper496c1992016-09-07 22:48:53 +00002227 }
2228
Krasimir Georgiev9ad83fe2017-10-30 14:01:50 +00002229 return {Fixes, Penalty};
2230}
2231} // namespace internal
2232
2233tooling::Replacements reformat(const FormatStyle &Style, StringRef Code,
2234 ArrayRef<tooling::Range> Ranges,
2235 StringRef FileName,
2236 FormattingAttemptStatus *Status) {
2237 return internal::reformat(Style, Code, Ranges,
2238 /*FirstStartColumn=*/0,
2239 /*NextStartColumn=*/0,
2240 /*LastStartColumn=*/0, FileName, Status)
2241 .first;
Eric Liu4cfb88a2016-04-25 15:09:22 +00002242}
2243
Eric Liu4cfb88a2016-04-25 15:09:22 +00002244tooling::Replacements cleanup(const FormatStyle &Style, StringRef Code,
2245 ArrayRef<tooling::Range> Ranges,
2246 StringRef FileName) {
Martin Probst816a9662017-05-29 08:41:11 +00002247 // cleanups only apply to C++ (they mostly concern ctor commas etc.)
2248 if (Style.Language != FormatStyle::LK_Cpp)
2249 return tooling::Replacements();
Eric Liu2e538082018-05-09 21:35:52 +00002250 return Cleaner(Environment(Code, FileName, Ranges), Style).process().first;
Daniel Jasperec04c0d2013-05-16 10:40:07 +00002251}
2252
Krasimir Georgievbcda54b2017-04-21 14:35:20 +00002253tooling::Replacements reformat(const FormatStyle &Style, StringRef Code,
2254 ArrayRef<tooling::Range> Ranges,
2255 StringRef FileName, bool *IncompleteFormat) {
2256 FormattingAttemptStatus Status;
2257 auto Result = reformat(Style, Code, Ranges, FileName, &Status);
2258 if (!Status.FormatComplete)
2259 *IncompleteFormat = true;
2260 return Result;
2261}
2262
Krasimir Georgiev7cb267a2017-02-27 13:28:36 +00002263tooling::Replacements fixNamespaceEndComments(const FormatStyle &Style,
2264 StringRef Code,
2265 ArrayRef<tooling::Range> Ranges,
2266 StringRef FileName) {
Eric Liu2e538082018-05-09 21:35:52 +00002267 return NamespaceEndCommentsFixer(Environment(Code, FileName, Ranges), Style)
2268 .process()
2269 .first;
Krasimir Georgiev7cb267a2017-02-27 13:28:36 +00002270}
2271
Krasimir Georgievb03877a2017-06-21 12:03:12 +00002272tooling::Replacements sortUsingDeclarations(const FormatStyle &Style,
2273 StringRef Code,
2274 ArrayRef<tooling::Range> Ranges,
2275 StringRef FileName) {
Eric Liu2e538082018-05-09 21:35:52 +00002276 return UsingDeclarationsSorter(Environment(Code, FileName, Ranges), Style)
2277 .process()
2278 .first;
Krasimir Georgievb03877a2017-06-21 12:03:12 +00002279}
2280
Daniel Jasper4db69bd2014-09-04 18:23:42 +00002281LangOptions getFormattingLangOpts(const FormatStyle &Style) {
Daniel Jasperc1fa2812013-01-10 13:08:12 +00002282 LangOptions LangOpts;
2283 LangOpts.CPlusPlus = 1;
Daniel Jasper4db69bd2014-09-04 18:23:42 +00002284 LangOpts.CPlusPlus11 = Style.Standard == FormatStyle::LS_Cpp03 ? 0 : 1;
2285 LangOpts.CPlusPlus14 = Style.Standard == FormatStyle::LS_Cpp03 ? 0 : 1;
Aaron Ballmanc351fba2017-12-04 20:27:34 +00002286 LangOpts.CPlusPlus17 = Style.Standard == FormatStyle::LS_Cpp03 ? 0 : 1;
Richard Smithc70f1d62017-12-14 15:16:18 +00002287 LangOpts.CPlusPlus2a = Style.Standard == FormatStyle::LS_Cpp03 ? 0 : 1;
Daniel Jasper55213652013-03-22 10:01:29 +00002288 LangOpts.LineComment = 1;
Daniel Jasper1dbc2102017-03-31 13:30:24 +00002289 bool AlternativeOperators = Style.isCpp();
Daniel Jasper30a24062014-11-14 09:02:28 +00002290 LangOpts.CXXOperatorNames = AlternativeOperators ? 1 : 0;
Daniel Jasperc1fa2812013-01-10 13:08:12 +00002291 LangOpts.Bool = 1;
Erik Pilkingtonfa983902018-10-30 20:31:30 +00002292 LangOpts.ObjC = 1;
Eric Liu4cfb88a2016-04-25 15:09:22 +00002293 LangOpts.MicrosoftExt = 1; // To get kw___try, kw___finally.
Saleem Abdulrasoold170c4b2015-10-04 17:51:05 +00002294 LangOpts.DeclSpecKeyword = 1; // To get __declspec.
Daniel Jasperc1fa2812013-01-10 13:08:12 +00002295 return LangOpts;
2296}
2297
Edwin Vaned544aa72013-09-30 13:31:48 +00002298const char *StyleOptionHelpDescription =
2299 "Coding style, currently supports:\n"
2300 " LLVM, Google, Chromium, Mozilla, WebKit.\n"
2301 "Use -style=file to load style configuration from\n"
2302 ".clang-format file located in one of the parent\n"
2303 "directories of the source file (or current\n"
2304 "directory for stdin).\n"
2305 "Use -style=\"{key: value, ...}\" to set specific\n"
2306 "parameters, e.g.:\n"
2307 " -style=\"{BasedOnStyle: llvm, IndentWidth: 8}\"";
2308
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00002309static FormatStyle::LanguageKind getLanguageByFileName(StringRef FileName) {
Daniel Jasper498f5582015-12-25 08:53:31 +00002310 if (FileName.endswith(".java"))
Daniel Jasperc58c70e2014-09-15 11:21:46 +00002311 return FormatStyle::LK_Java;
Daniel Jasper498f5582015-12-25 08:53:31 +00002312 if (FileName.endswith_lower(".js") || FileName.endswith_lower(".ts"))
2313 return FormatStyle::LK_JavaScript; // JavaScript or TypeScript.
Daniel Jasper03a04fe2016-12-12 12:42:29 +00002314 if (FileName.endswith(".m") || FileName.endswith(".mm"))
2315 return FormatStyle::LK_ObjC;
Daniel Jasper498f5582015-12-25 08:53:31 +00002316 if (FileName.endswith_lower(".proto") ||
2317 FileName.endswith_lower(".protodevel"))
Daniel Jasper7052ce62014-01-19 09:04:08 +00002318 return FormatStyle::LK_Proto;
Krasimir Georgiev66496652017-11-17 15:10:49 +00002319 if (FileName.endswith_lower(".textpb") ||
2320 FileName.endswith_lower(".pb.txt") ||
2321 FileName.endswith_lower(".textproto") ||
2322 FileName.endswith_lower(".asciipb"))
2323 return FormatStyle::LK_TextProto;
Daniel Jasper498f5582015-12-25 08:53:31 +00002324 if (FileName.endswith_lower(".td"))
2325 return FormatStyle::LK_TableGen;
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00002326 return FormatStyle::LK_Cpp;
Alexander Kornienkocabdd732013-11-29 15:19:43 +00002327}
2328
Ben Hamilton3b345c32018-02-21 15:54:31 +00002329FormatStyle::LanguageKind guessLanguage(StringRef FileName, StringRef Code) {
Ben Hamilton6e066352018-02-27 15:56:40 +00002330 const auto GuessedLanguage = getLanguageByFileName(FileName);
2331 if (GuessedLanguage == FormatStyle::LK_Cpp) {
Ben Hamilton07e58362018-02-21 21:27:27 +00002332 auto Extension = llvm::sys::path::extension(FileName);
Ben Hamilton3b345c32018-02-21 15:54:31 +00002333 // If there's no file extension (or it's .h), we need to check the contents
2334 // of the code to see if it contains Objective-C.
Ben Hamilton07e58362018-02-21 21:27:27 +00002335 if (Extension.empty() || Extension == ".h") {
2336 auto NonEmptyFileName = FileName.empty() ? "guess.h" : FileName;
Eric Liu2e538082018-05-09 21:35:52 +00002337 Environment Env(Code, NonEmptyFileName, /*Ranges=*/{});
2338 ObjCHeaderStyleGuesser Guesser(Env, getLLVMStyle());
Ben Hamilton3b345c32018-02-21 15:54:31 +00002339 Guesser.process();
Ben Hamilton6e066352018-02-27 15:56:40 +00002340 if (Guesser.isObjC())
2341 return FormatStyle::LK_ObjC;
Ben Hamilton3b345c32018-02-21 15:54:31 +00002342 }
2343 }
Ben Hamilton6e066352018-02-27 15:56:40 +00002344 return GuessedLanguage;
Ben Hamilton3b345c32018-02-21 15:54:31 +00002345}
2346
Eric Liub4adc912018-06-25 16:29:19 +00002347const char *DefaultFormatStyle = "file";
2348
2349const char *DefaultFallbackStyle = "LLVM";
2350
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002351llvm::Expected<FormatStyle> getStyle(StringRef StyleName, StringRef FileName,
Antonio Maiorano7eb75072017-01-20 01:22:42 +00002352 StringRef FallbackStyleName,
Jonas Devliegherefc514902018-10-10 13:27:25 +00002353 StringRef Code,
2354 llvm::vfs::FileSystem *FS) {
Eric Liu547d8792016-03-24 13:22:42 +00002355 if (!FS) {
Jonas Devliegherefc514902018-10-10 13:27:25 +00002356 FS = llvm::vfs::getRealFileSystem().get();
Eric Liu547d8792016-03-24 13:22:42 +00002357 }
Jordan Rupprecht8bd97e72019-02-28 19:16:45 +00002358 FormatStyle Style = getLLVMStyle(guessLanguage(FileName, Code));
Daniel Jasper03a04fe2016-12-12 12:42:29 +00002359
Antonio Maiorano7eb75072017-01-20 01:22:42 +00002360 FormatStyle FallbackStyle = getNoStyle();
2361 if (!getPredefinedStyle(FallbackStyleName, Style.Language, &FallbackStyle))
2362 return make_string_error("Invalid fallback style \"" + FallbackStyleName);
Edwin Vaned544aa72013-09-30 13:31:48 +00002363
2364 if (StyleName.startswith("{")) {
2365 // Parse YAML/JSON style from the command line.
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002366 if (std::error_code ec = parseConfiguration(StyleName, &Style))
2367 return make_string_error("Error parsing -style: " + ec.message());
Edwin Vaned544aa72013-09-30 13:31:48 +00002368 return Style;
2369 }
2370
2371 if (!StyleName.equals_lower("file")) {
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00002372 if (!getPredefinedStyle(StyleName, Style.Language, &Style))
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002373 return make_string_error("Invalid value for -style");
Edwin Vaned544aa72013-09-30 13:31:48 +00002374 return Style;
2375 }
2376
Alexander Kornienkoc1637f12013-12-10 11:28:13 +00002377 // Look for .clang-format/_clang-format file in the file's parent directories.
Alexander Kornienkocabdd732013-11-29 15:19:43 +00002378 SmallString<128> UnsuitableConfigFiles;
Edwin Vaned544aa72013-09-30 13:31:48 +00002379 SmallString<128> Path(FileName);
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002380 if (std::error_code EC = FS->makeAbsolute(Path))
2381 return make_string_error(EC.message());
Antonio Maiorano34c03762016-12-22 05:10:07 +00002382
Alexander Kornienkoe2e03872013-10-14 00:46:35 +00002383 for (StringRef Directory = Path; !Directory.empty();
Edwin Vaned544aa72013-09-30 13:31:48 +00002384 Directory = llvm::sys::path::parent_path(Directory)) {
Eric Liu547d8792016-03-24 13:22:42 +00002385
2386 auto Status = FS->status(Directory);
2387 if (!Status ||
2388 Status->getType() != llvm::sys::fs::file_type::directory_file) {
Edwin Vaned544aa72013-09-30 13:31:48 +00002389 continue;
Eric Liu547d8792016-03-24 13:22:42 +00002390 }
2391
Edwin Vaned544aa72013-09-30 13:31:48 +00002392 SmallString<128> ConfigFile(Directory);
2393
2394 llvm::sys::path::append(ConfigFile, ".clang-format");
Nicola Zaghen3538b392018-05-15 13:30:56 +00002395 LLVM_DEBUG(llvm::dbgs() << "Trying " << ConfigFile << "...\n");
Eric Liud4758322016-03-24 13:22:37 +00002396
Eric Liu547d8792016-03-24 13:22:42 +00002397 Status = FS->status(ConfigFile.str());
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002398 bool FoundConfigFile =
Eric Liu547d8792016-03-24 13:22:42 +00002399 Status && (Status->getType() == llvm::sys::fs::file_type::regular_file);
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002400 if (!FoundConfigFile) {
Edwin Vaned544aa72013-09-30 13:31:48 +00002401 // Try _clang-format too, since dotfiles are not commonly used on Windows.
2402 ConfigFile = Directory;
2403 llvm::sys::path::append(ConfigFile, "_clang-format");
Nicola Zaghen3538b392018-05-15 13:30:56 +00002404 LLVM_DEBUG(llvm::dbgs() << "Trying " << ConfigFile << "...\n");
Eric Liu547d8792016-03-24 13:22:42 +00002405 Status = FS->status(ConfigFile.str());
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002406 FoundConfigFile = Status && (Status->getType() ==
2407 llvm::sys::fs::file_type::regular_file);
Edwin Vaned544aa72013-09-30 13:31:48 +00002408 }
2409
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002410 if (FoundConfigFile) {
Rafael Espindola2d2b4202014-07-06 17:43:24 +00002411 llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> Text =
Eric Liu547d8792016-03-24 13:22:42 +00002412 FS->getBufferForFile(ConfigFile.str());
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002413 if (std::error_code EC = Text.getError())
2414 return make_string_error(EC.message());
Rafael Espindola2d2b4202014-07-06 17:43:24 +00002415 if (std::error_code ec =
2416 parseConfiguration(Text.get()->getBuffer(), &Style)) {
Rafael Espindolad0136702014-06-12 02:50:04 +00002417 if (ec == ParseError::Unsuitable) {
Alexander Kornienkocabdd732013-11-29 15:19:43 +00002418 if (!UnsuitableConfigFiles.empty())
2419 UnsuitableConfigFiles.append(", ");
2420 UnsuitableConfigFiles.append(ConfigFile);
Alexander Kornienkobc4ae442013-12-02 15:21:38 +00002421 continue;
Alexander Kornienkocabdd732013-11-29 15:19:43 +00002422 }
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002423 return make_string_error("Error reading " + ConfigFile + ": " +
2424 ec.message());
Edwin Vaned544aa72013-09-30 13:31:48 +00002425 }
Nicola Zaghen3538b392018-05-15 13:30:56 +00002426 LLVM_DEBUG(llvm::dbgs()
2427 << "Using configuration file " << ConfigFile << "\n");
Edwin Vaned544aa72013-09-30 13:31:48 +00002428 return Style;
2429 }
2430 }
Antonio Maiorano3adfb6a2017-01-17 00:12:27 +00002431 if (!UnsuitableConfigFiles.empty())
2432 return make_string_error("Configuration file(s) do(es) not support " +
2433 getLanguageName(Style.Language) + ": " +
2434 UnsuitableConfigFiles);
Antonio Maiorano7eb75072017-01-20 01:22:42 +00002435 return FallbackStyle;
Edwin Vaned544aa72013-09-30 13:31:48 +00002436}
2437
Daniel Jasper8d1832e2013-01-07 13:26:07 +00002438} // namespace format
2439} // namespace clang