src/test/java/io/reactivex/rxjava4/internal/util/JavadocNoThrows.java - 4.x - githubmirror/RxJava

src/test/java/io/reactivex/rxjava4/internal/util/JavadocNoThrows.java
73 строки3 KB
David Karnok
4.x: Unit test lambdaification 23 of 23 (#8165)
23 июн 2026, 11:56
23 июн 2026, 11:5678c35cb
/*
 * Copyright (c) 2016-present, RxJava Contributors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License is
 * distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See
 * the License for the specific language governing permissions and limitations under the License.
 */

package io.reactivex.rxjava4.internal.util;

import java.io.File;
import java.nio.file.Files;
import java.util.List;

import io.reactivex.rxjava4.core.*;
import io.reactivex.rxjava4.parallel.ParallelFlowable;
import io.reactivex.rxjava4.testsupport.TestHelper;

/**
 * Scan the Javadocs of the base classes and list those which do not have the {@code @throws} tag.
 * The lack is not an error by itself but worth looking at.
 */
public final class JavadocNoThrows {

    private JavadocNoThrows() {
        throw new IllegalArgumentException("No instances!");
    }

    public static void main(String[] args) throws Exception {
        for (Class<?> clazz : CLASSES) {
            String clazzName = clazz.getSimpleName();
            String packageName = clazz.getPackage().getName();
            File f = TestHelper.findSource(clazzName, packageName);

            List<String> lines = Files.readAllLines(f.toPath());

            for (int i = 1; i < lines.size(); i++) {
                String line = lines.get(i).trim();

                if (line.startsWith("/**")) {
                    boolean found = false;
                    for (int j = i + 1; j < lines.size(); j++) {

                        String line2 = lines.get(j).trim();
                        if (line2.startsWith("public")) {
                            if (line2.endsWith("() {")) {
                                found = true;
                            }
                            break;
                        }
                        if (line2.startsWith("* @throws")) {
                            found = true;
                            break;
                        }
                    }

                    if (!found) {
                        System.out.printf(" at %s.%s.method(%s.java:%s)%n%n", packageName, clazzName, clazzName, i + 1);
                    }
                }
            }
        }
    }

    static final Class<?>[] CLASSES = {
            Flowable.class, Observable.class, Maybe.class, Single.class, Completable.class, ParallelFlowable.class
    };
}