python-js-executor/README.md

Execute Python code and files from JavaScript with full import support

# Python JS Executor

Execute Python code and files from JavaScript with full import support.

## Installation

```bash
npm install python-js-executor
```

## Requirements

- Node.js >= 14.0.0
- Python 3.x installed and accessible in PATH

## Usage

```javascript
const PythonRunner = require('python-js-executor');

const runner = new PythonRunner();

// Execute Python code directly
const code = `
import math
print(math.sqrt(16))
`;

runner.runCode(code)
  .then(output => console.log(output))
  .catch(err => console.error(err));

// Execute Python file
runner.runFile('./script.py', ['arg1', 'arg2'])
  .then(output => console.log(output))
  .catch(err => console.error(err));
```

## API

### `PythonRunner`

#### Constructor

```javascript
const runner = new PythonRunner();
```

#### Methods

##### `runCode(code: string, args?: string[]): Promise<string[]>`

Execute Python code directly from a string.

- `code`: Python code to execute
- `args`: Optional array of arguments to pass to the Python code
- Returns: Promise resolving to array of output lines

##### `runFile(pythonFile: string, args?: string[]): Promise<string[]>`

Execute a Python file.

- `pythonFile`: Path to the Python file
- `args`: Optional array of arguments to pass to the Python script
- Returns: Promise resolving to array of output lines

## License

MIT

## Author

Abhinav Tiwari (PINAKA)