nagasaki45 / bibo

Command line reference manager with a single source of truth: the .bib file. Inspired by beets.

Command line reference manager with a single source of truth: the .bib file. Inspired by beets.

Links

• Documentation: https://bibo.readthedocs.io/en/latest
• Source code: https://github.com/Nagasaki45/bibo
• PyPI releases: https://pypi.org/project/bibo
• License: MIT

bibo's Issues

Consider using latexcodec

Bare minimum is to add it after the bibtex citation to present the citations properly. Another option is to add it all the way to pybibs import / export, so everything in the app will deal with "clean" data.

Floating filter

Click on tag to filter by it (frontend only)

Export selected entries (as an archive with PDFs and .bib file)

Finish the "add new entry" feature

Protect against duplicate keys

Edit and remove command expect a key instead of search terms

Make sure automatic filenames are valid

Base on a similar SO question, django's slugify, and django's get_valid_filename.

Document all built in commands in README

List command should support year ranges

Sort table by author / title / year / etc

Rephrase `pdf` -> `file`

Add a sort by option to the list command

With a similar format to whatever is used for custom formatting (#14).

Auto focus filter field

Support the PREAMBLE and COMMENT bibtex entry types

Check this out

Move pybibs to be part of bibo

I really don't want to support this as an external project...

Open should open file / url / doi

Fail `add` with file when there's no destination path in hueristic

Tests

Ability to pass destination path explicitly

Do not create a file field when no file is provided

Resolve bug in latex library

When adding new items every & character is replaced by \&, braking the format completely.

Change the `edit` option to assume field

Editing key and type as usual:

bibo edit whatever2000 --key newkey
bibo edit whatever2000 --type book

If anything but key or type is provided use it as the field name:

bibo edit whatever2000 --author moshe
bibo edit whatever2000 --tags interesting

If, and only if, the value is missing, open the editor.

documentation needed for the "remove" command

if no [OPTIONS] or [SEARCH_TERMS] provided then deletes the whole bibliography.

maybe needs a warning output before erasing everything?

Custom formatting for the list command

Don't remove a file when an entry is removed

Mainly because the file might belong to multiple entries. I should probably write a plugin that check DB issues (missing files or files with no entries).

Fix exception when trying to remove non-existing field

Missing commands

• show
• remove
• edit --key new_key --pdf path/to/pdf --type new_type SEARCH_TERM
• read Mark the entry as read today
• field remove
• field edit

Open URLs in new tabs

Make it pip installable

`file` field should contain plain path

There's nothing in the specs saying that the file field should look as how I use it now. I inherited this from another reference manager. Change it to plain path.

Documentation

• Screencast demo
• Why?
• Tutorial
• BIBO_DATABASE
• EDITOR
• xclip (preferred) or xsel on linux
• bibtex
• List of available plugins

Edit review online

Listing by a word with capital letter fails

Fix bibtex parser

Get the entry that caused pybibs to fail from Ben.

An escape sequence for colon in search terms

If I have a key like a:b it should be possible to query for it somehow. For example with a\:b.

`add` command to default to copy from clipboard

Searching entry (in edit command) fails if capital letter in search term

Add entry by doi

Document activating autocomplete

All paths should be absolute

Otherwise:

➜  bibo git:(master) ✗ cat test.bib 
@article{PhysRev.47.777,
  title = {Can Quantum-Mechanical Description of Physical Reality Be Considered Complete?},
  author = {Einstein, A. and Podolsky, B. and Rosen, N.},
  journal = {Phys. Rev.},
  volume = {47},
  issue = {10},
  pages = {777--780},
  numpages = {0},
  year = {1935},
  month = {May},
  publisher = {American Physical Society},
  doi = {10.1103/PhysRev.47.777},
  url = {https://link.aps.org/doi/10.1103/PhysRev.47.777}
}

➜  bibo git:(master) ✗ bibo --database test.bib list --verbose
This is BibTeX, Version 0.99d (TeX Live 2018/Arch Linux)
The top-level auxiliary file: tmpy8j5xdm9.aux
I couldn't open database file test.bib
---line 1 of file tmpy8j5xdm9.aux
 : \bibdata{test.bib
 :                  }
I'm skipping whatever remains of this command
The style file: plain.bst
I found no database files---while reading file tmpy8j5xdm9.aux
Warning--I didn't find a database entry for "PhysRev.47.777"
(There were 2 error messages)
PhysRev.47.777 🔗
Einstein, A. and Podolsky, B. and Rosen, N. (1935). Can Quantum-Mechanical Description of Physical Reality Be Considered Complete?
bibtex failed. Using a fallback citation method. Use --verbose for more information

Get PDF from url

Autocompletion broke completion for paths (file, destination, database)

Add file for an existing item

Autocomplete keys as search terms

Handle situation when user exit the editor without saving (returning None)

Autocomplete should suggest escaped keys (\\:)

Ability to match a key when it's partial for a 2nd key

Help / description for commands

Better search with search by field a la beets