Changelog¶
Version 1.10.3¶
New:
Dependencies versions were bumped following multiple moderate CVE declared in transitive dependencies.
Version 1.10.1 and 1.10.2¶
Bugfixes:
1.10.1 was released to fix a packaging and installation problem (see `this issue <https://github.com/PyCQA/pylint-plugin-utils/issues/29`_ for a description of the problem).
However this caused a separate regression in packaging and installation #618
1.10.2 fixes both issues
Version 1.10.0¶
New:
Version 1.9.0¶
Version 1.8.4¶
Version 1.8.3¶
Version 1.8.2¶
Version 1.8.1¶
Let’s test faster.
Add support for Python 3.11:
Python 3.11 is between 10-60% faster than Python 3.10.
Version 1.8.0¶
File discovery fixes:
Finding paths and files to check has been replaced with a new version using pathlib
- this should not result in any changes,
except fixing an issue where pylint
and pydocstyle
were inspecting the same file or directory twice sometimes.
However it may cause slightly different orders or reduce these duplicate warnings.
The behavior of prospector should be unchanged, apart from some bugfixes related to the old file discovery mechanism.
Related bugs and PRs:
Other bugfixes:
Running prospector on a path not in the CWD (eg, ‘prospector /some/where/else’) will not cause exceptions, and will instead use absolute paths for message output
Autodetction of libraries, to automatically use pylint plugins, will no work on projects using a pyproject.toml ; also it has been turned on by default, it seemed to have accidentally been set to off by default some time ago.
Misc:
Prospector now runs on itself without generating errors after all linting warnings were fixed
Version 1.7.6¶
It’s a bugs life.
Fixes:
Fixed a problem where pylint was reporting the same message multiple times, because it was given a path to the file multiple times
The blending fix mentioned in the 1.7.5 release was actually not checked in by accident, this is there now.
Version 1.7.5¶
Just say no to bugs.
New:
Profile inheritance is now optional - appending a profile name with a
?
means that if it is not found, prospector will simply continue. Read the documentation here. Closes #161
Fixes:
Stopped the ProfileValidator tool raising errors about
pep8
andpep257
sections being unknown. Instead, they raise deprecated warnings.Blending works again - for example, pylint and pycodestyle errors representing the same thing are combined. After renaming pep8 to pycodestyle, this only worked when using legacy names.
Unrecognised Mypy options now raise an exception instead of silently carrying on - #455
Tidyup:
Lots of warnings fixed from running prospector on itself
Version 1.7.4¶
Mea culpa release
Fix
The effort to allow pylint configuration in pyproject.toml
to be used as an external config source (issue here) had the unintended side effect where any project using poetry would now use that configuration and thus would ignore the pylint configuration in the profile. This was true even if the pyproject.toml
had no pylint directives in it.
The behaviour has now been fixed where pylint will be configured using configuration from the profile first and then if any additional settings are found in a pylintrc
or pyproject.toml
or setup.cfg
then these will override the profile configuration, instead of replacing it entirely.
This also has the benefit of fixing #227.
Version 1.7.3¶
The war on bugs.
Fixes:
Autodetect now does not die if a user does not have permissions (related to #271 and #487)
Fixed that some pylint documentation warning messages were not correctly included in the list of documentation warnings to squash if doc warnings are not desired.
Fixed the exit code for prospector - it was always
0
after the move to using poetry for packaging instead of1
if errors were found (unless--zero-exit
) was used. This now exits with the correct code based on the documented (and previous) behaviour.Fix that
pep8
would overwrite instead of inherit from previouspycodestyle
blocks, same with pep257 - #491 (comment)Fix the pre-commit hook, as it could not run without being installed
[with_everything]
, due to the “NotAvailableTool” class not properly implementing the abstract base class.Improved documentation about the pre-commit hook as well to clarify its use better - #484
Version 1.7.2¶
More bugfixes!
Fixes:
Version 1.7.1¶
Lots of smaller bugfixes.
Fixes:
Prospector now configures pylint using settings found in
pyproject.toml
orsetup.cfg
, not only.pylintrc
- #485Fixed
--no-style-warnings
command line argument no longer warning after renamingpep8
topycodestyle
- #488Documentation is building again - #473
--with-tool
flag now respects - but overrides - tools disabled in profiles - #447Fixed crash with merging multiple import warnings - #477
Fixed segfault when analysing code using cartopy - #403
Version 1.7.0¶
This is mostly a “tidying up” release but some things have changed which may cause differences to output, hence the bump of the major version.
New:
Added a
--quiet
command line option to suppress all output. Useful if you just want to know the exit code of prospector for scripting.Removed the prospector “indent checker” since this is now no longer in pylint #482
Fixes:
Deprecation warning:
Tools
pep8
andpep257
have been renamed topycodestyle
andpydocstyle
respectively. This is because the tools themselves were renamed years ago - See #222.
Note that this means that prospector profiles and message output uses this new name instead of the old name, so you will need to update your configuration. The old names will still work, but this legacy behaviour will be removed in prospector 2.0
There is now a
--legacy-tool-names
flag for outputting pep8 or pep257 as the tool name when outputting errors. This is to be backwards compatible with any parsing logic; this flag is also deprecated and will go away in prospector 2.0
Tidying up internals
These are all internal prospector code quality improvements. Ideally, they should not be noticed by anybody as they are internal refactorings.
#467 - Removed nosetests, as nose is not compatible with Python 3.10 yet and the pytest tests were already doing the same thing
Tidied up the tox testing
Started adding some type hints to methods
Fixed lots of warnings raised by prospector when running prospector on itself…
Removed some old python2 compatibility code which is no longer needed now python2 is not supported at all
Fixed hyperlink formatting in this CHANGELOG to be RST (was never updated after converting from markdown)
Replaced os.path with pathlib.Path everywhere in prospector internals, to improve and simplify finding files to inspect. Theoretically this behaves in the same way as far as the user will see (please open a ticket if you notice anything obviously different)
Version 1.6.1¶
Update pyflakes to 2.* #454
Version 1.6.0¶
Fixed incompatible version specification of pylint-plugin-utils. This now requires pylint-django of at least 2.5. #478
note This release drops support for python 3.6.1
Version 1.5.3 and 1.5.3dev0 and 1.5.3.1¶
#465 Remove unnecessary configuration reset to fix pylint>=2.12 compatibility
Version 1.5.3.1 was needed to unpin the pylint dependency to actually use the fix for compatibility.
Version 1.5.2¶
#465 Bugfix release to pin pylint<2.12 because prospector’s internals were not compatible with it
Version 1.5.1¶
#438 Promoting pre-release to release as it appears to work
Version 1.5.0.1¶
#433 Attempted fix of flake8 dependency versioning conflict
Version 1.5.0¶
#436 Swapped out packaging to use poetry instead of setup.py and setuptools
Version 1.4.1¶
Version 1.4.0¶
Version 1.3.1¶
Version 1.3.0¶
Update pylint support to 2.5.2
Update pylint-django to 2.0.15
Update pyflakes support to 2.2.0
Update pycodestyle support to 2.6.0
Update pep8-naming support to 0.10.0
Update pyflakes to <2.3.0 and >=2.2.0
Update pycodestyle to <2.7.0 and >=2.6.0
Update vulture to 1.5
Drop Python 2 support
Add output-target field when merging profiles
Add support for [pycodestyle] external config section
Fix AttributeExceptionError being raised when ignore_paths is an integer
Use black on entire project
Add new pylint option: use_pylint_default_path_finder to make sure there’s an option to preserve pylint default behavior.
Update pyflakes error code list to the recent version
Version 1.2.0¶
Version 1.1.7¶
Version 1.1.6.4¶
Version 1.1.6.2¶
Version 1.1.6.1¶
#292 Adding pylint plugin dependencies back and fixing autodetect behaviour.
(note: .1 added as 1.1.6 upload to PyPI was broken)
Version 1.1.5¶
Version 1.1.4¶
#285 Fix dependency tree resolution - now insists on pep8-naming<=0.4.1 as later versions cause conflicting versions of flake8 to be installed.
Version 1.1.3¶
#279 Fix –show-profile crash
Version 1.1.2¶
Version 1.1.1¶
Removing pylint-common as a direct dependency as it does not add a lot of utility and is not kept up to date as much as other plugins
Version 1.1¶
Version 1.0¶
Version 0.12.11¶
#256 Match relative paths that giving different results when using –absolute-paths flag
Pin vulture version < 0.25
Version 0.12.10¶
Force pyroma >= 2.3
#236 Fix typo and update URLs in docs
Version 0.12.9¶
Version 0.12.8¶
Version 0.12.7¶
Enforcing pydocstyle >= 2.0.0 for API compatibility reliability
Version 0.12.6¶
Version 0.12.5¶
#207 Fixed missing ‘UnknownMessage’ exception caused by recent pylint submodule changes
Minor documentation formatting updates
#202 Ignoring .tox directories to avoid accidentally checking the code in there
#205 Fixes for compatibility with pylint 1.7+
#193 Fixes for compatibility with pylint 1.6+
#194 Fixes for compatibility with vulture 0.9+
#191 Fixes for compatibility with pydocstyle 1.1+
Version 0.12.4¶
Panicky stapling of pyroma dependency until prospector is fixed to not break with the new pyroma release
Version 0.12.3¶
Version 0.12.1¶
Version 0.12¶
#170 Changed from using pep257 to pydocstyle (which is what pep257 is now called)
#162 Properly warning about optional tools which are not installed
#166 Added vscode formatter
#153 Better pep257 support
#156 Better pyroma logging hack for when pyroma is not installed
#158 Fixed max-line-length command line option
Version 0.11.7¶
Wrapping all tools so that none can directly write to stdout/stderr, as this breaks the output format for things like json. Instead, it is captured and optionally included as a regular message.
Version 0.11.6¶
Yet more ‘dodgy’ encoding problem avoidance
Version 0.11.5¶
Including forgotten ‘python-targets’ value in profile serialization
Version 0.11.4¶
Prevented ‘dodgy’ tool from trying to analyse compressed text data
Version 0.11.3¶
Fixed encoding of file contents handling by tool “dodgy” under Python3
Version 0.11.2¶
Fixed a file encoding detection issue when running under Python3
If a pylint plugin is specified in a .pylintrc file which cannot be loaded, prospector will now carry on with a warning rather than simply crash
Version 0.11.1¶
#147 Fixed crash when trying to load pylint configuration files in pylint 1.5
Version 0.11¶
Compatibility fixes to work with pylint>=1.5
McCabe tool now reports correct line and character number for syntax errors (and therefore gets blended if pylint etc detects such an error)
Autodetect of libraries will now not search inside virtualenvironments
#142 better installation documentation in README (thanks @ExcaliburZero)
#141 profile-validator no longer complains about member-warnings (thanks @alefteris)
#140 emacs formatter includes character position (thanks @philroberts)
#138 docs fixed for ‘output-format’ profile option (thanks @faulkner)
#137 fixed various formatting issues in docs (thanks @danstender)
#132 Added support for custom flask linting thanks to the awesome [pylint-flask](https://github.com/jschaf/pylint-flask) plugin by [jschaf](https://github.com/jschaf)
#131, #134 Custom pylint plugins are now loaded from existing .pylintrc files if present (thanks @kaidokert and @antoviaque)
Version 0.10.2¶
Added information to summary to explain what external configuration was used (if any) to configure the underlying tools
Fixed supression-token search to use (or at least guess) correct file encoding
Version 0.10.1¶
#116 Comparison failed between messages with numeric values for character and those with a None value (thanks @smspillaz)
#118 Unified output of formatters to have correct output of str rather than bytes (thanks @prophile)
#115 Removed argparse as an explicit dependency as only Python 2.7+ is supported now
Version 0.10¶
#112 Profiles will now also be autoloaded from directories named .prospector.
#32 and #108 Added a new ‘xunit’ output formatter for tools and services which integrate with this format (thanks to [lfrodrigues](https://github.com/lfrodrigues))
Added a new built-in profile called ‘flake8’ for people who want to mimic the behaviour of ‘flake8’ using prospector.
Version 0.9.10¶
The profile validator would load any file whose name was a subset of ‘.prospector.yaml’ due to using the incorrect comparison operator.
Fixing a crash when using an empty ignore-patterns list in a profile.
Fixing a crash when a profile is not valid YAML at all.
#105 pyflakes was not correctly ignoring errors.
Version 0.9.9¶
pep8.py 1.6.0 added new messages, which are now in prospector’s built-in profiles
Version 0.9.8¶
Fixing a crash when using pep8 1.6.0 due to the pep8 tool renaming something that Prospector uses
Version 0.9.7¶
#104 The previous attempt at normalising bytestrings and unicode in Python 2 was clumsily done and a bit broken. It is hopefully now using the correct voodoo incantations to get characters from one place to another.
The blender combinations were not updated to use the new PyFlakes error codes; this is now fixed.
Version 0.9.6¶
The profile validator tool was always outputting absolute paths in messages. This is now fixed.
The “# NOQA” checking was using absolute paths incorrectly, which meant the message locations (with relative paths) did not match up and no messages were suppressed.
Version 0.9.5¶
Fixed a problem with profile serialising where it was using the incorrect dict value for strictness
Version 0.9.4¶
The previous PEP257 hack was not compatible with older versions of pep257.
Version 0.9.3¶
The PEP257 tool sets a logging level of DEBUG globally when imported as of version 0.4.1, and this causes huge amounts of tokenzing debug to be output. Prospector now has a hacky workaround until that is fixed.
Extra profile information (mainly the shorthand information) is kept when parsing and serializing profiles.
Version 0.9.2¶
There were some problems related to absolute paths when loading profiles that were not in the current working directory.
Version 0.9.1¶
Mandating version 0.2.3 of pylint-plugin-utils, as the earlier ones don’t work with the add_message API changes made in pylint 1.4+
Version 0.9¶
#102 By default, prospector will hide pylint’s “no-member” warnings, because more often than not they are simply incorrect. They can be re-enabled with the ‘–member-warnings’ command line flag or the ‘member-warnings: true’ profile option.
#101 Code annotated with pep8/flake8 style “# noqa” comments is now understood by prospector and will lead to messages from other tools being suppressed too.
#100 Pyflakes error codes have been replaced with the same as those used in flake8, for consistency. Profiles with the old values will still work, and the profile-validator will warn you to upgrade.
Messages now use Pylint error symbols (‘star-args’) instead of codes (‘W0142’). This makes it much more obvious what each message means and what is happening when errors are suppressed or ignored in profiles. The old error codes will continue to work in profiles.
The way that profiles are handled and parsed has completely been rewritten to avoid several bugs and introduce ‘shorthand’ options to profiles. This allows profiles to specify simple options like ‘doc-warnings: true’ inside profiles and configure anything that can be configured as a command line argument. Profiles can now use options like ‘strictness: high’ or ‘doc-warnings: true’ as a shortcut for inheriting the built-in prospector profiles.
A new –show-profile option is available to dump the calculated profile, which is helpful for figuring out what prospector thinks it is doing.
Profiles now have separate ignore-paths and ignore-patterns directives to match the command line arguments. The old ignore directive remains in place for backwards compatibility and will be deprecated in the future.
A new tool, profile-validator, has been added. It simply checks prospector profiles and validates the settings, providing warnings if any are incorrect.
#89 and #40 - profile merging was not behaving exactly as intended, with later profiles not overriding earlier profiles. This is now fixed as part of the aforementioned rewrite.
pep257 is now included by default; however it will not run unless the ‘–doc-warnings’ flag is used.
pep257 messages are now properly blended with other tools’ documentation warnings
Path and output character encoding is now handled much better (which is to say, it is handled; previously it wasn’t at all).
Version 0.8.3¶
Version 0.8.2¶
Version loading in setup.py no longer imports the prospector module (which could lead to various weirdnesses when installing on different platforms)
#82 resolves regression in adapter library detection raising,
ValueError: too many values to unpack
. provided by @jquast#83 resolves regression when adapter library detects django,
TypeError: '_sre.SRE_Pattern' object is not iterable
. provided by @jquast
Version 0.8.1¶
Strictness now also changes which pep257 messages are output
pep257 and vulture messages are now combined and ‘blended’ with other tools
#80 Fix for Python3 issue when detecting libraries, provided by @smspillaz
Version 0.8¶
Demoted frosted to be an optional tool - this is because development seems to have slowed and pyflakes has picked up again, and frosted how has several issues which are solved by pyflakes and is no longer a useful addition.
#78 Prospector can now take multiple files as a path argument, thus providing errors for several files at a time. This helps when integrating with IDEs, for example.
Upgrading to newer versions of Pylint and related dependencies resolves #73, #75, #76 and #79
#74, #10 Tools will now use any configuration specific to them by default. That is to say, if a .pylintrc file exists, then that will be used in preference to prospector’s own opinions of how to use pylint.
Added centralised configuration management, with an abstraction away from how prospector and each tool is actually configured.
Removed the “adaptors” concept. This was a sort of visitor pattern in which each tool’s configuration could be updated by an adaptor, which ‘visited’ the tool to tweak settings based on what the adaptor represented. In practise this was not useful and a confusing way to tweak behaviour - tools now configure themselves based on configuration options directly.
Changed the default output format to be ‘grouped’ rather than ‘text’
Support for Python 2.6 has been dropped, following Pylint’s lead.
Using pylint 1.4’s ‘unsafe’ mode, which allows it to load any C extensions (this was the behaviour for 1.3 and below). Not loading them causes many many inference errors.
#65 Resolve UnicodeDecodeErrors thrown while attempting to auto-discover modules of interest by discovering target python source file encoding (PEP263), and issuing only a warning if it fails (thanks to [Jeff Quast](https://github.com/jquast)).
Version 0.7.3¶
Pylint dependency version restricted to 1.3, as 1.4 drops support for Python 2.6. Prospector will drop support for Python 2.6 in a 0.8 release.
File names ending in ‘tests.py’ will now be ignored if prospector is set to ignore tests (previously, the regular expression only ignored files ending in ‘test.py’)
#70 Profiles starting with a .yml extension can now be autoloaded
#62 For human readable output, the summary of messages will now be printed at the end rather than at the start, so the summary will be what users see when running prospector (without piping into less etc)
Version 0.7.2¶
The E265 error from PEP8 - “Block comment should start with ‘# ‘” - has been disabled for anything except veryhigh strictness.
Version 0.7.1¶
#60 Prospector did not work with Python2.6 due to timedelta.total_seconds() not being available.
Restored the behaviour where std_out/std_err from pylint is suppressed
Version 0.7¶
#48 If a folder is detected to be a virtualenvironment, then prospector will not check the files inside.
#31 Prospector can now check single files if passed a module as the path argument.
#50 Prospector now uses an exit code of 1 to indicate that messages were found, to make it easier for bash scripts and so on to fail if any messages are found. A new flag, -0 or –zero-exit, turns off this behaviour so that a non-zero exit code indicates that prospector failed to run.
Profiles got an update to make them easier to understand and use. They are mostly the same as before, but the documentation and command line arguments have improved so that they can be reliably used.
If a directive inline in code disables a pylint message, equivalent messages from other tools will now also be disabled.
Added optional tools - additional tools which are not enabled by default but can be activated if the user chooses to.
Added pyroma, a tool for validating packaging metadata, as an optional tool.
#29 Added support for pep257, a docstring format checker
#45 Added vulture, a tool for finding dead code, as an optional tool.
#24 Added Sphinx documentation, which is now also available on ReadTheDocs
Version 0.6.4¶
Fixed pylint system path munging again again
Version 0.6.3¶
Fixed dodgy tool’s use of new file finder
Version 0.6.2¶
Fixed pylint system path munging again
Version 0.6.1¶
Fixed pylint system path munging
Version 0.6¶
Module and package finding has been centralised into a finder.py module, from which all tools take the list of files to be inspected. This helps unify which files get inspected, as previously there were several times when tools were not correctly ignoring files.
Frosted [cannot handle non-utf-8 encoded files](https://github.com/timothycrosley/frosted/issues/56) so a workaround has been added to simply ignore encoding errors raised by Frosted until the bug is fixed. This was deemed okay as it is very similar to pyflakes in terms of what it finds, and pyflakes does not have this problem.
#43 - the blender is now smarter, and considers that a message may be part of more than one ‘blend’. This means that some messages are no longer duplicated.
#42 - a few more message pairs were cleaned up, reducing ambiguity and redundancy
#33 - there is now an output format called pylint which mimics the pylint –parseable output format, with the slight difference that it includes the name of the tool as well as the code of the message.
#37 - profiles can now use the extension .yml as well as .yaml
#34 - south migrations are ignored if in the new south name of south_migrations (ie, this is compatible with the post-Django-1.7 world)
Version 0.5.6 / 0.5.5¶
The pylint path handling was slightly incorrect when multiple python modules were in the same directory and importing from each other, but no __init__.py package was present. If modules in such a directory imported from each other, pylint would crash, as the modules would not be in the sys.path. Note that 0.5.5 was released but this bugfix was not correctly merged before releasing. 0.5.6 contains this bugfix.
Version 0.5.4¶
Fixing a bug in the handling of relative/absolute paths in the McCabe tool
Version 0.5.3¶
##### New Features
Python 3.4 is now tested for and supported
##### Bug Fixes
Module-level attributes can now be documented with a string without triggering a “String statement has no effect” warning
#28 Fixed absolute path bug with Frosted tool
Version 0.5.2¶
##### New Features
Support for new error messages introduced in recent versions of pep8 and pylint was included.
Version 0.5.1¶
##### New Features
All command line arguments can now also be specified in a tox.ini and setup.cfg (thanks to [Jason Simeone](https://github.com/jayclassless))
–max-line-length option can be used to override the maximum line length specified by the chosen strictness
##### Bug Fixes
#17 Prospector generates messages if in a path containing a directory beginning with a . - ignore patterns were previously incorrectly being applied to the absolute path rather than the relative path.
#12 Library support for Django now extends to all tools rather than just pylint
Some additional bugs related to ignore paths were squashed.
Version 0.5¶
Files and paths can now be ignored using the –ignore-paths and –ignore-patterns arguments.
Full PEP8 compliance can be turned on using the –full-pep8 flag, which overrides the defaults in the strictness profile.
The PEP8 tool will now use existing config if any is found in .pep8, tox.ini, setup.cfg in the path to check, or ~/.config/pep8. These will override any other configuration specified by Prospector. If none are present, Prospector will fall back on the defaults specified by the strictness.
A new flag, –external-config, can be used to tweak how PEP8 treats external config. only, the default, means that external configuration will be preferred to Prospector configuration. merge means that Prospector will combine external configuration and its own values. none means that Prospector will ignore external config.
The –path command line argument is no longer required, and Prospector can be called with prospector path_to_check.
Pylint version 1.1 is now used.
Prospector will now run under Python3.
Version 0.4.1¶
Additional blending of messages - more messages indicating the same problem from different tools are now merged together
Fixed the maximum line length to 160 for medium strictness, 100 for high and 80 for very high. This affects both the pep8 tool and pylint.
Version 0.4¶
Added a changelog
Added support for the dodgy codebase checker
Added support for pep8 (thanks to Jason Simeone)
Added support for pyflakes (thanks to Jason Simeone)
Added support for mccabe (thanks to Jason Simeone)
Replaced Pylint W0312 with a custom checker. This means that warnings are only generated for inconsistent indentation characters, rather than warning if spaces were not used.
Some messages will now be combined if Pylint generates multiple warnings per line for what is the same cause. For example, ‘unused import from wildcard import’ messages are now combined rather than having one message per unused import from that line.
Messages from multiple tools will be merged if they represent the same problem.
Tool failure no longer kills the Prospector process but adds a message instead.
Tools can be enabled or disabled from profiles.
All style warnings can be suppressed using the
--no-style-warnings
command line switch.Uses a newer version of pylint-django for improved analysis of Django-based code.