Skip to content

Commit 329390f

Browse files
author
Your Name
committed
Update Readme
1 parent a68d170 commit 329390f

File tree

1 file changed

+12
-15
lines changed

1 file changed

+12
-15
lines changed

README.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,21 @@
11
# AsoSoft Library (Python)
2-
AsoSoft Library offers basic natural language processing (NLP) algorithms for the Kurdish Language (ckb: Central branch of Kurdish).
3-
AsoSoft Library is originally written in C# and this library is the Python port.
4-
- **Grapheme-to-Phoneme (G2P) converter and Transliteration**: converts Kurdish text into syllabified phoneme string. Also transliterates Kurdish texts from Arabic script into Latin script and vice versa.
2+
AsoSoft Library offers the following natural language processing (NLP) algorithms for the Kurdish Language (ckb: Central branch of Kurdish):
3+
- **Grapheme-to-Phoneme (G2P) converter and Transliterator**: converts Kurdish text into syllabified phoneme string. Also transliterates Kurdish texts from Arabic script into Latin script and vice versa.
54
- **Normalizer**: normalizes the Kurdish text and punctuation marks, unifies numerals, replaces Html Entities, extracts and replaces URLs and emails, and more.
65
- **Numeral Converter**: converts any type of numbers into Kurdish words.
76
- **Sort**: Sorts a list in correct Kurdish alphabet order.
8-
- **Poem Meter Classifier**: Classifies the meter of the input Kurdish poem
7+
- **Poem Meter Classifier**: Classifies the meter of the input Kurdish poem
8+
9+
AsoSoft Library is originally written in C# by [Aso Mahmudi](https://github.com/aso-mehmudi) and this library is its Python port.
910

1011
## How to use?
11-
- **Python version**: Python 3.11+
12-
- **Install package using pip**: [pip install asosoft](https://pypi.org/project/asosoft/)
13-
- **Import package in your py file**:
12+
- **Requierements**: Python 3.8+
13+
- **Install the package using pip**: [pip install asosoft](https://pypi.org/project/asosoft/)
14+
- **Import the package in your Python file**:
1415
```python
1516
import asosoft
1617
```
1718

18-
## Development
19-
AsoSoft Library is developed and maintained by Aso Mahmudi.
20-
AsoSoft Library is written in C# (.NET 6).
21-
2219
## Grapheme-to-Phoneme (G2P) converter and Transliteration
2320
This function is based on the study "[Automated Grapheme-to-Phoneme Conversion for Central Kurdish based on Optimality Theory](https://www.sciencedirect.com/science/article/abs/pii/S0885230821000292)".
2421

@@ -196,16 +193,16 @@ Sorting a string list in correct order of Kurdish alphabet ("ئءاآأإبپت
196193
```
197194
or using your custom order:
198195
```python
199-
>>> inputList = ["یەک", "ڕەنگ", "ئەو", "ئاو", "ڤەژین", "فڵان"]
200-
>>> inputOrder = list("ئءاآأإبپتثجچحخدڎڊذرڕزژسشصضطظعغفڤقكکگڴلڵمنوۆۊۉۋهھەیێ")
201-
>>> print(asosoft.CustomSort(inputList, inputOrder))
196+
>>> input_list = ["یەک", "ڕەنگ", "ئەو", "ئاو", "ڤەژین", "فڵان"]
197+
>>> input_order = list("ئءاآأإبپتثجچحخدڎڊذرڕزژسشصضطظعغفڤقكکگڴلڵمنوۆۊۉۋهھەیێ")
198+
>>> print(asosoft.CustomSort(input_list, input_order))
202199
["ئاو", "ئەو", "ڕەنگ", "فڵان", "ڤەژین", "یەک"]
203200
```
204201
## Poem Meter Classifier
205202
It classifies the meter of the input Kurdish poem typed in Arabic script. The lines of the poem should be seprated by new line char ('\n').
206203
You can find Kurdish poems in https://books.vejin.net/.
207204
```python
208-
>>> poem = "گەرچی تووشی ڕەنجەڕۆیی و حەسرەت و دەردم ئەمن\nقەت لەدەس ئەم چەرخە سپڵە نابەزم مەردم ئەمن\nئاشقی چاوی کەژاڵ و گەردنی پڕ \nخاڵ نیم\nئاشقی کێو و تەلان و بەندەن و بەردم ئەمن"
205+
>>> poem = f"گەرچی تووشی ڕەنجەڕۆیی و حەسرەت و دەردم ئەمن\nقەت لەدەس ئەم چەرخە سپڵە نابەزم مەردم ئەمن\nمن لە زنجیر و تەناف و دار و بەند باکم نییە\nلەت لەتم کەن، بمکوژن، هێشتا دەڵێم کوردم ئەمن"
209206
>>> classified = asosoft.ClassifyKurdishPoem(poem)
210207
>>> print("Poem Type= " + classified.overalMeterType)
211208
Quantitative/عەرووزی

0 commit comments

Comments
 (0)