From 0dcd5bcae216f7c74af0a1f762c11190e5a280c9 Mon Sep 17 00:00:00 2001
From: Fredess74 <Proxima.hse@gmail.com>
Date: Sun, 6 Jul 2025 14:38:06 +0500
Subject: [PATCH] Add poem analysis utility

---
 README.md        | 20 ++++++++++-
 poem_analyzer.py | 92 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+), 1 deletion(-)
 create mode 100644 poem_analyzer.py

diff --git a/README.md b/README.md
index c32ea5a..30800b2 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
-# Second
\ No newline at end of file
+# Poem Analyzer
+
+This repository contains a simple console utility `poem_analyzer.py` for analyzing Russian poetry.
+
+## Usage
+
+```
+python poem_analyzer.py path/to/poem.txt
+```
+
+The script outputs:
+
+- The number of lines in the poem.
+- Average syllables per line.
+- Last vowels (approximated stressed vowels) for each line.
+- Suggested rhyme pairs and the rhyme scheme.
+- A rough hint at the poetic meter.
+
+The implementation relies only on the Python standard library.
diff --git a/poem_analyzer.py b/poem_analyzer.py
new file mode 100644
index 0000000..e8d38d0
--- /dev/null
+++ b/poem_analyzer.py
@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+"""Simple Russian poem analysis utility."""
+import argparse
+import re
+from collections import defaultdict
+
+VOWELS = 'аеёиоуыэюя'
+
+
+def count_syllables(line: str) -> int:
+    """Approximate syllable count by counting vowels."""
+    return len(re.findall(f'[{VOWELS}]', line.lower()))
+
+
+def extract_last_stressed(line: str):
+    """Return the last vowel and the rhyme part from that vowel to end."""
+    for idx in range(len(line) - 1, -1, -1):
+        ch = line[idx].lower()
+        if ch in VOWELS:
+            return ch, line[idx:].lower()
+    return '', ''
+
+
+def rhyme_scheme(parts):
+    mapping = {}
+    scheme = []
+    next_code = ord('A')
+    for part in parts:
+        if part in mapping:
+            scheme.append(mapping[part])
+        else:
+            mapping[part] = chr(next_code)
+            scheme.append(chr(next_code))
+            next_code += 1
+    return ''.join(scheme)
+
+
+def guess_meter(syllables):
+    if not syllables:
+        return None
+    avg = sum(syllables) / len(syllables)
+    if int(avg) % 2 == 0:
+        return 'Похоже на хорей или ямб'
+    return 'Размер не определён'
+
+
+def analyze(text: str):
+    lines = [l.strip() for l in text.splitlines() if l.strip()]
+    syllables = [count_syllables(line) for line in lines]
+    last_vowels = []
+    rhyme_parts = []
+    for line in lines:
+        v, part = extract_last_stressed(line)
+        last_vowels.append(v)
+        rhyme_parts.append(part)
+    scheme = rhyme_scheme(rhyme_parts)
+    groups = defaultdict(list)
+    for i, part in enumerate(rhyme_parts):
+        groups[part].append(i + 1)
+    pairs = []
+    for indices in groups.values():
+        for i in range(0, len(indices) - 1, 2):
+            pairs.append((indices[i], indices[i + 1]))
+    meter = guess_meter(syllables)
+    return {
+        'lines': len(lines),
+        'avg_syllables': sum(syllables) / len(syllables) if lines else 0,
+        'last_vowels': last_vowels,
+        'rhyme_pairs': pairs,
+        'scheme': scheme,
+        'meter_hint': meter,
+    }
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Analyze Russian poetry.')
+    parser.add_argument('file', help='Path to text file with poem')
+    args = parser.parse_args()
+    with open(args.file, encoding='utf-8') as f:
+        text = f.read()
+    result = analyze(text)
+    print('Число строк:', result['lines'])
+    print('Среднее количество слогов на строку:', f"{result['avg_syllables']:.2f}")
+    print('Последние гласные:', ' '.join(result['last_vowels']))
+    print('Предполагаемые пары рифм:', result['rhyme_pairs'])
+    print('Схема рифмовки:', result['scheme'])
+    if result['meter_hint']:
+        print('Размер:', result['meter_hint'])
+
+
+if __name__ == '__main__':
+    main()