Как понять документы и использовать модуль

Question

я боролся за некоторое время понимания документации любого модуля:

Я хочу использовать selenium модуль.

Рассматривая документацию, я ничего не могу реализовать.

Учитывая эту часть API Docs: http://selenium-python.readthedocs.io/api.html#module-selenium.webdriver.chrome.webdriver

Я вижу это: class selenium.webdriver.chrome.webdriver.WebDriver(...)

При попытке реализации этого в моем питона коде говорит: AttributeError: module 'selenium' has no attribute 'webdriver'

питон код 3.x:

import selenium 
browser = selenium.webdriver.chrome.webdriver.WebDriver(executable_path='C:/Users/chromedriver') 

Может кто-нибудь объяснить мне, как читать, понимать и использовать любую документацию?

Answer 1

Я не могу объяснить, как читать «любую документацию» (я не думаю, что кто-то может). Тем не менее, я могу помочь вам в хорошем направлении, предоставив вам представление о том, как начинать с новых модулей I.

Обычно каждый модуль имеет не только документацию, но и часть «Начало работы»: here для selenium.

Только когда у меня возникает ощущение, что я понимаю основы модуля, которые я посещаю, и читаю документы для тонкой настройки того, что я действительно хотел сделать. Как вы сказали: их трудно читать.

================================================================================================================================== ======

В данном конкретном случае:

import selenium 
browser = selenium.webdriver.chrome.webdriver.WebDriver(executable_path='C:/Users/chromedriver') 

приводит к

AttributeError: module 'selenium' has no attribute 'webdriver'

Однако после 'Getting started' tutorial:

from selenium import webdriver 
driver = webdriver.Firefox() 

отлично работает. Это работает, потому что webdriver не является атрибутом для модуля selenium, но module itself. Это означает, что вы должны явно называть это, чтобы использовать его. (Это очень неявно указывается в верхней части страницы документации:. Рекомендуемые Импорт Стиль (показывая from selenium import webdriver))

Использование Google Chrome:

from selenium import webdriver 
driver = webdriver.Chrome('/path/to/chromedriver') # Optional argument, if not specified will search path. 

работает также хорошо, и этот пример дается Google itself.