Functional python that shields users from breaking changes.
Project description
A_GIS Python Package
pip install A_GIS
Pronounced with a long "a" like AEGIS, this is a package for functional python.
Distill and recompose
Checkout out notebooks/roundtrip.ipynb for an example of round-tripping.
In the __A_GIS__
directory we can have the segmented data
so that AI can operate on different parts more efficiently.
The basic sequence is
- raw function only (8 lines or less ideally)
- add comments and spacing
- add docstring
- send through formatter
- this is now a complete function like someone would want to see in a code base
To split it up again we go in reverse.
- remove docstring
- remove comments and spacing (save in file)
- save raw function
Now you can see easily if the raw function changed. Once this iteration converges, the diff should be zero.
This process has advantages in that we can isolate the docstring and work on making that beautiful.
It could get examples, and all kinds of crazy awesome reformatting as its own document. Then we can reapply comments to the raw source, THEN the docstring, then format. We could send this to an AI now to create better comments and then ONLY update the comments file. I think the comments are somewhat dependent on the docstring so it's nice to have this flow of regenerating comments assuming a certain docstring and visibility of the whole file.
After splitting back out and saving the raw function, you can see (with git diff for example), if the AI changed the execution of the code. One could imagine asking the AI to split a function into several that don't exceed e.g. 9 lines for example.
This scheme gives us a way to then split those functions and send them to their place on the file system.
By going to such small granularity, we should be able to fit in many AIs token counts and they should be able to design tests and examples much easier.
We could also, based on similarity metrics for the raw functions, make sure AI aren't creating a bunch of extra functions. I.e. if they create a new one that has high similarity to an existing one, we could ask it to use the existing one instead, or propose modifications to the existing one, e.g. optional arguments, that would make it work.
It would be interesting to see what an AI would generate in terms of a code base with this approach. It should arrive at lots of small functions that are basically idioms, like A_GIS.File.read().
You should be able to apply this approach hierarchically to handle tests
for example, each test a function. This should be a totally functional
based system. Inside the functions we may want helper classes,
especially for testing. We should start
these names with an _
to make sure they do not appear in the public
API.
Finally, it should be possible to hash the raw function content like
IPFS and provide these in a distributed computing framework, where you
basically call a function by the hash, output = A_GIS.<hash>(input)
which ensures you get a specific version of that function even across
different versions of A_GIS
. All A_GIS
functions should require
keywords which may help with handling serialized data in dictionaries
and such.
Nice Tree Output
tree -I *.pyc -I __A_GIS__ -I __init__.py -I __pycache__ -I tests A_GIS/
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.