Package: lit-review
litreviewAutomates the creation of reports for literature reviews.Installpip3 install lit-review(Don't confound this tool withthis one.)UsageSimply calllitreview <url> <categories>+There are also a few optional arguments you can learn about by callinglitreview --helpThe most relevant are listed here:--pdfdirname allows you to change the (local) directory where the pdf files will be created--postdirname allows you to change the (local) directory where the report will be create--archive allows you to change the website scrapper to use--overwriteconf allows you to reset the configuration files to their defaults--configfile allows you to change the name of the config file to use--layoutfile allows you to change the name of the layout file to useConfigurationsThis utility will write config files to/home/$USER/.config/litreview. By default, the
files the script uses areconfig.yamlanddefaultlayout.md. But you can add new config
and layout files to/home/$USER/.config/litrevieweasily, and litreview will be able to use them.Some use cases:I mostly want to review ML papers. I am going to changeconfig.yamlanddefaultlayout.mdto reflect that.
But I want a slightly different layout for my RL papers, even if they use the sameconfig.yaml. I can createrlpaper.mdand call litreview with the--layoutfile rlpaper.mdargument whenever I review RL papers. Both of these use mostly the sameconfigarguments,
so I'm fine withconfig.yaml.I review both biology and astrology papers. Theconfigneeded for these is completely different.
Astrology papers useArxiv, but biology papers come from Nature (or whatever, I'm not a bio person k).
I can setconfig.yamlto useArxiv(like it does by default), and createbio.yamlto use Nature (and set the
other parameters I need to review bio papers). When I review bio papers, I can call litreview with--configfile bio.yamlandbiopaper.md, if I have also created a new layout file.I want to make my reports link to the PDF and its annotated version.
I can open up the layout file I am using, and write the links there in python's fstring formatting! Litreview
provieds the entire extracted data from the URL of the paper inside adataobject along with every single argument
parsed from the command line inside aargsobject. To add this functionnality, I can simply addLink to the PDF: ./{args.pdfdirname}/{data.filename()}to the layout file.Okay, but I actually want to do something a bit funkier. Like, I don't know, reference the username I am using on this current computer, or something.
Well, litreview just uses fstrings for its report format. It's trivial to just add python code to the layout file.My username from my computer, for some reason? {subprocess.run("whoami", shell=True, unviversal_newlines=True, capture_output=True).stdout}You get the idea.WorkflowYou want to review the paper with this linkhttps://arxiv.org/abs/2006.11259.litreview https://arxiv.org/abs/2006.11259 rl ml proofsThis downloads the PDF for the paper found at that link and writes it
to the localpdfsfolder under the2006.11259directory. It also duplicates it with a_annotatedmodifier
to the file name. This way you have a working copy to doodle in while also preserving the "clean" copy in a neat, organised way.This also extracts a bunch of information from the link. It then writes a new report
under the_postslocal directory. The report's name is the date, plus2006.11259. The report
includes key, useful information, like the title of the paper, its authors, the date it was published, the current date,
therl ml proofscategories you associated with it, and its abstract. It also sets up an area for you to write in.Philosophy/Why litreview instead of other tools?The main goal of litreview is to be completely open source, and completelyunderstandable.Litreview is incredibly easy to work on, and new extractors can be added trivially, simply by editinglitreview/src/extractor.py.I created this tool because I was frustrated with the other tools out there, because it was hard for me to extend their functionality to do what I wanted to do. And when they did support what I wanted,
the tools were bulky and included a billion other things. No. This is a simple, easy to use tool to help remove the overhead
associated with reviewing papers, and nothing else.This tool is self-contained. It does not depend on firefox being installed, or Selenium, etc.ContributeCurrently, litreview only has an extractor for Arxiv. It would be cool to add extractors for many, many paper archives.If you want to participate to this project, PRs are strongly encouraged.