Metadata-Version: 2.4
Name: pub-analyzer
Version: 0.5.2
Summary: A text user interface, written in python, which automates the generation of scientific production reports using OpenAlex
License: MIT
License-File: LICENSE
Author: Alejandro Gaspar
Author-email: alejandro@gaspar.land
Maintainer: Alejandro Gaspar
Maintainer-email: alejandro@gaspar.land
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Dist: httpx[http2] (==0.28.1)
Requires-Dist: pydantic (==2.11.7)
Requires-Dist: textual (==0.85.2)
Requires-Dist: typst (==0.13.2)
Project-URL: Documentation, https://pub-analyzer.com/
Project-URL: Homepage, https://github.com/alejandrgaspar/pub-analyzer
Project-URL: Repository, https://github.com/alejandrgaspar/pub-analyzer
Description-Content-Type: text/markdown

# Pub Analyzer

<p align="center">
    <img src="https://raw.githubusercontent.com/alejandrgaspar/pub-analyzer/main/docs/assets/img/logo.png" alt="PubAnalyzer splash image" width="275">
</p>

<p align="center">
    <a href="https://github.com/alejandrgaspar/pub-analyzer/actions/workflows/python-test.yml" target="_blank">
        <img src="https://github.com/alejandrgaspar/pub-analyzer/actions/workflows/python-test.yml/badge.svg?branch=main" alt="Test status">
    </a>
    <a href="https://pypi.org/project/pub-analyzer/" target="_blank">
        <img src="https://img.shields.io/pypi/v/pub-analyzer?color=%230f80c1" alt="PyPI - Version">
    </a>
    <a href="https://pypi.org/project/pub-analyzer/" target="_blank">
        <img src="https://img.shields.io/pypi/pyversions/pub-analyzer?color=%230f80c1" alt="PyPI - Python Version">
    </a>
    <a href="https://github.com/alejandrgaspar/pub-analyzer/blob/main/LICENSE" target="_blank">
        <img src="https://img.shields.io/github/license/alejandrgaspar/pub-analyzer?color=%2331c553" alt="License MIT">
    </a>
</p>

<p align="center">
    Pub-Analyzer &mdash;<a href="https://github.com/alejandrgaspar/pub-analyzer" target="_blank"><em>Publication Analyzer</em></a>&mdash; is a Text User Interface &mdash;<em>TUI</em>&mdash; written in Python, which automates the generation of scientific production reports using <a href="https://openalex.org/" target="_blank"><em>OpenAlex</em></a>.
</p>

---

## What is Pub Analyzer for?

Pub Analyzer is a tool designed to retrieve, process and present in a concise and understandable way the scientific production of a researcher, including detailed information about their articles, citations, collaborations and other relevant metrics. The tool automates the collection and processing of data, providing users with a comprehensive view of the impact of their research and contributions in academia.

All our information comes from OpenAlex, an open and complete catalog of the world's scholarly papers, researchers, journals, and institutions &mdash; along with all the ways they're connected to one another. This is the key piece to **make all this possible**.

Pub Analyzer generates reports that you can view directly within the app, **export as PDF** files to submit as evidence, or **export as JSON** for analysis with the tools you use every day.

## Why use Pub Analyzer?

Researchers are generally required to submit scientific production reports when seeking promotions or funding to support their ongoing research. Instead of laborious manual tracking of their publications and citations, researchers now have the opportunity to perform all of these tasks automatically **in a matter of minutes**.

## Requirements

Pub Analyzer requires **Python 3.10 or later** and can run on Linux, macOS, and Windows.

## Installation

Install Pub Analyzer via PyPI, with the following command:

```
pip install pub-analyzer
```

## Usage

Open the app with the following command:

```
pub-analyzer
```

## Documentation

See [documentation](https://pub-analyzer.com/) for more details.

## Contributing

Pull requests are welcome!

