.rubocop.yml

AllCops:
  Include:
    - bin/*
    - lib/**/*.rb
    - test/**/*.rb
  Exclude:
    - '[^blt]*/**/*'
  TargetRubyVersion: 2.7


Layout/LineLength:
  Max: 110 # Preferred length is 100
  Exclude:
    - lib/hexapdf/content/canvas.rb
    - lib/hexapdf/document/destinations.rb
    - lib/hexapdf/serializer.rb
    - lib/hexapdf/configuration.rb
    - lib/hexapdf/dictionary_fields.rb
    - lib/hexapdf/type/file_specification.rb
    - test/hexapdf/content/test_parser.rb
    - test/hexapdf/layout/test_text_layouter.rb

Metrics/ParameterLists:
  CountKeywordArgs: false
  Max: 8
  MaxOptionalParameters: 8

Metrics/BlockLength:
  Enabled: false

Metrics/MethodLength:
  Enabled: false

Metrics/ClassLength:
  Enabled: false

Metrics/ModuleLength:
  Enabled: false

Metrics/AbcSize:
  Enabled: false

Metrics/CyclomaticComplexity:
  Enabled: false

Metrics/PerceivedComplexity:
  Enabled: false

Metrics/BlockNesting:
  Max: 5


Style/Encoding:
  Enabled: false

Style/FrozenStringLiteralComment:
  Exclude:
    - test/**/*.rb

Style/StringLiterals:
  Enabled: false # we don't care

Style/RegexpLiteral:
  AllowInnerSlashes: true

Style/NumericLiterals:
  MinDigits: 6

Style/NumericLiteralPrefix:
  EnforcedOctalStyle: zero_only

Style/SymbolArray:
  EnforcedStyle: brackets
  Exclude:
    - lib/hexapdf/type/font_type1.rb

Style/WordArray:
  MinSize: 5
  Exclude:
    - lib/hexapdf/utils/pdf_doc_encoding.rb

Style/TrailingCommaInArrayLiteral:
  EnforcedStyleForMultiline: comma

Style/TrailingCommaInHashLiteral:
  EnforcedStyleForMultiline: comma

Style/ClassCheck:
  EnforcedStyle: kind_of?

Style/EmptyMethod:
  EnforcedStyle: expanded

Style/EmptyCaseCondition:
  Enabled: false

Style/Lambda:
  EnforcedStyle: lambda

Style/NumericPredicate:
  EnforcedStyle: comparison

Style/TernaryParentheses:
  Enabled: false

Style/FormatString:
  EnforcedStyle: sprintf
  Exclude:
    - lib/hexapdf/cli/command.rb # uses a different format method
    - lib/hexapdf/cli/inspect.rb # uses a different format method

Style/Semicolon:
  AllowAsExpressionSeparator: true

Style/YodaCondition:
  EnforcedStyle: forbid_for_equality_operators_only

Style/EmptyElse:
  EnforcedStyle: empty

Style/InverseMethods:
  Exclude:
    - lib/hexapdf/layout/box.rb # false alarm for custom none?

Style/SingleLineMethods:
  Exclude:
    - test/**/*

Style/Documentation:
  Exclude:
    - lib/hexapdf/data_dir.rb # false alaram
    - lib/hexapdf/configuration.rb # false alaram
    - lib/hexapdf/type/actions.rb # false alaram
    - lib/hexapdf/type/annotations.rb # false alaram
    - lib/hexapdf/layout/text_shaper.rb # false alaram
    - lib/hexapdf/encryption/fast_arc4.rb # false alarm
    - test/**/*

Style/GuardClause:
  Enabled: false # false alarms

Style/Next:
  Enabled: false # not really useful

Style/ParallelAssignment:
  Enabled: false # not really needed

Style/TrivialAccessors:
  Enabled: false

Style/NestedTernaryOperator:
  Enabled: false # compact nested ternary operators are okay

Style/RescueModifier:
  Enabled: false # valid but using it makes life sometimes easier

Style/MutableConstant:
  Enabled: false # valid but sometimes unavoidable

Style/CommentedKeyword:
  Enabled: false # false alarms and we do want yield comments on that line

Style/StderrPuts:
  Enabled: false # false alarms because not all $stderr.puts messages are Ruby style warnings

Style/PerlBackrefs:
  Enabled: false # sometimes there are no good alternatives

