karaoke-lyrics-processor 0.1.1__py3-none-any.whl → 0.3.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- karaoke_lyrics_processor/cli.py +4 -2
- karaoke_lyrics_processor/karaoke_lyrics_processor.py +91 -11
- {karaoke_lyrics_processor-0.1.1.dist-info → karaoke_lyrics_processor-0.3.0.dist-info}/METADATA +6 -1
- karaoke_lyrics_processor-0.3.0.dist-info/RECORD +8 -0
- {karaoke_lyrics_processor-0.1.1.dist-info → karaoke_lyrics_processor-0.3.0.dist-info}/WHEEL +1 -1
- karaoke_lyrics_processor-0.1.1.dist-info/RECORD +0 -8
- {karaoke_lyrics_processor-0.1.1.dist-info → karaoke_lyrics_processor-0.3.0.dist-info}/LICENSE +0 -0
- {karaoke_lyrics_processor-0.1.1.dist-info → karaoke_lyrics_processor-0.3.0.dist-info}/entry_points.txt +0 -0
karaoke_lyrics_processor/cli.py
CHANGED
@@ -48,7 +48,8 @@ def main():
|
|
48
48
|
if args.output:
|
49
49
|
output_filename = args.output
|
50
50
|
else:
|
51
|
-
|
51
|
+
base_name = filename_parts[0].replace(" (Lyrics)", "")
|
52
|
+
output_filename = f"{base_name} (Lyrics Processed).{filename_parts[1]}"
|
52
53
|
|
53
54
|
processor = KaraokeLyricsProcessor(
|
54
55
|
log_level=log_level,
|
@@ -60,7 +61,8 @@ def main():
|
|
60
61
|
processor.process()
|
61
62
|
processor.write_to_output_file()
|
62
63
|
|
63
|
-
|
64
|
+
output_file = processor.output_filename
|
65
|
+
logger.info(f"Lyrics processing complete, lyrics written to output file: {output_file}")
|
64
66
|
|
65
67
|
|
66
68
|
if __name__ == "__main__":
|
@@ -1,6 +1,10 @@
|
|
1
1
|
import re
|
2
2
|
import logging
|
3
3
|
import pyperclip
|
4
|
+
import unicodedata
|
5
|
+
import docx2txt
|
6
|
+
from striprtf.striprtf import rtf_to_text
|
7
|
+
import os
|
4
8
|
|
5
9
|
|
6
10
|
class KaraokeLyricsProcessor:
|
@@ -35,13 +39,44 @@ class KaraokeLyricsProcessor:
|
|
35
39
|
if input_lyrics_text is not None and input_filename is None:
|
36
40
|
self.input_lyrics_lines = input_lyrics_text.splitlines()
|
37
41
|
elif input_filename is not None and input_lyrics_text is None:
|
38
|
-
self.input_lyrics_lines = self.
|
42
|
+
self.input_lyrics_lines = self.read_input_file()
|
39
43
|
else:
|
40
44
|
raise ValueError("Either input_lyrics or input_filename must be set, but not both.")
|
41
45
|
|
42
|
-
def
|
43
|
-
|
44
|
-
|
46
|
+
def read_input_file(self):
|
47
|
+
file_extension = os.path.splitext(self.input_filename)[1].lower()
|
48
|
+
|
49
|
+
if file_extension == ".txt":
|
50
|
+
return self.read_txt_file()
|
51
|
+
elif file_extension in [".docx", ".doc"]:
|
52
|
+
return self.read_doc_file()
|
53
|
+
elif file_extension == ".rtf":
|
54
|
+
return self.read_rtf_file()
|
55
|
+
else:
|
56
|
+
raise ValueError(f"Unsupported file format: {file_extension}")
|
57
|
+
|
58
|
+
def read_txt_file(self):
|
59
|
+
with open(self.input_filename, "r", encoding="utf-8") as infile:
|
60
|
+
return self.clean_text(infile.read()).splitlines()
|
61
|
+
|
62
|
+
def read_doc_file(self):
|
63
|
+
text = docx2txt.process(self.input_filename)
|
64
|
+
return self.clean_text(text).splitlines()
|
65
|
+
|
66
|
+
def read_rtf_file(self):
|
67
|
+
with open(self.input_filename, "r", encoding="utf-8") as file:
|
68
|
+
rtf_text = file.read()
|
69
|
+
plain_text = rtf_to_text(rtf_text)
|
70
|
+
return self.clean_text(plain_text).splitlines()
|
71
|
+
|
72
|
+
def clean_text(self, text):
|
73
|
+
# Remove any non-printable characters except newlines
|
74
|
+
text = "".join(char for char in text if char.isprintable() or char == "\n")
|
75
|
+
# Replace multiple newlines with a single newline
|
76
|
+
text = re.sub(r"\n{2,}", "\n", text)
|
77
|
+
# Remove leading/trailing whitespace from each line
|
78
|
+
text = "\n".join(line.strip() for line in text.splitlines())
|
79
|
+
return text
|
45
80
|
|
46
81
|
def find_best_split_point(self, line):
|
47
82
|
"""
|
@@ -81,17 +116,55 @@ class KaraokeLyricsProcessor:
|
|
81
116
|
self.logger.debug(f"Splitting at middle word index: {mid_word_index}")
|
82
117
|
return split_at_middle
|
83
118
|
|
84
|
-
# If the line is still too long,
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
119
|
+
# If the line is still too long, find the last space before max_line_length
|
120
|
+
if len(line) > self.max_line_length:
|
121
|
+
last_space = line.rfind(" ", 0, self.max_line_length)
|
122
|
+
if last_space != -1:
|
123
|
+
self.logger.debug(f"Splitting at last space before max_line_length: {last_space}")
|
124
|
+
return last_space
|
125
|
+
else:
|
126
|
+
# If no space is found, split at max_line_length
|
127
|
+
self.logger.debug(f"No space found, forcibly splitting at max_line_length: {self.max_line_length}")
|
128
|
+
return self.max_line_length
|
129
|
+
|
130
|
+
# If the line is shorter than max_line_length, return its length
|
131
|
+
return len(line)
|
132
|
+
|
133
|
+
def replace_non_printable_spaces(self, text):
|
134
|
+
"""
|
135
|
+
Replace non-printable space-like characters, tabs, and other whitespace with regular spaces,
|
136
|
+
excluding newline characters.
|
137
|
+
"""
|
138
|
+
self.logger.debug(f"Replacing non-printable spaces in: {text}")
|
139
|
+
# Define a pattern for space-like characters, including tabs and other whitespace, but excluding newlines
|
140
|
+
space_pattern = r"[^\S\n\r]|\u00A0|\u1680|\u2000-\u200A|\u202F|\u205F|\u3000"
|
141
|
+
# Replace matched characters with a regular space
|
142
|
+
cleaned_text = re.sub(space_pattern, " ", text)
|
143
|
+
# Remove leading/trailing spaces and collapse multiple spaces into one, preserving newlines
|
144
|
+
cleaned_text = re.sub(r" +", " ", cleaned_text).strip()
|
145
|
+
self.logger.debug(f"Text after replacing non-printable spaces: {cleaned_text}")
|
146
|
+
return cleaned_text
|
147
|
+
|
148
|
+
def clean_punctuation_spacing(self, text):
|
149
|
+
"""
|
150
|
+
Remove unnecessary spaces before punctuation marks.
|
151
|
+
"""
|
152
|
+
self.logger.debug(f"Cleaning punctuation spacing in: {text}")
|
153
|
+
# Remove space before comma, period, exclamation mark, question mark, colon, and semicolon
|
154
|
+
cleaned_text = re.sub(r"\s+([,\.!?:;])", r"\1", text)
|
155
|
+
self.logger.debug(f"Text after cleaning punctuation spacing: {cleaned_text}")
|
156
|
+
return cleaned_text
|
89
157
|
|
90
158
|
def process_line(self, line):
|
91
159
|
"""
|
92
160
|
Process a single line to ensure it's within the maximum length,
|
93
|
-
and
|
161
|
+
handle parentheses, and replace non-printable spaces.
|
94
162
|
"""
|
163
|
+
# Replace non-printable spaces at the beginning
|
164
|
+
line = self.replace_non_printable_spaces(line)
|
165
|
+
# Clean up punctuation spacing
|
166
|
+
line = self.clean_punctuation_spacing(line)
|
167
|
+
|
95
168
|
processed_lines = []
|
96
169
|
iteration_count = 0
|
97
170
|
max_iterations = 100 # Failsafe limit
|
@@ -153,6 +226,10 @@ class KaraokeLyricsProcessor:
|
|
153
226
|
|
154
227
|
processed_lyrics_text = "\n".join(lyrics_lines)
|
155
228
|
|
229
|
+
# Final pass to replace any remaining non-printable spaces and clean punctuation
|
230
|
+
processed_lyrics_text = self.replace_non_printable_spaces(processed_lyrics_text)
|
231
|
+
processed_lyrics_text = self.clean_punctuation_spacing(processed_lyrics_text)
|
232
|
+
|
156
233
|
self.processed_lyrics_text = processed_lyrics_text
|
157
234
|
pyperclip.copy(processed_lyrics_text)
|
158
235
|
|
@@ -161,8 +238,11 @@ class KaraokeLyricsProcessor:
|
|
161
238
|
return processed_lyrics_text
|
162
239
|
|
163
240
|
def write_to_output_file(self):
|
241
|
+
# Ensure the output filename has a .txt extension
|
242
|
+
base, _ = os.path.splitext(self.output_filename)
|
243
|
+
self.output_filename = f"{base}.txt"
|
164
244
|
|
165
|
-
with open(self.output_filename, "w") as outfile:
|
245
|
+
with open(self.output_filename, "w", encoding="utf-8") as outfile:
|
166
246
|
outfile.write(self.processed_lyrics_text)
|
167
247
|
|
168
248
|
self.logger.info(f"Processed lyrics written to output file {self.output_filename}")
|
{karaoke_lyrics_processor-0.1.1.dist-info → karaoke_lyrics_processor-0.3.0.dist-info}/METADATA
RENAMED
@@ -1,6 +1,6 @@
|
|
1
1
|
Metadata-Version: 2.1
|
2
2
|
Name: karaoke-lyrics-processor
|
3
|
-
Version: 0.
|
3
|
+
Version: 0.3.0
|
4
4
|
Summary: Process song lyrics to prepare them for karaoke video production, e.g. by splitting long lines
|
5
5
|
Home-page: https://github.com/karaokenerds/karaoke-lyrics-processor
|
6
6
|
License: MIT
|
@@ -13,13 +13,18 @@ Classifier: Programming Language :: Python :: 3.9
|
|
13
13
|
Classifier: Programming Language :: Python :: 3.10
|
14
14
|
Classifier: Programming Language :: Python :: 3.11
|
15
15
|
Classifier: Programming Language :: Python :: 3.12
|
16
|
+
Requires-Dist: docx2txt (>=0.8)
|
16
17
|
Requires-Dist: pyperclip (>=1.8)
|
18
|
+
Requires-Dist: python-docx (>=1)
|
19
|
+
Requires-Dist: striprtf (>=0.0.27)
|
17
20
|
Project-URL: Documentation, https://github.com/karaokenerds/karaoke-lyrics-processor/blob/main/README.md
|
18
21
|
Project-URL: Repository, https://github.com/karaokenerds/karaoke-lyrics-processor
|
19
22
|
Description-Content-Type: text/markdown
|
20
23
|
|
21
24
|
# Karaoke Lyrics Processor 🎶 ✍️
|
22
25
|
|
26
|
+

|
27
|
+
|
23
28
|
Karaoke Lyrics Processor is a tool to prepare song lyrics for karaoke video production.
|
24
29
|
|
25
30
|
It processes lyrics by splitting long lines, handling parentheses, and ensuring that each line fits within a specified maximum length.
|
@@ -0,0 +1,8 @@
|
|
1
|
+
karaoke_lyrics_processor/__init__.py,sha256=rLRkJQi61qkRiNXdlTleE3ahJ1oBKcghYVkz64x7IIg,62
|
2
|
+
karaoke_lyrics_processor/cli.py,sha256=bdtseRI2jcChb1bMr92pc5mpSWpHXh4TSzA2tknbyjU,2522
|
3
|
+
karaoke_lyrics_processor/karaoke_lyrics_processor.py,sha256=LmsciDtBS1-apCbvya2RBmYCSH4S-svrIDpOb8Ut0Gw,10387
|
4
|
+
karaoke_lyrics_processor-0.3.0.dist-info/LICENSE,sha256=BiPihPDxhxIPEx6yAxVfAljD5Bhm_XG2teCbPEj_m0Y,1069
|
5
|
+
karaoke_lyrics_processor-0.3.0.dist-info/METADATA,sha256=JuGcHlIyUvoesSQbFxN1iu-JP-B4mmGQIIrgIVv72pE,4264
|
6
|
+
karaoke_lyrics_processor-0.3.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
|
7
|
+
karaoke_lyrics_processor-0.3.0.dist-info/entry_points.txt,sha256=hjFp6CUxl1p-1WJYfB6TbNcI_DHEnVzX3BXAs4y_0O8,78
|
8
|
+
karaoke_lyrics_processor-0.3.0.dist-info/RECORD,,
|
@@ -1,8 +0,0 @@
|
|
1
|
-
karaoke_lyrics_processor/__init__.py,sha256=rLRkJQi61qkRiNXdlTleE3ahJ1oBKcghYVkz64x7IIg,62
|
2
|
-
karaoke_lyrics_processor/cli.py,sha256=yCbmQBTRHvSV0tjRf2WmWmYHXjYzlsPXd_EfZIRYm_c,2427
|
3
|
-
karaoke_lyrics_processor/karaoke_lyrics_processor.py,sha256=M8CE5l_aIyzjWwiu1lOqFkOkBB7R38JV8oqHFS-wklQ,6615
|
4
|
-
karaoke_lyrics_processor-0.1.1.dist-info/LICENSE,sha256=BiPihPDxhxIPEx6yAxVfAljD5Bhm_XG2teCbPEj_m0Y,1069
|
5
|
-
karaoke_lyrics_processor-0.1.1.dist-info/METADATA,sha256=Yi8rovwQ9alrNvFYQeOxvGD5z7v6Lde85hk5sJ_Q1Wc,4089
|
6
|
-
karaoke_lyrics_processor-0.1.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
|
7
|
-
karaoke_lyrics_processor-0.1.1.dist-info/entry_points.txt,sha256=hjFp6CUxl1p-1WJYfB6TbNcI_DHEnVzX3BXAs4y_0O8,78
|
8
|
-
karaoke_lyrics_processor-0.1.1.dist-info/RECORD,,
|
{karaoke_lyrics_processor-0.1.1.dist-info → karaoke_lyrics_processor-0.3.0.dist-info}/LICENSE
RENAMED
File without changes
|
File without changes
|