class Config: # Derived from here: # https://sites.google.com/site/tomihasa/google-language-codes#searchlanguage LANGUAGES = [ {'name': 'Default (none specified)', 'value': ''}, {'name': 'English', 'value': 'lang_en'}, {'name': 'Afrikaans', 'value': 'lang_af'}, {'name': 'Arabic', 'value': 'lang_ar'}, {'name': 'Armenian', 'value': 'lang_hy'}, {'name': 'Belarusian', 'value': 'lang_be'}, {'name': 'Bulgarian', 'value': 'lang_bg'}, {'name': 'Catalan', 'value': 'lang_ca'}, {'name': 'Chinese (Simplified)', 'value': 'lang_zh-CN'}, {'name': 'Chinese (Traditional)', 'value': 'lang_zh-TW'}, {'name': 'Croatian', 'value': 'lang_hr'}, {'name': 'Czech', 'value': 'lang_cs'}, {'name': 'Danish', 'value': 'lang_da'}, {'name': 'Dutch', 'value': 'lang_nl'}, {'name': 'Esperanto', 'value': 'lang_eo'}, {'name': 'Estonian', 'value': 'lang_et'}, {'name': 'Filipino', 'value': 'lang_tl'}, {'name': 'Finnish', 'value': 'lang_fi'}, {'name': 'French', 'value': 'lang_fr'}, {'name': 'German', 'value': 'lang_de'}, {'name': 'Greek', 'value': 'lang_el'}, {'name': 'Hebrew', 'value': 'lang_iw'}, {'name': 'Hindi', 'value': 'lang_hi'}, {'name': 'Hungarian', 'value': 'lang_hu'}, {'name': 'Icelandic', 'value': 'lang_is'}, {'name': 'Indonesian', 'value': 'lang_id'}, {'name': 'Italian', 'value': 'lang_it'}, {'name': 'Japanese', 'value': 'lang_ja'}, {'name': 'Korean', 'value': 'lang_ko'}, {'name': 'Latvian', 'value': 'lang_lv'}, {'name': 'Lithuanian', 'value': 'lang_lt'}, {'name': 'Norwegian', 'value': 'lang_no'}, {'name': 'Persian', 'value': 'lang_fa'}, {'name': 'Polish', 'value': 'lang_pl'}, {'name': 'Portuguese', 'value': 'lang_pt'}, {'name': 'Romanian', 'value': 'lang_ro'}, {'name': 'Russian', 'value': 'lang_ru'}, {'name': 'Serbian', 'value': 'lang_sr'}, {'name': 'Slovak', 'value': 'lang_sk'}, {'name': 'Slovenian', 'value': 'lang_sl'}, {'name': 'Spanish', 'value': 'lang_es'}, {'name': 'Swahili', 'value': 'lang_sw'}, {'name': 'Swedish', 'value': 'lang_sv'}, {'name': 'Thai', 'value': 'lang_th'}, {'name': 'Turkish', 'value': 'lang_tr'}, {'name': 'Ukrainian', 'value': 'lang_uk'}, {'name': 'Vietnamese', 'value': 'lang_vi'}, ] COUNTRIES = [ {'name': 'Default (none)', 'value': ''}, {'name': 'Afghanistan', 'value': 'countryAF'}, {'name': 'Albania', 'value': 'countryAL'}, {'name': 'Algeria', 'value': 'countryDZ'}, {'name': 'American Samoa', 'value': 'countryAS'}, {'name': 'Andorra', 'value': 'countryAD'}, {'name': 'Angola', 'value': 'countryAO'}, {'name': 'Anguilla', 'value': 'countryAI'}, {'name': 'Antarctica', 'value': 'countryAQ'}, {'name': 'Antigua and Barbuda', 'value': 'countryAG'}, {'name': 'Argentina', 'value': 'countryAR'}, {'name': 'Armenia', 'value': 'countryAM'}, {'name': 'Aruba', 'value': 'countryAW'}, {'name': 'Australia', 'value': 'countryAU'}, {'name': 'Austria', 'value': 'countryAT'}, {'name': 'Azerbaijan', 'value': 'countryAZ'}, {'name': 'Bahamas', 'value': 'countryBS'}, {'name': 'Bahrain', 'value': 'countryBH'}, {'name': 'Bangladesh', 'value': 'countryBD'}, {'name': 'Barbados', 'value': 'countryBB'}, {'name': 'Belarus', 'value': 'countryBY'}, {'name': 'Belgium', 'value': 'countryBE'}, {'name': 'Belize', 'value': 'countryBZ'}, {'name': 'Benin', 'value': 'countryBJ'}, {'name': 'Bermuda', 'value': 'countryBM'}, {'name': 'Bhutan', 'value': 'countryBT'}, {'name': 'Bolivia', 'value': 'countryBO'}, {'name': 'Bosnia and Herzegovina', 'value': 'countryBA'}, {'name': 'Botswana', 'value': 'countryBW'}, {'name': 'Bouvet Island', 'value': 'countryBV'}, {'name': 'Brazil', 'value': 'countryBR'}, {'name': 'British Indian Ocean Territory', 'value': 'countryIO'}, {'name': 'Brunei Darussalam', 'value': 'countryBN'}, {'name': 'Bulgaria', 'value': 'countryBG'}, {'name': 'Burkina Faso', 'value': 'countryBF'}, {'name': 'Burundi', 'value': 'countryBI'}, {'name': 'Cambodia', 'value': 'countryKH'}, {'name': 'Cameroon', 'value': 'countryCM'}, {'name': 'Canada', 'value': 'countryCA'}, {'name': 'Cape Verde', 'value': 'countryCV'}, {'name': 'Cayman Islands', 'value': 'countryKY'}, {'name': 'Central African Republic', 'value': 'countryCF'}, {'name': 'Chad', 'value': 'countryTD'}, {'name': 'Chile', 'value': 'countryCL'}, {'name': 'China', 'value': 'countryCN'}, {'name': 'Christmas Island', 'value': 'countryCX'}, {'name': 'Cocos (Keeling) Islands', 'value': 'countryCC'}, {'name': 'Colombia', 'value': 'countryCO'}, {'name': 'Comoros', 'value': 'countryKM'}, {'name': 'Congo', 'value': 'countryCG'}, {'name': 'Congo, Democratic Republic of the', 'value': 'countryCD'}, {'name': 'Cook Islands', 'value': 'countryCK'}, {'name': 'Costa Rica', 'value': 'countryCR'}, {'name': 'Cote D\'ivoire', 'value': 'countryCI'}, {'name': 'Croatia (Hrvatska)', 'value': 'countryHR'}, {'name': 'Cuba', 'value': 'countryCU'}, {'name': 'Cyprus', 'value': 'countryCY'}, {'name': 'Czech Republic', 'value': 'countryCZ'}, {'name': 'Denmark', 'value': 'countryDK'}, {'name': 'Djibouti', 'value': 'countryDJ'}, {'name': 'Dominica', 'value': 'countryDM'}, {'name': 'Dominican Republic', 'value': 'countryDO'}, {'name': 'East Timor', 'value': 'countryTP'}, {'name': 'Ecuador', 'value': 'countryEC'}, {'name': 'Egypt', 'value': 'countryEG'}, {'name': 'El Salvador', 'value': 'countrySV'}, {'name': 'Equatorial Guinea', 'value': 'countryGQ'}, {'name': 'Eritrea', 'value': 'countryER'}, {'name': 'Estonia', 'value': 'countryEE'}, {'name': 'Ethiopia', 'value': 'countryET'}, {'name': 'European Union', 'value': 'countryEU'}, {'name': 'Falkland Islands (Malvinas)', 'value': 'countryFK'}, {'name': 'Faroe Islands', 'value': 'countryFO'}, {'name': 'Fiji', 'value': 'countryFJ'}, {'name': 'Finland', 'value': 'countryFI'}, {'name': 'France', 'value': 'countryFR'}, {'name': 'France\, Metropolitan', 'value': 'countryFX'}, {'name': 'French Guiana', 'value': 'countryGF'}, {'name': 'French Polynesia', 'value': 'countryPF'}, {'name': 'French Southern Territories', 'value': 'countryTF'}, {'name': 'Gabon', 'value': 'countryGA'}, {'name': 'Gambia', 'value': 'countryGM'}, {'name': 'Georgia', 'value': 'countryGE'}, {'name': 'Germany', 'value': 'countryDE'}, {'name': 'Ghana', 'value': 'countryGH'}, {'name': 'Gibraltar', 'value': 'countryGI'}, {'name': 'Greece', 'value': 'countryGR'}, {'name': 'Greenland', 'value': 'countryGL'}, {'name': 'Grenada', 'value': 'countryGD'}, {'name': 'Guadeloupe', 'value': 'countryGP'}, {'name': 'Guam', 'value': 'countryGU'}, {'name': 'Guatemala', 'value': 'countryGT'}, {'name': 'Guinea', 'value': 'countryGN'}, {'name': 'Guinea-Bissau', 'value': 'countryGW'}, {'name': 'Guyana', 'value': 'countryGY'}, {'name': 'Haiti', 'value': 'countryHT'}, {'name': 'Heard Island and Mcdonald Islands', 'value': 'countryHM'}, {'name': 'Holy See (Vatican City State)', 'value': 'countryVA'}, {'name': 'Honduras', 'value': 'countryHN'}, {'name': 'Hong Kong', 'value': 'countryHK'}, {'name': 'Hungary', 'value': 'countryHU'}, {'name': 'Iceland', 'value': 'countryIS'}, {'name': 'India', 'value': 'countryIN'}, {'name': 'Indonesia', 'value': 'countryID'}, {'name': 'Iran, Islamic Republic of', 'value': 'countryIR'}, {'name': 'Iraq', 'value': 'countryIQ'}, {'name': 'Ireland', 'value': 'countryIE'}, {'name': 'Israel', 'value': 'countryIL'}, {'name': 'Italy', 'value': 'countryIT'}, {'name': 'Jamaica', 'value': 'countryJM'}, {'name': 'Japan', 'value': 'countryJP'}, {'name': 'Jordan', 'value': 'countryJO'}, {'name': 'Kazakhstan', 'value': 'countryKZ'}, {'name': 'Kenya', 'value': 'countryKE'}, {'name': 'Kiribati', 'value': 'countryKI'}, {'name': 'Korea, Democratic People\'s Republic of', 'value': 'countryKP'}, {'name': 'Korea, Republic of', 'value': 'countryKR'}, {'name': 'Kuwait', 'value': 'countryKW'}, {'name': 'Kyrgyzstan', 'value': 'countryKG'}, {'name': 'Lao People\'s Democratic Republic', 'value': 'countryLA'}, {'name': 'Latvia', 'value': 'countryLV'}, {'name': 'Lebanon', 'value': 'countryLB'}, {'name': 'Lesotho', 'value': 'countryLS'}, {'name': 'Liberia', 'value': 'countryLR'}, {'name': 'Libyan Arab Jamahiriya', 'value': 'countryLY'}, {'name': 'Liechtenstein', 'value': 'countryLI'}, {'name': 'Lithuania', 'value': 'countryLT'}, {'name': 'Luxembourg', 'value': 'countryLU'}, {'name': 'Macao', 'value': 'countryMO'}, {'name': 'Macedonia, the Former Yugosalv Republic of', 'value': 'countryMK'}, {'name': 'Madagascar', 'value': 'countryMG'}, {'name': 'Malawi', 'value': 'countryMW'}, {'name': 'Malaysia', 'value': 'countryMY'}, {'name': 'Maldives', 'value': 'countryMV'}, {'name': 'Mali', 'value': 'countryML'}, {'name': 'Malta', 'value': 'countryMT'}, {'name': 'Marshall Islands', 'value': 'countryMH'}, {'name': 'Martinique', 'value': 'countryMQ'}, {'name': 'Mauritania', 'value': 'countryMR'}, {'name': 'Mauritius', 'value': 'countryMU'}, {'name': 'Mayotte', 'value': 'countryYT'}, {'name': 'Mexico', 'value': 'countryMX'}, {'name': 'Micronesia, Federated States of', 'value': 'countryFM'}, {'name': 'Moldova, Republic of', 'value': 'countryMD'}, {'name': 'Monaco', 'value': 'countryMC'}, {'name': 'Mongolia', 'value': 'countryMN'}, {'name': 'Montserrat', 'value': 'countryMS'}, {'name': 'Morocco', 'value': 'countryMA'}, {'name': 'Mozambique', 'value': 'countryMZ'}, {'name': 'Myanmar', 'value': 'countryMM'}, {'name': 'Namibia', 'value': 'countryNA'}, {'name': 'Nauru', 'value': 'countryNR'}, {'name': 'Nepal', 'value': 'countryNP'}, {'name': 'Netherlands', 'value': 'countryNL'}, {'name': 'Netherlands Antilles', 'value': 'countryAN'}, {'name': 'New Caledonia', 'value': 'countryNC'}, {'name': 'New Zealand', 'value': 'countryNZ'}, {'name': 'Nicaragua', 'value': 'countryNI'}, {'name': 'Niger', 'value': 'countryNE'}, {'name': 'Nigeria', 'value': 'countryNG'}, {'name': 'Niue', 'value': 'countryNU'}, {'name': 'Norfolk Island', 'value': 'countryNF'}, {'name': 'Northern Mariana Islands', 'value': 'countryMP'}, {'name': 'Norway', 'value': 'countryNO'}, {'name': 'Oman', 'value': 'countryOM'}, {'name': 'Pakistan', 'value': 'countryPK'}, {'name': 'Palau', 'value': 'countryPW'}, {'name': 'Palestinian Territory', 'value': 'countryPS'}, {'name': 'Panama', 'value': 'countryPA'}, {'name': 'Papua New Guinea', 'value': 'countryPG'}, {'name': 'Paraguay', 'value': 'countryPY'}, {'name': 'Peru', 'value': 'countryPE'}, {'name': 'Philippines', 'value': 'countryPH'}, {'name': 'Pitcairn', 'value': 'countryPN'}, {'name': 'Poland', 'value': 'countryPL'}, {'name': 'Portugal', 'value': 'countryPT'}, {'name': 'Puerto Rico', 'value': 'countryPR'}, {'name': 'Qatar', 'value': 'countryQA'}, {'name': 'Reunion', 'value': 'countryRE'}, {'name': 'Romania', 'value': 'countryRO'}, {'name': 'Russian Federation', 'value': 'countryRU'}, {'name': 'Rwanda', 'value': 'countryRW'}, {'name': 'Saint Helena', 'value': 'countrySH'}, {'name': 'Saint Kitts and Nevis', 'value': 'countryKN'}, {'name': 'Saint Lucia', 'value': 'countryLC'}, {'name': 'Saint Pierre and Miquelon', 'value': 'countryPM'}, {'name': 'Saint Vincent and the Grenadines', 'value': 'countryVC'}, {'name': 'Samoa', 'value': 'countryWS'}, {'name': 'San Marino', 'value': 'countrySM'}, {'name': 'Sao Tome and Principe', 'value': 'countryST'}, {'name': 'Saudi Arabia', 'value': 'countrySA'}, {'name': 'Senegal', 'value': 'countrySN'}, {'name': 'Serbia and Montenegro', 'value': 'countryCS'}, {'name': 'Seychelles', 'value': 'countrySC'}, {'name': 'Sierra Leone', 'value': 'countrySL'}, {'name': 'Singapore', 'value': 'countrySG'}, {'name': 'Slovakia', 'value': 'countrySK'}, {'name': 'Slovenia', 'value': 'countrySI'}, {'name': 'Solomon Islands', 'value': 'countrySB'}, {'name': 'Somalia', 'value': 'countrySO'}, {'name': 'South Africa', 'value': 'countryZA'}, {'name': 'South Georgia and the South Sandwich Islands', 'value': 'countryGS'}, {'name': 'Spain', 'value': 'countryES'}, {'name': 'Sri Lanka', 'value': 'countryLK'}, {'name': 'Sudan', 'value': 'countrySD'}, {'name': 'Suriname', 'value': 'countrySR'}, {'name': 'Svalbard and Jan Mayen', 'value': 'countrySJ'}, {'name': 'Swaziland', 'value': 'countrySZ'}, {'name': 'Sweden', 'value': 'countrySE'}, {'name': 'Switzerland', 'value': 'countryCH'}, {'name': 'Syrian Arab Republic', 'value': 'countrySY'}, {'name': 'Taiwan, Province of China', 'value': 'countryTW'}, {'name': 'Tajikistan', 'value': 'countryTJ'}, {'name': 'Tanzania, United Republic of', 'value': 'countryTZ'}, {'name': 'Thailand', 'value': 'countryTH'}, {'name': 'Togo', 'value': 'countryTG'}, {'name': 'Tokelau', 'value': 'countryTK'}, {'name': 'Tonga', 'value': 'countryTO'}, {'name': 'Trinidad and Tobago', 'value': 'countryTT'}, {'name': 'Tunisia', 'value': 'countryTN'}, {'name': 'Turkey', 'value': 'countryTR'}, {'name': 'Turkmenistan', 'value': 'countryTM'}, {'name': 'Turks and Caicos Islands', 'value': 'countryTC'}, {'name': 'Tuvalu', 'value': 'countryTV'}, {'name': 'Uganda', 'value': 'countryUG'}, {'name': 'Ukraine', 'value': 'countryUA'}, {'name': 'United Arab Emirates', 'value': 'countryAE'}, {'name': 'United Kingdom', 'value': 'countryUK'}, {'name': 'United States', 'value': 'countryUS'}, {'name': 'United States Minor Outlying Islands', 'value': 'countryUM'}, {'name': 'Uruguay', 'value': 'countryUY'}, {'name': 'Uzbekistan', 'value': 'countryUZ'}, {'name': 'Vanuatu', 'value': 'countryVU'}, {'name': 'Venezuela', 'value': 'countryVE'}, {'name': 'Vietnam', 'value': 'countryVN'}, {'name': 'Virgin Islands, British', 'value': 'countryVG'}, {'name': 'Virgin Islands, U.S.', 'value': 'countryVI'}, {'name': 'Wallis and Futuna', 'value': 'countryWF'}, {'name': 'Western Sahara', 'value': 'countryEH'}, {'name': 'Yemen', 'value': 'countryYE'}, {'name': 'Yugoslavia', 'value': 'countryYU'}, {'name': 'Zambia', 'value': 'countryZM'}, {'name': 'Zimbabwe', 'value': 'countryZW'} ] def __init__(self, **kwargs): self.url = '' self.lang_search = '' self.lang_interface = '' self.ctry = '' self.safe = False self.dark = False self.nojs = False self.tor = False self.near = '' self.alts = False self.new_tab = False self.get_only = False for key, value in kwargs.items(): setattr(self, key, value) def __getitem__(self, name): return getattr(self, name) def __setitem__(self, name, value): return setattr(self, name, value) def __delitem__(self, name): return delattr(self, name) def __contains__(self, name): return hasattr(self, name) def is_safe_key(self, key) -> bool: """Establishes a group of config options that are safe to set in the url. Args: key (str) -- the key to check against Returns: bool -- True/False depending on if the key is in the "safe" array """ return key in [ 'lang_search', 'lang_interface', 'ctry', 'dark' ] def from_params(self, params) -> 'Config': """Modify user config with search parameters. This is primarily used for specifying configuration on a search-by-search basis on public instances. Args: params -- the url arguments (can be any deemed safe by is_safe()) Returns: Config -- a modified config object """ for param_key in params.keys(): if not self.is_safe_key(param_key): continue self[param_key] = params.get(param_key) return self