added basic ASTX to python transpiler

[nagajaideep]

Pull Request Description

This pull request introduces a new feature: an ASTx to Python AST transpiler. The ASTxPythonASTTranspiler class enables the conversion of ASTx nodes into Python AST nodes using Python's built-in ast module. This allows for programmatic manipulation of ASTx nodes and seamless integration with Python's AST ecosystem.

Changes Made

• Added ASTxPythonASTTranspiler class in libs/astx-transpilers/src/astx_transpilers/python_ast.py.
• Implemented visit_* methods for several ASTx node types:
  • LiteralInt32, Variable
  • BinaryOp
  • Assign, If, While, and more
• Added fallback support using ast.unparse for unsupported or complex cases.

Issue This PR Aims to Resolve

This PR introduces a new feature and does not resolve an existing issue directly.

---

How to Test These Changes

You can run the following Python script to test the transpiler functionality:

from astx_transpilers.python_ast import ASTxPythonASTTranspiler
import astx
import ast

# Example ASTx node
astx_node = astx.BinaryOp(
    lhs=astx.LiteralInt32(value=5),
    op_code="+",
    rhs=astx.Variable(name="x")
)

# Transpile to Python AST
transpiler = ASTxPythonASTTranspiler()
python_ast_node = transpiler.visit(astx_node)

# Print the Python AST node
print(ast.dump(python_ast_node))

# Convert to Python code
python_code = ast.unparse(python_ast_node)
print(python_code)

Expected Output:

BinOp(left=Constant(value=5), op=Add(), right=Name(id='x', ctx=Load()))
5 + x

Additionally, run any included unit tests to validate correctness.

---

Pull Request Checklists

This PR is a:

• new feature
• bug-fix
• maintenance

About this PR:

• it includes tests.
• the tests are executed on CI.
• the tests generate log file(s) (path).
• pre-commit hooks were executed locally.
• this PR requires a project documentation update.

Author's checklist:

• I have reviewed the changes and it contains no misspelling.
• The code is well commented, especially in the parts that contain more complexity.
• New and old tests passed locally.

Optional:

• Share updated images of the graph representation of the new ASTx node proposed in this PR, in both image and ASCII formats. For more information, refer to this Colab notebook

---

Additional Information

Example Output:

BinOp(left=Constant(value=5), op=Add(), right=Name(id='x', ctx=Load()))
5 + x

---

Reviewer's Checklist

Copy and paste this template when reviewing:

## Reviewer's Checklist

- [ ] I managed to reproduce the problem locally from the `main` branch.
- [ ] I managed to test the new changes locally.
- [ ] I confirm that the issues mentioned were fixed/resolved.

[xmnlab]

this variable should be moved to outside of the function nd class, otherwise it will be created every time it is executed.

it could be called OP_MAP

[xmnlab]

this variable should be moved to outside of the function nd class, otherwise it will be created every time it is executed.

it could be called OP_MAP

[xmnlab]

not really sure about this .. but we can keep it for now

[xmnlab]

just a few comments, in general looks good to me.
you can proceed with tests and docs.

appreciate it!

[github-actions]

This pull request has been marked as stale because it has been
inactive for more than 5 days. Please update this pull request
or it will be automatically closed in 5 days.

[nagajaideep]

TASKS TO BE DONE:
-NEED TO ADD COMPLETE NODE TRANSLATIONS
-WRITE APPROPRIATE TESTS FOR NODES (WITH SYMMETRY)
-DOCUMENT THE NEW TRANSPILER

[github-actions]

This pull request has been marked as stale because it has been
inactive for more than 5 days. Please update this pull request
or it will be automatically closed in 5 days.