Symmetria

MAINTENANCE:
- deprecated symmetria.generator: This function will be deprecated in a future version. Use `permutation_generator` instead
- deprecated symmetria.generators.random.api.random: This function will be deprecated in a future version. Use `random_permutation` instead
- Makefile: added `ruff` command.

FEATURE:
- `symmetria.Permutation`: add `lexicographic_rank` method
- `symmetria.CycleDecomposition`: add `lexicographic_rank` method
- `symmetria.Permutation`: add `lehmer_code` method
- `symmetria.CycleDecomposition`: add `lehmer_code` method

FIX:
- `symmetria.Permutation`: fix small typos in class methods

FEATURE:
- `symmetria.Permutation`: add `degree` method
- `symmetria.CyclePermutation`: add `degree` method
- `symmetria.Cycle`: add `degree` method
- `symmetria.random`: add random module to create random permutations

ENHANCEMENT:
- `symmetria.Permutation`: change how the sign is computed
- `symmetria.Permutation`: add `__new__` method to the class
- `symmetria.CyclePermutation`: add `__new__` method to the class
- `symmetria.Cycle`: add `__new__` method to the class

FEATURE:
- `cli`: add (minimal) command line interface

DOCUMENTATION:
- add documentation for command line interface

FEATURE:
- `symmetria.Permutation`: add `describe` method
- `symmetria.CyclePermutation`: add `describe` method
- `symmetria.Cycle`: add `describe` method

DEPRECATED:
- `symmetria.Cycle`: delete method `__pow__` as was not consistent
- `symmetria.Cycle`: delete `NotImplementedError` for `is_regular` and `is_conjugate`
- `symmetria.CycleDecomposition`: delete `NotImplementedError` for `__int__`

DOCUMENTATION:
- `README.md`: improve section quickstart
- `quickstart.rst`: improve examples

FEATURE:
- `generators`: add structure to generate permutations
- `generators`: add `lexicographic` generator
- `generators`: add generator following `Heap`'s algorithm
- `generators`: add generator following `Steinhaus-Johnson-Trotter`'s algorithm