Falocalrepo

Release 3.0.0 marks a complete change in how the program is run, its capabilities and future development.

Following the change of interface on Fur Affinity in January 2020, version 2 stopped working, but with this new release
the tool can once again get content from FurAffinity and is much simpler to update to support future changes to FA's web
interface.

This change was achieved thanks to the FAAPI package (from the same author of
FALocalRepo [FAAPIPyPi.org](https://pypi.org/project/faapi)). All scraping functions are now independent of the
interface, allowing for much quicker development and response to changes in the Fur Affinity website.

The interface of the program was changed from an interactive menu to a command line tool. This allows for much quicker
execution of commands, simpler code and automation via shell scripts.

The database has been updated and is now over 50% lighter for large numbers of downloaded submissions. Furthermore, it
now holds the cookies used by the scraper, reducing the program footprint.

All database functions have been completely overhauled and are now _considerably_ faster, especially searching. Using a
500k submissions table and a modern SSD drive, searching for a specific tag takes 0,90s on average, and searching for a
string in the descriptions takes only 1,30s. Time may vary depending on search parameters and drive speed.

The last big change regards the packaging and distribution of the program. falocalrepo is now a PyPi package, easily
installed with a single pip command. All dependencies have also been packaged and distributed on PyPi and are handled
without the need for git submodules. The new distribution method allows running falocalrepo in any folder, without the
need to have the program itself stored with the database.

Changes

* Use FAAPI package to separate scraper development from interface
* Support for new FA's interface
* Menu interface replaced with a command line tool
* Database cleanup
* Cookies stored in database
* Database queries improvements
* Command line help
* Distribution via PyPi

Dependencies

* Set FAAPI dependency to [2.5.0](https://pypi.org/project/FAAPI/2.5.0)

Distribution

* [falocalrepo on PyPi.org](https://pypi.org/project/falocalrepo/)

Reduced the number of indexes created and made the whole process safer. Also, interruption is now available during
indexing.

PS: Linux release is once again bigger than it should. Will work on finding a more permanent fix.

**Warning**: Binaries are for 64bit systems only

Extras' `e` option has been changed to search for ':iconusername:' and ':usernameicon:' only in the descriptions as
searching in keywords caused too many false positives in case the username was a common word/phrase.

Extras' `E` options has been changed to search 'username' in submissions' titles too.

A new 'warning' log type has been added for errors and exceptions. These will be saved in the log file regardless of
other settings. The log also has a new column for the type of log event: 'N', 'V', or 'W'

A small output error was also fixed.

PS: Linux release is once again bigger than it should. Will work on finding a more permanent fix.

**Warning**: Binaries are for 64bit systems only

Thanks to a special Python module created by yours truly, Windows users can now enjoy the program with safe interruption
support. The module can be found on GitHub
&rarr; [SignalBlock](https://github.com/MatteoCampinoti94/PythonSignalBlocking-CrossPlatform).<br>
More information on the feature can be found in the README.

A new function has been added to the program to correctly detect version differences as the old method was causing
errors with some versions.

New log events have been added for SIGINT (CTRL-C interruption) detection and database version.

PS: Linux release is once again bigger than it should. Will work on finding a more permanent fix.

**Warning**: Binaries are for 64bit systems only

Added logging to the program if launched with '--log' or '--logv' as argument (the latter logs ALL operations, thus the
v of verbose). Log is saved in a file named 'FA.log' and is trimmed to the last 10000 lines at each program start.

A new 'slow' option has been added to the download/update sections to throttle speed even further down by adding a
delay of 1,5 seconds between submissions downloads.

A critical bug in the update function has been fixed.

Argument '--debug' was changed to '--raise' to be clearer.

Search results are now properly sorted by author, id.

Some functions have been improved removing bits of unused code.

PS: Linux release is once again bigger than it should. Will work on finding a more permanent fix.

**Warning**: Binaries are for 64bit systems only

Just a small fix for an incorrect check in the analysis of submissions values.

PS: Linux release is once again bigger than it should. Will work on finding a more permanent fix.

**Warning**: Binaries are for 64bit systems only