Add a parameter augment_copy to the augment_score function

[pstrepetov]

Hi!

This pull request introduces a new parameter 'augment_copy' to the augment_score function in the data_augmentation module. This enhancement provides users with more control over how the augmentation is applied to the input Score object.

Changes made:

1. Added a new boolean parameter 'augment_copy' with a default value of True.
2. Updated the function's docstring to include a description of the new parameter.
3. Modified the function logic to use the 'augment_copy' parameter when deciding whether to create a copy of the input Score object or modify it in-place.

The 'augment_copy' parameter allows users to choose between two behaviors:

• When True (default): A copy of the input symusic.Score object is augmented and returned, preserving the original object.
• When False: The input symusic.Score object is modified in-place, which can be more memory-efficient for large scores.

This change enhances the flexibility of the augment_score function, allowing users to optimize for either safety (by working on a copy) or performance (by modifying in-place) based on their specific use case.

---

📚 Documentation preview 📚: https://miditok--221.org.readthedocs.build/en/221/

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.13%. Comparing base (2982218) to head (435eb92).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #221      +/-   ##
==========================================
- Coverage   90.25%   90.13%   -0.13%     
==========================================
  Files          41       41              
  Lines        6598     6598              
==========================================
- Hits         5955     5947       -8     
- Misses        643      651       +8     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Natooz]

Hi, thank your for this nice addition which can indeed be quite useful!