Skip to contentSkip to conversation

python-mutagen: new package

PATCH New Adam Duskett 3 participants 5 messages Jan 25, 2017 – Jan 26, 2017

lore
Share & tools
lore
#0 lore raw

PATCH v4 1/1 python-mutagen: new package

Mutagen is a Python module to handle audio metadata.
It supports ASF, FLAC, MP4, Monkey?s Audio, MP3, Musepack, Ogg Opus, Ogg FLAC, Ogg Speex, Ogg Theora, Ogg Vorbis, True Audio, WavPack, OptimFROG, and AIFF audio files. All versions of ID3v2 are supported, and all standard ID3v2.4 frames are parsed.

It can read Xing headers to accurately calculate the bitrate and length of MP3s. ID3 and APEv2 tags can be edited regardless of audio format. It can also manipulate Ogg streams on an individual packet/page level.

Mutagen works with Python 2.7, 3.3+ (CPython and PyPy) on Linux, Windows and macOS, and has no dedependencies outside the Python standard library.

---
v3 - v4:
- Fixed licensing information.

v2 - v3:
- Readded longer help explination.
- Added check for python2 or python3 zlib.

v1 - v2:
- Added BR2_PACKAGE_PYTHON_ZLIB as a requirement. Without this dependency, programs using python-mutagen will fail to load with a import error complaining about not being able to find zlib in python.

 package/Config.in                          |  1 +
 package/python-mutagen/Config.in           | 18 ++++++++++++++++++
 package/python-mutagen/python-mutagen.hash |  3 +++
 package/python-mutagen/python-mutagen.mk   | 14 ++++++++++++++
 4 files changed, 36 insertions(+)
 create mode 100644 package/python-mutagen/Config.in
 create mode 100644 package/python-mutagen/python-mutagen.hash
 create mode 100644 package/python-mutagen/python-mutagen.mk
package/Config.in +1 -0
index c7b6862..0023e7b 100644
@@ -724,6 +724,7 @@ menu "External python modules"
 	source "package/python-meld3/Config.in"
 	source "package/python-mistune/Config.in"
 	source "package/python-msgpack/Config.in"
+	source "package/python-mutagen/Config.in"
 	source "package/python-mwclient/Config.in"
 	source "package/python-mwscrape/Config.in"
 	source "package/python-mwscrape2slob/Config.in"
package/python-mutagen/Config.in new file +18 -0
new file mode 100644
index 0000000..faaff39
@@ -0,0 +1,18 @@
+config BR2_PACKAGE_PYTHON_MUTAGEN
+	bool "python-mutagen"
+	select BR2_PACKAGE_PYTHON_PYEXPAT if BR2_PACKAGE_PYTHON # runtime
+	select BR2_PACKAGE_PYTHON3_PYEXPAT if BR2_PACKAGE_PYTHON3 # runtime
+	select BR2_PACKAGE_PYTHON_ZLIB if BR2_PACKAGE_PYTHON # runtime
+	select BR2_PACKAGE_PYTHON3_ZLIB if BR2_PACKAGE_PYTHON3 # runtime
+	help
+	  Mutagen is a Python module to handle audio metadata. 
+	  It supports ASF, FLAC, MP4, Monkey?s Audio, MP3, Musepack, Ogg Opus, 
+	  Ogg FLAC, Ogg Speex, Ogg Theora, Ogg Vorbis, True Audio, WavPack, 
+	  OptimFROG, and AIFF audio files. All versions of ID3v2 are supported, 
+	  and all standard ID3v2.4 frames are parsed. 
+	  
+	  It can read Xing headers to accurately calculate the bitrate and length 
+	  of MP3s. ID3 and APEv2 tags can be edited regardless of audio format. 
+	  It can also manipulate Ogg streams on an individual packet/page level.
+
+	  https://mutagen.readthedocs.io/en/latest/#
package/python-mutagen/python-mutagen.hash new file +3 -0
new file mode 100644
index 0000000..8970a23
@@ -0,0 +1,3 @@
+# md5 from https://pypi.python.org/pypi/mutagen, sha256 locally computed
+md5	2bd50519d64411626fa22d405afbf078  mutagen-1.36.tar.gz
+sha256	d7ee37e33b8c5893c3ebf66edac31241eb9d48e1dc7ec647bbfbc180565a4bcd  mutagen-1.36.tar.gz
package/python-mutagen/python-mutagen.mk new file +14 -0
new file mode 100644
index 0000000..fa7b34d
@@ -0,0 +1,14 @@
+################################################################################
+#
+# python-mutagen
+#
+################################################################################
+
+PYTHON_MUTAGEN_VERSION = 1.36
+PYTHON_MUTAGEN_SOURCE = mutagen-$(PYTHON_MUTAGEN_VERSION).tar.gz
+PYTHON_MUTAGEN_SITE = https://pypi.python.org/packages/69/14/4a5c8360a727563291a7159de935ffff2b99ee783928169f0fea7445370f
+PYTHON_MUTAGEN_LICENSE = LGPLv2+
+PYTHON_MUTAGEN_LICENSE_FILES = COPYING
+PYTHON_MUTAGEN_SETUP_TYPE = distutils
+
+$(eval $(python-package))
Signature · 1 line
2.9.3
#1 lore raw

PATCH v4 1/1 python-mutagen: new package

Hello,

package/python-mutagen/Config.in line 16

