3:36 p.m.
Add .flake8 configuration file enabling show_source and statistics. This
makes flake8 output more useful for handling bug reports like:
https://gitlab.com/nbdkit/libnbd/-/issues/4
For example I added some bad changes:
$ sh pycodestyle.sh
...
python/nbdsh.py:20:1: F401 'unused' imported but unused
import unused
^
python/nbdsh.py:22:1: E302 expected 2 blank lines, found 1
def bad_function():
^
python/nbdsh.py:24:80: E501 line too long (87 > 79 characters)
"""
bad doctring. bad doctring. bad doctring. bad doctring. bad doctring. bad
doctring.
"""
^
/home/nsoffer/src/libnbd/python/nbdsh.py:28:1: E302 expected 2 blank lines, found 1
def shell():
^
2 E302 expected 2 blank lines, found 1
1 E501 line too long (87 > 79 characters)
1 F401 'unused' imported but unused
Signed-off-by: Nir Soffer <nsoffer(a)redhat.com>
---
python/.flake8 | 6 ++++++
1 file changed, 6 insertions(+)
create mode 100644 python/.flake8
diff --git a/python/.flake8 b/python/.flake8
new file mode 100644
index 0000000..0e1dec1
--- /dev/null
+++ b/python/.flake8
@@ -0,0 +1,6 @@
+[flake8]
+# Print the source code generating the error/warning in question.
+show_source = True
+
+# Count the number of occurrences of each error/warning code and print a report.
+statistics = True
--
2.26.3
2:26 a.m.
On Sun, Apr 25, 2021 at 11:36:15PM +0300, Nir Soffer wrote:
Add .flake8 configuration file enabling show_source and statistics.
This
makes flake8 output more useful for handling bug reports like:
https://gitlab.com/nbdkit/libnbd/-/issues/4
...
python/.flake8 | 6 ++++++
I suspect this will be ignored if we're using srcdir != builddir (not
that this works at the moment). The documentation is confusing about
how exactly the file is found mentioning only the "project" directory
whatever that means.
https://flake8.pycqa.org/en/latest/user/configuration.html
Should we add the equivalent command line parameters instead?
Anyway, as it's only optional configuration, ACK.
Rich.
1 file changed, 6 insertions(+)
create mode 100644 python/.flake8
diff --git a/python/.flake8 b/python/.flake8
new file mode 100644
index 0000000..0e1dec1
--- /dev/null
+++ b/python/.flake8
@@ -0,0 +1,6 @@
+[flake8]
+# Print the source code generating the error/warning in question.
+show_source = True
+
+# Count the number of occurrences of each error/warning code and print a report.
+statistics = True
--
2.26.3
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-p2v converts physical machines to virtual machines. Boot with a
live CD or over the network (PXE) and turn machines into KVM guests.
http://libguestfs.org/virt-v2v
5:24 a.m.
On Mon, Apr 26, 2021 at 10:26 AM Richard W.M. Jones <rjones(a)redhat.com> wrote:
On Sun, Apr 25, 2021 at 11:36:15PM +0300, Nir Soffer wrote:
> Add .flake8 configuration file enabling show_source and statistics. This
> makes flake8 output more useful for handling bug reports like:
> https://gitlab.com/nbdkit/libnbd/-/issues/4
...
> python/.flake8 | 6 ++++++
I suspect this will be ignored if we're using srcdir != builddir (not
that this works at the moment). The documentation is confusing about
how exactly the file is found mentioning only the "project" directory
whatever that means.
I think .flake8 file is searched in the directories where the source is,
so this should work also in out of tree builds. This works for me for pytest
in another project using out of tree build.
https://flake8.pycqa.org/en/latest/user/configuration.html
Should we add the equivalent command line parameters instead?
We can, but using a configuration file makes it easier to document why
certain configuration is used. For example why you want to disable certain
checks.
When you have a configuration file, you can actually drop the pycodestyle.sh
script, since running flake8 /path/to/dir is enough to check all the *.py files
under that tree.
Anyway, as it's only optional configuration, ACK.
Rich.
> 1 file changed, 6 insertions(+)
> create mode 100644 python/.flake8
>
> diff --git a/python/.flake8 b/python/.flake8
> new file mode 100644
> index 0000000..0e1dec1
> --- /dev/null
> +++ b/python/.flake8
> @@ -0,0 +1,6 @@
> +[flake8]
> +# Print the source code generating the error/warning in question.
> +show_source = True
> +
> +# Count the number of occurrences of each error/warning code and print a report.
> +statistics = True
> --
> 2.26.3
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-p2v converts physical machines to virtual machines. Boot with a
live CD or over the network (PXE) and turn machines into KVM guests.
http://libguestfs.org/virt-v2v
5:40 a.m.
On Mon, Apr 26, 2021 at 01:24:48PM +0300, Nir Soffer wrote:
On Mon, Apr 26, 2021 at 10:26 AM Richard W.M. Jones
<rjones(a)redhat.com> wrote:
>
> On Sun, Apr 25, 2021 at 11:36:15PM +0300, Nir Soffer wrote:
> > Add .flake8 configuration file enabling show_source and statistics. This
> > makes flake8 output more useful for handling bug reports like:
> > https://gitlab.com/nbdkit/libnbd/-/issues/4
>
> ...
>
> > python/.flake8 | 6 ++++++
>
> I suspect this will be ignored if we're using srcdir != builddir (not
> that this works at the moment). The documentation is confusing about
> how exactly the file is found mentioning only the "project" directory
> whatever that means.
I think .flake8 file is searched in the directories where the source is,
so this should work also in out of tree builds. This works for me for pytest
in another project using out of tree build.
> https://flake8.pycqa.org/en/latest/user/configuration.html
>
> Should we add the equivalent command line parameters instead?
We can, but using a configuration file makes it easier to document why
certain configuration is used. For example why you want to disable certain
checks.
When you have a configuration file, you can actually drop the pycodestyle.sh
script, since running flake8 /path/to/dir is enough to check all the *.py files
under that tree.
We'll have to keep pycodestyle.sh because it checks if flake8 is
available before running it.
I'm still happy with the original patch if you wish to push it.
Rich.
> Anyway, as it's only optional configuration, ACK.
>
> Rich.
>
> > 1 file changed, 6 insertions(+)
> > create mode 100644 python/.flake8
> >
> > diff --git a/python/.flake8 b/python/.flake8
> > new file mode 100644
> > index 0000000..0e1dec1
> > --- /dev/null
> > +++ b/python/.flake8
> > @@ -0,0 +1,6 @@
> > +[flake8]
> > +# Print the source code generating the error/warning in question.
> > +show_source = True
> > +
> > +# Count the number of occurrences of each error/warning code and print a
report.
> > +statistics = True
> > --
> > 2.26.3
>
> --
> Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
> Read my programming and virtualization blog: http://rwmj.wordpress.com
> virt-p2v converts physical machines to virtual machines. Boot with a
> live CD or over the network (PXE) and turn machines into KVM guests.
> http://libguestfs.org/virt-v2v
>
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-builder quickly builds VMs from scratch
http://libguestfs.org/virt-builder.1.html
6:16 a.m.
On Mon, Apr 26, 2021 at 1:40 PM Richard W.M. Jones <rjones(a)redhat.com> wrote:
On Mon, Apr 26, 2021 at 01:24:48PM +0300, Nir Soffer wrote:
> On Mon, Apr 26, 2021 at 10:26 AM Richard W.M. Jones <rjones(a)redhat.com>
wrote:
> >
> > On Sun, Apr 25, 2021 at 11:36:15PM +0300, Nir Soffer wrote:
> > > Add .flake8 configuration file enabling show_source and statistics. This
> > > makes flake8 output more useful for handling bug reports like:
> > > https://gitlab.com/nbdkit/libnbd/-/issues/4
> >
> > ...
> >
> > > python/.flake8 | 6 ++++++
> >
> > I suspect this will be ignored if we're using srcdir != builddir (not
> > that this works at the moment). The documentation is confusing about
> > how exactly the file is found mentioning only the "project"
directory
> > whatever that means.
>
> I think .flake8 file is searched in the directories where the source is,
> so this should work also in out of tree builds. This works for me for pytest
> in another project using out of tree build.
>
> > https://flake8.pycqa.org/en/latest/user/configuration.html
> >
> > Should we add the equivalent command line parameters instead?
>
> We can, but using a configuration file makes it easier to document why
> certain configuration is used. For example why you want to disable certain
> checks.
>
> When you have a configuration file, you can actually drop the pycodestyle.sh
> script, since running flake8 /path/to/dir is enough to check all the *.py files
> under that tree.
We'll have to keep pycodestyle.sh because it checks if flake8 is
available before running it.
This is another issue, running a random version of flake8 from the
host means it will
fail each time flake8 changes the rules (we have suffered from this a
lot in the last 7 years).
I added more info about this here:
https://gitlab.com/nbdkit/libnbd/-/issues/4#note_559832296
I'm still happy with the original patch if you wish to push it.
I'll push it, thanks.
Rich.
> > Anyway, as it's only optional configuration, ACK.
> >
> > Rich.
> >
> > > 1 file changed, 6 insertions(+)
> > > create mode 100644 python/.flake8
> > >
> > > diff --git a/python/.flake8 b/python/.flake8
> > > new file mode 100644
> > > index 0000000..0e1dec1
> > > --- /dev/null
> > > +++ b/python/.flake8
> > > @@ -0,0 +1,6 @@
> > > +[flake8]
> > > +# Print the source code generating the error/warning in question.
> > > +show_source = True
> > > +
> > > +# Count the number of occurrences of each error/warning code and print a
report.
> > > +statistics = True
> > > --
> > > 2.26.3
> >
> > --
> > Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
> > Read my programming and virtualization blog: http://rwmj.wordpress.com
> > virt-p2v converts physical machines to virtual machines. Boot with a
> > live CD or over the network (PXE) and turn machines into KVM guests.
> > http://libguestfs.org/virt-v2v
> >
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-builder quickly builds VMs from scratch
http://libguestfs.org/virt-builder.1.html
1339
days inactive
1340
days old
4 comments
3 participants
participants (3)
-
Nir Soffer -
Nir Soffer -
Richard W.M. Jones