Svvamp

--------------------------------------------------

* Accelerate ``Profile.plurality_scores_ut``. As an example, for a profile with 65,000 voters and 5 candidates,
the new version is approximately 10 times faster.

--------------------------------------------------------

--------------------------------------------------------

* Fix bug: in some distributions, some subpackages of Svvamp were not included.

------------------------------------------------------

------------------------------------------------------

* Add ``RuleBlack``.
* Add ``RuleCopeland``.
* Add ``RuleSplitCycle``.
* Add ``RuleSTAR``.
* In ``RuleRangeVoting`` and ``RuleMajorityJudgment``, add an attribute ``allowed_grades``: a list of the
allowed grades.

--------------------------------------------------------------

--------------------------------------------------------------

* New CM algorithms for Smith-IRV-like rules:

* New CM algorithms for ``RuleICRV``, ``RuleSmithIRV``, ``RuleTideman``, ``RuleWoodall`` and ``RuleIRVAverage``.
* Add ``RuleIRV.example_ballots_cm_c_`` and ``RuleIRV.example_ballots_cm_w_against_``: examples of manipulating ballots
(used as heuristic to manipulate Smith-IRV and similar rules).
* In ``RuleCondorcetAbsIRV`` and ``RuleCondorcetVtbIRV``, the former option ``almost_exact`` is renamed to
``very_slow``, for the sake of consistency with Smith-IRV and similar voting rules.

* Improve imports/exports:

* ``ProfileFromFile`` can now import a CVR (cast vote record) file.
* ``ProfileFromFile`` has a new parameter ``sort_candidates``: sort the candidates from strongest to weakest (in a
Black method sense).
* Add ``Profile.to_csv``: export the utilities to a csv file.

* Add ``Rule.options``: a dictionary with all the options of a rule.
* Bug fixes:

* Fix a major bug in ``RuleTideman``: ballots were not counted correctly.
* Fix a bug in ``RuleExhaustiveBallot`` and ``RuleIRV``: applying a voting rule to a profile was able to change the
options of another (related) rule.

------------------------------------------------------

------------------------------------------------------

* A ``Profile`` object can now compute its Smith set (also called "top cycle"): ``smith_set_rk``, ``smith_set_rk_ctb``,
``smith_set_ut_abs``, ``smith_set_ut_abs_ctb``, ``smith_set_ut_rel``, ``smith_set_ut_rel_ctb``.
* Add Smith-IRV.
* Add Tideman's rule.
* Add Woodall's rule.
* Add constant ``RULE_CLASSES``: list of all the rule classes.
* Tools that are mostly dedicated to developers:

* A global option allows to throw an error when an uncovered portion of code is reached.
* Add ``Profile.to_doctest_string``.
* Add ``Rule._set_random_options``.
* Add ``Rule._random_instruction``.

--------------------------------------

--------------------------------------

* Fix release number.

----------------------------------