Quoted 10 lines · Adam Duskett
package/python-mutagen/Config.in new file +10 -0
+	help
+	  Mutagen is a Python module to handle audio metadata. 
+	  It supports ASF, FLAC, MP4, Monkey?s Audio, MP3, Musepack, Ogg Opus, 
+	  Ogg FLAC, Ogg Speex, Ogg Theora, Ogg Vorbis, True Audio, WavPack, 
+	  OptimFROG, and AIFF audio files. All versions of ID3v2 are supported, 
+	  and all standard ID3v2.4 frames are parsed. 
+	  
+	  It can read Xing headers to accurately calculate the bitrate and length 
+	  of MP3s. ID3 and APEv2 tags can be edited regardless of audio format. 
+	  It can also manipulate Ogg streams on an individual packet/page level.

These lines were too long, and contained some trailing white space. I fixed that up.

package/python-mutagen/python-mutagen.mk line 10

Quoted 4 lines
package/python-mutagen/python-mutagen.mk new file +4 -0
+PYTHON_MUTAGEN_VERSION = 1.36
+PYTHON_MUTAGEN_SOURCE = mutagen-$(PYTHON_MUTAGEN_VERSION).tar.gz
+PYTHON_MUTAGEN_SITE = https://pypi.python.org/packages/69/14/4a5c8360a727563291a7159de935ffff2b99ee783928169f0fea7445370f
+PYTHON_MUTAGEN_LICENSE = LGPLv2+

Yegor told you the license was GPLv2+, so why do you write LGPLv2+ here?

But in fact, Yegor was wrong I believe, the license is actually just GPLv2, I haven't seen any "or later" statement anywhere.

So I fixed it as well, and applied.

Thanks!

Thomas

Signature · 3 lines
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux and Kernel engineering
http://free-electrons.com
#2 lore raw

PATCH v4 1/1 python-mutagen: new package

Hi Thomas,

Quoted 24 lines · Thomas Petazzoni

Hello,

package/python-mutagen/Config.in line 16

Quoted 10 lines · Adam Duskett
package/python-mutagen/Config.in new file +10 -0
+     help
+       Mutagen is a Python module to handle audio metadata.
+       It supports ASF, FLAC, MP4, Monkey?s Audio, MP3, Musepack, Ogg Opus,
+       Ogg FLAC, Ogg Speex, Ogg Theora, Ogg Vorbis, True Audio, WavPack,
+       OptimFROG, and AIFF audio files. All versions of ID3v2 are supported,
+       and all standard ID3v2.4 frames are parsed.
+
+       It can read Xing headers to accurately calculate the bitrate and length
+       of MP3s. ID3 and APEv2 tags can be edited regardless of audio format.
+       It can also manipulate Ogg streams on an individual packet/page level.

These lines were too long, and contained some trailing white space. I fixed that up.

package/python-mutagen/python-mutagen.mk line 10

Quoted 4 lines
package/python-mutagen/python-mutagen.mk new file +4 -0
+PYTHON_MUTAGEN_VERSION = 1.36
+PYTHON_MUTAGEN_SOURCE = mutagen-$(PYTHON_MUTAGEN_VERSION).tar.gz
+PYTHON_MUTAGEN_SITE = https://pypi.python.org/packages/69/14/4a5c8360a727563291a7159de935ffff2b99ee783928169f0fea7445370f
+PYTHON_MUTAGEN_LICENSE = LGPLv2+

Yegor told you the license was GPLv2+, so why do you write LGPLv2+ here?

Quoted 2 lines

But in fact, Yegor was wrong I believe, the license is actually just GPLv2, I haven't seen any "or later" statement anywhere.

This is the stuff I still don't really grok. How do I tell whether it is GPLv2 or GPLv2+?

This passage [1] contains such a sentence:

"either version 2 of the License, or (at your option) any later version."

Is this not enough? This is what our manual states in regard to GPLv2+:

"GPLv2+: GNU General Public License, version 2 or (at your option) any later version;"

This is what I used to as a rule.

[1] https://github.com/quodlibet/mutagen/blob/master/COPYING#L296

Yegor

#3 lore raw

PATCH v4 1/1 python-mutagen: new package

Hello,

Quoted 6 lines · Yegor Yefremov

This is the stuff I still don't really grok. How do I tell whether it is GPLv2 or GPLv2+?

This passage [1] contains such a sentence:

"either version 2 of the License, or (at your option) any later version."

Have you read this part of the license? It is an *example* of what you can put in the header of your files to indicate what the license is.

So this part of the license is an *example*, it does not tell you at all what is the license that applies to this package.

To know whether it's GPLv2 or GPLv2+ you have to open an actual source file, and look at its copyright header. If it says "version 2 or later", then it's GPLv2+. If it says "version 2", then it's GPLv2 only.

If you look at the mutagen source code, all source files I could see mention just "version 2", hence GPLv2.

Please read again the text of the GPL around the line you indicated. You will understand better what it means.

Best regards,

Thomas

Signature · 3 lines
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux and Kernel engineering
http://free-electrons.com
#4 lore raw

PATCH v4 1/1 python-mutagen: new package

Quoted 21 lines · Thomas Petazzoni

Hello,

Quoted 6 lines · Yegor Yefremov

This is the stuff I still don't really grok. How do I tell whether it is GPLv2 or GPLv2+?

This passage [1] contains such a sentence:

"either version 2 of the License, or (at your option) any later version."

Have you read this part of the license? It is an *example* of what you can put in the header of your files to indicate what the license is.

So this part of the license is an *example*, it does not tell you at all what is the license that applies to this package.

To know whether it's GPLv2 or GPLv2+ you have to open an actual source file, and look at its copyright header. If it says "version 2 or later", then it's GPLv2+. If it says "version 2", then it's GPLv2 only.

Quoted 5 lines

If you look at the mutagen source code, all source files I could see mention just "version 2", hence GPLv2.

Please read again the text of the GPL around the line you indicated. You will understand better what it means.

I see now. Thanks for your explanations.

Yegor