How is fullclean command different from clean?

vishnumaiea · October 12, 2023, 2:45pm

I know what the clean command does. But what does the fullclean command do or how does it differ? A search for “fullclean” keyword in the PIO docs returned 0 results.

maxgerhardt · October 12, 2023, 2:54pm

github.com

platformio/platformio-core/blob/5548197a749fbba981fc09ca03e8ba8ccbb1981d/platformio/run/helpers.py#L21C1-L22


      
          KNOWN_CLEAN_TARGETS = ("clean",)
          KNOWN_FULLCLEAN_TARGETS = ("cleanall", "fullclean")

github.com

platformio/platformio-core/blob/5548197a749fbba981fc09ca03e8ba8ccbb1981d/platformio/builder/tools/piotarget.py#L58-L59


      
          if fullclean and os.path.isdir(libdeps_dir):
              _clean_dir(libdeps_dir)

github.com

platformio/platformio-core/blob/5548197a749fbba981fc09ca03e8ba8ccbb1981d/platformio/platform/_run.py#L70-L95


      
          def _run_scons(self, variables, targets, jobs):
              scons_dir = get_core_package_dir("tool-scons")
              args = [
                  proc.get_pythonexe_path(),
                  os.path.join(scons_dir, "scons.py"),
                  "-Q",
                  "--warn=no-no-parallel-support",
                  "--jobs",
                  str(jobs),
                  "--sconstruct",
                  os.path.join(fs.get_source_dir(), "builder", "main.py"),
              ]
              args.append("PIOVERBOSE=%d" % int(self.verbose))
              # pylint: disable=protected-access
              args.append("ISATTY=%d" % int(click._compat.isatty(sys.stdout)))
              # encode and append variables
              for key, value in variables.items():
                  args.append("%s=%s" % (key.upper(), self.encode_scons_arg(value)))
          
              if set(KNOWN_CLEAN_TARGETS + KNOWN_FULLCLEAN_TARGETS) & set(targets):

This file has been truncated. show original

vishnumaiea · October 12, 2023, 2:58pm

So fullclean clears the libdeps in addition to build files. That’s another way to find documentation Maybe we should also add the command to the official docs next to the clean command?