Skip to content

Commit

Permalink
Convert to pytest
Browse files Browse the repository at this point in the history
  • Loading branch information
@Josef-Friedrich
Josef-Friedrich committed Jan 2, 2024
1 parent ba70a41 commit 395506e
Show file tree
Hide file tree
Showing 9 changed files with 199 additions and 183 deletions.
59 changes: 7 additions & 52 deletions .vscode/settings.json
View file
Original file line number Diff line number Diff line change
@@ -1,61 +1,16 @@
{
"python.pythonPath": "/usr/bin/python3",
"files.exclude": {
"**/*.mscx,": true,
"**/cover/": true,
"**/__pycache__/": true,
"**/.mypy_cache/": true,
"**/.pytest_cache/": true,
"**/.tox/": true,
"**/*.egg-info": true,
"**/*.py[cod]": true,
"**/*$py.class": true,
"**/*.so": true,
"**/.Python": true,
"**/env/": true,
"**/build/": true,
"**/develop-eggs/": true,
"**/dist/": true,
"**/downloads/": true,
"**/eggs/": true,
"**/.eggs/": true,
"**/lib/": true,
"**/lib64/": true,
"**/parts/": true,
"**/sdist/": true,
"**/var/": true,
"**/*.egg-info/": true,
"**/.installed.cfg": true,
"**/*.egg": true,
"**/*.manifest": true,
"**/*.spec": true,
"**/pip-log.txt": true,
"**/pip-delete-this-directory.txt": true,
"**/htmlcov/": true,
"**/.tox/": true,
"**/.coverage": true,
"**/.coverage.*": true,
"**/.cache": true,
"**/nosetests.xml": true,
"**/coverage.xml": true,
"**/*,cover": true,
"**/.hypothesis/": true,
"**/*.mo": true,
"**/*.pot": true,
"**/*.log": true,
"**/local_settings.py": true,
"**/instance/": true,
"**/.webassets-cache": true,
"**/.scrapy": true,
"**/doc/html/": true,
"**/docs/_build/": true,
"**/target/": true,
"**/.ipynb_checkpoints": true,
"**/.python-version": true,
"**/celerybeat-schedule": true,
"**/.env": true,
"**/.venv/": true,
"**/venv/": true,
"**/ENV/": true,
"**/.spyderproject": true,
"**/.ropeproject": true,
"**/_build/": true,
"**/.tex/": true
"**/MANIFEST": true,
"**/nosetests.xml": true
},
"python.defaultInterpreterPath": ".venv/bin/python",
"python.testing.unittestEnabled": false,
Expand Down
60 changes: 41 additions & 19 deletions README.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -44,12 +44,16 @@ mscxyz

.. code-block:: text
usage: mscx-manager [-h] [-V] [-b] [-c] [-C GENERAL_CONFIG_FILE] [-d] [-g GENERAL_GLOB] [-m] [-e GENERAL_EXECUTABLE] [-v] {clean,meta,lyrics,rename,export,help} ... path
usage: mscx-manager [-h] [-V] [-b] [-c] [-C GENERAL_CONFIG_FILE] [-d] [-g GENERAL_GLOB] [-m] [-e GENERAL_EXECUTABLE]
[-v]
{clean,meta,lyrics,rename,export,help} ... path
A command line tool to manipulate the XML based "*.mscX" and "*.mscZ" files of the notation software MuseScore.
positional arguments:
path Path to a "*.mscx" file or a folder which contains "*.mscx" files. In conjunction with the subcommand "help" this positional parameter accepts the names of all other subcommands or the word "all".
path Path to a "*.mscx" file or a folder which contains "*.mscx" files. In conjunction with the
subcommand "help" this positional parameter accepts the names of all other subcommands or
the word "all".
options:
-h, --help show this help message and exit
Expand All @@ -60,22 +64,27 @@ mscxyz
Specify a configuration file in the INI format.
-d, --dry-run Simulate the actions.
-g GENERAL_GLOB, --glob GENERAL_GLOB
Handle only files which matches against Unix style glob patterns (e. g. "*.mscx", "* - *"). If you omit this option, the standard glob pattern "*.msc[xz]" is used.
-m, --mscore Open and save the XML file in MuseScore after manipulating the XML with lxml to avoid differences in the XML structure.
Handle only files which matches against Unix style glob patterns (e. g. "*.mscx", "* - *").
If you omit this option, the standard glob pattern "*.msc[xz]" is used.
-m, --mscore Open and save the XML file in MuseScore after manipulating the XML with lxml to avoid
differences in the XML structure.
-e GENERAL_EXECUTABLE, --executable GENERAL_EXECUTABLE
Path of the musescore executable.
-v, --verbose Make commands more verbose. You can specifiy multiple arguments (. g.: -vvv) to make the command more verbose.
-v, --verbose Make commands more verbose. You can specifiy multiple arguments (. g.: -vvv) to make the
command more verbose.
Subcommands:
{clean,meta,lyrics,rename,export,help}
Run "subcommand --help" for more informations.
clean Clean and reset the formating of the "*.mscx" file
meta Deal with meta data informations stored in the MuseScore file.
lyrics Extract lyrics. Without any option this subcommand extracts all lyrics verses into separate mscx files. This generated mscx files contain only one verse. The old verse number is appended to the file name, e. g.:
score_1.mscx.
lyrics Extract lyrics. Without any option this subcommand extracts all lyrics verses into separate
mscx files. This generated mscx files contain only one verse. The old verse number is
appended to the file name, e. g.: score_1.mscx.
rename Rename the "*.mscx" files.
export Export the scores to PDFs or to the specified extension.
help Show help. Use “mscx-manager help all” to show help messages of all subcommands. Use “mscx-manager help <subcommand>” to show only help messages for the given subcommand.
help Show help. Use “mscx-manager help all” to show help messages of all subcommands. Use “mscx-
manager help <subcommand>” to show only help messages for the given subcommand.
Subcommands
===========
Expand All @@ -97,7 +106,8 @@ mscx-manager meta

.. code-block:: text
usage: mscx-manager meta [-h] [-c META_CLEAN] [-D] [-d SOURCE_FIELDS FORMAT_STRING] [-j] [-l DESTINATION FORMAT_STRING] [-s] [-S DESTINATION_FIELD FORMAT_STRING]
usage: mscx-manager meta [-h] [-c META_CLEAN] [-D] [-d SOURCE_FIELDS FORMAT_STRING] [-j]
[-l DESTINATION FORMAT_STRING] [-s] [-S DESTINATION_FIELD FORMAT_STRING]
MuseScore can store meta data informations in different places:
Expand Down Expand Up @@ -178,14 +188,20 @@ mscx-manager meta
-c META_CLEAN, --clean META_CLEAN
Clean the meta data fields. Possible values: „all“ or „field_one,field_two“.
-D, --delete-duplicates
Deletes combined_lyricist if this field is equal to combined_composer. Deletes combined_subtitle if this field is equal tocombined_title. Move combined_subtitle to combimed_title if combined_title is empty.
Deletes combined_lyricist if this field is equal to combined_composer. Deletes
combined_subtitle if this field is equal tocombined_title. Move combined_subtitle to
combimed_title if combined_title is empty.
-d SOURCE_FIELDS FORMAT_STRING, --distribute-fields SOURCE_FIELDS FORMAT_STRING
Distribute source fields to target fields applying a format string on the source fields. It is possible to apply multiple --distribute-fields options. SOURCE_FIELDS can be a single field or a comma separated list
of fields: field_one,field_two. The program tries first to match the FORMAT_STRING on the first source field. If this fails, it tries the second source field ... an so on.
Distribute source fields to target fields applying a format string on the source fields. It
is possible to apply multiple --distribute-fields options. SOURCE_FIELDS can be a single
field or a comma separated list of fields: field_one,field_two. The program tries first to
match the FORMAT_STRING on the first source field. If this fails, it tries the second source
field ... an so on.
-j, --json Additionally write the meta data to a json file.
-l DESTINATION FORMAT_STRING, --log DESTINATION FORMAT_STRING
Write one line per file to a text file. e. g. --log /tmp/mscx-manager.log '$title $composer'
-s, --synchronize Synchronize the values of the first vertical frame (vbox) (title, subtitle, composer, lyricist) with the corresponding metadata fields
-s, --synchronize Synchronize the values of the first vertical frame (vbox) (title, subtitle, composer,
lyricist) with the corresponding metadata fields
-S DESTINATION_FIELD FORMAT_STRING, --set-field DESTINATION_FIELD FORMAT_STRING
Set value to meta data fields.
Expand All @@ -201,9 +217,12 @@ mscx-manager lyrics
-e LYRICS_EXTRACT, --extract LYRICS_EXTRACT
The lyric verse number to extract or "all".
-r LYRICS_REMAP, --remap LYRICS_REMAP
Remap lyrics. Example: "--remap 3:2,5:3". This example remaps lyrics verse 3 to verse 2 and verse 5 to 3. Use commas to specify multiple remap pairs. One remap pair is separated by a colon in this form:
"old:new": "old" stands for the old verse number. "new" stands for the new verse number.
-f, --fix Fix lyrics: Convert trailing hyphens ("la- la- la") to a correct hyphenation ("la - la - la")
Remap lyrics. Example: "--remap 3:2,5:3". This example remaps lyrics verse 3 to verse 2 and
verse 5 to 3. Use commas to specify multiple remap pairs. One remap pair is separated by a
colon in this form: "old:new": "old" stands for the old verse number. "new" stands for the
new verse number.
-f, --fix Fix lyrics: Convert trailing hyphens ("la- la- la") to a correct hyphenation ("la - la -
la")
mscx-manager rename
-------------------
Expand Down Expand Up @@ -411,7 +430,8 @@ mscx-manager rename
-a, --ascii Use only ASCII characters.
-n, --no-whitespace Replace all whitespaces with dashes or sometimes underlines.
-s FIELDS, --skip-if-empty FIELDS
Skip rename action if FIELDS are empty. Separate FIELDS using commas: combined_composer,combined_title
Skip rename action if FIELDS are empty. Separate FIELDS using commas:
combined_composer,combined_title
-t RENAME_TARGET, --target RENAME_TARGET
Target directory
Expand All @@ -436,8 +456,10 @@ mscx-manager help
options:
-h, --help show this help message and exit
-m, --markdown Show help in markdown format. This option enables to generate the README file directly form the command line output.
-r, --rst Show help in reStructuresText format. This option enables to generate the README file directly form the command line output.
-m, --markdown Show help in markdown format. This option enables to generate the README file directly form the
command line output.
-r, --rst Show help in reStructuresText format. This option enables to generate the README file directly
form the command line output.
API Usage
=========
Expand Down
Loading

0 comments on commit 395506e

Please sign in to comment.