I Built a Module System for PineScript to Resolve Complex Indicator Workflows

The Workflow From Hell

PineScript, despite being in its 5th version in 2025, lacks a native module system, forcing developers to manage complex trading indicators within single, monolithic files. This leads to a cumbersome workflow involving repeated copy-pasting between local files, Git, and TradingView’s editor for even minor updates, significantly increasing development time and frustration.

Why This Matters

Ideal software development practices emphasize modularity and code reuse, but PineScript’s global scope and lack of closures create significant challenges. Without a module system, code collisions are inevitable when combining multiple files, leading to broken indicators and increased debugging efforts. The cost of this inefficiency manifests in developer time and potentially missed trading opportunities due to delayed bug fixes or feature implementations.

Key Insights

• AST Manipulation: The solution leveraged Abstract Syntax Trees (ASTs) to understand and modify PineScript code structure, avoiding the pitfalls of simple find-and-replace operations.
• pynescript Library: The Python library pynescript was crucial, providing the parsing and unparsing capabilities necessary to work with PineScript’s AST.
• Prefixing Strategy: A renaming strategy using file path-based prefixes (e.g., __utils_math__) resolves naming conflicts when combining modules.

Working Example

# Example Python code snippet (illustrative)
import pynescript

# Parse PineScript code
code = """
//@version=5
// @export double
double(x) =>
x * 2
"""
ast = pynescript.parse(code)

# Rename the function 'double' (simplified)
for node in ast.walk():
    if isinstance(node, pynescript.FunctionDefinition) and node.name == "double":
        node.name = "__math_utils__double"

# Unparse the modified AST
modified_code = pynescript.unparse(ast)
print(modified_code)

Practical Applications

• TradingView Indicators: PineCone enables developers to create complex, well-organized indicators for TradingView, improving maintainability and collaboration.
• Pitfall: Relying on manual copy-pasting for updates leads to errors and wasted time, especially in larger projects with multiple dependencies.

References:

• https://dev.to/claudianadalin/i-built-a-module-system-for-a-language-that-doesnt-have-one-13kb