added terminal support

README.rst

@@ -79,6 +79,7 @@ Features
 * Translate directly from a text file
 * Get multiple translation for a word
 * Automate the translation of different paragraphs in different languages
+* Translate directly from terminal (version >= 1.1.0)
 
 Installation
 =============
@@ -142,14 +143,42 @@ The mymemory translator is also supported for version >= 1.0.2:
     word = 'good'
     translated_word = MyMemoryTranslator(source='english', target='french').translate(word)
 
+Usage from Terminal
+====================
+
+For a quick access, you can use the deep_translator from terminal. For this to work, you need to provide
+the right arguments, which are the translator you want to use, source language, target language and the text
+you want to translate.
+
+For example, provide "google" as an argument to use the google translator. Alternatively you can use
+the other supported translators. Just read the documentation to have an overview about the supported
+translators in this library.
+
+.. code-block:: console
+
+    $ deep_translator --translator "google" --source "english" --target "german" --text "happy coding"
+
+Or you can go for the short version:
+
+.. code-block:: console
+
+    $ deep_translator -trans "google" -src "english" -tg "german" -txt "happy coding"
+
+If you want, you can also pass the source and target language by their abbreviation
+
+.. code-block:: console
+
+    $ deep_translator -trans "google" -src "en" -tg "de" -txt "happy coding"
+
 ========
 Links
 ========
 Check this article on medium to know why you should use the deep-translator package and how to translate text using python.
 https://medium.com/@nidhalbacc/how-to-translate-text-with-python-9d203139dcf5
 
-========
-Finally
-========
+==========
+Next Step
+==========
+
 Take a look in the examples folder for more :)
-Feel free to contribute and give me a feedback if you found the package useful/helpful or you are using it :)
+Contributions are always welcome. Feel free to make a pull request and give me a feedback if you found the package useful/helpful or you are using it :)

deep_translator/__init__.py

@@ -8,7 +8,7 @@ from .mymemory import MyMemoryTranslator
 
 __author__ = """Nidhal Baccouri"""
 __email__ = '[email protected]'
-__version__ = '1.0.9'
+__version__ = '1.1.0'
 
 __all__ = [GoogleTranslator,
            PonsTranslator,

docs/usage.rst

@@ -50,3 +50,31 @@ The mymemory translator is also supported for version >= 1.0.2:
 
     word = 'good'
     translated_word = MyMemoryTranslator(source='english', target='french').translate(word)
+
+
+Usage from Terminal
+====================
+
+For a quick access, you can use the deep_translator from terminal. For this to work, you need to provide
+the right arguments, which are the translator you want to use, source language, target language and the text
+you want to translate.
+
+For example, provide "google" as an argument to use the google translator. Alternatively you can use
+the other supported translators. Just read the documentation to have an overview about the supported
+translators in this library.
+
+.. code-block:: console
+
+    $ deep_translator --translator "google" --source "english" --target "german" --text "happy coding"
+
+Or you can go for the short version:
+
+.. code-block:: console
+
+    $ deep_translator -trans "google" -src "english" -tg "german" -txt "happy coding"
+
+If you want, you can also pass the source and target language by their abbreviation
+
+.. code-block:: console
+
+    $ deep_translator -trans "google" -src "en" -tg "de" -txt "happy coding"

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.0.9
+current_version = 1.1.0
 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.0.9',
+    version='1.1.0',
     zip_safe=False,
 )