A passive Python syntax checker
Frosted is a fork of pyflakes (originally created by Phil Frost) that aims at more open contribution from the outside public, a smaller more maintainable code base, and a better Python checker for all. It currently cleanly supports Python 2.6 - 3.4 using pies (https://github.com/timothycrosley/pies) to achieve this without ugly hacks and/or py2to3.
Installing Frosted is as simple as:
pip install frosted --upgrade
or if you prefer
from the command line:
frosted mypythonfile.py mypythonfile2.py
frosted -r .
which is equivalent to
or to read from stdin:
from within Python:
import frosted frosted.api.check_path("pythonfile.py")
Using any of the following methods will result in a quick resolution to any issue you may have with Frosted or a quick response to any implementation detail you wish to discuss. - Mailing List - best place to discuss large architectural changes or changes that effect that may effect Python code-quality projects beyond Frosted. - Github issues - best place to report bugs, ask for concretely defined features, and even ask for general help. - firstname.lastname@example.org - feel free to email me any questions or concerns you have that you don’t think would benefit from community wide involvement.
The following improvements have already been implemented into Frosted
And it will only get better from here on out!
If you find the default frosted settings do not work well for your project, frosted provides several ways to adjust the behavior.
To configure frosted for a single user create a ~/.frosted.cfg file:
[settings] skip=file3.py,file4.py ignore_frosted_errors=E101,E205,E300 run_doctests=True
Additionally, you can specify project level configuration simply by placing a .frosted.cfg file at the root of your project. frosted will look up to 25 directories up, from the one it is ran, to find a project specific configuration.
You can then override any of these settings by using command line arguments, or by passing in kwargs into any of the exposed api checking methods.
Beyond that, frosted supports setup.cfg based configuration. All you need to do is add a [frosted] section to your project’s setup.cfg file with any desired settings.
Finally, frosted supports editorconfig files using the standard syntax defined here: http://editorconfig.org/
Meaning You can place any standard frosted configuration parameters within a .editorconfig file under the *.py section and they will be honored.
Frosted recognizes the following errors when present within your code. You can use the ‘ignore_frosted_errors’ setting to specify any errors you want Frosted to ignore. If you specify the series error code (ex: E100) all errors in that series will be ignored.
I100 Series - General Information - I101: Generic
E100 Series - Import Errors - E101: UnusedImport - Note that it is common practice to import something and not use it for the purpose of exposing it as an API, or using it in an exec statment below. Frosted tries to circumvent most of this by ignoring this error by default in init.py - E102: ImportShadowedByLoopVar - E103: ImportStarUsed
E200 Series - Function / Method Definition and Calling Errors - E201: MultipleValuesForArgument - E202: TooFewArguments - E203: TooManyArguments - E204: UnexpectedArgument - E205: NeedKwOnlyArgument - E206: DuplicateArgument - E207: LateFutureImport - E208: ReturnWithArgsInsideGenerator
E300 Series - Variable / Definition Usage Errors - E301: RedefinedWhileUnused - E302: RedefinedInListComp - E303: UndefinedName - E304: UndefinedExport - E305: UndefinedLocal - E306: Redefined - E307: UnusedVariable
E400 Series - Syntax Errors - E401: DoctestSyntaxError - E402: PythonSyntaxError
W100 Series - Exception Warning - W101: BareExcept - Note that one common case where a bare except is okay, and should be ignored is when handling the rollback of database transactions. In this or simular cases the warning can safely be ignored.
W200 Series - Handling Warning - W201: FileSkipped
When deciding whether or not to include an error for reporting, Frosted uses the 99% approach as a yard stick. If it is agreed that 99% of the time (or more) that a pattern occurs it’s an error, Frosted will report on it, if not it will not be added to the Frosted project.
Frosted exposes a simple API for checking Python code from withing other Python applications or plugins.
Additionally, you can use the command line tool in an API fashion, by passing ‘-‘ in as the filename and then sending file content to stdin.
Integration with text editors and tools is a priority for the project. As such, any pull request that adds integration support or links to a third-party project that does will be enthusiastically accepted.
Current list of known supported text-editors:
Our preferred contributions come in the form of pull requests and issue reports. That said, we will not deny monetary contributions. If you desire to do this using flattr etc, please make sure you flattr @bitglue as he is the original creator of pyflakes and without his contribution Frosted would not be possible.
Pyflakes was a great project, and introduced a great approach for quickly checking for Python coding errors. I am very grateful to the original creators. However, I feel over the last year it has become stagnant, without a clear vision and someone willing to take true ownership of the project. While I know it is in no way intentional, critical failures have stayed open, despite perfectly complete and valid pull-requests open, without so much as an acknowledgement from the maintainer. As I genuinely believe open source projects need constant improvement (releasing early and often), I decided to start this project and look for as much input as possible from the Python community. I’m hoping together we can build an even more awesome code checker!
Note: the maintainer of pyflakes has been added as a contributer to frosted.
Frosted is a homage to the original pyflakes creator Phil Frost.
Thanks and I hope you enjoy the new Frosted pyflakes!
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|frosted-1.4.1-py2.py3-none-any.whl (50.5 kB) Copy SHA256 Checksum SHA256||2.7||Wheel||Apr 24, 2014|
|frosted-1.4.1.tar.gz (36.4 kB) Copy SHA256 Checksum SHA256||–||Source||Apr 24, 2014|