brazilian-utils / python Goto Github PK

Hey @camilamaia! I noticed that you've been cleaning up this project recently, so I have a proposal to make:

Historical Context

I am the owner of the brutils package in PyPI, which predates the brazilian-utils package and organization by about roughly 2 years if I recall correctly.

My project (unlike most in the Python ecosystem, including this one), is thoroughly documented both in Portuguese and English, is thoroughly tested and fully supports both python 2.7 and 3.x (2.7 is still important for legacy applications), exposes an ergonomic and type-hinted API with additional utility functions, and doesn't suffer from extensive code quality issues like some others do (even on this one, validate_first_digit and validate_second_digit are a clear smell of code duplication, as they are almost identical and implement the same checksumming algorithm, but in different positions in the array).

Mine also has the benefit that it already implements CNPJ which this one doesn't, and its internal architecture was made to favor extending the package with support for other types of documents by simply adding more internal modules. Also, like this one, it has zero dependencies outside of Python itself (although the tests can be ran with pytest as well if preferred).

When this organization started a few years ago, I offered to transfer my package so that it would be maintained under it, but that conversation died out and nothing was done.

The Proposal

Given the renewed interest in this package from you, what would you say to us instead of trying to refactor this package into a better shape, transfer mine to the organization (both here and in PyPI) making it the official one, and deprecating this one?

It would lessen the maintenance burden for everyone, and de-fragment the ecosystem (especially since my crate is very old and shares a very similar name)

What do you say? 😃

Regards, Luiz.

I literally wrote a Python package which is already on pip with the same name as this project 2 years ago, currently supporting CPF and CNPJ.

Could I suggest not doing (at least the python part) from scratch and merging my project with this organization?

https://github.com/luizberti/brutils