Nour

Nour is a tool which converts Arabic words, letters or sentences to and from Braille notations.


Keywords
Conversion, Braille, development, Arabic, to, converter, translater, letters, notations, Python, nour, arabic-braille, arabic-conversion, arabic-language, arabic-translations, arabicbraille, braille-notation, converter-app, gplv3, python3-library, sentences, translates-arabic
License
GPL-3.0
Install
pip install Nour==1.0.3

Documentation

Nour

Nour is a tool that translates Arabic words, letters, or sentences to and from Braille notations.

Nour has used the unified braille standard for Arabic that was developed at a conference in Saudi Arabia in 2002. However, some other Arab countries in 2013 do not sign it up thus they use a different standard of braille notation which will be added in the next version of Nour. based on the world Braille usage we added the unified braille standard for Arabic and we will add other Arab countries standards

Example:

From inside python shell:

from Nour import nour
nour.arabicToBrailles('بسم الله الرحمن الرحيم')
nour.brailleToArabic('⠍⠗⠱⠃⠁')

output:

⠃⠎⠍⠀⠁⠇⠇⠓⠀⠁⠇⠗⠱⠍⠝⠀⠁⠇⠗⠱⠊⠍
مرحبا

From CLI:

python nour -br ⠗

output:

ر

From virtualenv:

python -m Nour.nour -br ⠗

output:

ر

Installation:

  • Install from pip:

    Use the package manager pip to install Nour.
pip install Nour

Usage:

usage: Nour [-h] [-ar ARTEXT] [-br BRTEXT] [-arf ARFILE]           
            [-brf BRFILE] [-o] [-p] [-info]                        
                                                                   
optional arguments:                                                
  -h, --help            show this help message and exit            
  -ar ARTEXT, --artext ARTEXT                                      
                        The Arabic text to be converted to         
                        Braille.                                   
  -br BRTEXT, --brtext BRTEXT                                      
                        The Braille text to be converted to        
                        Arabic.                                    
  -arf ARFILE, --arfile ARFILE                                     
                        The Arabic text file to be converted to    
                        Braille.                                   
  -brf BRFILE, --brfile BRFILE                                     
                        The Braille text file to be converted to   
                        Arabic.                                    
  -o, --out             Write Convertion to file                   
  -p, --print           Print Standard Arabic Braille Code.        
  -info, --info         Print Information about Nour.              
                                                                   
Examples:                                                          
Nour -p                                                            
Nour -ar مرحبا                                                     
Nour -ar arabicTextFile.txt                                        
Nour -arf readFromtext.txt -o                                      
Nour -br ⠓                                                         
Nour -brf brailleTextFile.txt                                      
Nour -arf ArTextFile.txt -abf BrTextFile.txt        

License

Image of GPLv3 GPLv3