Journal Fabulous Club
jfc is an utility to make reviewing ArXiv papers for your Journal Club easier.
Install
Consider using pipx.
pipx install git+https://github.com/mikeevmm/jfc/
Otherwise, if you are using pip:
pip install git+https://github.com/mikeevmm/jfc/
How to Use
jfc aggregates unseen articles from the specified timeframe (see the configuration section), and displays them to you in an interactive prompt. From the title, you can choose to read the abstract, and from there you can choose to open the ArXiv PDF.
Run jfc to get an interactive prompt.
Configuration
jfc has some configuration parameters, which are set in the TOML file that lives in the configuration directory (as reported by appdirs).
Running jfc config will output the full path of the configuration file. Since most editors accept a path as an argument for the file to open, this means you can quickly edit the configuration (in bash) with
<div class="highlight highlight-source-shell position-relative overflow-auto" data-snippet-clipboard-copy-content=" $(jfc config)
“>
<your favourite editor> $(jfc config)
To clean the configuration and/or article database, run one of
jfc clean conf
jfc clean db
jfc clean all
A copy of the old files is kept with a .old extension, so that these can be recovered. In particular, your old configuration can be recovered (in bash) with
mv "$(jfc config).old" "$(jfc config)"
Parameters
span The timeframe of publication dates to aggregate, in days, and counting backwards from today. [Default: 7]show_header Whether to be boring (false) or not (true) [Default: true][categories] Set each item below it to true to include it in the ArXiv search. Every element defaults to false, except quant-ph, which defaults to true.
cseconeessmathastro-phcond-matgr-qchep-exhep-lathep-phhep-thmath-phnlinnucl-exnucl-thphysicsquant-phq-bioq-finstat
Contributing
Pull requests are welcome. Issues are not guaranteed to be addressed. jfc is built primarily for self-use, provided to you for free, and not my primary occupation. Please respect this.
Licence
jfc is licenced under a GNU General Public License, version 3. This informally means that:
You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.
You can find a copy of the licence under LICENCE.
Support
We’re all poor students, so we know how this goes. Nonetheless, getting donations, no matter how small, lets me know that people use and appreciate the software I’ve published.
?
If you like and use jfc, consider buying me a coffee.
GitHub
View Github
