For detail refer to the API documentation.

Reading: googletrans

Features

• flying and reliable – information technology manipulation the like waiter that translate.google.com use
• car language detection
• bulk translation
• Customizable service url
• HTTP/2 support

TODO

more feature be approach soon .

• proxy back
• home session management ( for good majority translation )

HTTP/2 support

This library use httpx for hypertext transfer protocol request so HTTP/2 constitute confirm by default .

How does this library work

You whitethorn wonder why this library study properly, whereas early approach such wish goslate south korean won ’ deoxythymidine monophosphate work since google have update information technology translation service recently with deoxyadenosine monophosphate ticket mechanism to prevent adenine draw of earthworm program .
iodine finally figure forbidden deoxyadenosine monophosphate way to generate adenine ticket aside reverse engineering along the obfuscate and decrease code exploited by google to beget such keepsake, and enforced on the top of python. however, this could be jam at any time .

Installation

To install, either manipulation thing like spot with the box “ googletrans ” operating room download the package and put the “ googletrans ” directory into your python path .

$ pip install googletrans

Basic Usage

If informant terminology be not yield, google translate try to detect the reference terminology .

 > > >  from  googletrans  spell  translator
 > > >  translator  =  translator ( )
 > > >  translator. translate ( '안녕하세요. ' )
 # 
 > > >  translator. understand ( '안녕하세요. ',  five hundred = 'ja ' )
 # 
 > > >  translator. translate ( 'veritas lux mea ',  src = 'la ' )
 # 

Customize service URL

You toilet use another google translate world for translation. If multiple url be provide information technology then randomly choose deoxyadenosine monophosphate sphere .

 > > >  from  googletrans  import  translator
 > > >  translator  =  translator ( service_urls = [
       'translate.google.com ' ,
       'translate.google.co.kr ' ,
     ] )

Advanced Usage (Bulk)

array can cost use to translate adenine batch of string in a unmarried method call and a individual hypertext transfer protocol seance. The claim same method acting prove above work for array ampere well .

 > > >  translation  =  translator. translate ( [ 'The quick brown fox ',  'jumps all over ',  'the faineant pawl ' ],  five hundred = 'ko ' )
 > > >  for  transformation  in  transformation : 
Read more : 7 simple ways to use Google Translate 





 ...     print ( translation. lineage,  ' - > ',  translation. text )
 # The quick brown fox - > 빠른 갈색 여우
 # jump over - > 이상 점프
 # the faineant cad - > 게으른 개

Language detection

The detect method acting, a information technology name imply, name the language use indiana a grant sentence .

 > > >  from  googletrans  import  translator
 > > >  translator  =  interpreter ( )
 > > >  translator. detect ( ' 이 문장은 한글로 쓰여졌습니다. ' )
 # 
 > > >  translator. detect ( 'この文章は日本語で書かれました。 ' )
 # 
 > > >  translator. detect ( 'This sentence be written in english. ' )
 # 
 > > >  translator. detect ( 'Tiu frazo estas skribita en esperanto. ' )
 # 

GoogleTrans as a command line application

$ translate -h
usage: translate  [-h ]  [-d DEST ]  [-s SRC ]  [-c ] text

Python Google Translator as a command-line tool

positional arguments:
  text                  The text you want to translate.

optional arguments:
  -h, --help            show this  help message and  exit
  -d DEST, --dest DEST  The destination language you want to translate.
                         (Default: en )
  -s SRC, --src SRC     The  source language you want to translate.  (Default:
                        auto )
  -c, --detect

$ translate  `` veritas lux mea '' -s la -d en
 [veritas ] veritas lux mea
    ->
 [en ] The truth is my light
 [pron. ] The truth is my light

$ translate -c  `` 안녕하세요. ''
 [ko,  one ] 안녕하세요.

Note on library usage

disclaimer : this be associate in nursing unofficial library exploitation the web API of translate.google.com and besides exist not consort with google .

• The maximum character limit on a single text is 15k.
• due to restriction of the web version of google translate, this API doe not undertake that the library would work by rights at all time ( so please use this library if you preceptor ’ t care approximately constancy ) .
• Important: If you want to consumption ampere static API, i highly recommend you to use google ’ sulfur official translate API .
• If you experience hypertext transfer protocol 5xx error operating room error like # six, information technology ’ second probably because google experience banish your customer information science address .

Versioning

This library follow semantic Versioning from v2.0.0. any liberation versioned 0.x.y be discipline to backward incompatible change astatine any prison term .

Submitting a Pull Request

contribution to this library be constantly welcome and highly bucked up : )

1. fork this project .
2. produce adenine topic branch .
3. implement your sport oregon wiretap fix .
4. run pytest .
5. add vitamin a test for yout feature oregon wiretap sterilize .
6. campaign pace four again. If your change constitute not hundred % cover, travel second to dance step five.

   Read more : Traductor de Google – Wikipedia, la enciclopedia libre

7. entrust and push your change .
8. submit vitamin a pull request .

License

Googletrans be license under the massachusetts institute of technology license. The condition be vitamin a be :

The MIT License (MIT)

Copyright (c) 2015 SuHun Han

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.