Style/IfUnlessModifier:
  Enabled: false # useful but sometimes the meaning is better conveyed using an if/unless statement

Style/InfiniteLoop:
  Enabled: false # why should Kernel#loop be better than while true?

Style/SpecialGlobalVars:
  Enabled: false # I think that $! and $? are recognizable in terms of their function

Style/MultipleComparison:
  Enabled: false # why should an array be created? especially if only two items are compared

Style/AccessModifierDeclarations:
  Enabled: false

Style/WhileUntilModifier:
  Enabled: false # I prefer to use either one or the other, depending on context

Style/FormatStringToken:
  Enabled: false # I don't care about this

Style/ExponentialNotation:
  Enabled: true

Style/HashTransformKeys:
  Enabled: true

Style/HashEachMethods:
  Enabled: false
  Exclude:
    - lib/hexapdf/dictionary.rb # hash may be changed during iteration
    - lib/hexapdf/utils/object_hash.rb # hash may be changed during iteration
    - lib/hexapdf/font/true_type/subsetter.rb # hash is changed during iteration

Style/HashTransformValues:
  Enabled: true
  Exclude:
    - lib/hexapdf/cli/fonts.rb # false alarm

Style/OptionalBooleanParameter:
  Enabled: false

Style/OptionalArguments:
  Exclude:
    - lib/hexapdf/content/canvas.rb # bc of line_with_rounded_corners
    - lib/hexapdf/document/layout.rb # bc of CellArgumentCollector#[]

Style/CaseLikeIf:
  Exclude:
    - lib/hexapdf/tokenizer.rb # false alarm

Style/ZeroLengthPredicate:
  Exclude:
    - lib/hexapdf/type/acro_form/appearance_generator.rb # false alarm

Style/RaiseArgs:
  AllowedCompactTypes: [HexaPDF::MissingGlyphError]

Layout/HashAlignment:
  EnforcedLastArgumentHashStyle: ignore_implicit

Layout/SpaceInsideBlockBraces:
  SpaceBeforeBlockParameters: false

Layout/SpaceInsideHashLiteralBraces:
  EnforcedStyle: no_space

Layout/TrailingWhitespace:
  Exclude:
    - test/hexapdf/test_parser.rb # bc xref
    - test/hexapdf/test_writer.rb # bc xref
    - test/hexapdf/test_revisions.rb # bc xref
    - test/hexapdf/test_document.rb # bc xref

Layout/EmptyLineBetweenDefs:
  AllowAdjacentOneLineDefs: true

Layout/EmptyLinesAroundModuleBody:
  Enabled: false

Layout/EmptyLinesAroundClassBody:
  EnforcedStyle: empty_lines

Layout/EmptyLineAfterGuardClause:
  Enabled: false

Layout/MultilineOperationIndentation:
  EnforcedStyle: indented
  Exclude:
    - lib/hexapdf/type/acro_form/choice_field.rb # false alarm
    - lib/hexapdf/type/annotations/widget.rb # false alarm
    - lib/hexapdf/layout/style.rb # false alarm
    - lib/hexapdf/layout/width_from_polygon.rb # false alarm
    - lib/hexapdf/layout/frame.rb # false alarm

Layout/MultilineMethodCallIndentation:
  EnforcedStyle: indented

Layout/DotPosition:
  EnforcedStyle: trailing

Layout/EmptyLineAfterMagicComment:
  Enabled: false # we have the magic comment and then the license

Layout/AssignmentIndentation:
  Enabled: false # false alarms

Layout/SpaceAroundMethodCallOperator:
  Enabled: true

Layout/LeadingCommentSpace:
  Enabled: false # would be nice but triggers for RDoc things like :nodoc:


Naming/PredicateName:
  Exclude:
    - lib/hexapdf/font/true_type/table/post.rb

Naming/VariableNumber:
  Exclude:
    - lib/hexapdf/encryption/security_handler.rb # bc of n_plus_5

Naming/ConstantName:
  Exclude:
    - lib/hexapdf/dictionary_fields.rb

Naming/MemoizedInstanceVariableName:
  Exclude:
    - lib/hexapdf/font/encoding/glyph_list.rb
    - lib/hexapdf/type/object_stream.rb

Naming/HeredocDelimiterNaming:
  Enabled: false # we like our delimiters short and obvious

Naming/MethodParameterName:
  Enabled: false # for points the names x,y are perfectly reasonable

Lint/LiteralAsCondition:
  Enabled: false # we use while true

