Codestyle & documentation

CURA-537

plugins/CuraProfileReader/CuraProfileReader.py

@@ -6,13 +6,13 @@ from UM.Logger import Logger
 from UM.Settings.Profile import Profile
 from UM.Settings.ProfileReader import ProfileReader
 
+
 ##  A plugin that reads profile data from Cura profile files.
 #
 #   It reads a profile from a .curaprofile file, and returns it as a profile
 #   instance.
 class CuraProfileReader(ProfileReader):
     ##  Initialises the cura profile reader.
-    #
     #   This does nothing since the only other function is basically stateless.
     def __init__(self):
         super().__init__()
@@ -24,7 +24,8 @@ class CuraProfileReader(ProfileReader):
     #   not be read or didn't contain a valid profile, \code None \endcode is
     #   returned.
     def read(self, file_name):
-        profile = Profile(machine_manager = Application.getInstance().getMachineManager(), read_only = False) #Create an empty profile.
+        # Create an empty profile.
+        profile = Profile(machine_manager = Application.getInstance().getMachineManager(), read_only = False)
         serialised = ""
         try:
             with open(file_name) as f:  # Open file for reading.
@@ -36,5 +37,6 @@ class CuraProfileReader(ProfileReader):
         try:
             profile.unserialise(serialised)
         except Exception as e:  # Parsing error. This is not a (valid) Cura profile then.
+            Logger.log("e", "Error while trying to parse profile: %s", str(e))
             return None
         return profile

plugins/CuraProfileWriter/CuraProfileWriter.py

@@ -6,6 +6,7 @@ from UM.Logger import Logger
 from UM.SaveFile import SaveFile
 from UM.Settings.ProfileWriter import ProfileWriter
 
+
 ##  Writes profiles to Cura's own profile format with config files.
 class CuraProfileWriter(ProfileWriter):
     ##  Writes a profile to the specified file path.

plugins/GCodeProfileReader/GCodeProfileReader.py

@@ -7,6 +7,7 @@ from UM.Settings.ProfileReader import ProfileReader
 from UM.Logger import Logger
 import re #Regular expressions for parsing escape characters in the settings.
 
+
 ##  A class that reads profile data from g-code files.
 #
 #   It reads the profile data from g-code files and stores it in a new profile.
@@ -47,20 +48,25 @@ class GCodeProfileReader(ProfileReader):
         prefix = ";SETTING_" + str(GCodeProfileReader.version) + " "
         prefix_length = len(prefix)
 
-        #Loading all settings from the file. They are all at the end, but Python has no reverse seek any more since Python3. TODO: Consider moving settings to the start?
+        # Loading all settings from the file.
+        # They are all at the end, but Python has no reverse seek any more since Python3.
+        # TODO: Consider moving settings to the start?
         serialised = ""  # Will be filled with the serialised profile.
         try:
             with open(file_name) as f:
                 for line in f:
                     if line.startswith(prefix):
-                        serialised += line[prefix_length : -1] #Remove the prefix and the newline from the line, and add it to the rest.
+                        # Remove the prefix and the newline from the line and add it to the rest.
+                        serialised += line[prefix_length : -1]
         except IOError as e:
             Logger.log("e", "Unable to open file %s for reading: %s", file_name, str(e))
             return None
 
-        #Unescape the serialised profile.
+        # Un-escape the serialised profile.
         pattern = re.compile("|".join(GCodeProfileReader.escape_characters.keys()))
-        serialised = pattern.sub(lambda m: GCodeProfileReader.escape_characters[re.escape(m.group(0))], serialised) #Perform the replacement with a regular expression.
+
+        # Perform the replacement with a regular expression.
+        serialised = pattern.sub(lambda m: GCodeProfileReader.escape_characters[re.escape(m.group(0))], serialised)
 
         # Apply the changes to the current profile.
         profile = Profile(machine_manager = Application.getInstance().getMachineManager(), read_only = False)

plugins/GCodeWriter/GCodeWriter.py

@@ -40,7 +40,8 @@ class GCodeWriter(MeshWriter):
         if gcode_list:
             for gcode in gcode_list:
                 stream.write(gcode)
-            profile = self._serialiseProfile(Application.getInstance().getMachineManager().getWorkingProfile()) #Serialise the profile and put them at the end of the file.
+            # Serialise the profile and put them at the end of the file.
+            profile = self._serialiseProfile(Application.getInstance().getMachineManager().getWorkingProfile())
             stream.write(profile)
             return True
 
@@ -62,11 +63,14 @@ class GCodeWriter(MeshWriter):
 
         # Escape characters that have a special meaning in g-code comments.
         pattern = re.compile("|".join(GCodeWriter.escape_characters.keys()))
-        serialised = pattern.sub(lambda m: GCodeWriter.escape_characters[re.escape(m.group(0))], serialised) #Perform the replacement with a regular expression.
+        # Perform the replacement with a regular expression.
+        serialised = pattern.sub(lambda m: GCodeWriter.escape_characters[re.escape(m.group(0))], serialised)
 
         # Introduce line breaks so that each comment is no longer than 80 characters. Prepend each line with the prefix.
         result = ""
-        for pos in range(0, len(serialised), 80 - prefix_length): #Lines have 80 characters, so the payload of each line is 80 - prefix.
+
+        # Lines have 80 characters, so the payload of each line is 80 - prefix.
+        for pos in range(0, len(serialised), 80 - prefix_length):
             result += prefix + serialised[pos : pos + 80 - prefix_length] + "\n"
         serialised = result