--- a/src/eric7/Utilities/FtpUtilities.py Wed Jul 13 11:16:20 2022 +0200
+++ b/src/eric7/Utilities/FtpUtilities.py Wed Jul 13 14:55:47 2022 +0200
@@ -18,6 +18,7 @@
"""
Exception class raised, if a parser issue was detected.
"""
+
pass
@@ -25,6 +26,7 @@
"""
Class to parse lines returned by a FTP LIST command.
"""
+
MonthnamesNumbers = {
"jan": 1,
"feb": 2,
@@ -39,66 +41,62 @@
"nov": 11,
"dec": 12,
}
-
+
def __init__(self, parent=None):
"""
Constructor
-
+
@param parent reference to the parent object (QObject)
"""
super().__init__(parent)
-
+
self.__parseLine = self.__parseUnixLine
self.__modeSwitchAllowed = True
-
+
def __ignoreLine(self, line):
"""
Private method to check, if the line should be ignored.
-
+
@param line to check (string)
@return flag indicating to ignore the line (boolean)
"""
- return (
- line.strip() == "" or
- line.strip().lower().startswith("total ")
- )
-
+ return line.strip() == "" or line.strip().lower().startswith("total ")
+
def __parseUnixMode(self, modeString, urlInfo):
"""
Private method to parse a Unix mode string modifying the
given URL info object.
-
+
@param modeString mode string to be parsed (string)
@param urlInfo reference to the URL info object (EricUrlInfo)
@exception FtpDirLineParserError Raised if the mode cannot be parsed.
"""
if len(modeString) != 10:
- raise FtpDirLineParserError(
- "invalid mode string '{0}'".format(modeString))
-
+ raise FtpDirLineParserError("invalid mode string '{0}'".format(modeString))
+
modeString = modeString.lower()
-
+
permission = 0
- if modeString[1] != '-':
+ if modeString[1] != "-":
permission |= EricUrlPermission.READ_OWNER
- if modeString[2] != '-':
+ if modeString[2] != "-":
permission |= EricUrlPermission.WRITE_OWNER
- if modeString[3] != '-':
+ if modeString[3] != "-":
permission |= EricUrlPermission.EXE_OWNER
- if modeString[4] != '-':
+ if modeString[4] != "-":
permission |= EricUrlPermission.READ_GROUP
- if modeString[5] != '-':
+ if modeString[5] != "-":
permission |= EricUrlPermission.WRITE_GROUP
- if modeString[6] != '-':
+ if modeString[6] != "-":
permission |= EricUrlPermission.EXE_GROUP
- if modeString[7] != '-':
+ if modeString[7] != "-":
permission |= EricUrlPermission.READ_OTHER
- if modeString[8] != '-':
+ if modeString[8] != "-":
permission |= EricUrlPermission.WRITE_OTHER
- if modeString[9] != '-':
+ if modeString[9] != "-":
permission |= EricUrlPermission.EXE_OTHER
urlInfo.setPermissions(permission)
-
+
if modeString[0] == "d":
urlInfo.setDir(True)
urlInfo.setFile(False)
@@ -111,12 +109,12 @@
urlInfo.setDir(False)
urlInfo.setFile(True)
urlInfo.setSymLink(False)
-
+
def __parseUnixTime(self, monthAbbreviation, day, yearOrTime, urlInfo):
"""
Private method to parse a Unix date and time indication modifying
the given URL info object.
-
+
Date time strings in Unix-style directory listings typically
have one of these formats:
@@ -124,7 +122,7 @@
<li>"Nov 23 02:33" (month name, day of month, time)</li>
<li>"May 26 2005" (month name, day of month, year)</li>
</ul>
-
+
@param monthAbbreviation abbreviation of the month name (string)
@param day day of the month (string)
@param yearOrTime string giving the year or a time (string)
@@ -133,33 +131,32 @@
not recognized.
"""
try:
- month = FtpDirLineParser.MonthnamesNumbers[
- monthAbbreviation.lower()]
+ month = FtpDirLineParser.MonthnamesNumbers[monthAbbreviation.lower()]
except KeyError:
raise FtpDirLineParserError(
- "illegal month abbreviation '{0}'".format(
- monthAbbreviation))
+ "illegal month abbreviation '{0}'".format(monthAbbreviation)
+ )
day = int(day)
- if ':' in yearOrTime:
+ if ":" in yearOrTime:
year = QDate.currentDate().year()
- hour, minute = yearOrTime.split(':')
+ hour, minute = yearOrTime.split(":")
hour = int(hour)
minute = int(minute)
else:
year = int(yearOrTime)
hour = 0
minute = 0
-
+
lastModified = QDateTime(QDate(year, month, day), QTime(hour, minute))
urlInfo.setLastModified(lastModified)
-
+
def __splitUnixLine(self, line):
"""
Private method to split a line of a Unix like directory listing.
-
+
It splits the line into meta data, number of links, user, group, size,
month, day, year or time and name.
-
+
@param line directory line to split (string)
@return tuple of nine strings giving the meta data,
number of links, user, group, size, month, day, year or time
@@ -173,9 +170,8 @@
fieldCountWithoutUserID = 8
fieldCountWithUserID = fieldCountWithoutUserID + 1
if len(lineParts) < fieldCountWithoutUserID:
- raise FtpDirLineParserError(
- "line '{0}' cannot be parsed".format(line))
-
+ raise FtpDirLineParserError("line '{0}' cannot be parsed".format(line))
+
# If we have a valid format (either with or without user id field),
# the field with index 5 is either the month abbreviation or a day.
try:
@@ -188,23 +184,31 @@
lineParts = line.split(None, fieldCountWithoutUserID - 1)
userFieldIndex = 2
lineParts.insert(userFieldIndex, "")
-
+
return lineParts
-
+
def __parseUnixLine(self, line):
"""
Private method to parse a Unix style directory listing line.
-
+
@param line directory line to be parsed (string)
@return URL info object containing the valid data (EricUrlInfo)
"""
- modeString, nlink, user, group, size, month, day, yearOrTime, name = (
- self.__splitUnixLine(line)
- )
-
+ (
+ modeString,
+ nlink,
+ user,
+ group,
+ size,
+ month,
+ day,
+ yearOrTime,
+ name,
+ ) = self.__splitUnixLine(line)
+
if name in [".", ".."]:
return None
-
+
urlInfo = EricUrlInfo()
self.__parseUnixMode(modeString, urlInfo)
self.__parseUnixTime(month, day, yearOrTime, urlInfo)
@@ -216,9 +220,9 @@
if i >= 0:
name = name[:i]
urlInfo.setName(name)
-
+
return urlInfo
-
+
def __parseWindowsTime(self, date, time, urlInfo):
"""
Private method to parse a Windows date and time indication modifying
@@ -227,7 +231,7 @@
Date time strings in Windows-style directory listings typically
have the format "10-23-12 03:25PM" (month-day_of_month-two_digit_year,
hour:minute, am/pm).
-
+
@param date date string (string)
@param time time string (string)
@param urlInfo reference to the URL info object (EricUrlInfo)
@@ -235,30 +239,28 @@
recognized.
"""
try:
- month, day, year = [int(part) for part in date.split('-')]
+ month, day, year = [int(part) for part in date.split("-")]
year = 1900 + year if year >= 70 else 2000 + year
except (ValueError, IndexError):
- raise FtpDirLineParserError(
- "illegal date string '{0}'".format(month))
+ raise FtpDirLineParserError("illegal date string '{0}'".format(month))
try:
hour, minute, am_pm = time[0:2], time[3:5], time[5]
hour = int(hour)
minute = int(minute)
except (ValueError, IndexError):
- raise FtpDirLineParserError(
- "illegal time string '{0}'".format(month))
- if hour == 12 and am_pm == 'A':
+ raise FtpDirLineParserError("illegal time string '{0}'".format(month))
+ if hour == 12 and am_pm == "A":
hour = 0
- if hour != 12 and am_pm == 'P':
+ if hour != 12 and am_pm == "P":
hour += 12
-
+
lastModified = QDateTime(QDate(year, month, day), QTime(hour, minute))
urlInfo.setLastModified(lastModified)
-
+
def __parseWindowsLine(self, line):
"""
Private method to parse a Windows style directory listing line.
-
+
@param line directory line to be parsed (string)
@return URL info object containing the valid data (EricUrlInfo)
@exception FtpDirLineParserError Raised if the line is not of a
@@ -268,12 +270,11 @@
date, time, dirOrSize, name = line.split(None, 3)
except ValueError:
# "unpack list of wrong size"
- raise FtpDirLineParserError(
- "line '{0}' cannot be parsed".format(line))
-
+ raise FtpDirLineParserError("line '{0}' cannot be parsed".format(line))
+
if name in [".", ".."]:
return None
-
+
urlInfo = EricUrlInfo()
self.__parseWindowsTime(date, time, urlInfo)
if dirOrSize.lower() == "<dir>":
@@ -285,48 +286,50 @@
try:
urlInfo.setSize(int(dirOrSize))
except ValueError:
- raise FtpDirLineParserError(
- "illegal size '{0}'".format(dirOrSize))
+ raise FtpDirLineParserError("illegal size '{0}'".format(dirOrSize))
urlInfo.setName(name)
-
+
ext = os.path.splitext(name.lower())[1]
urlInfo.setSymLink(ext == ".lnk")
-
+
permissions = (
- EricUrlPermission.READ_OWNER | EricUrlPermission.WRITE_OWNER |
- EricUrlPermission.READ_GROUP | EricUrlPermission.WRITE_GROUP |
- EricUrlPermission.READ_OTHER | EricUrlPermission.WRITE_OTHER
+ EricUrlPermission.READ_OWNER
+ | EricUrlPermission.WRITE_OWNER
+ | EricUrlPermission.READ_GROUP
+ | EricUrlPermission.WRITE_GROUP
+ | EricUrlPermission.READ_OTHER
+ | EricUrlPermission.WRITE_OTHER
)
if ext in [".exe", ".com", ".bat", ".cmd"]:
permissions |= (
- EricUrlPermission.EXE_OWNER |
- EricUrlPermission.EXE_GROUP |
- EricUrlPermission.EXE_OTHER
+ EricUrlPermission.EXE_OWNER
+ | EricUrlPermission.EXE_GROUP
+ | EricUrlPermission.EXE_OTHER
)
urlInfo.setPermissions(permissions)
-
+
return urlInfo
-
+
def parseLine(self, line):
"""
Public method to parse a directory listing line.
-
+
This implementation support Unix and Windows style directory
listings. It tries Unix style first and if that fails switches
to Windows style. If that fails as well, an exception is raised.
-
+
@param line directory line to be parsed (string)
@return URL info object containing the valid data (EricUrlInfo)
"""
if self.__ignoreLine(line):
return None
-
+
try:
return self.__parseLine(line)
except FtpDirLineParserError:
if not self.__modeSwitchAllowed:
raise
-
+
self.__parseLine = self.__parseWindowsLine
self.__modeSwitchAllowed = False
return self.__parseLine(line)
