Новый перевод английской версии сайта

pages/en/Pars_EN.md

@@ -1,42 +1,55 @@
 ### Working with Pars
 
-This class is designed to work with requests and the resulting html page.
+This class is designed for handling requests and the obtained HTML page.
 
-The Pars class does not take any arguments for its constructors.
+The Pars class does not accept any data for its constructor.
 
-```python
+```py
 from ipars import Pars
 
 p = Pars()
 ```
 
-### Brief Overview of Pars Methods
+### Brief Overview of Pars Methods:
 
-1. The **getStaticPage** method takes the URL of the page, the path where the page will be saved, the write method, and request headers. The "wb" write method is used for saving images; by default, the write method is set to "w", which is used for HTML pages. If request headers are not specified, random user-agent headers will be used. The method returns the status response from the website, which should be used for conducting checks.
-2. The **getDynamicPage** method uses the Selenium library to get a dynamically updated page. This is useful when content on the page loads dynamically. It takes the URL of the page, the save path, closeWindow, and timeSleep. By default, the Selenium browser opens in the background, and its operation is not visible, but if closeWindow is set to False, the code execution process will be shown. The timeSleep parameter can extend the page load time if content takes long to load.
-3. The **gpsa** (get page semi-automatically) method is similar to the getDynamicPage method but works in a semi-automatic mode. It opens the webpage and waits until Enter is pressed in the terminal. During this time, you can register on the site and/or switch to the desired tab on the site, after which pressing Enter will allow the method to parse the page. This is suitable for social media feeds where unauthorized users have limited access to content. It accepts the same arguments and serves the same purposes as getDynamicPage, except for closeWindow.
-4. The **returnBs4Object** method returns a BeautifulSoup object. It takes the path to the HTML page, converts its contents into a BeautifulSoup object, the file open encoding (default is UTF-8), and the parser type (default is lxml).
-5. The **getAttributes** method is used to retrieve a list of attributes from a list of BeautifulSoup objects. It takes a list of BeautifulSoup objects and the name of the attribute to be extracted from the elements of the list.
-6. The **getTexts** method is used to retrieve a list of text from a list of BeautifulSoup objects. It takes a list of BeautifulSoup objects and the needFix parameter. If this parameter is set to True, \n, \t, and spaces from the ends will be removed from the text.
-7. The **pprint** method is used for displaying variable values that have a high level of nesting. For example, if you have an array of objects, where another array of objects is used as the value of a key.
-8. The **mkdir** method is used to create a directory with the name nameDir if it does not already exist.
+- The **getStaticPage** method takes a URL of the page, the path where the page will be saved, the write method, and request headers. The write method "wb" is used for saving images; by default, the write method is set to "w", which is used for HTML pages. If the request headers are not specified, random user-agent headers will be used. The method returns the response status of the website, which can be used for checks.
+
+```py
+for index, url in enumerate(urlList):
+    if p.getStaticPage(url, f'./page{index}') == 404:
+        print('Failed to obtain the page: ', url)
+```
+
+- The **getDynamicPage** method uses the Selenium library to obtain dynamically updating pages. This helps when the content on the page loads dynamically. It takes the URL of the page, the saving path, closeWindow, and timeSleep. By default, the Selenium browser opens in the background, and the browser activity is not visible, but if closeWindow is set to False, the code execution process will be visible. The timeSleep parameter can be used to increase the loading time if the content takes a while to load.
+
+- The **gpsa** (get page semi-automatically) method is similar to the getDynamicPage method but operates in a semi-automatic mode. It opens the site page and waits for the Enter key to be pressed in the terminal. During this time, you can register on the site and/or switch to the desired tab, after which pressing Enter will allow the method to parse the page. It accepts the same arguments for the same purposes as getDynamicPage, except for closeWindow.
+
+- The **returnBs4Object** method returns a BeautifulSoup4 object. It takes the path to the HTML page, converts its content into a BeautifulSoup object, the file encoding (default is UTF-8), and the parser type (default is lxml).
+
+- The **getAttributes** method is used to obtain a list of attributes from a list of bs4 objects. It takes a list of bs4 objects and the name of the attribute to be extracted from the list elements.
+
+- The **getTexts** method is used to obtain a list of text from a list of bs4 objects. It takes a list of bs4 objects and the needFix parameter. If this parameter is set to True, \n, \t, and spaces from the ends will be removed from the text.
+
+- The **pprint** method is used to output the values of variables with significant nesting. For example, if you have an array of objects where the value of the key is another array of objects.
+
+- The **mkdir** method is used to create a folder with the name _nameDir_ if it does not already exist.
 
 ### Example Parser Using ipars:
 
 ```py
-# Read about the ProgressBarManager class below
+# About the ProgressBarManager class, read below
 from ipars import Pars, ProgressBarManager
 p = Pars()
 nameFile = 'index.html'
 
 # Getting the HTML page
-p.getDynamicPage(nameFile, 'https://duckduckgo.com/?q=greenhouse+social+technologies+youtube&iar=videos&atb=v454-1', closeWindow=0)
+p.getDynamicPage(nameFile, 'https://duckduckgo.com/?q=теплица+социальных+технологий+youtube&iar=videos&atb=v454-1', closeWindow=0)
 
-# Getting the BeautifulSoup object
+# Getting the BeautifulSoup Object
 soup = p.returnBs4Object(nameFile)
 
 # Finding all answer cards
-# The first results are those we want, while the rest are not. Therefore, we want the first 84 elements
+# The first results are what we wanted, and the rest are not. Therefore, we prefer to get the first 84 elements
 allCards = soup.find*all(class*='b_NgmZrVnRtV8MZMEjLs')[:84]
 
 # Getting all images
@@ -45,7 +58,7 @@ allImg = [card.find('img') for card in allCards]
 # Getting all links
 allSrc = p.getAttributes(allImg, 'src')
 
-# Creating the img folder if it doesn't already exist
+# Creating a folder img if it does not already exist
 nameFolder = 'img'
 p.mkdir(nameFolder)
 
@@ -60,19 +73,23 @@ bar.next()
 bar.finish()
 ```
 
-### Example Using getAttributes and getTexts Methods
+### Example Usage of _getAttributes_ and _getTexts_ Methods
 
 ```py
 from ipars import Pars
 p = Pars()
+nameFile = 'index.html'
 
-p.getStaticPage('./index.html', 'https://google.com')
-soup = p.returnBs4Object('./index.html')
+# download the page and get the object bs4 based on it
+p.getStaticPage(nameFile, 'https://google.com')
+soup = p.returnBs4Object(nameFile)
 
+# Getting the text
 allTegA = soup.find_all('a')
-a1 = p.getTexts(allTegA, needFix=1)
+textsFromA = p.getTexts(allTegA, needFix=1)
 p.pprint(a1)
 
-a2 = p.getAttributes(allTegA, 'href')
+# Getting the attribute href
+attributesFromA = p.getAttributes(allTegA, 'href')
 p.pprint(a2)
 ```