Skip to content

Rename flowfile module to ff_kernel across codebase#325

Open
Edwardvaneechoud wants to merge 2 commits intofeauture/kernel-implementationfrom
claude/rename-flowfile-module-Aj6Ig
Open

Rename flowfile module to ff_kernel across codebase#325
Edwardvaneechoud wants to merge 2 commits intofeauture/kernel-implementationfrom
claude/rename-flowfile-module-Aj6Ig

Conversation

@Edwardvaneechoud
Copy link
Owner

Summary

This PR renames the flowfile module to ff_kernel throughout the codebase to better reflect its purpose as a kernel-level API for code execution within the FlowFile system.

Key Changes

  • Test files: Updated all test code snippets in test_global_artifacts_kernel_integration.py and test_kernel_integration.py to use ff_kernel instead of flowfile for all API calls (read_input, publish_output, publish_artifact, read_artifact, delete_artifact, list_artifacts, publish_global, get_global, list_global_artifacts, delete_global_artifact, etc.)

  • Frontend documentation: Updated the API help modal (FlowfileApiHelp.vue) to reference ff_kernel in all code examples and API documentation sections (Data I/O, Artifacts, Display, Global Artifacts, and Logging)

  • Frontend code completions: Updated autocomplete suggestions in flowfileCompletions.ts to use ff_kernel module name and updated all function detail strings to reflect the new module name

  • Frontend templates: Updated default Python script template in utils.ts to use ff_kernel.read_input() and ff_kernel.publish_output()

  • Documentation: Updated kernel_runtime/README.md to reference ff_kernel module in all code examples and explanations throughout the documentation

Implementation Details

The rename is consistent across:

  • All test code execution strings
  • User-facing API documentation and help text
  • Code completion/autocomplete suggestions
  • Default code templates
  • README examples and explanations

This change improves clarity by using a more specific name (ff_kernel) that better indicates this is the kernel-level API, distinguishing it from other potential FlowFile APIs.

https://claude.ai/code/session_01EuVZrAvHRhfChnx4AK63ss

The kernel runtime previously injected a module called 'flowfile' into
the user's execution namespace, which caused confusion with the
top-level flowfile package. This renames the injected namespace variable
to 'ff_kernel' to clearly distinguish the kernel-side data I/O and
artifact API from the broader FlowFile ecosystem.

Changes:
- kernel_runtime/main.py: inject as 'ff_kernel' with deprecated
  'flowfile' alias that emits DeprecationWarning on first use
- Frontend completions, API help, and default code templates updated
- All test inline code strings updated to use ff_kernel
- kernel_runtime/README.md documentation updated

https://claude.ai/code/session_01EuVZrAvHRhfChnx4AK63ss
Drop the _DeprecatedFlowfileAlias proxy and the 'flowfile' key from
exec_globals entirely. The kernel namespace now only exposes 'ff_kernel'.

https://claude.ai/code/session_01EuVZrAvHRhfChnx4AK63ss
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants