diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-pytaglib.spec | 315 | ||||
| -rw-r--r-- | sources | 2 |
3 files changed, 169 insertions, 149 deletions
@@ -1 +1,2 @@ /pytaglib-1.5.0.tar.gz +/pytaglib-2.0.0.tar.gz diff --git a/python-pytaglib.spec b/python-pytaglib.spec index fbc5e09..bbe992c 100644 --- a/python-pytaglib.spec +++ b/python-pytaglib.spec @@ -1,62 +1,67 @@ %global _empty_manifest_terminate_build 0 Name: python-pytaglib -Version: 1.5.0 +Version: 2.0.0 Release: 1 Summary: cross-platform, Python audio metadata ("tagging") library based on TagLib License: GPLv3+ URL: http://github.com/supermihi/pytaglib -Source0: https://mirrors.nju.edu.cn/pypi/web/packages/ea/bb/bdd8aa96668820731f8eb871a938efbf535cf70a3fbe2939d3323dfb0228/pytaglib-1.5.0.tar.gz +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/5c/ad/38d631f242648200a5c8800c15ad3fd1b5390871b05563c2bed680ada75b/pytaglib-2.0.0.tar.gz +Requires: python3-pytest %description # **pytaglib** + [](https://pypi.org/project/pytaglib/) -pytaglib is a [Python](http://www.python.org) audio tagging library. It is cross-platform and svery simple to use yet fully featured: - - [supports more than a dozen file formats](http://taglib.github.io) including mp3, flac, ogg, wma, and mp4, - - support arbitrary, non-standard tag names, - - support multiple values per tag. +pytaglib is a [Python](https://www.python.org) audio tagging library. It is cross-platform and very simple to use yet fully featured: + +- [supports more than a dozen file formats](https://taglib.org/) including mp3, flac, ogg, wma, and mp4, +- support arbitrary, non-standard tag names, +- support multiple values per tag. + +pytaglib is a very thin wrapper (≈150 lines of [code](src/taglib.pyx)) around the fast and rock-solid [TagLib](https://taglib.org/) C++ library. -pytaglib is a very thin wrapper (≈150 lines of [code](src/taglib.pyx)) around the fast and rock-solid [TagLib](http://taglib.github.io) C++ library. ## News -See the [Changelog](CHANGELOG.md). -## Get it -At first, you might need to install taglib with development headers. Ubuntu, Mint and other Debian-Based distributions: - - sudo apt install libtag1-dev -On a Mac, use HomeBrew: - - brew install taglib +_2023-03-26_ pytaglib-2.0.0 has been released. Major improvements: -Then install pytaglib with [pip](https://pip.pypa.io/en/stable/): +- **binary wheels** are shipped for all Python versions and platforms +- _breaking change_: `File.path` is now a `Path` object +- support using `File` as context manager - pip install pytaglib +For a full list of changes in this and previous releases, see the [Changelog](CHANGELOG.md). +## Install - -For other operating systems and more details, see [installation notes](#installation-notes) below. +Use [pip](https://pip.pypa.io/en/stable/): + + pip install pytaglib + +In most cases, this should pick a provided binary wheel that bundles the native TagLib library suitable for your platform. If it doesn't, and the +installation fails, see [below](#installation-notes). ## Usage ```python >>> import taglib ->>> song = taglib.File("/path/to/my/file.mp3") ->>> song.tags +>>> with taglib.File("/path/to/my/file.mp3", save_on_exit=True) as song: +>>> song.tags {'ARTIST': ['piman', 'jzig'], 'ALBUM': ['Quod Libet Test Data'], 'TITLE': ['Silence'], 'GENRE': ['Silence'], 'TRACKNUMBER': ['02/10'], 'DATE': ['2004']} ->>> song.length +>>> song.length 239 ->>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values ->>> del song.tags["DATE"] ->>> song.tags["GENRE"] = ["Vocal", "Classical"] ->>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"] ->>> song.save() +>>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values +>>> del song.tags["DATE"] +>>> song.tags["GENRE"] = ["Vocal", "Classical"] +>>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"] +>>> # with save_on_exit=True, file will be saved at the end of the 'with' block ``` -For detailed API documentation, use the docstrings of the `taglib.File` class or view the [source code](src/taglib.pyx) directly. +For detailed API documentation, use the docstrings of the `taglib.File` class or view the [source code](src/taglib.pyx) directly. ## `pyprinttags` + This package also installs the `pyprinttags` script. It takes one or more files as command-line parameters and will display all known metadata of that files on the terminal. If unsupported tags (a.k.a. non-textual information) are found, they can optionally be removed @@ -64,49 +69,51 @@ from the file. ## Installation Notes -* Ensure that `pip` is installed and points to the correct Python version - - on Windows, be sure to check *install pip* in the Python installer - - on Debian/Ubuntu/Mint, install `python3-pip` - - you might need to type, e.g., `pip-3` to install pytaglib for Python 3 if your system's default is Python 2.x. -* For Windows users, there are some precompiled binary packages (wheels). See the [PyPI page](https://pypi.python.org/pypi/pytaglib) for a list of supported Python versions. -* If no binary packages exists, you need to have both Python and taglib installed with development headers (packages `python3-dev` (or `python-dev`) and `libtag1-dev` for debian / ubuntu and derivates, `python-devel` and `taglib-devel` for fedora and friends, `brew install taglib` on OS X). +Things are a bit more complicated than usual with Python because pytaglib requires the native (C++) TagLib library. + +If there are no binary wheels for your platform, or you want to manually +compile pytaglib, you will need to have Taglib installed with development headers,and also development tools for Python. + +On Ubuntu, Mint and other Debian-Based distributions, install +the `libtag1-dev` and `python-dev` packages. On Fedora and friends, these are called `taglib-devel` and `python-devel`, respectively. On a Mac, use HomeBrew to install the `taglib` package. For Windows, see below. +As an alternative, run `python build_taglib.py` in this directory to +automatically download and build the latest Taglib version into the `build` subdirectory (also works on Windows). This requires Python and a +suitable compiler to be installed; specific instructions are beyond the +scope of this README. ### Linux: Distribution-Specific Packages -* Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called `python3-taglib`. Unfortunatelly, they are heavily outdated, so you should instally the recent version via `pip` whenever possible. -* For Arch users, there is a [package](https://aur.archlinux.org/packages/python-pytaglib/) in the user repository (AUR). -### Manual Compilation: General -You can download or checkout the sources and compile manually: +- Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called `python3-taglib`. Unfortunatelly, they are heavily outdated, so you should instally the recent version via `pip` whenever possible. +- For Arch users, there is a [package](https://aur.archlinux.org/packages/python-pytaglib/) in the user repository (AUR). - python setup.py build - python setup.py test # optional, run unit tests - sudo python setup.py install +### Manual Compilation: General +You can download or checkout the sources and compile manually: -**Note**: The `taglib` Python extension is built from [`taglib.cpp`](src/taglib.cpp) which in turn is -auto-generated by [Cython](http://www.cython.org) from [`taglib.pyx`](src/taglib.pyx). -To regenerate the `taglib.cpp` after making changes to `taglib.pyx`, set the environment variable `PYTAGLIB_CYTHONIZE` to `1` before calling `setup.py` or `pip`. + pip install . + # if you want to run the unit tests, use these commands instead + # pip install .[tests] + # python -m pytest ### Compilation: Windows -Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed [here](https://wiki.python.org/moin/WindowsCompilers). Also enable *cmake* in the Visual Studio Installer. +Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed [here](https://wiki.python.org/moin/WindowsCompilers). Also enable _cmake_ in the Visual Studio Installer. Then: + - open the VS native tools command prompt -- navigate to the *pytaglib* repository -- run `python build_taglib_windows.py` which will download and build the latest official TagLib release +- navigate to the _pytaglib_ repository +- run `python build_taglib.py` which will download and build the latest official TagLib release - run `python setup.py install` - ## Contact + For bug reports or feature requests, please use the [issue tracker](https://github.com/supermihi/pytaglib/issues) on GitHub. For anything else, contact me by [email](mailto:michaelhelmling@posteo.de). - - %package -n python3-pytaglib Summary: cross-platform, Python audio metadata ("tagging") library based on TagLib Provides: python-pytaglib @@ -118,53 +125,57 @@ BuildRequires: gcc BuildRequires: gdb %description -n python3-pytaglib # **pytaglib** + [](https://pypi.org/project/pytaglib/) -pytaglib is a [Python](http://www.python.org) audio tagging library. It is cross-platform and svery simple to use yet fully featured: - - [supports more than a dozen file formats](http://taglib.github.io) including mp3, flac, ogg, wma, and mp4, - - support arbitrary, non-standard tag names, - - support multiple values per tag. +pytaglib is a [Python](https://www.python.org) audio tagging library. It is cross-platform and very simple to use yet fully featured: + +- [supports more than a dozen file formats](https://taglib.org/) including mp3, flac, ogg, wma, and mp4, +- support arbitrary, non-standard tag names, +- support multiple values per tag. + +pytaglib is a very thin wrapper (≈150 lines of [code](src/taglib.pyx)) around the fast and rock-solid [TagLib](https://taglib.org/) C++ library. -pytaglib is a very thin wrapper (≈150 lines of [code](src/taglib.pyx)) around the fast and rock-solid [TagLib](http://taglib.github.io) C++ library. ## News -See the [Changelog](CHANGELOG.md). -## Get it -At first, you might need to install taglib with development headers. Ubuntu, Mint and other Debian-Based distributions: - - sudo apt install libtag1-dev -On a Mac, use HomeBrew: - - brew install taglib +_2023-03-26_ pytaglib-2.0.0 has been released. Major improvements: -Then install pytaglib with [pip](https://pip.pypa.io/en/stable/): +- **binary wheels** are shipped for all Python versions and platforms +- _breaking change_: `File.path` is now a `Path` object +- support using `File` as context manager - pip install pytaglib +For a full list of changes in this and previous releases, see the [Changelog](CHANGELOG.md). + +## Install +Use [pip](https://pip.pypa.io/en/stable/): + + pip install pytaglib - -For other operating systems and more details, see [installation notes](#installation-notes) below. +In most cases, this should pick a provided binary wheel that bundles the native TagLib library suitable for your platform. If it doesn't, and the +installation fails, see [below](#installation-notes). ## Usage ```python >>> import taglib ->>> song = taglib.File("/path/to/my/file.mp3") ->>> song.tags +>>> with taglib.File("/path/to/my/file.mp3", save_on_exit=True) as song: +>>> song.tags {'ARTIST': ['piman', 'jzig'], 'ALBUM': ['Quod Libet Test Data'], 'TITLE': ['Silence'], 'GENRE': ['Silence'], 'TRACKNUMBER': ['02/10'], 'DATE': ['2004']} ->>> song.length +>>> song.length 239 ->>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values ->>> del song.tags["DATE"] ->>> song.tags["GENRE"] = ["Vocal", "Classical"] ->>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"] ->>> song.save() +>>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values +>>> del song.tags["DATE"] +>>> song.tags["GENRE"] = ["Vocal", "Classical"] +>>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"] +>>> # with save_on_exit=True, file will be saved at the end of the 'with' block ``` -For detailed API documentation, use the docstrings of the `taglib.File` class or view the [source code](src/taglib.pyx) directly. +For detailed API documentation, use the docstrings of the `taglib.File` class or view the [source code](src/taglib.pyx) directly. ## `pyprinttags` + This package also installs the `pyprinttags` script. It takes one or more files as command-line parameters and will display all known metadata of that files on the terminal. If unsupported tags (a.k.a. non-textual information) are found, they can optionally be removed @@ -172,101 +183,107 @@ from the file. ## Installation Notes -* Ensure that `pip` is installed and points to the correct Python version - - on Windows, be sure to check *install pip* in the Python installer - - on Debian/Ubuntu/Mint, install `python3-pip` - - you might need to type, e.g., `pip-3` to install pytaglib for Python 3 if your system's default is Python 2.x. -* For Windows users, there are some precompiled binary packages (wheels). See the [PyPI page](https://pypi.python.org/pypi/pytaglib) for a list of supported Python versions. -* If no binary packages exists, you need to have both Python and taglib installed with development headers (packages `python3-dev` (or `python-dev`) and `libtag1-dev` for debian / ubuntu and derivates, `python-devel` and `taglib-devel` for fedora and friends, `brew install taglib` on OS X). +Things are a bit more complicated than usual with Python because pytaglib requires the native (C++) TagLib library. + +If there are no binary wheels for your platform, or you want to manually +compile pytaglib, you will need to have Taglib installed with development headers,and also development tools for Python. +On Ubuntu, Mint and other Debian-Based distributions, install +the `libtag1-dev` and `python-dev` packages. On Fedora and friends, these are called `taglib-devel` and `python-devel`, respectively. On a Mac, use HomeBrew to install the `taglib` package. For Windows, see below. + +As an alternative, run `python build_taglib.py` in this directory to +automatically download and build the latest Taglib version into the `build` subdirectory (also works on Windows). This requires Python and a +suitable compiler to be installed; specific instructions are beyond the +scope of this README. ### Linux: Distribution-Specific Packages -* Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called `python3-taglib`. Unfortunatelly, they are heavily outdated, so you should instally the recent version via `pip` whenever possible. -* For Arch users, there is a [package](https://aur.archlinux.org/packages/python-pytaglib/) in the user repository (AUR). -### Manual Compilation: General -You can download or checkout the sources and compile manually: +- Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called `python3-taglib`. Unfortunatelly, they are heavily outdated, so you should instally the recent version via `pip` whenever possible. +- For Arch users, there is a [package](https://aur.archlinux.org/packages/python-pytaglib/) in the user repository (AUR). - python setup.py build - python setup.py test # optional, run unit tests - sudo python setup.py install +### Manual Compilation: General +You can download or checkout the sources and compile manually: -**Note**: The `taglib` Python extension is built from [`taglib.cpp`](src/taglib.cpp) which in turn is -auto-generated by [Cython](http://www.cython.org) from [`taglib.pyx`](src/taglib.pyx). -To regenerate the `taglib.cpp` after making changes to `taglib.pyx`, set the environment variable `PYTAGLIB_CYTHONIZE` to `1` before calling `setup.py` or `pip`. + pip install . + # if you want to run the unit tests, use these commands instead + # pip install .[tests] + # python -m pytest ### Compilation: Windows -Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed [here](https://wiki.python.org/moin/WindowsCompilers). Also enable *cmake* in the Visual Studio Installer. +Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed [here](https://wiki.python.org/moin/WindowsCompilers). Also enable _cmake_ in the Visual Studio Installer. Then: + - open the VS native tools command prompt -- navigate to the *pytaglib* repository -- run `python build_taglib_windows.py` which will download and build the latest official TagLib release +- navigate to the _pytaglib_ repository +- run `python build_taglib.py` which will download and build the latest official TagLib release - run `python setup.py install` - ## Contact + For bug reports or feature requests, please use the [issue tracker](https://github.com/supermihi/pytaglib/issues) on GitHub. For anything else, contact me by [email](mailto:michaelhelmling@posteo.de). - - %package help Summary: Development documents and examples for pytaglib Provides: python3-pytaglib-doc %description help # **pytaglib** + [](https://pypi.org/project/pytaglib/) -pytaglib is a [Python](http://www.python.org) audio tagging library. It is cross-platform and svery simple to use yet fully featured: - - [supports more than a dozen file formats](http://taglib.github.io) including mp3, flac, ogg, wma, and mp4, - - support arbitrary, non-standard tag names, - - support multiple values per tag. +pytaglib is a [Python](https://www.python.org) audio tagging library. It is cross-platform and very simple to use yet fully featured: + +- [supports more than a dozen file formats](https://taglib.org/) including mp3, flac, ogg, wma, and mp4, +- support arbitrary, non-standard tag names, +- support multiple values per tag. + +pytaglib is a very thin wrapper (≈150 lines of [code](src/taglib.pyx)) around the fast and rock-solid [TagLib](https://taglib.org/) C++ library. -pytaglib is a very thin wrapper (≈150 lines of [code](src/taglib.pyx)) around the fast and rock-solid [TagLib](http://taglib.github.io) C++ library. ## News -See the [Changelog](CHANGELOG.md). -## Get it -At first, you might need to install taglib with development headers. Ubuntu, Mint and other Debian-Based distributions: - - sudo apt install libtag1-dev -On a Mac, use HomeBrew: - - brew install taglib +_2023-03-26_ pytaglib-2.0.0 has been released. Major improvements: -Then install pytaglib with [pip](https://pip.pypa.io/en/stable/): +- **binary wheels** are shipped for all Python versions and platforms +- _breaking change_: `File.path` is now a `Path` object +- support using `File` as context manager - pip install pytaglib +For a full list of changes in this and previous releases, see the [Changelog](CHANGELOG.md). +## Install - -For other operating systems and more details, see [installation notes](#installation-notes) below. +Use [pip](https://pip.pypa.io/en/stable/): + + pip install pytaglib + +In most cases, this should pick a provided binary wheel that bundles the native TagLib library suitable for your platform. If it doesn't, and the +installation fails, see [below](#installation-notes). ## Usage ```python >>> import taglib ->>> song = taglib.File("/path/to/my/file.mp3") ->>> song.tags +>>> with taglib.File("/path/to/my/file.mp3", save_on_exit=True) as song: +>>> song.tags {'ARTIST': ['piman', 'jzig'], 'ALBUM': ['Quod Libet Test Data'], 'TITLE': ['Silence'], 'GENRE': ['Silence'], 'TRACKNUMBER': ['02/10'], 'DATE': ['2004']} ->>> song.length +>>> song.length 239 ->>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values ->>> del song.tags["DATE"] ->>> song.tags["GENRE"] = ["Vocal", "Classical"] ->>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"] ->>> song.save() +>>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values +>>> del song.tags["DATE"] +>>> song.tags["GENRE"] = ["Vocal", "Classical"] +>>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"] +>>> # with save_on_exit=True, file will be saved at the end of the 'with' block ``` -For detailed API documentation, use the docstrings of the `taglib.File` class or view the [source code](src/taglib.pyx) directly. +For detailed API documentation, use the docstrings of the `taglib.File` class or view the [source code](src/taglib.pyx) directly. ## `pyprinttags` + This package also installs the `pyprinttags` script. It takes one or more files as command-line parameters and will display all known metadata of that files on the terminal. If unsupported tags (a.k.a. non-textual information) are found, they can optionally be removed @@ -274,51 +291,53 @@ from the file. ## Installation Notes -* Ensure that `pip` is installed and points to the correct Python version - - on Windows, be sure to check *install pip* in the Python installer - - on Debian/Ubuntu/Mint, install `python3-pip` - - you might need to type, e.g., `pip-3` to install pytaglib for Python 3 if your system's default is Python 2.x. -* For Windows users, there are some precompiled binary packages (wheels). See the [PyPI page](https://pypi.python.org/pypi/pytaglib) for a list of supported Python versions. -* If no binary packages exists, you need to have both Python and taglib installed with development headers (packages `python3-dev` (or `python-dev`) and `libtag1-dev` for debian / ubuntu and derivates, `python-devel` and `taglib-devel` for fedora and friends, `brew install taglib` on OS X). +Things are a bit more complicated than usual with Python because pytaglib requires the native (C++) TagLib library. +If there are no binary wheels for your platform, or you want to manually +compile pytaglib, you will need to have Taglib installed with development headers,and also development tools for Python. + +On Ubuntu, Mint and other Debian-Based distributions, install +the `libtag1-dev` and `python-dev` packages. On Fedora and friends, these are called `taglib-devel` and `python-devel`, respectively. On a Mac, use HomeBrew to install the `taglib` package. For Windows, see below. + +As an alternative, run `python build_taglib.py` in this directory to +automatically download and build the latest Taglib version into the `build` subdirectory (also works on Windows). This requires Python and a +suitable compiler to be installed; specific instructions are beyond the +scope of this README. ### Linux: Distribution-Specific Packages -* Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called `python3-taglib`. Unfortunatelly, they are heavily outdated, so you should instally the recent version via `pip` whenever possible. -* For Arch users, there is a [package](https://aur.archlinux.org/packages/python-pytaglib/) in the user repository (AUR). -### Manual Compilation: General -You can download or checkout the sources and compile manually: +- Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called `python3-taglib`. Unfortunatelly, they are heavily outdated, so you should instally the recent version via `pip` whenever possible. +- For Arch users, there is a [package](https://aur.archlinux.org/packages/python-pytaglib/) in the user repository (AUR). - python setup.py build - python setup.py test # optional, run unit tests - sudo python setup.py install +### Manual Compilation: General +You can download or checkout the sources and compile manually: -**Note**: The `taglib` Python extension is built from [`taglib.cpp`](src/taglib.cpp) which in turn is -auto-generated by [Cython](http://www.cython.org) from [`taglib.pyx`](src/taglib.pyx). -To regenerate the `taglib.cpp` after making changes to `taglib.pyx`, set the environment variable `PYTAGLIB_CYTHONIZE` to `1` before calling `setup.py` or `pip`. + pip install . + # if you want to run the unit tests, use these commands instead + # pip install .[tests] + # python -m pytest ### Compilation: Windows -Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed [here](https://wiki.python.org/moin/WindowsCompilers). Also enable *cmake* in the Visual Studio Installer. +Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed [here](https://wiki.python.org/moin/WindowsCompilers). Also enable _cmake_ in the Visual Studio Installer. Then: + - open the VS native tools command prompt -- navigate to the *pytaglib* repository -- run `python build_taglib_windows.py` which will download and build the latest official TagLib release +- navigate to the _pytaglib_ repository +- run `python build_taglib.py` which will download and build the latest official TagLib release - run `python setup.py install` - ## Contact + For bug reports or feature requests, please use the [issue tracker](https://github.com/supermihi/pytaglib/issues) on GitHub. For anything else, contact me by [email](mailto:michaelhelmling@posteo.de). - - %prep -%autosetup -n pytaglib-1.5.0 +%autosetup -n pytaglib-2.0.0 %build %py3_build @@ -358,5 +377,5 @@ mv %{buildroot}/doclist.lst . %{_docdir}/* %changelog -* Thu Mar 09 2023 Python_Bot <Python_Bot@openeuler.org> - 1.5.0-1 +* Fri Apr 07 2023 Python_Bot <Python_Bot@openeuler.org> - 2.0.0-1 - Package Spec generated @@ -1 +1 @@ -1176897de0d2943a3c6814634657fa66 pytaglib-1.5.0.tar.gz +94c4e56531e526c24d3298b5f16becd5 pytaglib-2.0.0.tar.gz |