Mutwo.core

Added
- `ComplexEvent.slide_in`, see [here](https://github.com/mutwo-org/mutwo.core/commit/f145c3fefad1a6ef37e5cdbfc02f00f3160bfdcb)
- `ComplexEvent.extend_until`, see [here](https://github.com/mutwo-org/mutwo.core/commit/ad282e0798926d0999983448632452dae09ee5e8)
- `SimultaneousEvent.concatenate_by_index`, see [here](https://github.com/mutwo-org/mutwo.core/commit/cf678e244acfed7eef647c5d27223e93428d5930)
- `SimultaneousEvent.concatenate_by_tag`, see [here](https://github.com/mutwo-org/mutwo.core/commit/cf678e244acfed7eef647c5d27223e93428d5930)

Added
- get and set items of `ComplexEvent` by tags

Before:


>>> s = core_events.SequentialEvent(
>>> [core_events.TaggedSimpleEvent(1, tag='vl'), core_events.TaggedSimpleEvent(1, tag='va')]
>>> )
>>> for ev in s:
>>> if ev.tag == "vl"
>>> vl_ev = ev


After


>>> s = core_events.SequentialEvent(
>>> [core_events.TaggedSimpleEvent(1, tag='vl'), core_events.TaggedSimpleEvent(1, tag='va')]
>>> )
>>> vl_ev = s['vl']


Fixed
- `ComplexEvent.set_parameter` and `ComplexEvent.mutate_parameter` calls for `ComplexEvent`s which contained multiple references of the same event. [1](https://github.com/mutwo-org/mutwo.core/commit/8c17c27674fa8da20c87055e5357e0666fd5de9d)
- math calculations on `mutwo.core_parameters.abc.Duration` for unexpected numbers [1](https://github.com/mutwo-org/mutwo.core/commit/2ae859104a8de2a7a0486be0aff6209f99fc2ba3) [2](https://github.com/mutwo-org/mutwo.core/commit/dafdf6ca6efaef70be15de5513ee9efbd4d88c08)
- comparison between builtin `fractions.Fraction` and `mutwo.core_parameters.abc.Duration` objects (worked only with `quicktions.Fraction` objects before)

This release improves the performance from various `SequentialEvent` and `Envelope` methods.

Added
- `SequentialEvent.absolute_time_as_floats_tuple`
- `core_parameters.abc.TempoPoint`
- `core_events.configurations.DEFAULT_TEMPO_ENVELOPE_PARAMETER_NAME`

Changed
- `Event.filter` to `Event.remove_by`
- `core_parameters.TempoPoint` to `core_parameters.DirectTempoPoint`
- `TempoRangeInBeatsPerMinute` from `tuple[float, float]` to `ranges.Range`
- allows `TempoPoint` and `float` objects in `TempoEnvelope`

Added
- `EmptyEnvelopeError` in case user tries to call `value_at` on an envelope without any events.
- `split_at` method for `Envelope`

Changed
- `TempoPointConverter` to `TempoPointToBeatLengthInSeconds`

Fixed
- `cut_out` method of `Envelope`
- `split_at` method of `Envelope`
- `TempoEnvelope.convert` corner case issue
- `squash_in` always inserts before any other event on the same absolute time. This wasn't true when squashing in at positions which contains events with duration = 0.
- `cut_off` method of `Envelope`

Removed
- prime_factors module with `is_prime`, `factorize` and `factors` functions (see https://github.com/mutwo-org/mutwo.core/commit/56218a3abd42e4ac93b6a31fc3db2ecfcdef73b1 for rationale)

Added
- [nix derivation](https://github.com/mutwo-org/mutwo.core/commit/10e2e47b56de5621ffea180d70ba533d7c26c78e)

Added
- new class: `mutwo.core_parameters.abc.Duration`
- new class: `mutwo.core_parameters.DirectDuration`
- new `UnknownObjectToObjectTest` in `core_converters` module
- `EventToMetrizedEvent` in `core_converters`
- `filter_undefined` keyword to `get_parameter` method

To all event classes
- `metrize` method
- `tempo_envelope` as property of each event class
- `reset_tempo_envelope` method
- `set` method

Changed
- implicit `duration` of any numerical type to explicit `duration` of `mutwo.core_parameters.abc.Duration` type
- return type of `get_parameter(flat=True)` for `SimpleEvent` is no longer a tuple but only the parameter value itself
- argument `n_items_to_sum_up` of `core_utilites.find_numbers_which_sums_up_to` to `item_to_sum_up_count_set`
- use `class_specific_side_attribute_tuple` as a class init instead of a simple class attribute

old:
python3
class MyComplexEvent(ComplexEvent):
_class_specific_side_attribute_tuple = (("new_attribute",) +
ComplexEvent._class_specific_side_attribute_tuple)


new:
python3
class MyComplexEvent(
ComplexEvent,
class_specific_side_attribute_tuple = ("new_attribute",)
): pass


Fixed
- illegal comparison of `SingleValueParameter` (raises error now)

Removed
- `core_utilites.import_module_if_dependencies_have_been_installed` (no longer used)