[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation
From: |
Markus Armbruster |
Subject: |
Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation |
Date: |
Fri, 09 Oct 2020 09:19:56 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) |
John Snow <jsnow@redhat.com> writes:
> On 10/8/20 3:15 AM, Markus Armbruster wrote:
>> John Snow <jsnow@redhat.com> writes:
>>
>>> On 10/7/20 4:12 AM, Markus Armbruster wrote:
>>>> I keep stumbling over things in later patches that turn out to go back
>>>> to this one.
>>>> John Snow <jsnow@redhat.com> writes:
>>>>
>>>>> This is a minor re-work of the entrypoint script. It isolates a
>>>>> generate() method from the actual command-line mechanism.
>>>>>
>>>>> Signed-off-by: John Snow <jsnow@redhat.com>
>>>>> Reviewed-by: Eduardo Habkost <ehabkost@redhat.com>
>>>>> Reviewed-by: Cleber Rosa <crosa@redhat.com>
>>>>> Tested-by: Cleber Rosa <crosa@redhat.com>
>>>>> ---
>>>>> scripts/qapi-gen.py | 85 +++++++++++++++++++++++++++++++++------------
>>>>> 1 file changed, 62 insertions(+), 23 deletions(-)
>>>>>
>>>>> diff --git a/scripts/qapi-gen.py b/scripts/qapi-gen.py
>>>>> index 541e8c1f55d..117b396a595 100644
>>>>> --- a/scripts/qapi-gen.py
>>>>> +++ b/scripts/qapi-gen.py
>>>>> @@ -1,30 +1,77 @@
>>>>> #!/usr/bin/env python3
>>>>> -# QAPI generator
>>>>> -#
>>>>> +
>>>>> # This work is licensed under the terms of the GNU GPL, version 2 or
>>>>> later.
>>>>> # See the COPYING file in the top-level directory.
>>>>> +"""
>>>>> +QAPI Generator
>>>>> +
>>>>> +This script is the main entry point for generating C code from the QAPI
>>>>> schema.
>>>> PEP 8: For flowing long blocks of text with fewer structural
>>>> restrictions (docstrings or comments), the line length should be limited
>>>> to 72 characters.
>>>>
>>>
>>> Eugh. OK, but I don't have a good way to check or enforce this,
>>> admittedly. I have to change my emacs settings to understand this when
>>> I hit the reflow key. I don't know if the python mode has a
>>> context-aware reflow length.
>>>
>>> ("I don't disagree, but I'm not immediately sure right now how I will
>>> make sure I, or anyone else, complies with this. Low priority as a
>>> result?")
>>
>> Emacs Python mode is close enough by default: fill-paragraph (bound to
>> M-q) uses variable fill-column, which defaults to 70. If you want the
>> extra two columns PEP 8 grants you, I can show you how to bump it to 72
>> just for Python mode.
>>
>> You can use fill-paragraph for code, too. I don't myself, because I
>> disagree with its line breaking decisions too often (and so does PEP 8).
>> A better Python mode would break code lines more neatly, and with the
>> width defaulting to 79.
>
> Yeah, how do I set the reflow to 72 for specific modes?
>
> I tend to do a lot of refactoring and "prototyping" in Pycharm, but
> when it comes to bread and butter edits I still prefer emacs. I kinda
> bounce between 'em a lot. Having emacs DTRT is still useful to me.
In your .emacs:
(add-hook 'python-mode-hook
(lambda () (setq fill-column 72)))
Happy to explain this in detail if you're curious.
[...]
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, (continued)
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, Markus Armbruster, 2020/10/07
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, John Snow, 2020/10/07
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, Markus Armbruster, 2020/10/08
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, John Snow, 2020/10/08
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, John Snow, 2020/10/08
- Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, Markus Armbruster, 2020/10/09
Re: [PATCH v5 03/36] qapi-gen: Separate arg-parsing from generation, Markus Armbruster, 2020/10/07
[PATCH v5 04/36] qapi: move generator entrypoint into module, John Snow, 2020/10/05
[PATCH v5 02/36] qapi: modify docstrings to be sphinx-compatible, John Snow, 2020/10/05
[PATCH v5 07/36] qapi: enforce import order/styling with isort, John Snow, 2020/10/05
[PATCH v5 05/36] qapi: Prefer explicit relative imports, John Snow, 2020/10/05