Lint/SuppressedException:
  Exclude:
    - test/test_helper.rb

Lint/UselessAccessModifier:
  Exclude:
    - lib/hexapdf/dictionary_fields.rb # not useless

Lint/StructNewOverride:
  Enabled: true
  Exclude:
    - lib/hexapdf/font/true_type/table/directory.rb

Lint/RaiseException:
  Enabled: true

Lint/MissingSuper:
  Enabled: false # why the need to fallback to super?

Lint/ConstantDefinitionInBlock:
  Exclude:
    - test/**/*.rb

Lint/FloatComparison:
  Exclude:
    - lib/hexapdf/image_loader/png.rb


Gemspec/RequireMFA: # new in 1.23
  Enabled: true
Layout/LineEndStringConcatenationIndentation: # new in 1.18
  Enabled: false
Layout/SpaceBeforeBrackets: # new in 1.7
  Enabled: true
Lint/AmbiguousAssignment: # new in 1.7
  Enabled: true
Lint/AmbiguousOperatorPrecedence:
  Enabled: false
Lint/AmbiguousRange: # new in 1.19
  Enabled: true
Lint/DeprecatedConstants: # new in 1.8
  Enabled: true
Lint/DuplicateBranch: # new in 1.3
  Enabled: false
Lint/DuplicateRegexpCharacterClassElement: # new in 1.1
  Enabled: true
Lint/EmptyBlock: # new in 1.1
  Enabled: false
Lint/EmptyClass: # new in 1.3
  Enabled: true
Lint/EmptyInPattern: # new in 1.16
  Enabled: true
Lint/IncompatibleIoSelectWithFiberScheduler: # new in 1.21
  Enabled: true
Lint/LambdaWithoutLiteralBlock: # new in 1.8
  Enabled: true
Lint/NoReturnInBeginEndBlocks: # new in 1.2
  Enabled: true
Lint/NumberedParameterAssignment: # new in 1.9
  Enabled: true
Lint/OrAssignmentToConstant: # new in 1.9
  Enabled: true
Lint/RedundantDirGlobSort: # new in 1.8
  Enabled: true
Lint/RequireRelativeSelfPath: # new in 1.22
  Enabled: true
Lint/SymbolConversion: # new in 1.9
  Enabled: true
  Exclude:
    - test/hexapdf/content/test_operator.rb # conflict with other cop
    - lib/hexapdf/type/page.rb # False alarm
Lint/ToEnumArguments: # new in 1.1
  Enabled: true
Lint/TripleQuotes: # new in 1.9
  Enabled: true
Lint/UnexpectedBlockArity: # new in 1.5
  Enabled: true
Lint/UnmodifiedReduceAccumulator: # new in 1.1
  Enabled: false
Lint/UselessRuby2Keywords: # new in 1.23
  Enabled: true
Naming/BlockForwarding: # new in 1.24
  Enabled: true
Security/IoMethods: # new in 1.22
  Enabled: true
Style/ArgumentsForwarding: # new in 1.1
  Enabled: true
Style/CollectionCompact: # new in 1.2
  Enabled: true
Style/DocumentDynamicEvalDefinition: # new in 1.1
  Enabled: false
Style/EndlessMethod: # new in 1.8
  Enabled: true
Style/FileRead: # new in 1.24
  Enabled: true
Style/FileWrite: # new in 1.24
  Enabled: true
Style/HashConversion: # new in 1.10
  Enabled: true
Style/HashExcept: # new in 1.7
  Enabled: true
Style/IfWithBooleanLiteralBranches: # new in 1.9
  Enabled: true
Style/InPatternThen: # new in 1.16
  Enabled: true
Style/MapToHash: # new in 1.24
  Enabled: true
Style/MultilineInPatternThen: # new in 1.16
  Enabled: true
Style/NegatedIfElseCondition: # new in 1.2
  Enabled: true
  Exclude:
    - lib/hexapdf/filter/ascii85_decode.rb
Style/NilLambda: # new in 1.3
  Enabled: true
Style/NumberedParameters: # new in 1.22
  Enabled: true
Style/NumberedParametersLimit: # new in 1.22
  Enabled: true
Style/OpenStructUse: # new in 1.23
  Enabled: false
Style/QuotedSymbols: # new in 1.16
  Enabled: true
Style/RedundantArgument: # new in 1.4
  Enabled: true
