I've decided to go ahead and release Promnesia as 1.0! Doesn't mean any breaking changes, just because it's fairly stable and settled.
general
- improved docs/FAQ + `promnesia doctor` which will hopefully help nail down the most common issues: [link](https://github.com/karlicoss/promnesia/blob/master/doc/TROUBLESHOOTING.org#general-notes)
- enhanced error handling, more defensive where it makes sense, with the summary of errors presented
- enhanced logger, you can control debug logs with `COLLAPSE_DEBUG_LOGS` env variable now
- some improvements towards running on Windows
- more tests and mypy checks running on CI
indexer
- `HOOK` optional config attribute, allows you to arbitrarily filter/rewrite a visit before storing in the database. See [here](https://github.com/karlicoss/promnesia/blob/4363b5797b30819b89a4e4908ea27b009b598112/doc/config.py#L133) for a demonstration
- `index --dry` mode to test your code changes without touching the database
- (experimental) partial index update, useful for frequent periodic indexing of specific data sources (e.g. your plaintext notes). See [here](https://github.com/karlicoss/promnesia/blob/master/doc/GUIDE.org#partial-update).
- fail when nothing was indexed, so you can spot problems earlier
server
- `/visited` endpoint now returns an example visit, for the [enhanced](https://camo.githubusercontent.com/18fddd103efebd549a64c9a17d9468ce66ed62bcd01044760e28e88a4cfc9198/68747470733a2f2f6b61726c69636f73732e6769746875622e696f2f70726f6d6e657369612d64656d6f732f73637265656e732f7669736974735f6368696c647669736974735f6c6f6361746f725f706f707570735f626f72696e675f696e746572657374696e672e706e67) 'show visited' feature (backwards compatible towards older extension version)
- `/search` now uses the original URL and locator
- `/visited`: major speedup, use db index
- minor fixes for timezone handling
sources
- `sources.auto`:
- can index source code now
- plaintext(grep) indexer keeps surrounding context now
- (experimental) support multicore indexing: see [this](https://github.com/karlicoss/promnesia/blob/master/doc/GUIDE.org#using-multiple-cores)
- (experimental) support excluding files: see [this](https://github.com/karlicoss/promnesia/blob/master/doc/GUIDE.org#exclude-files-from-auto-indexer)
- major speedup via using `fd-find`
- more consistent and friendly error handling
- `sources.org`:
**NOTE: it's highly recommended to update [`orgparse`](https://github.com/karlicoss/orgparse)**. You can do it via `pip3 install -U orgparse`.
Current version is still backwards compatible though.
- support for line numbers (if you update `orgparse`)
- general cleanup
- `sources.browser`: a bit more consistent indexing for the databases backed up by [browser_history.py](https://github.com/karlicoss/promnesia/blob/4363b5797b30819b89a4e4908ea27b009b598112/scripts/browser_history.py) script
-----------------------------
See the commit log if you're interested about something specific: https://github.com/karlicoss/promnesia/compare/v0.11.20200605...v1.0.20201125
(the extension changes are described [here](https://github.com/karlicoss/promnesia/releases/edit/extension-v1.0.0))
extension-v1.0.0
I've decided to go ahead and release Promnesia as 1.0.0! Doesn't mean any breaking changes, just because it's fairly stable and settled.
general
- **new**: uses browser bookmarks as additional data source (can be toggled in the settings)
- **new**: can work without the backend now!
Which means it's easier to try the extension without (potentially) complex backend setup.
- improved error handling, so the extension keeps working even when backend is unavailable
- instead of cryptic 'local', browser name is used now (thanks koo5 for suggestion)
- timezones are handled properly and the time in the original visit's timezone is displayed (so for example, DST shifts won't change timestamps anymore)
- refactoring and improved test coverage, which means the extension will be more stable and easier to contribute to
mark visited
- **new**: huge enhancements, now it not only displays marks, but also some metadata, associated with the visit!
- before: [video](https://karlicoss.github.io/promnesia-demos/mark-visited.webm), [screenshot](https://user-images.githubusercontent.com/291333/80279161-9bf63400-86f3-11ea-8f87-65332caf2c73.png)
- after: [video](https://www.youtube.com/watch?v=9PsOeYheIY4), [screenshot](https://karlicoss.github.io/promnesia-demos/screens/promnesia-showvisited-help.png)
See [feature guide](https://github.com/karlicoss/promnesia/blob/master/doc/GUIDE.org#extension-features) on more information.
NOTE: to benefit from the update you need to update the backend: https://github.com/karlicoss/promnesia/releases/tag/v1.0.20201125 (otherwise you won't get much metadata from the old version).
Note: it's recommended to try out 'mark visited links on page load' in the settings, at the moment it's off by default, but from personal experience it feels pretty stable.
search/'search around'
- **new**: search over bookmark data and in-browser visits
- backend search uses all available information now (locator/context/URL)
sidebar
- links are detected in the visit's contexts and highlighted now (thanks to [linkifyjs](https://github.com/SoapBox/linkifyjs))
- big responsiveness improvements, as much as possible is done asynchronously, and shouldn't block user interface
- add settings to display sidebar on page load (however it's off by default, sometimes can be glitchy on the pages with complicated lifecycle, and needs more work)
highlights
- huge performance/responsiveness enhancements
- improvements for matching algorithm, less false positives
- highlights do not tilt page elements anymore
settings
- **new**: settings export (no import yet, but useful as a backup)
- more settings/toggles and more documentation right on the settings page
- quick toggles in the context menu (e.g. highlights/visited marks/sidebar)
- you can use URL lists as filterlists now to exclude a whole bunch of domains (like adblock/ublock) (thanks to [basket.js](https://github.com/addyosmani/basket.js))
-------------
full commit log: https://github.com/karlicoss/promnesia/compare/extension-v0.11.14...extension-v1.0.0
note: the corresponding backend/indexer updates are [here](https://github.com/karlicoss/promnesia/releases/tag/v1.0.20201125)