[B4X] CodeBundle – Export Projects as a Single JSON for AI Analysis

Edit: An improved and integrated version of Code Bundle is included in B4A 13.5 and B4J v10.5. Soon to be added to B4i and B4R.

The purpose of this tool is to easily export the complete project as a single json file which can be then fed to ChatGPT or any other capable AI bot for further analysis. It exports the modules code, layouts and some additional meta information.

This is an experimental tool. Please provide feedback if you find it useful or have any other suggestion.

Usage:

- Download the jar file and put it in the additional libraries folder, preferably under the B4X folder.
- Add to Main or B4XMainPage:
The path is set with the assumption that the additional libraries folder is set as recommended: https://www.b4x.com/android/forum/threads/b4x-additional-libraries-folder.103165/#content
Change it as needed.

- Click on Ctrl + 1 or the title bar button to export the project.

Notes:

- The following optional parameters are supported:

vmargs=-DHandleLayouts%3DFalse - To omit the layout files.
vmargs=-DCompactJson&3DFalse - To generate non-compact json.


Source code is also attached.

- Save the project before running if you made changes. The tool reads the code from the project files.

Updates:

v0.32 - The bundle file is copied to the clipboard. Explorer is no longer opening.
v0.31 - Fixed bug where first character was missing. Thanks @aeric for reporting.
v0.3 - #SignKeyPassword is removed from output.
Most regular libraries are now also added to the output.
v0.2 - API keys are replaced with all-zeros key. This is done heuristically based on several regex patterns. Replaced keys are logged. If you encounter a key that isn't replaced then please post an example.
Information about referenced b4xlibs is added to the output.

Download link: https://www.b4x.com/android/files/CodeBundle.jar

Example with ChatGPT (plus):

I've generated the json of B4XTable project:



Output:

In B4XTable, there are 4 column types (constants on the class): TEXT, NUMBERS, DATE, VOID.

1) COLUMN_TYPE_TEXT​

• SQL storage: created as TEXT.

Search: only TEXT columns are searchable (Searchable = True). Filtering uses LIKE ? on searchable columns.


Display: read with rs.GetString(...) and placed into the label; if search highlighting is enabled it can render highlighted matches.


Sort: sortable (like everything except VOID).

2) COLUMN_TYPE_NUMBERS​

• SQL storage: INTEGER (note: even though you might insert doubles, the table schema uses INTEGER for non-text).

Search: not searchable.


Display: read with rs.GetDouble(...) and formatted via the column’s Formatter (defaults to DefaultDataFormatter).


Sort: sortable (SQL ORDER BY on the column).

3) COLUMN_TYPE_DATE​

• SQL storage: INTEGER (date is stored as a Long ticks value, typical DateTime style).

• Search: not searchable.

Display: read with rs.GetLong(...) and shown as DateTime.Date(longValue).


Sort: sortable.

4) COLUMN_TYPE_VOID​

• Purpose: “UI-only” / placeholder columns (not part of the SQL data model).
• SQL storage: not stored — VOID columns are skipped when building the SQL table, inserts, and selects.

Not bad.

First suggestion: Make it simple to generate json from b4xlibs. Will do...

I haven't tried this tool yet, but one thought that came to mind is if this tool could incorporate a Conditional Symbol such as "CODEBUNDLE" so that it can automatically/optionally use alternative values for certain code/info that you don't want to send to the AI:

Yes, we could manually implement a scheme that would use a particular symbol to manage what can be safely sent to the AI, but that would require us to remember to switch build configurations before using this tool.

By having "CODEBUNDLE" be a built-in symbol for this tool, we can be assured that the fake info will always be sent to the AI even in the event we forgot to manually switch build configurations before running this tool.

Here are some more comments I made for this suggestion:

Wow, awesome, is there an option not to export particular file?

For example, I am using an env.json file to store security settings and other things for my project that I would not like to share with AI, will it be possible to have a command to exclude such an asset file?

Again, thanks so much for this tool. What a christmas present!!

The project "Files" are not added to the json. Only the layouts are exported.

v0.2 - API keys are replaced with all-zeros key. This is done heuristically based on several regex patterns. Replaced keys are logged. If you encounter a key that isn't replaced then please post an example.
Information about referenced b4xlibs is added to the output.

So this take care of ?


I write it in .b4a in my projects.

Good point. I will add a rule for this.

v0.3: #SignKeyPassword is removed from output.
Most regular libraries are now also added to the output.

Here, tried for reversing... tried in simple projects seems working good (only some probs at headers)

Erel said:

The purpose of this tool is to easily export the complete project as a single json file which can be then fed to ChatGPT or any other capable AI bot for further analysis. It exports the modules code, layouts and some additional meta information.

...

Click to expand...

While I acknowledge that this may diverge from the current scope, I believe the project's utility for third-party analysis and AI integration is outstanding. Providing a comprehensive, readable codebase rather than a compressed archive is a significant advantage.

We might consider extending this functionality to embed assets using Base64 encoding. (this would increase the output length and associated token costs, but in some cases can be fantastic)

Generally - The project/tool's fundamental approach is excellent.

v0.31 - Fixed bug where first character was missing. Thanks @aeric for reporting.

Can the project be exported as JSON? This is interesting, but I don't quite understand.Is it for the library or the entire project?If you can import JSON as a project according to your rules. That third-party designer based on B4X becomes possible.

byz said:

That third-party designer based on B4X becomes possible.

Click to expand...

Basically, you can just ask AI to create/edit the design for you, give you back the updated JSON file and then you can convert it back to your project files. How good the AI can do, that is another question but at least it can "see" the project much better.

That’s an interesting idea, thanks. I think it would be better to place this option in the main menu of the b4j. Also, having an option to restore settings from a JSON file could be very useful.

behnam_tr said:

That’s an interesting idea, thanks. I think it would be better to place this option in the main menu of the b4j. Also, having an option to restore settings from a JSON file could be very useful.

Click to expand...

If you want to convert layouts to Json then use this tool: https://www.b4x.com/android/forum/t...onize-json-and-binary-layouts.167398/#content
It is built exactly for that use case. The purpose of CodeBundle is different.

Thanks a lot for this tool. Great.
To share that I have used the tool to create documentation for my HMITiles library.

Approach

Step 1 - Included in B4XMainpage of the HMITiles B4J project

Step 2 - Generate JSON
The file HMITiles.json (900k) is created in the dirapp folder.

Step 3 - Extract HMITile JSON object for single class as test: module_type": "Class", "name": "HMITileLabel"

Step 4 - Asked ChatGPT to generate Github markdown documentation.
Extracted the JSON object for the test class and asked ChatGPT to generate Github markdown documentation.

Step 5 - Asked ChatGPT to generate B4X code for the test class. Output Github markdown documentation.

Step 6 - Created B4J B4XPages project HMITilesDocCreator
Used the code from step 5 to create the GitHub API documentation for all HMITiles classes.
Amended with additional code and corrected list/map methods.

Step 7 - Review and improve Documentation
And also the code improvements.

B4J project attached (test version)

Great!

(Worth testing it with CompactJson = True. It has a significant impact on large projects.)

Erel said:

Download link: www.b4x.com/android/files/CodeBundle.jar

Click to expand...

The link doesn't work.


I compiled the source code (jdk-19.0.2) and tried using the library: