KtAlex is an open-source Kotlin library for OpenAlex, a fully open catalog of the global research system. KtAlex uses the OpenAlex API to let users discover scholarly papers, authors, institutions, publishers, funders and the relations among all these entities.

With KtAlex you can:

• search for papers, authors, sources, institutions, publishers, funders and concepts,
• filter and sort them by different criteria
• discover the relations between authors and their published papers, publishers and their sources (e.g. journals, repositories), sources and their papers, and so on...
• get statistics about the entities in the OpenAlex catalog. E.g. papers published by authors / sources / publishers by year.
• integrate the OpenAlex API to your Kotlin/Java/JVM application.

1. Add the following dependency to your build.gradle(.kts) file:

repositories {
    mavenCentral()
}

dependencies {
    implementation("io.github.benedekh:ktalex:1.0.0")
}

2. Dependening on your target language, follow one of the examples below:

AuthorClient().use { client ->
    client.getByOrcid("0000-0002-9805-1580").resolveWorks()?.forEach { response ->
        response.results?.forEach { work -> println(work.title) }
    }
}

MoDeS3: Model-Based Demonstrator for Smart and Safe Cyber-Physical Systems
Towards the next generation of reactive model transformations on low-code platforms
On Open Source Tools for Behavioral Modeling and Analysis with fUML and Alf.
Model checking as a service
Towards Continuous Consistency Checking of DevOps Artefacts
Towards Scalable Validation of Low-Code System Models: Mapping EVL to VIATRA Patterns
Pragmatic verification and validation of industrial executable SysML models

WorkClient().use { client ->
    client.getEntities(QueryBuilder().gt("citedByCount", 10000).eq("isOa", true)).forEach { response ->
        println("Total number of works: ${response.meta?.count}")
        println("Works per page: ${response.meta?.perPage}")
        response.results?.forEach { works ->
            // TODO go through the works on this page...
        }
    }
}

Total number of works: 465
Works per page: 25

try (AuthorClient client = new AuthorClient()) {
    client.getByOrcid("0000-0002-9805-1580", null).resolveWorks().forEach(response ->
            response.getResults().forEach(work -> System.out.println(work.getTitle())));
}

MoDeS3: Model-Based Demonstrator for Smart and Safe Cyber-Physical Systems
Towards the next generation of reactive model transformations on low-code platforms
On Open Source Tools for Behavioral Modeling and Analysis with fUML and Alf.
Model checking as a service
Towards Continuous Consistency Checking of DevOps Artefacts
Towards Scalable Validation of Low-Code System Models: Mapping EVL to VIATRA Patterns
Pragmatic verification and validation of industrial executable SysML models

try (WorkClient client = new WorkClient()) {
    QueryBuilder queryBuilder = new QueryBuilder().gt("citedByCount", 10000).eq("isOa", true);
    client.getEntities(queryBuilder).forEach(response -> {
        System.out.println("Total number of works: " + response.getMeta().getCount());
        System.out.println("Works per page: " + response.getMeta().getPerPage());
        response.getResults().forEach(work -> {
            // TODO go through the works on this page...
        });
    });
}

Total number of works: 465
Works per page: 25

3. KtAlex uses ch.qos.logback to control logging. Add the following logback.xml configuration file to src/main/resources to enable logging:

<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} MDC=%X{user} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="debug">
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>

4. The source code is published together with the compiled JAR. In the sources JAR you will find the documentation of the entity client API, the QueryBuilder and some other classes. If you use IntelliJ, then simply click on the Download Sources button when opening one of the class files. Alternatively, you can download the io.github.benedekh:ktalex-sources JAR from one of the public repositories and add it to the classpath.

You can read more about the OpenAlex API, and the entities (work, author, source, institution, concept, publisher and funder) in the OpenAlex documentation. The documentation also contains examples on how to use the API. All examples should work in KtAlex as well.

• Do you have a question in general or specifically? Then let's start a discussion.
• Do you have a question about a bug or a weird behavior? Then let's open an issue.

Check out the contribution guide to get started.