[code-quality] release 0.6 of RedBaron, high level parser/modifier of python source file

[Ian Cordasco]

On Mon, Mar 28, 2016 at 10:30 AM, Laurent Peuch
<cortex at worlddomination.be> wrote:
> Hello,
>
> One year later I've finally made a new release for RedBaron. For those
> of you that don't know RedBaron, it's a library that allows you to
> modify you python *source* file with a high level API pretty much like
> BeautifulSoup with a lot of helper to make this way-harder-than-expected
> task doable.
>
> Life being life, I don't have the same time that I used to have to
> work on this project, therefor this release mark my decision to now
> focus on brigging a 1.0 without adding any new big feature but instead
> focusing on stability, bugfixing and fully support the python 3
> grammar (if they stop adding new things all the time). This release
> also mark the decision of being backward compatible from now one
> until 2.0.
>
> I know that this mailing list is full of "without any free time"
> people and that this project is quite complicated but I wouldn't be
> against new contributors :)
>
> I'm adding the release notes at the end of this email.
>
> Have a nice day,
>
>> 0.6 (2016-03-28)
>> ----------------
>>
>> This release is guaranteed to have a retro-compatible public documented API
>> from now on until maybe 2.0.
>> There might be the only exception that if you directly call specific nodes
>> constructors with FST that this API change, but this is not documented and
>> simply horribly unpracticable, so I'm expecting no one to do that.
>>
>> From now on the focus will be on moving to a stable 1.0 meaning: bugs fixes and
>> API additions for missing needed features and no more big modifications, this
>> will be for other releases, the workload is already big enough.
>>
>> - BIG improvement on the proxy list merging algorithm, it is not perfect yet (comments aren't handled yet) but it's really a big move forward
>> - possible retrocompatibility breaking change: from now on the node.find("name") to node.name shortcut ONLY works with possible nodes identifiers. For example node.i_dont_exist_as_an_identifier will raise AttributeError
>> - new helper method .to_python that wrap ast.literal_eval on compatibile nodes https://redbaron.readthedocs.org/en/latest/other.html#to-python
>> - breaking: IntNode no longer return an int on .value but a .string instead, use .to_python to have an evaluated version
>> - fix node.decrease_indentation (that was simply not working)
>> - fix code_block_node.value was broken on node with no parent
>> - add string representation for Path object
>> - now redbaron Path() class can be compared directly to baron paths
>>   without using to_baron_path() helper.
>> - fix by novocaine: 'function' was used as a function type detector instead of 'def'
>> - add getitem() method with same api on NodeList and ProxyList
>> - fix: inconsistencies when inserting lines around code blocks
>> - inserting a blank lines inserts effectively a \n in a LineProxyList
>> - new helper methods: .next_recursive and .previous_recursive https://redbaron.readthedocs.org/en/latest/other.html
>> - fix: doc is tested in CI now, it shouldn't break anymore
>> - more rendering test for python3, it shouldn't break anymore
>> - pygments is now an optional dependancy, "pip install redbaron" won't install it, "pip install redbaron[pygments"] will
>> - new node.next_intuitive and node.previous_intuitive methods for situations where .next/previous doesn't behave the way the user expect it http://redbaron.readthedocs.org/en/latest/other.html#next-intuitive-previous-intuitive
>
> --
>
> Laurent Peuch -- Bram
> _______________________________________________
> code-quality mailing list
> code-quality at python.org
> https://mail.python.org/mailman/listinfo/code-quality

I'm really happy you sent this. I had forgotten about RedBaron and was
going to start looking for a project exactly like it. Would you be
interested in moving the project under the umbrella of the PyCQA? We
could probably more easily integrate new contributors in an
organization. I'll start taking a look at how I could help out with
RedBaron since Flake8 will probably start depending on it or something
like it.

Cheers,
Ian