{"id":13570282,"url":"https://github.com/khalidt/Nour","last_synced_at":"2025-04-04T06:32:15.938Z","repository":{"id":57446907,"uuid":"304634589","full_name":"khalidt/Nour","owner":"khalidt","description":"Nour is a tool that translates Arabic words, letters, or sentences to and from  Braille notations.","archived":false,"fork":false,"pushed_at":"2020-10-23T18:23:02.000Z","size":33,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-09T00:32:31.279Z","etag":null,"topics":["arabic-braille","arabic-conversion","arabic-language","arabic-translations","arabicbraille","braille","braille-notation","conversion","converter","converter-app","gplv3","letters","nour","python3-library","sentences","translates-arabic"],"latest_commit_sha":null,"homepage":"https://github.com/khalidt/Nour","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khalidt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-16T13:25:44.000Z","updated_at":"2024-04-06T13:24:53.000Z","dependencies_parsed_at":"2022-09-10T22:02:16.201Z","dependency_job_id":null,"html_url":"https://github.com/khalidt/Nour","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khalidt%2FNour","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khalidt%2FNour/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khalidt%2FNour/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khalidt%2FNour/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khalidt","download_url":"https://codeload.github.com/khalidt/Nour/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247134930,"owners_count":20889410,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arabic-braille","arabic-conversion","arabic-language","arabic-translations","arabicbraille","braille","braille-notation","conversion","converter","converter-app","gplv3","letters","nour","python3-library","sentences","translates-arabic"],"created_at":"2024-08-01T14:00:50.537Z","updated_at":"2025-04-04T06:32:10.928Z","avatar_url":"https://github.com/khalidt.png","language":"Python","readme":"# Description 🐋\n  **Nour** is an Arabic Braille tool that converts Arabic words, letters, or sentences to and from  Braille notations.\nNour 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](https://unesdoc.unesco.org/ark:/48223/pf0000087242) we added the unified braille standard for Arabic and we will add other Arab countries standards.\n\n# Sample:\n\n#### From inside python shell:\n```python\n\u003e\u003e\u003e from Nour import nour\n\u003e\u003e\u003e nour.arabicToBraille('بسم الله الرحمن الرحيم')\n\u003e\u003e\u003e nour.brailleToArabic('⠍⠗⠱⠃⠁')\n\u003e\u003e\u003e nour.util.brailles\n\u003e\u003e\u003e nour.util.arabic\n```\n\n#### Output:\n```\n⠃⠎⠍⠀⠁⠇⠇⠓⠀⠁⠇⠗⠱⠍⠝⠀⠁⠇⠗⠱⠊⠍\nمرحبا\n['⠀', '\\n', '⠁', '⠃', '⠞', '⠹', '⠚', '⠱', '⠭', '⠙', '⠮', '⠗', '⠵', '⠎', \n  '⠩', '⠯', '⠫', '⠾', '⠿', '⠷', '⠣', '⠋', '⠟', '⠅', '⠇', '⠍', '⠝', '⠓', \n  '⠡', '⠺', '⠊', '⠕', '⠉', '⠧', '⠴⠠', '⠌', '⠨', '⠜', '⠪', '⠳', '⠽', '⠄', \n  '⠥', '⠂', '⠆', '⠑', '⠔', '⠢', '⠒', '⠠', '⠐', '⠰', '⠐⠂', '⠶', '⠦…', '…⠴', \n  '⠠⠦', '⠐⠦', '⠴⠂', '⠲', '⠖', '⠦', '⠤', '⠼⠁', '⠼⠃', '⠼⠉',\n  '⠼⠙', '⠼⠑', '⠼⠋', '⠼⠛', '⠼⠓', '⠼⠊', '⠼⠚', '⠒⠏']\n \n[' ', '\\n', 'ا', 'ب', 'ت', 'ث', 'ج', 'ح', 'خ', 'د', 'ذ', 'ر', 'ز', 'س', \n  'ش', 'ص', 'ض', 'ط', 'ظ', 'ع', 'غ', 'ف', 'ق', 'ك', 'ل', 'م', 'ن', 'ه', 'ة', \n  'و', 'ي', 'ى', 'ال', 'لا', ']', 'أ', 'إ', 'آ', 'أو', 'ؤ', 'ئ', 'ء', 'ُ', \n  'َ', 'ً', 'ِ', 'ٍ', 'ٌ', 'ْ', 'ّ', '،', '؛', ':', '\"', '(', ')', '[', '{', \n  '}', '.', '!', '؟', '-', '١', '٢', '٣', '٤', '٥', '٦', '٧', '٨', '٩', '٠', \n  '٪']\n```\n\n#### From CLI:\n```bash\npython nour -br ⠞\n```\noutput:\n```\nت\n```\n\n#  Requirements\n* Python3 \u003e=3.6 \n\n\n# Installation:\n\n* ### Install from pip:\n  Use the package manager [pip](https://pypi.org/project/Nour/) to install Nour.\n\n```bash\npip install Nour\n```\n\n# Usage:\n```bash\nusage: Nour [-h] [-ar ARTEXT] [-br BRTEXT] [-arf ARFILE]           \n            [-brf BRFILE] [-o] [-p] [-info]                        \n                                                                   \noptional arguments:                                                \n  -h, --help            show this help message and exit            \n  -ar ARTEXT, --artext ARTEXT                                      \n                        The Arabic text to be converted to         \n                        Braille.                                   \n  -br BRTEXT, --brtext BRTEXT                                      \n                        The Braille text to be converted to        \n                        Arabic.                                    \n  -arf ARFILE, --arfile ARFILE                                     \n                        The Arabic text file to be converted to    \n                        Braille.                                   \n  -brf BRFILE, --brfile BRFILE                                     \n                        The Braille text file to be converted to   \n                        Arabic.                                    \n  -o, --out             Write Conversion to file                   \n  -p, --print           Print Standard Arabic Braille Code.        \n  -info, --info         Print Information about Nour.              \n                                                                   \nExamples:                                                          \nNour -p                                                            \nNour -ar مرحبا                                                     \nNour -ar arabicTextFile.txt                                        \nNour -arf readFromtext.txt -o                                      \nNour -br ⠓                                                         \nNour -brf brailleTextFile.txt                                      \nNour -arf ArTextFile.txt -abf BrTextFile.txt        \n```\n\n# Notes:\n* The character that is not in the standard of Arabic Braille code, will be ignored and replaced by space '  '. for **Example:** ~ , ^ , ' , \u0026 , /\n* Arithmetic and Logic operators are not supported yet.\n* Both the Arabic numerals (1,2,3 ...etc) and Eastern Arabic numerals (Hindi)  (١,٢,٣ ... etc) are used by the same Arabic Braille code.\n* Underline is not tested but it's included! \n* When using the argument of output file ' **-o** ' it creates a file and writes the conversion to it, the generated file will be named by default as **'Nour %d-%m-%y %H-%M'.txt**. Ex: **Nour 02-10-2020 08-12.txt**.\n* The only file that is supported for reading and writing is text **.txt**\n\n# Roadmap:\n* Add other Arab countries braille standards.\n* Import different files to read from and write to such as:\n   - **.docx , .doc, .rtf, .pdf, .html, .odt, xml** and more.\n* New feature will be added which is converting the Arabic alphabets in images and extract them to the document file.\n* Add mechanism to deal with shapes, Maps ... etc.\n* Add Math translation for **Nemeth** and more.\n\n# License\n\n\n[![GPL3v](https://www.gnu.org/graphics/gplv3-127x51.png)](https://www.gnu.org/licenses/gpl-3.0.html)\n\n\n    Nour is a tool which translates Arabic words, letters \n    or sentences to and from  Braille notations.\n    Copyright (C) 2020  Khalid Alkhaldi\n\n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation, version 3.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","funding_links":[],"categories":["Python Packages"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhalidt%2FNour","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhalidt%2FNour","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhalidt%2FNour/lists"}