rbs-relaxed 3.9.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.github/dependabot.yml +22 -0
- data/.github/workflows/comments.yml +35 -0
- data/.github/workflows/dependabot.yml +30 -0
- data/.github/workflows/ruby.yml +82 -0
- data/.github/workflows/typecheck.yml +38 -0
- data/.github/workflows/windows.yml +43 -0
- data/.gitignore +23 -0
- data/.rubocop.yml +68 -0
- data/BSDL +22 -0
- data/CHANGELOG.md +1868 -0
- data/COPYING +56 -0
- data/README.md +203 -0
- data/Rakefile +417 -0
- data/Steepfile +44 -0
- data/config.yml +313 -0
- data/core/array.rbs +4062 -0
- data/core/basic_object.rbs +375 -0
- data/core/binding.rbs +150 -0
- data/core/builtin.rbs +277 -0
- data/core/class.rbs +220 -0
- data/core/comparable.rbs +171 -0
- data/core/complex.rbs +786 -0
- data/core/constants.rbs +96 -0
- data/core/data.rbs +415 -0
- data/core/dir.rbs +981 -0
- data/core/encoding.rbs +1371 -0
- data/core/enumerable.rbs +2405 -0
- data/core/enumerator/product.rbs +92 -0
- data/core/enumerator.rbs +630 -0
- data/core/env.rbs +6 -0
- data/core/errno.rbs +673 -0
- data/core/errors.rbs +760 -0
- data/core/exception.rbs +485 -0
- data/core/false_class.rbs +82 -0
- data/core/fiber.rbs +550 -0
- data/core/fiber_error.rbs +11 -0
- data/core/file.rbs +2936 -0
- data/core/file_test.rbs +331 -0
- data/core/float.rbs +1151 -0
- data/core/gc.rbs +644 -0
- data/core/global_variables.rbs +184 -0
- data/core/hash.rbs +1861 -0
- data/core/integer.rbs +1413 -0
- data/core/io/buffer.rbs +984 -0
- data/core/io/wait.rbs +70 -0
- data/core/io.rbs +3406 -0
- data/core/kernel.rbs +3096 -0
- data/core/marshal.rbs +207 -0
- data/core/match_data.rbs +635 -0
- data/core/math.rbs +729 -0
- data/core/method.rbs +386 -0
- data/core/module.rbs +1704 -0
- data/core/nil_class.rbs +209 -0
- data/core/numeric.rbs +818 -0
- data/core/object.rbs +110 -0
- data/core/object_space/weak_key_map.rbs +166 -0
- data/core/object_space.rbs +190 -0
- data/core/proc.rbs +868 -0
- data/core/process.rbs +2296 -0
- data/core/ractor.rbs +1068 -0
- data/core/random.rbs +237 -0
- data/core/range.rbs +1107 -0
- data/core/rational.rbs +531 -0
- data/core/rb_config.rbs +88 -0
- data/core/rbs/unnamed/argf.rbs +1229 -0
- data/core/rbs/unnamed/env_class.rbs +1209 -0
- data/core/rbs/unnamed/random.rbs +293 -0
- data/core/refinement.rbs +59 -0
- data/core/regexp.rbs +1930 -0
- data/core/ruby_vm.rbs +765 -0
- data/core/rubygems/basic_specification.rbs +6 -0
- data/core/rubygems/config_file.rbs +38 -0
- data/core/rubygems/dependency_installer.rbs +6 -0
- data/core/rubygems/errors.rbs +176 -0
- data/core/rubygems/installer.rbs +15 -0
- data/core/rubygems/path_support.rbs +6 -0
- data/core/rubygems/platform.rbs +7 -0
- data/core/rubygems/request_set.rbs +49 -0
- data/core/rubygems/requirement.rbs +148 -0
- data/core/rubygems/rubygems.rbs +1171 -0
- data/core/rubygems/source_list.rbs +15 -0
- data/core/rubygems/specification.rbs +23 -0
- data/core/rubygems/stream_ui.rbs +5 -0
- data/core/rubygems/uninstaller.rbs +10 -0
- data/core/rubygems/version.rbs +294 -0
- data/core/set.rbs +621 -0
- data/core/signal.rbs +100 -0
- data/core/string.rbs +3583 -0
- data/core/struct.rbs +667 -0
- data/core/symbol.rbs +475 -0
- data/core/thread.rbs +1765 -0
- data/core/thread_group.rbs +79 -0
- data/core/time.rbs +1762 -0
- data/core/trace_point.rbs +477 -0
- data/core/true_class.rbs +98 -0
- data/core/unbound_method.rbs +329 -0
- data/core/warning.rbs +87 -0
- data/docs/CONTRIBUTING.md +106 -0
- data/docs/architecture.md +110 -0
- data/docs/collection.md +192 -0
- data/docs/data_and_struct.md +86 -0
- data/docs/gem.md +57 -0
- data/docs/rbs_by_example.md +309 -0
- data/docs/repo.md +125 -0
- data/docs/sigs.md +167 -0
- data/docs/stdlib.md +147 -0
- data/docs/syntax.md +910 -0
- data/docs/tools.md +17 -0
- data/exe/rbs +7 -0
- data/ext/rbs_extension/extconf.rb +15 -0
- data/ext/rbs_extension/lexer.c +2728 -0
- data/ext/rbs_extension/lexer.h +179 -0
- data/ext/rbs_extension/lexer.re +147 -0
- data/ext/rbs_extension/lexstate.c +175 -0
- data/ext/rbs_extension/location.c +325 -0
- data/ext/rbs_extension/location.h +85 -0
- data/ext/rbs_extension/main.c +33 -0
- data/ext/rbs_extension/parser.c +2973 -0
- data/ext/rbs_extension/parser.h +18 -0
- data/ext/rbs_extension/parserstate.c +397 -0
- data/ext/rbs_extension/parserstate.h +163 -0
- data/ext/rbs_extension/rbs_extension.h +31 -0
- data/ext/rbs_extension/unescape.c +32 -0
- data/goodcheck.yml +91 -0
- data/include/rbs/constants.h +82 -0
- data/include/rbs/ruby_objs.h +72 -0
- data/include/rbs/util/rbs_constant_pool.h +219 -0
- data/include/rbs.h +7 -0
- data/lib/rbs/ancestor_graph.rb +92 -0
- data/lib/rbs/annotate/annotations.rb +199 -0
- data/lib/rbs/annotate/formatter.rb +92 -0
- data/lib/rbs/annotate/rdoc_annotator.rb +400 -0
- data/lib/rbs/annotate/rdoc_source.rb +131 -0
- data/lib/rbs/annotate.rb +8 -0
- data/lib/rbs/ast/annotation.rb +29 -0
- data/lib/rbs/ast/comment.rb +29 -0
- data/lib/rbs/ast/declarations.rb +467 -0
- data/lib/rbs/ast/directives.rb +49 -0
- data/lib/rbs/ast/members.rb +451 -0
- data/lib/rbs/ast/type_param.rb +225 -0
- data/lib/rbs/ast/visitor.rb +137 -0
- data/lib/rbs/buffer.rb +67 -0
- data/lib/rbs/builtin_names.rb +58 -0
- data/lib/rbs/cli/colored_io.rb +48 -0
- data/lib/rbs/cli/diff.rb +83 -0
- data/lib/rbs/cli/validate.rb +357 -0
- data/lib/rbs/cli.rb +1223 -0
- data/lib/rbs/collection/cleaner.rb +38 -0
- data/lib/rbs/collection/config/lockfile.rb +92 -0
- data/lib/rbs/collection/config/lockfile_generator.rb +218 -0
- data/lib/rbs/collection/config.rb +81 -0
- data/lib/rbs/collection/installer.rb +32 -0
- data/lib/rbs/collection/sources/base.rb +14 -0
- data/lib/rbs/collection/sources/git.rb +258 -0
- data/lib/rbs/collection/sources/local.rb +81 -0
- data/lib/rbs/collection/sources/rubygems.rb +48 -0
- data/lib/rbs/collection/sources/stdlib.rb +50 -0
- data/lib/rbs/collection/sources.rb +38 -0
- data/lib/rbs/collection.rb +16 -0
- data/lib/rbs/constant.rb +28 -0
- data/lib/rbs/definition.rb +401 -0
- data/lib/rbs/definition_builder/ancestor_builder.rb +620 -0
- data/lib/rbs/definition_builder/method_builder.rb +254 -0
- data/lib/rbs/definition_builder.rb +845 -0
- data/lib/rbs/diff.rb +125 -0
- data/lib/rbs/environment/use_map.rb +77 -0
- data/lib/rbs/environment.rb +829 -0
- data/lib/rbs/environment_loader.rb +173 -0
- data/lib/rbs/environment_walker.rb +155 -0
- data/lib/rbs/errors.rb +645 -0
- data/lib/rbs/factory.rb +18 -0
- data/lib/rbs/file_finder.rb +28 -0
- data/lib/rbs/location_aux.rb +138 -0
- data/lib/rbs/locator.rb +243 -0
- data/lib/rbs/method_type.rb +143 -0
- data/lib/rbs/namespace.rb +125 -0
- data/lib/rbs/parser/lex_result.rb +15 -0
- data/lib/rbs/parser/token.rb +23 -0
- data/lib/rbs/parser_aux.rb +114 -0
- data/lib/rbs/prototype/helpers.rb +140 -0
- data/lib/rbs/prototype/node_usage.rb +99 -0
- data/lib/rbs/prototype/rb.rb +840 -0
- data/lib/rbs/prototype/rbi.rb +641 -0
- data/lib/rbs/prototype/runtime/helpers.rb +59 -0
- data/lib/rbs/prototype/runtime/reflection.rb +19 -0
- data/lib/rbs/prototype/runtime/value_object_generator.rb +279 -0
- data/lib/rbs/prototype/runtime.rb +667 -0
- data/lib/rbs/repository.rb +127 -0
- data/lib/rbs/resolver/constant_resolver.rb +219 -0
- data/lib/rbs/resolver/type_name_resolver.rb +91 -0
- data/lib/rbs/sorter.rb +198 -0
- data/lib/rbs/substitution.rb +83 -0
- data/lib/rbs/subtractor.rb +201 -0
- data/lib/rbs/test/errors.rb +80 -0
- data/lib/rbs/test/guaranteed.rb +30 -0
- data/lib/rbs/test/hook.rb +212 -0
- data/lib/rbs/test/observer.rb +19 -0
- data/lib/rbs/test/setup.rb +84 -0
- data/lib/rbs/test/setup_helper.rb +50 -0
- data/lib/rbs/test/tester.rb +167 -0
- data/lib/rbs/test/type_check.rb +435 -0
- data/lib/rbs/test.rb +112 -0
- data/lib/rbs/type_alias_dependency.rb +100 -0
- data/lib/rbs/type_alias_regularity.rb +126 -0
- data/lib/rbs/type_name.rb +109 -0
- data/lib/rbs/types.rb +1596 -0
- data/lib/rbs/unit_test/convertibles.rb +176 -0
- data/lib/rbs/unit_test/spy.rb +138 -0
- data/lib/rbs/unit_test/type_assertions.rb +347 -0
- data/lib/rbs/unit_test/with_aliases.rb +143 -0
- data/lib/rbs/unit_test.rb +6 -0
- data/lib/rbs/validator.rb +186 -0
- data/lib/rbs/variance_calculator.rb +189 -0
- data/lib/rbs/vendorer.rb +71 -0
- data/lib/rbs/version.rb +5 -0
- data/lib/rbs/writer.rb +424 -0
- data/lib/rbs.rb +94 -0
- data/lib/rdoc/discover.rb +20 -0
- data/lib/rdoc_plugin/parser.rb +163 -0
- data/rbs-relaxed.gemspec +48 -0
- data/schema/annotation.json +14 -0
- data/schema/comment.json +26 -0
- data/schema/decls.json +326 -0
- data/schema/function.json +87 -0
- data/schema/location.json +56 -0
- data/schema/members.json +266 -0
- data/schema/methodType.json +50 -0
- data/schema/typeParam.json +36 -0
- data/schema/types.json +317 -0
- data/sig/ancestor_builder.rbs +163 -0
- data/sig/ancestor_graph.rbs +60 -0
- data/sig/annotate/annotations.rbs +102 -0
- data/sig/annotate/formatter.rbs +24 -0
- data/sig/annotate/rdoc_annotater.rbs +82 -0
- data/sig/annotate/rdoc_source.rbs +30 -0
- data/sig/annotation.rbs +27 -0
- data/sig/buffer.rbs +32 -0
- data/sig/builtin_names.rbs +44 -0
- data/sig/cli/colored_io.rbs +15 -0
- data/sig/cli/diff.rbs +21 -0
- data/sig/cli/validate.rbs +43 -0
- data/sig/cli.rbs +87 -0
- data/sig/collection/cleaner.rbs +13 -0
- data/sig/collection/config/lockfile.rbs +74 -0
- data/sig/collection/config/lockfile_generator.rbs +66 -0
- data/sig/collection/config.rbs +46 -0
- data/sig/collection/installer.rbs +17 -0
- data/sig/collection/sources.rbs +214 -0
- data/sig/collection.rbs +4 -0
- data/sig/comment.rbs +26 -0
- data/sig/constant.rbs +21 -0
- data/sig/declarations.rbs +267 -0
- data/sig/definition.rbs +173 -0
- data/sig/definition_builder.rbs +165 -0
- data/sig/diff.rbs +28 -0
- data/sig/directives.rbs +77 -0
- data/sig/environment.rbs +279 -0
- data/sig/environment_loader.rbs +111 -0
- data/sig/environment_walker.rbs +65 -0
- data/sig/errors.rbs +405 -0
- data/sig/factory.rbs +5 -0
- data/sig/file_finder.rbs +28 -0
- data/sig/location.rbs +110 -0
- data/sig/locator.rbs +58 -0
- data/sig/manifest.yaml +7 -0
- data/sig/members.rbs +258 -0
- data/sig/method_builder.rbs +84 -0
- data/sig/method_types.rbs +58 -0
- data/sig/namespace.rbs +146 -0
- data/sig/parser.rbs +100 -0
- data/sig/prototype/helpers.rbs +27 -0
- data/sig/prototype/node_usage.rbs +20 -0
- data/sig/prototype/rb.rbs +96 -0
- data/sig/prototype/rbi.rbs +75 -0
- data/sig/prototype/runtime.rbs +182 -0
- data/sig/rbs.rbs +21 -0
- data/sig/rdoc/rbs.rbs +67 -0
- data/sig/repository.rbs +85 -0
- data/sig/resolver/constant_resolver.rbs +92 -0
- data/sig/resolver/context.rbs +34 -0
- data/sig/resolver/type_name_resolver.rbs +35 -0
- data/sig/shims/bundler.rbs +38 -0
- data/sig/shims/enumerable.rbs +5 -0
- data/sig/shims/rubygems.rbs +19 -0
- data/sig/sorter.rbs +41 -0
- data/sig/substitution.rbs +48 -0
- data/sig/subtractor.rbs +37 -0
- data/sig/test/errors.rbs +52 -0
- data/sig/test/guranteed.rbs +9 -0
- data/sig/test/type_check.rbs +19 -0
- data/sig/test.rbs +82 -0
- data/sig/type_alias_dependency.rbs +53 -0
- data/sig/type_alias_regularity.rbs +98 -0
- data/sig/type_param.rbs +110 -0
- data/sig/typename.rbs +79 -0
- data/sig/types.rbs +579 -0
- data/sig/unit_test/convertibles.rbs +154 -0
- data/sig/unit_test/spy.rbs +30 -0
- data/sig/unit_test/type_assertions.rbs +196 -0
- data/sig/unit_test/with_aliases.rbs +136 -0
- data/sig/use_map.rbs +35 -0
- data/sig/util.rbs +9 -0
- data/sig/validator.rbs +63 -0
- data/sig/variance_calculator.rbs +87 -0
- data/sig/vendorer.rbs +51 -0
- data/sig/version.rbs +3 -0
- data/sig/visitor.rbs +47 -0
- data/sig/writer.rbs +127 -0
- data/src/constants.c +153 -0
- data/src/ruby_objs.c +795 -0
- data/src/util/rbs_constant_pool.c +342 -0
- data/stdlib/abbrev/0/abbrev.rbs +66 -0
- data/stdlib/abbrev/0/array.rbs +26 -0
- data/stdlib/base64/0/base64.rbs +355 -0
- data/stdlib/benchmark/0/benchmark.rbs +452 -0
- data/stdlib/bigdecimal/0/big_decimal.rbs +1629 -0
- data/stdlib/bigdecimal-math/0/big_math.rbs +119 -0
- data/stdlib/bigdecimal-math/0/manifest.yaml +2 -0
- data/stdlib/cgi/0/core.rbs +1285 -0
- data/stdlib/cgi/0/manifest.yaml +3 -0
- data/stdlib/coverage/0/coverage.rbs +263 -0
- data/stdlib/csv/0/csv.rbs +3776 -0
- data/stdlib/csv/0/manifest.yaml +3 -0
- data/stdlib/date/0/date.rbs +1585 -0
- data/stdlib/date/0/date_time.rbs +616 -0
- data/stdlib/date/0/time.rbs +26 -0
- data/stdlib/dbm/0/dbm.rbs +421 -0
- data/stdlib/delegate/0/delegator.rbs +184 -0
- data/stdlib/delegate/0/kernel.rbs +47 -0
- data/stdlib/delegate/0/simple_delegator.rbs +96 -0
- data/stdlib/did_you_mean/0/did_you_mean.rbs +343 -0
- data/stdlib/digest/0/digest.rbs +577 -0
- data/stdlib/erb/0/erb.rbs +532 -0
- data/stdlib/etc/0/etc.rbs +865 -0
- data/stdlib/fileutils/0/fileutils.rbs +1734 -0
- data/stdlib/find/0/find.rbs +49 -0
- data/stdlib/forwardable/0/forwardable.rbs +268 -0
- data/stdlib/io-console/0/io-console.rbs +414 -0
- data/stdlib/ipaddr/0/ipaddr.rbs +428 -0
- data/stdlib/json/0/json.rbs +1916 -0
- data/stdlib/kconv/0/kconv.rbs +166 -0
- data/stdlib/logger/0/formatter.rbs +45 -0
- data/stdlib/logger/0/log_device.rbs +100 -0
- data/stdlib/logger/0/logger.rbs +796 -0
- data/stdlib/logger/0/manifest.yaml +2 -0
- data/stdlib/logger/0/period.rbs +17 -0
- data/stdlib/logger/0/severity.rbs +34 -0
- data/stdlib/minitest/0/kernel.rbs +42 -0
- data/stdlib/minitest/0/minitest/abstract_reporter.rbs +52 -0
- data/stdlib/minitest/0/minitest/assertion.rbs +17 -0
- data/stdlib/minitest/0/minitest/assertions.rbs +590 -0
- data/stdlib/minitest/0/minitest/backtrace_filter.rbs +23 -0
- data/stdlib/minitest/0/minitest/bench_spec.rbs +102 -0
- data/stdlib/minitest/0/minitest/benchmark.rbs +259 -0
- data/stdlib/minitest/0/minitest/composite_reporter.rbs +25 -0
- data/stdlib/minitest/0/minitest/compress.rbs +13 -0
- data/stdlib/minitest/0/minitest/error_on_warning.rbs +3 -0
- data/stdlib/minitest/0/minitest/expectation.rbs +2 -0
- data/stdlib/minitest/0/minitest/expectations.rbs +21 -0
- data/stdlib/minitest/0/minitest/guard.rbs +64 -0
- data/stdlib/minitest/0/minitest/mock.rbs +64 -0
- data/stdlib/minitest/0/minitest/parallel/executor.rbs +46 -0
- data/stdlib/minitest/0/minitest/parallel/test/class_methods.rbs +5 -0
- data/stdlib/minitest/0/minitest/parallel/test.rbs +3 -0
- data/stdlib/minitest/0/minitest/parallel.rbs +2 -0
- data/stdlib/minitest/0/minitest/pride_io.rbs +62 -0
- data/stdlib/minitest/0/minitest/pride_lol.rbs +19 -0
- data/stdlib/minitest/0/minitest/progress_reporter.rbs +11 -0
- data/stdlib/minitest/0/minitest/reportable.rbs +53 -0
- data/stdlib/minitest/0/minitest/reporter.rbs +5 -0
- data/stdlib/minitest/0/minitest/result.rbs +28 -0
- data/stdlib/minitest/0/minitest/runnable.rbs +163 -0
- data/stdlib/minitest/0/minitest/skip.rbs +6 -0
- data/stdlib/minitest/0/minitest/spec/dsl/instance_methods.rbs +48 -0
- data/stdlib/minitest/0/minitest/spec/dsl.rbs +129 -0
- data/stdlib/minitest/0/minitest/spec.rbs +11 -0
- data/stdlib/minitest/0/minitest/statistics_reporter.rbs +81 -0
- data/stdlib/minitest/0/minitest/summary_reporter.rbs +18 -0
- data/stdlib/minitest/0/minitest/test/lifecycle_hooks.rbs +92 -0
- data/stdlib/minitest/0/minitest/test.rbs +69 -0
- data/stdlib/minitest/0/minitest/unexpected_error.rbs +12 -0
- data/stdlib/minitest/0/minitest/unexpected_warning.rbs +6 -0
- data/stdlib/minitest/0/minitest/unit/test_case.rbs +3 -0
- data/stdlib/minitest/0/minitest/unit.rbs +4 -0
- data/stdlib/minitest/0/minitest.rbs +115 -0
- data/stdlib/monitor/0/monitor.rbs +363 -0
- data/stdlib/mutex_m/0/mutex_m.rbs +104 -0
- data/stdlib/net-http/0/manifest.yaml +3 -0
- data/stdlib/net-http/0/net-http.rbs +5552 -0
- data/stdlib/net-protocol/0/manifest.yaml +2 -0
- data/stdlib/net-protocol/0/net-protocol.rbs +56 -0
- data/stdlib/net-smtp/0/manifest.yaml +2 -0
- data/stdlib/net-smtp/0/net-smtp.rbs +55 -0
- data/stdlib/nkf/0/nkf.rbs +402 -0
- data/stdlib/objspace/0/objspace.rbs +487 -0
- data/stdlib/observable/0/observable.rbs +217 -0
- data/stdlib/open-uri/0/manifest.yaml +4 -0
- data/stdlib/open-uri/0/open-uri.rbs +393 -0
- data/stdlib/open3/0/open3.rbs +147 -0
- data/stdlib/openssl/0/manifest.yaml +3 -0
- data/stdlib/openssl/0/openssl.rbs +12113 -0
- data/stdlib/optparse/0/optparse.rbs +1725 -0
- data/stdlib/pathname/0/pathname.rbs +1406 -0
- data/stdlib/pp/0/manifest.yaml +2 -0
- data/stdlib/pp/0/pp.rbs +300 -0
- data/stdlib/prettyprint/0/prettyprint.rbs +383 -0
- data/stdlib/pstore/0/pstore.rbs +603 -0
- data/stdlib/psych/0/core_ext.rbs +12 -0
- data/stdlib/psych/0/dbm.rbs +237 -0
- data/stdlib/psych/0/manifest.yaml +3 -0
- data/stdlib/psych/0/psych.rbs +402 -0
- data/stdlib/psych/0/store.rbs +59 -0
- data/stdlib/pty/0/pty.rbs +237 -0
- data/stdlib/rdoc/0/code_object.rbs +51 -0
- data/stdlib/rdoc/0/comment.rbs +59 -0
- data/stdlib/rdoc/0/context.rbs +153 -0
- data/stdlib/rdoc/0/markup.rbs +117 -0
- data/stdlib/rdoc/0/parser.rbs +56 -0
- data/stdlib/rdoc/0/rdoc.rbs +391 -0
- data/stdlib/rdoc/0/ri.rbs +17 -0
- data/stdlib/rdoc/0/store.rbs +48 -0
- data/stdlib/rdoc/0/top_level.rbs +97 -0
- data/stdlib/resolv/0/manifest.yaml +3 -0
- data/stdlib/resolv/0/resolv.rbs +1830 -0
- data/stdlib/ripper/0/ripper.rbs +1648 -0
- data/stdlib/securerandom/0/securerandom.rbs +62 -0
- data/stdlib/shellwords/0/shellwords.rbs +229 -0
- data/stdlib/singleton/0/singleton.rbs +131 -0
- data/stdlib/socket/0/addrinfo.rbs +666 -0
- data/stdlib/socket/0/basic_socket.rbs +590 -0
- data/stdlib/socket/0/constants.rbs +2295 -0
- data/stdlib/socket/0/ip_socket.rbs +92 -0
- data/stdlib/socket/0/socket.rbs +4157 -0
- data/stdlib/socket/0/socket_error.rbs +5 -0
- data/stdlib/socket/0/tcp_server.rbs +192 -0
- data/stdlib/socket/0/tcp_socket.rbs +79 -0
- data/stdlib/socket/0/udp_socket.rbs +133 -0
- data/stdlib/socket/0/unix_server.rbs +169 -0
- data/stdlib/socket/0/unix_socket.rbs +172 -0
- data/stdlib/stringio/0/stringio.rbs +567 -0
- data/stdlib/strscan/0/string_scanner.rbs +1627 -0
- data/stdlib/tempfile/0/tempfile.rbs +479 -0
- data/stdlib/time/0/time.rbs +432 -0
- data/stdlib/timeout/0/timeout.rbs +81 -0
- data/stdlib/tmpdir/0/tmpdir.rbs +69 -0
- data/stdlib/tsort/0/cyclic.rbs +5 -0
- data/stdlib/tsort/0/interfaces.rbs +20 -0
- data/stdlib/tsort/0/tsort.rbs +409 -0
- data/stdlib/uri/0/common.rbs +582 -0
- data/stdlib/uri/0/file.rbs +118 -0
- data/stdlib/uri/0/ftp.rbs +13 -0
- data/stdlib/uri/0/generic.rbs +1108 -0
- data/stdlib/uri/0/http.rbs +104 -0
- data/stdlib/uri/0/https.rbs +14 -0
- data/stdlib/uri/0/ldap.rbs +230 -0
- data/stdlib/uri/0/ldaps.rbs +14 -0
- data/stdlib/uri/0/mailto.rbs +92 -0
- data/stdlib/uri/0/rfc2396_parser.rbs +189 -0
- data/stdlib/uri/0/rfc3986_parser.rbs +2 -0
- data/stdlib/uri/0/ws.rbs +13 -0
- data/stdlib/uri/0/wss.rbs +9 -0
- data/stdlib/yaml/0/manifest.yaml +2 -0
- data/stdlib/yaml/0/yaml.rbs +1 -0
- data/stdlib/zlib/0/buf_error.rbs +10 -0
- data/stdlib/zlib/0/data_error.rbs +10 -0
- data/stdlib/zlib/0/deflate.rbs +210 -0
- data/stdlib/zlib/0/error.rbs +20 -0
- data/stdlib/zlib/0/gzip_file/crc_error.rbs +12 -0
- data/stdlib/zlib/0/gzip_file/error.rbs +23 -0
- data/stdlib/zlib/0/gzip_file/length_error.rbs +12 -0
- data/stdlib/zlib/0/gzip_file/no_footer.rbs +11 -0
- data/stdlib/zlib/0/gzip_file.rbs +156 -0
- data/stdlib/zlib/0/gzip_reader.rbs +293 -0
- data/stdlib/zlib/0/gzip_writer.rbs +166 -0
- data/stdlib/zlib/0/inflate.rbs +180 -0
- data/stdlib/zlib/0/mem_error.rbs +10 -0
- data/stdlib/zlib/0/need_dict.rbs +13 -0
- data/stdlib/zlib/0/stream_end.rbs +11 -0
- data/stdlib/zlib/0/stream_error.rbs +11 -0
- data/stdlib/zlib/0/version_error.rbs +11 -0
- data/stdlib/zlib/0/zlib.rbs +449 -0
- data/stdlib/zlib/0/zstream.rbs +200 -0
- metadata +532 -0
data/rbs-relaxed.gemspec
ADDED
@@ -0,0 +1,48 @@
|
|
1
|
+
|
2
|
+
lib = File.expand_path("../lib", __FILE__)
|
3
|
+
$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
|
4
|
+
require "rbs/version"
|
5
|
+
|
6
|
+
Gem::Specification.new do |spec|
|
7
|
+
spec.name = "rbs-relaxed"
|
8
|
+
spec.version = RBS::VERSION
|
9
|
+
spec.authors = ["Soutaro Matsumoto"]
|
10
|
+
spec.email = ["matsumoto@soutaro.com"]
|
11
|
+
|
12
|
+
spec.summary = %q{Type signature for Ruby.}
|
13
|
+
spec.description = %q{RBS is the language for type signatures for Ruby and standard library definitions.}
|
14
|
+
spec.homepage = "https://github.com/ruby/rbs"
|
15
|
+
spec.licenses = ['BSD-2-Clause', 'Ruby']
|
16
|
+
|
17
|
+
# Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
|
18
|
+
# to allow pushing to a single host or delete this section to allow pushing to any host.
|
19
|
+
if spec.respond_to?(:metadata)
|
20
|
+
spec.metadata["homepage_uri"] = spec.homepage
|
21
|
+
spec.metadata["source_code_uri"] = "https://github.com/ruby/rbs.git"
|
22
|
+
spec.metadata["changelog_uri"] = "https://github.com/ruby/rbs/blob/master/CHANGELOG.md"
|
23
|
+
else
|
24
|
+
raise "RubyGems 2.0 or newer is required to protect against " \
|
25
|
+
"public gem pushes."
|
26
|
+
end
|
27
|
+
|
28
|
+
# Specify which files should be added to the gem when it is released.
|
29
|
+
# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
|
30
|
+
spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
|
31
|
+
`git ls-files -z`.split("\x0").reject do |f|
|
32
|
+
[
|
33
|
+
%r{^(test|spec|features|bin|steep|benchmark|templates)/},
|
34
|
+
/Gemfile/
|
35
|
+
].any? {|r| f.match(r) }
|
36
|
+
end
|
37
|
+
end
|
38
|
+
spec.extensions = %w{ext/rbs_extension/extconf.rb}
|
39
|
+
|
40
|
+
if false
|
41
|
+
spec.required_ruby_version = ">= 3.3"
|
42
|
+
end
|
43
|
+
|
44
|
+
spec.bindir = "exe"
|
45
|
+
spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
|
46
|
+
spec.require_paths = ["lib"]
|
47
|
+
spec.required_ruby_version = ">= 3.1"
|
48
|
+
end
|
@@ -0,0 +1,14 @@
|
|
1
|
+
{
|
2
|
+
"$schema": "http://json-schema.org/draft-04/schema#",
|
3
|
+
"title": "Annotation associated to a declaration or a member: `%a{rbs:test}`, `%a{steep:deprecated}`, ...",
|
4
|
+
"type": "object",
|
5
|
+
"properties": {
|
6
|
+
"string": {
|
7
|
+
"type": "string"
|
8
|
+
},
|
9
|
+
"location": {
|
10
|
+
"$ref": "location.json"
|
11
|
+
}
|
12
|
+
},
|
13
|
+
"required": ["string", "location"]
|
14
|
+
}
|
data/schema/comment.json
ADDED
@@ -0,0 +1,26 @@
|
|
1
|
+
{
|
2
|
+
"$schema": "http://json-schema.org/draft-04/schema#",
|
3
|
+
"definitions": {
|
4
|
+
"comment": {
|
5
|
+
"type": "object",
|
6
|
+
"properties": {
|
7
|
+
"string": {
|
8
|
+
"type": "string"
|
9
|
+
},
|
10
|
+
"location": {
|
11
|
+
"$ref": "location.json"
|
12
|
+
}
|
13
|
+
},
|
14
|
+
"required": ["string", "location"]
|
15
|
+
}
|
16
|
+
},
|
17
|
+
"title": "Comment associated with a declaration or a member",
|
18
|
+
"oneOf": [
|
19
|
+
{
|
20
|
+
"$ref": "#/definitions/comment"
|
21
|
+
},
|
22
|
+
{
|
23
|
+
"type": "null"
|
24
|
+
}
|
25
|
+
]
|
26
|
+
}
|
data/schema/decls.json
ADDED
@@ -0,0 +1,326 @@
|
|
1
|
+
{
|
2
|
+
"$schema": "http://json-schema.org/draft-04/schema#",
|
3
|
+
"definitions": {
|
4
|
+
"alias": {
|
5
|
+
"title": "Type alias declaration: `type foo = Integer`, ...",
|
6
|
+
"type": "object",
|
7
|
+
"properties": {
|
8
|
+
"declaration": {
|
9
|
+
"type": "string",
|
10
|
+
"enum": ["alias"]
|
11
|
+
},
|
12
|
+
"name": {
|
13
|
+
"type": "string"
|
14
|
+
},
|
15
|
+
"type_params": {
|
16
|
+
"type": "array",
|
17
|
+
"items": {
|
18
|
+
"$ref": "typeParam.json"
|
19
|
+
}
|
20
|
+
},
|
21
|
+
"type": {
|
22
|
+
"$ref": "types.json"
|
23
|
+
},
|
24
|
+
"annotations": {
|
25
|
+
"type": "array",
|
26
|
+
"items": {
|
27
|
+
"$ref": "annotation.json"
|
28
|
+
}
|
29
|
+
},
|
30
|
+
"location": {
|
31
|
+
"$ref": "location.json"
|
32
|
+
},
|
33
|
+
"comment": {
|
34
|
+
"$ref": "comment.json"
|
35
|
+
}
|
36
|
+
},
|
37
|
+
"required": ["declaration", "name", "type_params", "type", "annotations", "location", "comment"]
|
38
|
+
},
|
39
|
+
"constant": {
|
40
|
+
"title": "Constant declaration: `VERSION: String`, ...",
|
41
|
+
"type": "object",
|
42
|
+
"properties": {
|
43
|
+
"declaration": {
|
44
|
+
"type": "string",
|
45
|
+
"enum": ["constant"]
|
46
|
+
},
|
47
|
+
"name": {
|
48
|
+
"type": "string"
|
49
|
+
},
|
50
|
+
"type": {
|
51
|
+
"$ref": "types.json"
|
52
|
+
},
|
53
|
+
"location": {
|
54
|
+
"$ref": "location.json"
|
55
|
+
},
|
56
|
+
"comment": {
|
57
|
+
"$ref": "comment.json"
|
58
|
+
}
|
59
|
+
},
|
60
|
+
"required": ["declaration", "name", "type", "comment", "location"]
|
61
|
+
},
|
62
|
+
"global": {
|
63
|
+
"title": "Global declaration: `$DEBUG: boolish`, ...",
|
64
|
+
"type": "object",
|
65
|
+
"properties": {
|
66
|
+
"declaration": {
|
67
|
+
"type": "string",
|
68
|
+
"enum": ["global"]
|
69
|
+
},
|
70
|
+
"name": {
|
71
|
+
"type": "string"
|
72
|
+
},
|
73
|
+
"type": {
|
74
|
+
"$ref": "types.json"
|
75
|
+
},
|
76
|
+
"location": {
|
77
|
+
"$ref": "location.json"
|
78
|
+
},
|
79
|
+
"comment": {
|
80
|
+
"$ref": "comment.json"
|
81
|
+
}
|
82
|
+
},
|
83
|
+
"required": ["declaration", "name", "type", "comment", "location"]
|
84
|
+
},
|
85
|
+
"classMember": {
|
86
|
+
"oneOf": [
|
87
|
+
{
|
88
|
+
"$ref": "members.json#/definitions/methodDefinition"
|
89
|
+
},
|
90
|
+
{
|
91
|
+
"$ref": "members.json#/definitions/variable"
|
92
|
+
},
|
93
|
+
{
|
94
|
+
"$ref": "members.json#/definitions/include"
|
95
|
+
},
|
96
|
+
{
|
97
|
+
"$ref": "members.json#/definitions/extend"
|
98
|
+
},
|
99
|
+
{
|
100
|
+
"$ref": "members.json#/definitions/prepend"
|
101
|
+
},
|
102
|
+
{
|
103
|
+
"$ref": "members.json#/definitions/attribute"
|
104
|
+
},
|
105
|
+
{
|
106
|
+
"$ref": "members.json#/definitions/visibility"
|
107
|
+
},
|
108
|
+
{
|
109
|
+
"$ref": "members.json#/definitions/alias"
|
110
|
+
},
|
111
|
+
{
|
112
|
+
"$ref": "#/definitions/alias"
|
113
|
+
},
|
114
|
+
{
|
115
|
+
"$ref": "#/definitions/constant"
|
116
|
+
},
|
117
|
+
{
|
118
|
+
"$ref": "#/definitions/class"
|
119
|
+
},
|
120
|
+
{
|
121
|
+
"$ref": "#/definitions/module"
|
122
|
+
},
|
123
|
+
{
|
124
|
+
"$ref": "#/definitions/interface"
|
125
|
+
}
|
126
|
+
]
|
127
|
+
},
|
128
|
+
"class": {
|
129
|
+
"title": "Class declaration",
|
130
|
+
"type": "object",
|
131
|
+
"properties": {
|
132
|
+
"declaration": {
|
133
|
+
"enum": ["class"]
|
134
|
+
},
|
135
|
+
"name": {
|
136
|
+
"type": "string"
|
137
|
+
},
|
138
|
+
"type_params": {
|
139
|
+
"type": "array",
|
140
|
+
"items": {
|
141
|
+
"$ref": "typeParam.json"
|
142
|
+
}
|
143
|
+
},
|
144
|
+
"members": {
|
145
|
+
"type": "array",
|
146
|
+
"items": {
|
147
|
+
"$ref": "#/definitions/classMember"
|
148
|
+
}
|
149
|
+
},
|
150
|
+
"super_class": {
|
151
|
+
"oneOf": [
|
152
|
+
{
|
153
|
+
"type": "null"
|
154
|
+
},
|
155
|
+
{
|
156
|
+
"type": "object",
|
157
|
+
"properties": {
|
158
|
+
"name": {
|
159
|
+
"type": "string"
|
160
|
+
},
|
161
|
+
"args": {
|
162
|
+
"type": "array",
|
163
|
+
"items": {
|
164
|
+
"$ref": "types.json"
|
165
|
+
}
|
166
|
+
}
|
167
|
+
},
|
168
|
+
"required": ["name", "args"]
|
169
|
+
}
|
170
|
+
]
|
171
|
+
},
|
172
|
+
"annotations": {
|
173
|
+
"type": "array",
|
174
|
+
"items": {
|
175
|
+
"$ref": "annotation.json"
|
176
|
+
}
|
177
|
+
},
|
178
|
+
"comment": {
|
179
|
+
"$ref": "comment.json"
|
180
|
+
},
|
181
|
+
"location": {
|
182
|
+
"$ref": "location.json"
|
183
|
+
}
|
184
|
+
},
|
185
|
+
"required": ["declaration", "name", "type_params", "members", "super_class", "annotations", "comment", "location"]
|
186
|
+
},
|
187
|
+
"module": {
|
188
|
+
"type": "object",
|
189
|
+
"properties": {
|
190
|
+
"declaration": {
|
191
|
+
"enum": ["module"]
|
192
|
+
},
|
193
|
+
"name": {
|
194
|
+
"type": "string"
|
195
|
+
},
|
196
|
+
"type_params": {
|
197
|
+
"type": "array",
|
198
|
+
"items": {
|
199
|
+
"$ref": "typeParam.json"
|
200
|
+
}
|
201
|
+
},
|
202
|
+
"members": {
|
203
|
+
"type": "array",
|
204
|
+
"items": {
|
205
|
+
"$ref": "#/definitions/classMember"
|
206
|
+
}
|
207
|
+
},
|
208
|
+
"self_types": {
|
209
|
+
"type": "array",
|
210
|
+
"items": {
|
211
|
+
"$ref": "#/definitions/moduleSelf"
|
212
|
+
}
|
213
|
+
},
|
214
|
+
"annotations": {
|
215
|
+
"type": "array",
|
216
|
+
"items": {
|
217
|
+
"$ref": "annotation.json"
|
218
|
+
}
|
219
|
+
},
|
220
|
+
"comment": {
|
221
|
+
"$ref": "comment.json"
|
222
|
+
},
|
223
|
+
"location": {
|
224
|
+
"$ref": "location.json"
|
225
|
+
}
|
226
|
+
},
|
227
|
+
"required": ["declaration", "name", "type_params", "members", "self_types", "annotations", "location", "comment"]
|
228
|
+
},
|
229
|
+
"moduleSelf": {
|
230
|
+
"type": "object",
|
231
|
+
"properties": {
|
232
|
+
"name": {
|
233
|
+
"type": "string"
|
234
|
+
},
|
235
|
+
"args": {
|
236
|
+
"type": "array",
|
237
|
+
"items": {
|
238
|
+
"$ref": "types.json"
|
239
|
+
}
|
240
|
+
}
|
241
|
+
},
|
242
|
+
"required": ["name", "args"]
|
243
|
+
},
|
244
|
+
"interfaceMember": {
|
245
|
+
"oneOf": [
|
246
|
+
{
|
247
|
+
"allOf": [
|
248
|
+
{
|
249
|
+
"$ref": "members.json#/definitions/methodDefinition"
|
250
|
+
},
|
251
|
+
{
|
252
|
+
"type": "object",
|
253
|
+
"properties": {
|
254
|
+
"kind": {
|
255
|
+
"enum": ["instance"]
|
256
|
+
}
|
257
|
+
}
|
258
|
+
}
|
259
|
+
]
|
260
|
+
},
|
261
|
+
{
|
262
|
+
"$ref": "members.json#/definitions/include"
|
263
|
+
},
|
264
|
+
{
|
265
|
+
"$ref": "members.json#/definitions/alias"
|
266
|
+
}
|
267
|
+
]
|
268
|
+
},
|
269
|
+
"interface": {
|
270
|
+
"type": "object",
|
271
|
+
"properties": {
|
272
|
+
"declaration": {
|
273
|
+
"enum": ["interface"]
|
274
|
+
},
|
275
|
+
"name": {
|
276
|
+
"type": "string"
|
277
|
+
},
|
278
|
+
"type_params": {
|
279
|
+
"type": "array",
|
280
|
+
"items": {
|
281
|
+
"$ref": "typeParam.json"
|
282
|
+
}
|
283
|
+
},
|
284
|
+
"members": {
|
285
|
+
"type": "array",
|
286
|
+
"items": {
|
287
|
+
"$ref": "#/definitions/interfaceMember"
|
288
|
+
}
|
289
|
+
},
|
290
|
+
"annotations": {
|
291
|
+
"type": "array",
|
292
|
+
"items": {
|
293
|
+
"$ref": "annotation.json"
|
294
|
+
}
|
295
|
+
},
|
296
|
+
"comment": {
|
297
|
+
"$ref": "comment.json"
|
298
|
+
},
|
299
|
+
"location": {
|
300
|
+
"$ref": "location.json"
|
301
|
+
}
|
302
|
+
},
|
303
|
+
"required": ["declaration", "name", "type_params", "members", "annotations", "comment", "location"]
|
304
|
+
}
|
305
|
+
},
|
306
|
+
"oneOf": [
|
307
|
+
{
|
308
|
+
"$ref": "#/definitions/alias"
|
309
|
+
},
|
310
|
+
{
|
311
|
+
"$ref": "#/definitions/constant"
|
312
|
+
},
|
313
|
+
{
|
314
|
+
"$ref": "#/definitions/global"
|
315
|
+
},
|
316
|
+
{
|
317
|
+
"$ref": "#/definitions/class"
|
318
|
+
},
|
319
|
+
{
|
320
|
+
"$ref": "#/definitions/module"
|
321
|
+
},
|
322
|
+
{
|
323
|
+
"$ref": "#/definitions/interface"
|
324
|
+
}
|
325
|
+
]
|
326
|
+
}
|
@@ -0,0 +1,87 @@
|
|
1
|
+
{
|
2
|
+
"$schema": "http://json-schema.org/draft-04/schema#",
|
3
|
+
"definitions": {
|
4
|
+
"param": {
|
5
|
+
"title": "Function parameter with type and optional name: `Integer size`, `::String name`, `untyped`, ...",
|
6
|
+
"type": "object",
|
7
|
+
"properties": {
|
8
|
+
"type": {
|
9
|
+
"$ref": "types.json"
|
10
|
+
},
|
11
|
+
"name": {
|
12
|
+
"oneOf": [
|
13
|
+
{
|
14
|
+
"type": "string"
|
15
|
+
},
|
16
|
+
{
|
17
|
+
"type": "null"
|
18
|
+
}
|
19
|
+
]
|
20
|
+
}
|
21
|
+
},
|
22
|
+
"required": ["type", "name"]
|
23
|
+
}
|
24
|
+
},
|
25
|
+
"properties": {
|
26
|
+
"required_positionals": {
|
27
|
+
"title": "Required positional parameters",
|
28
|
+
"type": "array",
|
29
|
+
"items": {
|
30
|
+
"$ref": "#/definitions/param"
|
31
|
+
}
|
32
|
+
},
|
33
|
+
"optional_positionals": {
|
34
|
+
"title": "Optional positional parameters",
|
35
|
+
"type": "array",
|
36
|
+
"items": {
|
37
|
+
"$ref": "#/definitions/param"
|
38
|
+
}
|
39
|
+
},
|
40
|
+
"rest_positionals": {
|
41
|
+
"title": "Rest parameter",
|
42
|
+
"oneOf": [
|
43
|
+
{
|
44
|
+
"$ref": "#/definitions/param"
|
45
|
+
},
|
46
|
+
{
|
47
|
+
"type": "null"
|
48
|
+
}
|
49
|
+
]
|
50
|
+
},
|
51
|
+
"trailing_positionals": {
|
52
|
+
"title": "Trailing potisional parameters",
|
53
|
+
"type": "array",
|
54
|
+
"items": {
|
55
|
+
"$ref": "#/definitions/param"
|
56
|
+
}
|
57
|
+
},
|
58
|
+
"required_keywords": {
|
59
|
+
"title": "Required keyword parameters",
|
60
|
+
"additionalProperties": {
|
61
|
+
"$ref": "#/definitions/param"
|
62
|
+
}
|
63
|
+
},
|
64
|
+
"optional_keywords": {
|
65
|
+
"title": "Optional keyword parameters",
|
66
|
+
"additionalProperties": {
|
67
|
+
"$ref": "#/definitions/param"
|
68
|
+
}
|
69
|
+
},
|
70
|
+
"rest_keywords": {
|
71
|
+
"title": "Rest keyword parameters",
|
72
|
+
"oneOf": [
|
73
|
+
{
|
74
|
+
"$ref": "#/definitions/param"
|
75
|
+
},
|
76
|
+
{
|
77
|
+
"type": "null"
|
78
|
+
}
|
79
|
+
]
|
80
|
+
},
|
81
|
+
"return_type": {
|
82
|
+
"title": "Return type of a function",
|
83
|
+
"$ref": "types.json"
|
84
|
+
}
|
85
|
+
},
|
86
|
+
"required": ["required_positionals", "optional_positionals", "rest_positionals", "trailing_positionals", "required_keywords", "optional_keywords", "rest_keywords", "return_type"]
|
87
|
+
}
|
@@ -0,0 +1,56 @@
|
|
1
|
+
{
|
2
|
+
"$schema": "http://json-schema.org/draft-04/schema#",
|
3
|
+
"definitions": {
|
4
|
+
"point": {
|
5
|
+
"type": "object",
|
6
|
+
"properties": {
|
7
|
+
"line": {
|
8
|
+
"type": "integer"
|
9
|
+
},
|
10
|
+
"column": {
|
11
|
+
"type": "integer"
|
12
|
+
}
|
13
|
+
},
|
14
|
+
"required": ["line", "column"]
|
15
|
+
},
|
16
|
+
"buffer": {
|
17
|
+
"type": "object",
|
18
|
+
"properties": {
|
19
|
+
"name": {
|
20
|
+
"oneOf": [
|
21
|
+
{
|
22
|
+
"type": "string"
|
23
|
+
},
|
24
|
+
{
|
25
|
+
"type": "null"
|
26
|
+
}
|
27
|
+
]
|
28
|
+
}
|
29
|
+
},
|
30
|
+
"required": ["name"]
|
31
|
+
},
|
32
|
+
"location": {
|
33
|
+
"type": "object",
|
34
|
+
"properties": {
|
35
|
+
"start": {
|
36
|
+
"$ref": "#/definitions/point"
|
37
|
+
},
|
38
|
+
"end": {
|
39
|
+
"$ref": "#/definitions/point"
|
40
|
+
},
|
41
|
+
"buffer": {
|
42
|
+
"$ref": "#/definitions/buffer"
|
43
|
+
}
|
44
|
+
},
|
45
|
+
"required": ["start", "end", "buffer"]
|
46
|
+
}
|
47
|
+
},
|
48
|
+
"oneOf": [
|
49
|
+
{
|
50
|
+
"$ref": "#/definitions/location"
|
51
|
+
},
|
52
|
+
{
|
53
|
+
"type": "null"
|
54
|
+
}
|
55
|
+
]
|
56
|
+
}
|