rsrch 0.2.0

Manage your ever-growing list of research papers

rsrch

Manage your research papers from Python. This project lets you update a Notion database with arXiv links and download PDFs of papers to your local machine.

Installation

1. Create an internal integration in Notion.

2. Add the integration to the database you want to download from.

3. Create a .env file with the following variables:

   NOTION_TOKEN=secret_XXXXXXXX
   NOTION_DATABASE_ID=XXXXXXXXXXXXXXXX
   

   Your NOTION_TOKEN can be found in your integrations page and is called the Internal Integration Token. The NOTION_DATABASE_ID can be found in the URL of your database (https://www.notion.so/{workspace_name}/{database_id}?v={view_id}).

4. Install local dependencies:

   pip install rsrch
   

5. Important: Your Notion database must have the following columns with the corresponding types:

   • Title: Title
   • URL: URL
   • Date: Date
   • Authors: Text

   You can add more columns, but these are the ones that are required.

Usage

Download

This will download all the papers from your Notion database to the papers/ directory.

from rsrch import download
download()

Upload

You can upload arXiv abstract links, PDF links, or IDs to your Notion database and have it autofill all of the relevant fields.

from rsrch import upload
upload()

Alternatively, you can add non-arXiv links manually to Notion.

Notes

• Uploading papers to Notion is currently only supported for arXiv links. Papers with titles that already exist in the database will not be uploaded.
• I plan on adding support for other databases in the future, but for now it only works with Notion databases.
• To build and release this:
  • Make new code accessible in src/__init__.py
  • Update the version in src/__about__.py
  • Run python3 -m build
  • Run python3 -m twine upload dist/*

Resources

• Notion API