merged language detection feature in master

README.rst

@@ -61,10 +61,12 @@ When you should use it
 - If you want to get translations from many sources and not only one
 - If you want to automate translations
 - If you want to compare different translations
+- If you want to detect language automatically
 
 Why you should use it
 ----------------------
 - High level of abstraction
+- Automatic language detection
 - Easy to use and extend
 - It's the only python tool that integrates many translators
 - Stable
@@ -77,6 +79,7 @@ Features
 * Support for Pons translator (pons.com)
 * Support for the Linguee translator
 * Support for the Mymemory translator
+* Automatic language detection
 * Translate directly from a text file
 * Get multiple translation for a word
 * Automate the translation of different paragraphs in different languages
@@ -99,7 +102,7 @@ Usage
 
 .. code-block:: python
 
-    from deep_translator import GoogleTranslator, PonsTranslator, LingueeTranslator, MyMemoryTranslator
+    from deep_translator import GoogleTranslator, PonsTranslator, LingueeTranslator, MyMemoryTranslator, detect_language
 
     text = 'happy coding'
 
@@ -119,6 +122,19 @@ Usage
     # alternatively, you can the dictionary containing languages mapped to their abbreviation
     langs_dict = GoogleTranslator.get_supported_languages(as_dict=True)  # output: {arabic: ar, french: fr, english:en etc...}
 
+.. note::
+
+    You can also detect language automatically. Notice that this package is free and my goal is to keep it free.
+    Therefore, you will need to get your own api_key if you want to use the language detection function.
+    I figured out you can get one for free here: https://detectlanguage.com/documentation
+
+- Language detection:
+
+.. code-block:: python
+
+    lang = detect_language('bonjour la vie', api_key='your_api_key')
+    print(lang) # output: fr
+
 
 - Simple translation:
 

deep_translator/__init__.py

@@ -9,7 +9,7 @@ from .detection import detect_language
 
 __author__ = """Nidhal Baccouri"""
 __email__ = '[email protected]'
-__version__ = '1.1.2'
+__version__ = '1.1.3'
 
 __all__ = [GoogleTranslator,
            PonsTranslator,

deep_translator/detection.py

@@ -28,5 +28,5 @@ def detect_language(text, api_key=None):
                 return lang
 
         except Exception as e:
-            print(e.args)
-            raise
+            print("Error occured while requesting from server: ", e.args)
+            raise e

deep_translator/utils.py

@@ -1,21 +1,3 @@
-
-import requests
-from bs4 import BeautifulSoup
-
-
-# res = requests.get('https://translate.google.com/?sl=auto&tl=en#view=home&op=translate&sl=auto&tl=de&text=cute')
-# soup = BeautifulSoup(res.text, 'html.parser')
-# print(soup)
-# a = soup.find('div', {'class': 'goog-inline-block jfk-button jfk-button-standard jfk-button-collapse-right jfk-button-checked'})
-
-# print(a)
-from bs4 import BeautifulSoup
-from requests_html import HTMLSession
-
-session = HTMLSession()
-r = session.get('https://translate.google.com/m?hl=en&sl=auto&tl=de&ie=UTF-8&prev=_m&q=here+is+a+sentence')
-r.html.render()
-
-print(r.html.html)
-#soup = BeautifulSoup(r.html.html, 'html.parser')
-
+"""
+utilities
+"""

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.1.2
+current_version = 1.1.3
 commit = True
 tag = True
 

setup.py

@@ -51,6 +51,6 @@ setup(
     test_suite='tests',
     tests_require=test_requirements,
     url='https://github.com/nidhaloff/deep_translator',
-    version='1.1.2',
+    version='1.1.3',
     zip_safe=False,
 )