Style/RedundantSelfAssignmentBranch: # new in 1.19
  Enabled: true
  Exclude:
    - lib/hexapdf/filter/flate_decode.rb
Style/SelectByRegexp: # new in 1.22
  Enabled: true
Style/StringChars: # new in 1.12
  Enabled: true
Style/SwapValues: # new in 1.1
  Enabled: true
Gemspec/DeprecatedAttributeAssignment: # new in 1.30
  Enabled: true
Layout/LineContinuationLeadingSpace: # new in 1.31
  Enabled: true
Layout/LineContinuationSpacing: # new in 1.31
  Enabled: true
Lint/ConstantOverwrittenInRescue: # new in 1.31
  Enabled: true
Lint/DuplicateMagicComment: # new in 1.37
  Enabled: true
Lint/NonAtomicFileOperation: # new in 1.31
  Enabled: true
Lint/RefinementImportMethods: # new in 1.27
  Enabled: true
Lint/RequireRangeParentheses: # new in 1.32
  Enabled: true
Security/CompoundHash: # new in 1.28
  Enabled: false
Style/ArrayIntersect: # new in 1.40
  Enabled: true
Style/ConcatArrayLiterals: # new in 1.41
  Enabled: true
Style/EmptyHeredoc: # new in 1.32
  Enabled: true
Style/EnvHome: # new in 1.29
  Enabled: true
Style/FetchEnvVar: # new in 1.28
  Enabled: true
Style/MagicCommentFormat: # new in 1.35
  Enabled: true
Style/MapCompactWithConditionalBlock: # new in 1.30
  Enabled: true
Style/NestedFileDirname: # new in 1.26
  Enabled: true
Style/ObjectThen: # new in 1.28
  Enabled: true
Style/OperatorMethodCall: # new in 1.37
  Enabled: true
Style/RedundantConstantBase: # new in 1.40
  Enabled: true
Style/RedundantDoubleSplatHashBraces: # new in 1.41
  Enabled: true
Style/RedundantEach: # new in 1.38
  Enabled: true
Style/RedundantInitialize: # new in 1.27
  Enabled: true
Style/RedundantStringEscape: # new in 1.37
  Enabled: true
Style/SlicingWithRange:
  Enabled: false
Gemspec/DevelopmentDependencies: # new in 1.44
  Enabled: true
Lint/DuplicateMatchPattern: # new in 1.50
  Enabled: true
Lint/ItWithoutArgumentsInBlock: # new in 1.59
  Enabled: true
Lint/LiteralAssignmentInCondition: # new in 1.58
  Enabled: true
Lint/MixedCaseRange: # new in 1.53
  Enabled: true
Lint/RedundantRegexpQuantifiers: # new in 1.53
  Enabled: true
Lint/UselessRescue: # new in 1.43
  Enabled: true
Metrics/CollectionLiteralLength: # new in 1.47
  Enabled: false
Style/ComparableClamp: # new in 1.44
  Enabled: true
Style/DataInheritance: # new in 1.49
  Enabled: true
Style/DirEmpty: # new in 1.48
  Enabled: true
Style/ExactRegexpMatch: # new in 1.51
  Enabled: true
Style/FileEmpty: # new in 1.48
  Enabled: true
Style/MapToSet: # new in 1.42
  Enabled: true
Style/MinMaxComparison: # new in 1.42
  Enabled: false
Style/RedundantArrayConstructor: # new in 1.52
  Enabled: true
Style/RedundantCurrentDirectoryInPath: # new in 1.53
  Enabled: true
Style/RedundantFilterChain: # new in 1.52
  Enabled: true
Style/RedundantHeredocDelimiterQuotes: # new in 1.45
  Enabled: true
Style/RedundantLineContinuation: # new in 1.49
  Enabled: true
Style/RedundantRegexpArgument: # new in 1.53
  Enabled: false
Style/RedundantRegexpConstructor: # new in 1.52
  Enabled: true
Style/ReturnNilInPredicateMethodDefinition: # new in 1.53
  Enabled: true
Style/SingleLineDoEndBlock: # new in 1.57
  Enabled: true
Style/SuperWithArgsParentheses: # new in 1.58
  Enabled: true
Style/YAMLFileRead: # new in 1.53
  Enabled: true

# These cops should be run manually from time to time
# Style/MutableConstant
# Style/RescueModifier
# Style/PerlBackrefs
# Style/IfUnlessModifier