src/eric7/QScintilla/Lexers/LexerJSON.py

Tue, 23 Apr 2024 11:26:04 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Tue, 23 Apr 2024 11:26:04 +0200
branch
eric7
changeset 10692
9becf9ca115c
parent 10683
779cda568acb
child 11090
f5f5f5803935
permissions
-rw-r--r--

Changed the source code and the source code documentation to improve the indication of unused method/function arguments.

5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
1 # -*- coding: utf-8 -*-
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
2
10439
21c28b0f9e41 Updated copyright for 2024.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10431
diff changeset
3 # Copyright (c) 2017 - 2024 Detlev Offenbach <detlev@die-offenbachs.de>
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
4 #
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
5
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
6 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
7 Module implementing a JSON lexer with some additional methods.
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
8 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
9
8318
962bce857696 Replaced all imports of PyQt5 to PyQt6 and started to replace code using obsoleted methods and adapt to the PyQt6 enum usage.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 8312
diff changeset
10 from PyQt6.Qsci import QsciLexerJSON
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
11
9473
3f23dbf37dbe Resorted the import statements using isort.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9413
diff changeset
12 from eric7 import Preferences
3f23dbf37dbe Resorted the import statements using isort.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9413
diff changeset
13
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
14 from .Lexer import Lexer
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
15
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
16
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
17 class LexerJSON(Lexer, QsciLexerJSON):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
18 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
19 Subclass to implement some additional lexer dependent methods.
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
20 """
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
21
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
22 def __init__(self, parent=None):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
23 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
24 Constructor
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
25
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
26 @param parent parent widget of this lexer
10431
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
27 @type QWidget
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
28 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
29 QsciLexerJSON.__init__(self, parent)
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
30 Lexer.__init__(self)
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
31
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
32 self.commentString = "//"
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
33 self.streamCommentString = {"start": "/* ", "end": " */"}
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
34
6874
5a3a39442711 Lexers: extended the keyword set handling by introducing a keyword set description and some set adjustments (harmonized with SciTE).
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 6645
diff changeset
35 self.keywordSetDescriptions = [
5a3a39442711 Lexers: extended the keyword set handling by introducing a keyword set description and some set adjustments (harmonized with SciTE).
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 6645
diff changeset
36 self.tr("JSON Keywords"),
5a3a39442711 Lexers: extended the keyword set handling by introducing a keyword set description and some set adjustments (harmonized with SciTE).
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 6645
diff changeset
37 self.tr("JSON-LD Keywords"),
5a3a39442711 Lexers: extended the keyword set handling by introducing a keyword set description and some set adjustments (harmonized with SciTE).
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 6645
diff changeset
38 ]
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
39
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
40 def initProperties(self):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
41 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
42 Public slot to initialize the properties.
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
43 """
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
44 self.setHighlightComments(Preferences.getEditor("JSONHightlightComments"))
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
45 self.setHighlightEscapeSequences(
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
46 Preferences.getEditor("JSONHighlightEscapeSequences")
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
47 )
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
48 self.setFoldCompact(Preferences.getEditor("AllFoldCompact"))
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
49
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
50 def isCommentStyle(self, style):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
51 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
52 Public method to check, if a style is a comment style.
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
53
10431
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
54 @param style style to check
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
55 @type int
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
56 @return flag indicating a comment style
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
57 @rtype bool
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
58 """
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
59 return style in [QsciLexerJSON.CommentLine, QsciLexerJSON.CommentBlock]
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
60
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
61 def isStringStyle(self, style):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
62 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
63 Public method to check, if a style is a string style.
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
64
10431
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
65 @param style style to check
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
66 @type int
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
67 @return flag indicating a string style
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
68 @rtype bool
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
69 """
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
70 return style in [QsciLexerJSON.String, QsciLexerJSON.UnclosedString]
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
71
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
72 def defaultKeywords(self, kwSet):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
73 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
74 Public method to get the default keywords.
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
75
10431
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
76 @param kwSet number of the keyword set
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
77 @type int
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
78 @return string giving the keywords or None
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
79 @rtype str
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
80 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
81 return QsciLexerJSON.keywords(self, kwSet)
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
82
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
83 def maximumKeywordSet(self):
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
84 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
85 Public method to get the maximum keyword set.
9221
bf71ee032bb4 Reformatted the source code using the 'Black' utility.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9209
diff changeset
86
10431
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
87 @return maximum keyword set
64157aeb0312 Converted some source code documentation to the new style.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10069
diff changeset
88 @rtype int
5420
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
89 """
53ca6ddb4acf Added support for the new QScintilla JSON lexer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
90 return 2
9484
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
91
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
92
10692
9becf9ca115c Changed the source code and the source code documentation to improve the indication of unused method/function arguments.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10683
diff changeset
93 def createLexer(variant, parent=None): # noqa: U100
9484
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
94 """
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
95 Function to instantiate a lexer object.
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
96
10683
779cda568acb Changed the source code and the source code documentation to improve the indication of unused method/function arguments.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10439
diff changeset
97 @param variant name of the language variant (unused)
9484
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
98 @type str
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
99 @param parent parent widget of this lexer
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
100 @type QObject
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
101 @return instantiated lexer object
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
102 @rtype LexerJSON
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
103 """
d2eb8f0a5bf0 Changed the way editor lexers are instantiated.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9473
diff changeset
104 return LexerJSON(parent=parent)

eric ide

mercurial