Converted to Material UI v7 - bare.

This commit is contained in:
2026-01-31 11:52:15 +01:00
parent 57371feeb0
commit 3dd352df92
12 changed files with 1451 additions and 777 deletions

View File

@@ -71,11 +71,9 @@ The UI generates an API key at startup then load the sample data at startup and
The main components of the application are located in the `src` directory and target Node 24 LTS environment.
Framework to be used:
- React for building the user interface.
- Material UI v7 for building the user interface.
- React for building the component logic.
- JavaScript (ES6+) for scripting.
- Bootstrap for styling and layout.
- Express.js for serving the application and handling API requests.
### API

View File

@@ -4,7 +4,7 @@ A React-based web application for testing and validating JMESPath expressions ag
![JMESPath Testing Tool](https://img.shields.io/badge/React-18.2.0-blue?style=flat-square&logo=react)
![Node.js](https://img.shields.io/badge/Node.js-24%20LTS-green?style=flat-square&logo=node.js)
![Bootstrap](https://img.shields.io/badge/Bootstrap-5.3.2-purple?style=flat-square&logo=bootstrap)
![Material UI](https://img.shields.io/badge/Material--UI-v7-007FFF?style=flat-square&logo=mui)
## Features
@@ -127,7 +127,7 @@ MAX_SESSIONS=200 MAX_SAMPLE_SIZE=2097152 LISTEN_PORT=8080 node server.js
## Technology Stack
- **React 18.2.0**: Frontend framework with modern hooks and components
- **Bootstrap 5.3.2**: CSS framework with dark/light theme support
- **Material UI v7**: Modern React component library following Material 3 Design principles.
- **JMESPath 0.16.0**: JMESPath expression evaluation library
- **Express.js 4.19.2**: Backend API server with session management
- **Node.js 24 LTS**: Runtime environment

763
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@@ -17,10 +17,13 @@
"node": ">=24.0.0"
},
"dependencies": {
"@emotion/react": "^11.14.0",
"@emotion/styled": "^11.14.1",
"@mui/icons-material": "^7.3.7",
"@mui/material": "^7.3.7",
"@testing-library/jest-dom": "^6.1.4",
"@testing-library/react": "^13.4.0",
"@testing-library/user-event": "^14.5.1",
"bootstrap": "^5.3.2",
"express": "^4.19.2",
"jmespath": "^0.16.0",
"react": "^18.2.0",

View File

@@ -1,318 +1,46 @@
/* JMESPath Testing Tool Custom Styles */
/* JMESPath Testing Tool - Minimal Styles */
:root {
/* Common variables */
--font-mono: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
--accent-color: #007bff;
/* Brand colors */
--brand-gradient: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
--brand-white: #ffffff;
--brand-dark: #212529;
--brand-warning: #ffc107;
/* Brand opacity levels */
--brand-white-60: rgba(255, 255, 255, 0.6);
--brand-white-10: rgba(255, 255, 255, 0.1);
--brand-warning-50: rgba(255, 193, 7, 0.5);
--brand-warning-10: rgba(255, 193, 7, 0.1);
/* Elevation and overlays */
--shadow-light: rgba(0, 0, 0, 0.1);
--focus-ring: rgba(0, 123, 255, 0.25);
/* Button variants */
--btn-success: #28a745;
--btn-info: #17a2b8;
--btn-primary: #007bff;
--btn-danger: #dc3545;
--btn-secondary: #6c757d;
/* Common transitions */
--transition-fast: 0.2s ease;
--transition-normal: 0.3s ease;
/* Font families */
--font-sans: 'Noto Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
--font-mono: 'Noto Sans Mono', 'Consolas', 'Monaco', 'Courier New', monospace;
--font-sans: "Noto Sans", -apple-system, BlinkMacSystemFont, "Segoe UI",
"Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans",
"Helvetica Neue", sans-serif;
--font-mono: "JetBrains Mono", "Fira Code", "Noto Sans Mono", "Consolas", "Monaco", "Courier New", monospace;
}
/* Base font family */
body {
font-family: var(--font-sans);
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
transition: background-color var(--transition-normal), color var(--transition-normal);
}
/* Layout structure */
.vh-100 {
height: 100vh;
}
/* Header section styling - more compact */
.header-section {
background: var(--brand-gradient);
color: var(--brand-white);
padding: 1.2rem 0;
margin-bottom: 1rem;
margin: 0;
transition: background-color 0.3s ease;
}
.header-section h2 {
color: var(--brand-white);
#root {
display: flex;
flex-direction: column;
min-height: 100vh;
}
/* Ensure buttons in header are clearly visible against gradient */
.header-section .btn-light.active {
background-color: var(--brand-white);
color: var(--brand-dark) !important; /* Deep dark text for selected states */
border-color: var(--brand-white);
/* Scrollbar styling for a cleaner look */
::-webkit-scrollbar {
width: 8px;
height: 8px;
}
.header-section .btn-outline-light {
color: var(--brand-white);
border-color: var(--brand-white-60);
::-webkit-scrollbar-track {
background: transparent;
}
.header-section .btn-outline-light:hover {
background-color: var(--brand-white-10);
color: var(--brand-white);
::-webkit-scrollbar-thumb {
background: rgba(0, 0, 0, 0.1);
border-radius: 4px;
}
.header-section .btn-outline-warning {
color: var(--brand-warning);
border-color: var(--brand-warning-50);
[data-mui-color-scheme="dark"] ::-webkit-scrollbar-thumb {
background: rgba(255, 255, 255, 0.1);
}
.header-section .btn-outline-warning:hover {
background-color: var(--brand-warning-10);
color: var(--brand-warning);
}
/* Custom card styling */
.card {
border: none;
box-shadow: 0 2px 8px var(--shadow-light);
border-radius: 8px;
transition: background-color 0.3s ease, box-shadow 0.3s ease;
}
.card-header {
background-color: var(--bg-secondary);
border-bottom: 2px solid var(--border);
font-weight: 600;
color: var(--text-primary);
transition: background-color 0.3s ease, border-color 0.3s ease, color 0.3s ease;
}
/* Input and textarea styling */
.jmespath-input, .json-input, .result-output {
font-family: var(--font-mono);
font-weight: 400;
transition: background-color var(--transition-normal), border-color var(--transition-normal), color var(--transition-normal);
}
.jmespath-input {
font-size: 14px;
padding: 10px;
}
.json-input, .result-output {
font-size: 13px;
line-height: 1.4;
}
/* Button styling */
.btn {
transition: all var(--transition-fast);
}
.btn:hover {
transform: translateY(-1px);
}
/* Footer styling */
footer {
flex-shrink: 0;
}
/* Responsive adjustments */
@media (max-width: 768px) {
.header-section {
padding: 1.5rem 0 !important;
}
.display-4 {
font-size: 2rem;
}
.lead {
font-size: 1rem;
}
.btn-sm {
font-size: 0.8rem;
padding: 0.25rem 0.5rem;
}
.card-body textarea {
min-height: 300px !important;
}
}
/* Bootstrap theme integration */
[data-bs-theme="light"] {
--bg-primary: #ffffff;
--bg-secondary: #f8f9fa;
--text-primary: #212529;
--text-secondary: #495057;
--text-muted: #6c757d;
--border: #dee2e6;
--border-input: #ced4da;
--success-bg: #d4edda;
--success-border: #c3e6cb;
--success-text: #155724;
--error-bg: #f8d7da;
--error-border: #f5c6cb;
--error-text: #721c24;
}
[data-bs-theme="dark"] {
--bg-primary: #1a1a1a;
--bg-secondary: #2d2d2d;
--bg-card: #323232;
--text-primary: #ffffff;
--text-secondary: #e9ecef;
--text-muted: #adb5bd;
--border: #495057;
--border-input: #6c757d;
--success-bg: #1e4a1e;
--success-border: #2c6d2c;
--success-text: #d4edda;
--error-bg: #4a1e1e;
--error-border: #6d2c2c;
--error-text: #f8d7da;
}
/* Apply theme colors */
body {
background-color: var(--bg-primary);
color: var(--text-secondary);
}
.card {
background-color: var(--bg-primary);
border-color: var(--border);
color: var(--text-primary);
}
.card-header {
background-color: var(--bg-secondary);
border-bottom-color: var(--border);
color: var(--text-primary);
}
.jmespath-input {
background-color: var(--bg-primary);
border-color: var(--border-input);
color: var(--text-secondary);
}
.json-input, .result-output {
background-color: var(--bg-secondary);
border-color: var(--border);
color: var(--text-secondary);
}
footer {
background-color: var(--bg-secondary);
color: var(--text-secondary);
}
footer.bg-light {
background-color: var(--bg-secondary) !important;
}
footer a {
color: var(--text-muted);
}
footer a:hover {
color: var(--text-secondary);
}
/* State styles */
.jmespath-input.success {
background-color: var(--success-bg) !important;
border-color: var(--success-border) !important;
color: var(--success-text) !important;
}
.jmespath-input.error {
background-color: var(--error-bg) !important;
border-color: var(--error-border) !important;
color: var(--error-text) !important;
}
.json-input.success {
background-color: var(--success-bg) !important;
border-color: var(--success-border) !important;
color: var(--success-text) !important;
}
.json-input.error {
background-color: var(--error-bg) !important;
border-color: var(--error-border) !important;
color: var(--error-text) !important;
}
/* Focus states */
.jmespath-input:focus {
border-color: var(--accent-color, #007bff);
box-shadow: 0 0 0 0.2rem var(--focus-ring);
}
.json-input:focus,
.result-output:focus {
background-color: var(--bg-primary);
border-color: var(--accent-color, #007bff);
color: var(--text-secondary);
box-shadow: 0 0 0 0.2rem var(--focus-ring);
}
/* Placeholder colors */
.jmespath-input::placeholder,
.json-input::placeholder,
.result-output::placeholder {
color: var(--text-muted);
}
/* Alert styles */
.alert-danger {
background-color: var(--error-bg);
border-color: var(--error-border);
color: var(--error-text);
}
.alert-success {
background-color: var(--success-bg);
border-color: var(--success-border);
color: var(--success-text);
}
/* Code block styles */
pre.bg-light {
background-color: var(--bg-secondary) !important;
color: var(--text-secondary) !important;
border-color: var(--border) !important;
}
code {
color: var(--text-secondary);
::-webkit-scrollbar-thumb:hover {
background: rgba(0, 0, 0, 0.2);
}

View File

@@ -1,4 +1,12 @@
import React, { useState, useEffect } from "react";
import React, { useState, useEffect, useMemo } from "react";
import {
ThemeProvider,
createTheme,
CssBaseline,
Box,
Container,
} from "@mui/material";
import useMediaQuery from "@mui/material/useMediaQuery";
import Header from "./components/Header";
import Footer from "./components/Footer";
import MainPage from "./components/MainPage";
@@ -65,39 +73,22 @@ function App() {
return newKey;
});
// Theme management
useEffect(() => {
const applyTheme = (selectedTheme) => {
const effectiveTheme =
selectedTheme === "auto"
? window.matchMedia &&
window.matchMedia("(prefers-color-scheme: dark)").matches
? "dark"
: "light"
: selectedTheme;
const getApiHeaders = () => ({
"Accept": "application/json",
"x-api-key": apiKey,
});
document.documentElement.setAttribute("data-bs-theme", effectiveTheme);
};
applyTheme(theme);
// Save theme preference
localStorage.setItem("theme", theme);
}, [theme]);
// Shell type management
useEffect(() => {
localStorage.setItem("jmespath-shell-type", shellType);
}, [shellType]);
// Get headers for API requests
const getApiHeaders = () => {
return {
Accept: "application/json",
"X-API-Key": apiKey,
};
};
const prefersDarkMode = useMediaQuery("(prefers-color-scheme: dark)");
const muiTheme = useMemo(() => {
return createTheme({
cssVariables: true,
colorSchemes: {
light: true,
dark: true,
},
});
}, []);
// Load sample data from API on startup and setup periodic state checking
useEffect(() => {
loadSampleData();
@@ -172,7 +163,16 @@ function App() {
};
return (
<div className="vh-100 d-flex flex-column">
<ThemeProvider theme={muiTheme}>
<CssBaseline />
<Box
sx={{
display: "flex",
flexDirection: "column",
minHeight: "100vh",
bgcolor: "background.default",
}}
>
<Header
theme={theme}
onThemeChange={handleThemeChange}
@@ -181,9 +181,14 @@ function App() {
/>
{/* Main Content Section - flex-grow to fill space */}
<div
className="container-fluid flex-grow-1 d-flex flex-column"
style={{ minHeight: 0 }}
<Box
component="main"
sx={{
flexGrow: 1,
display: "flex",
flexDirection: "column",
minHeight: 0,
}}
>
{currentPage === "main" ? (
<MainPage
@@ -203,10 +208,11 @@ function App() {
onShellTypeChange={setShellType}
/>
)}
</div>
</Box>
<Footer />
</div>
</Box>
</ThemeProvider>
);
}

View File

@@ -49,7 +49,7 @@ describe('App Component', () => {
describe('Basic Rendering', () => {
test('renders JMESPath Testing Tool title', () => {
render(<App />);
const titleElement = screen.getByRole('heading', { name: /JMESPath Testing Tool/i });
const titleElement = screen.getByText(/JMESPath Playground/i);
expect(titleElement).toBeInTheDocument();
});
@@ -90,11 +90,11 @@ describe('App Component', () => {
test('renders all toolbar buttons', () => {
render(<App />);
expect(screen.getByTitle('Load JSON object from file')).toBeInTheDocument();
expect(screen.getByTitle('Load JSON Lines log file')).toBeInTheDocument();
expect(screen.getByTitle('Load sample data')).toBeInTheDocument();
expect(screen.getByTitle('Format JSON')).toBeInTheDocument();
expect(screen.getByTitle('Clear all inputs')).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Load from Disk/i })).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Load Logs/i })).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Load Sample/i })).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Format/i })).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Clear all inputs/i })).toBeInTheDocument();
});
});
@@ -108,7 +108,7 @@ describe('App Component', () => {
const resultArea = screen.getByPlaceholderText(/Results will appear here/i);
// Clear all inputs first to start fresh
const clearButton = screen.getByTitle('Clear all inputs');
const clearButton = screen.getByRole('button', { name: /Clear all inputs/i });
await user.click(clearButton);
// Set JSON data directly after clearing
@@ -153,7 +153,7 @@ describe('App Component', () => {
const jsonInput = screen.getByPlaceholderText(/Enter JSON data here/i);
// Clear all inputs first
const clearButton = screen.getByTitle('Clear all inputs');
const clearButton = screen.getByRole('button', { name: /Clear all inputs/i });
await user.click(clearButton);
// Set invalid JSON directly
@@ -187,31 +187,55 @@ describe('App Component', () => {
test('renders theme switcher buttons', () => {
render(<App />);
expect(screen.getByTitle('Auto (follow system)')).toBeInTheDocument();
expect(screen.getByTitle('Light theme')).toBeInTheDocument();
expect(screen.getByTitle('Dark theme')).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Auto/i })).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Light/i })).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Dark/i })).toBeInTheDocument();
});
test('switches to light theme when clicked', async () => {
const user = userEvent.setup();
render(<App />);
const lightButton = screen.getByTitle('Light theme');
const lightButton = screen.getByRole('button', { name: /Light/i });
await user.click(lightButton);
// Check if button becomes active
expect(lightButton).toHaveClass('btn-primary');
expect(lightButton).toHaveClass('Mui-selected');
});
test('switches to dark theme when clicked', async () => {
const user = userEvent.setup();
render(<App />);
const darkButton = screen.getByTitle('Dark theme');
const darkButton = screen.getByRole('button', { name: /Dark/i });
await user.click(darkButton);
// Check if button becomes active
expect(darkButton).toHaveClass('btn-primary');
expect(darkButton).toHaveClass('Mui-selected');
});
});
describe('Navigation', () => {
test('switches to API Keys page and back', async () => {
const user = userEvent.setup();
render(<App />);
// Find and click API Keys button in Header
// MUI Tooltip might set aria-label to title "API Key Management"
const apiKeyButton = screen.getByRole('button', { name: /API Key Management/i });
await user.click(apiKeyButton);
// Check if API Key Management title is visible
expect(screen.getByText(/API Key Management/i)).toBeInTheDocument();
expect(screen.getByText(/YOUR API KEY/i)).toBeInTheDocument();
// Find and click Home button to go back
// MUI Tooltip title "Back to Testing" becomes the accessible name
const homeButton = screen.getByRole('button', { name: /Back to Testing/i });
await user.click(homeButton);
// Check if we are back on main page
expect(screen.getByRole('heading', { name: /JMESPath Expression/i })).toBeInTheDocument();
});
});
@@ -222,7 +246,7 @@ describe('App Component', () => {
const jmespathInput = screen.getByPlaceholderText(/Enter JMESPath expression/i);
const jsonInput = screen.getByPlaceholderText(/Enter JSON data here/i);
const clearButton = screen.getByTitle('Clear all inputs');
const clearButton = screen.getByRole('button', { name: /Clear all inputs/i });
// Add some content
await user.type(jmespathInput, 'test.expression');
@@ -241,7 +265,7 @@ describe('App Component', () => {
render(<App />);
const jsonInput = screen.getByPlaceholderText(/Enter JSON data here/i);
const formatButton = screen.getByTitle('Format JSON');
const formatButton = screen.getByRole('button', { name: "Format" });
// Add minified JSON directly
fireEvent.change(jsonInput, { target: { value: '{"name":"Alice","age":30,"skills":["React","Node"]}' } });
@@ -260,7 +284,7 @@ describe('App Component', () => {
const user = userEvent.setup();
render(<App />);
const loadSampleButton = screen.getByTitle('Load sample data');
const loadSampleButton = screen.getByRole('button', { name: "Load Sample" });
const jsonInput = screen.getByPlaceholderText(/Enter JSON data here/i);
const jmespathInput = screen.getByPlaceholderText(/Enter JMESPath expression/i);
@@ -331,7 +355,7 @@ describe('App Component', () => {
const user = userEvent.setup();
render(<App />);
const loadObjectButton = screen.getByTitle('Load JSON object from file');
const loadObjectButton = screen.getByRole('button', { name: "Load from Disk" });
// Create a mock file
const file = new File(['{"test": "file data"}'], 'test.json', {

View File

@@ -1,4 +1,23 @@
import React, { useState } from 'react';
import React, { useState } from "react";
import {
Box,
Typography,
Paper,
TextField,
Button,
Grid,
Tooltip,
IconButton,
ToggleButtonGroup,
ToggleButton,
Divider,
} from "@mui/material";
import {
ContentCopy as ContentCopyIcon,
Autorenew as AutorenewIcon,
Check as CheckIcon,
Key as KeyIcon,
} from "@mui/icons-material";
function CodeBlock({ code }) {
const [copySuccess, setCopySuccess] = useState(false);
@@ -9,28 +28,57 @@ function CodeBlock({ code }) {
setCopySuccess(true);
setTimeout(() => setCopySuccess(false), 2000);
} catch (err) {
console.error('Failed to copy to clipboard:', err);
console.error("Failed to copy to clipboard:", err);
}
};
return (
<div className="position-relative">
<pre className="bg-light p-3 pe-5 rounded border shadow-sm">
<code className="d-block" style={{ whiteSpace: 'pre-wrap' }}>{code}</code>
</pre>
<button
className={`btn btn-sm ${copySuccess ? 'btn-success' : 'btn-outline-secondary'} position-absolute top-0 end-0 m-2`}
onClick={handleCopy}
title="Copy code to clipboard"
style={{ opacity: 0.8 }}
<Box sx={{ position: "relative", my: 2 }}>
<Paper
variant="outlined"
sx={{
p: 2,
pr: 6,
bgcolor: "action.hover",
fontFamily: "'JetBrains Mono', 'Fira Code', monospace",
fontSize: "0.85rem",
whiteSpace: "pre-wrap",
wordBreak: "break-all",
position: "relative",
borderRadius: 2,
borderColor: "divider",
}}
>
{copySuccess ? '✓' : '📋'}
</button>
</div>
<code>{code}</code>
<Tooltip title={copySuccess ? "Copied!" : "Copy code"}>
<IconButton
size="small"
onClick={handleCopy}
sx={{
position: "absolute",
top: 8,
right: 8,
color: copySuccess ? "success.main" : "primary.main",
}}
>
{copySuccess ? (
<CheckIcon fontSize="small" />
) : (
<ContentCopyIcon fontSize="small" />
)}
</IconButton>
</Tooltip>
</Paper>
</Box>
);
}
function ApiKeyPage({ apiKey, onRegenerateApiKey, shellType, onShellTypeChange }) {
function ApiKeyPage({
apiKey,
onRegenerateApiKey,
shellType,
onShellTypeChange,
}) {
const [copySuccess, setCopySuccess] = useState(false);
const handleCopyToClipboard = async () => {
@@ -39,107 +87,117 @@ function ApiKeyPage({ apiKey, onRegenerateApiKey, shellType, onShellTypeChange }
setCopySuccess(true);
setTimeout(() => setCopySuccess(false), 2000);
} catch (err) {
console.error('Failed to copy to clipboard:', err);
// Fallback for older browsers
const textArea = document.createElement('textarea');
textArea.value = apiKey;
document.body.appendChild(textArea);
textArea.select();
document.execCommand('copy');
document.body.removeChild(textArea);
setCopySuccess(true);
setTimeout(() => setCopySuccess(false), 2000);
console.error("Failed to copy to clipboard:", err);
}
};
return (
<div className="row justify-content-center">
<div className="col-md-8">
<div className="card">
<div className="card-header">
<h5 className="mb-0">🔐 API Key Management</h5>
</div>
<div className="card-body">
<div className="mb-4">
<label className="form-label fw-bold">Your API Key:</label>
<div className="input-group">
<input
type="text"
className="form-control font-monospace"
value={apiKey}
readOnly
/>
<button
className={`btn ${copySuccess ? 'btn-success' : 'btn-outline-secondary'}`}
onClick={handleCopyToClipboard}
title="Copy API key to clipboard"
>
{copySuccess ? '✓ Copied!' : '📋 Copy'}
</button>
<button
className="btn btn-outline-primary"
onClick={onRegenerateApiKey}
title="Generate new API key"
>
🔄 Regenerate
</button>
</div>
<div className="form-text">
This API key is used to encrypt and authenticate data uploads.
</div>
</div>
<Box component="main" sx={{ flexGrow: 1, py: 4, px: 2 }}>
<Grid container justifyContent="center">
<Grid size={{ xs: 12, md: 8, lg: 6 }}>
<Paper elevation={1} sx={{ p: { xs: 3, md: 5 }, borderRadius: 4, bgcolor: "background.paper", border: 1, borderColor: "divider" }}>
<Typography variant="h5" gutterBottom sx={{ mb: 4, fontWeight: 700, display: "flex", alignItems: "center", gap: 1.5, color: "text.primary" }}>
<KeyIcon color="primary" /> API Key Management
</Typography>
<div className="mb-4">
<div className="d-flex justify-content-between align-items-center mb-2">
<h6 className="mb-0">📡 Remote Data Upload API</h6>
<div className="btn-group btn-group-sm" role="group" aria-label="Shell type selector">
<input
type="radio"
className="btn-check"
name="shellType"
id="shellBash"
autoComplete="off"
checked={shellType === 'bash'}
onChange={() => onShellTypeChange('bash')}
<Box sx={{ mb: 6 }}>
<Typography variant="subtitle2" gutterBottom color="text.secondary">
YOUR API KEY
</Typography>
<Box sx={{ display: "flex", gap: 1.5, alignItems: "center" }}>
<TextField
fullWidth
value={apiKey}
slotProps={{
input: {
readOnly: true,
style: { fontFamily: "'JetBrains Mono', 'Fira Code', monospace", fontSize: "0.9rem" },
},
}}
variant="outlined"
sx={{ "& .MuiOutlinedInput-root": { borderRadius: 4, bgcolor: "background.paper" } }}
/>
<label className="btn btn-outline-secondary" htmlFor="shellBash">UNIX (Bash)</label>
<input
type="radio"
className="btn-check"
name="shellType"
id="shellPowerShell"
autoComplete="off"
checked={shellType === 'powershell'}
onChange={() => onShellTypeChange('powershell')}
/>
<label className="btn btn-outline-secondary" htmlFor="shellPowerShell">Windows (PowerShell)</label>
</div>
</div>
<p className="text-muted">
External tools can upload sample data remotely using the REST API.
The API key is required for authentication. Define two
environment variables in your {shellType === 'bash' ? <code>.bashrc</code> : <code>PowerShell profile</code>}.
</p>
<Tooltip title="Copy API Key">
<IconButton
onClick={handleCopyToClipboard}
color={copySuccess ? "success" : "primary"}
size="medium"
sx={{ border: 1, borderColor: "divider" }}
>
{copySuccess ? <CheckIcon /> : <ContentCopyIcon />}
</IconButton>
</Tooltip>
<Tooltip title="Regenerate Key">
<IconButton
onClick={onRegenerateApiKey}
color="primary"
size="medium"
sx={{ border: 1, borderColor: "divider" }}
>
<AutorenewIcon />
</IconButton>
</Tooltip>
</Box>
<Typography variant="caption" color="text.secondary" sx={{ mt: 1.5, display: "block" }}>
This key is stored locally in your browser. Use it to authenticate remote data uploads.
</Typography>
</Box>
<Divider sx={{ my: 4, borderColor: "divider" }} />
<Box sx={{ mb: 4 }}>
<Box
sx={{
display: "flex",
justifyContent: "space-between",
alignItems: "center",
mb: 3,
flexWrap: "wrap",
gap: 2,
}}
>
<Typography variant="h6" fontWeight="600" color="text.primary">📡 Remote Upload API</Typography>
<ToggleButtonGroup
size="small"
value={shellType}
exclusive
onChange={(e, value) => value && onShellTypeChange(value)}
aria-label="shell type"
>
<ToggleButton value="bash">UNIX (Bash)</ToggleButton>
<ToggleButton value="powershell">Windows (PS)</ToggleButton>
</ToggleButtonGroup>
</Box>
<Typography variant="body2" color="text.secondary" paragraph>
Use this endpoint to upload data from external scripts. Set these environment variables:
</Typography>
<CodeBlock
code={shellType === 'bash'
? `export JMESPATH_PLAYGROUND_API_URL=${window.location.origin}\nexport JMESPATH_PLAYGROUND_API_KEY=${apiKey}`
: `$env:JMESPATH_PLAYGROUND_API_URL = "${window.location.origin}"\n$env:JMESPATH_PLAYGROUND_API_KEY = "${apiKey}"`}
code={
shellType === "bash"
? `export JMESPATH_PLAYGROUND_API_URL="${window.location.origin}"\nexport JMESPATH_PLAYGROUND_API_KEY="${apiKey}"`
: `$env:JMESPATH_PLAYGROUND_API_URL = "${window.location.origin}"\n$env:JMESPATH_PLAYGROUND_API_KEY = "${apiKey}"`
}
/>
<p className="text-muted">Then, use the following {shellType === 'bash' ? <code>curl</code> : <code>PowerShell</code>} command to upload your data:</p>
<CodeBlock
code={shellType === 'bash'
? `curl -s -X POST \\\n -H "Content-Type: application/json" \\\n -H "Accept: application/json" \\\n -H "X-API-Key: $JMESPATH_PLAYGROUND_API_KEY" \\\n --data @__JSON_FILE_NAME__ \\\n "$JMESPATH_PLAYGROUND_API_URL/api/v1/upload"`
: `Invoke-RestMethod -Uri "$env:JMESPATH_PLAYGROUND_API_URL/api/v1/upload" \\\n -Method Post \\\n -ContentType "application/json" \\\n -Headers @{\n "X-API-Key" = $env:JMESPATH_PLAYGROUND_API_KEY\n "Accept" = "application/json"\n } \\\n -InFile __JSON_FILE_NAME__`}
code={
shellType === "bash"
? `curl -X POST "$JMESPATH_PLAYGROUND_API_URL/api/v1/upload" \\
-H "Accept: application/json" \\
-H "x-api-key: $JMESPATH_PLAYGROUND_API_KEY" \\
-d '{ "users": [ { "id": 1, "name": "Remote User" } ] }'`
: `Invoke-RestMethod -Method Post -Uri "$env:JMESPATH_PLAYGROUND_API_URL/api/v1/upload" \`
-Headers @{ "Accept" = "application/json"; "x-api-key" = $env:JMESPATH_PLAYGROUND_API_KEY } \`
-Body '{ "users": [ { "id": 1, "name": "Remote User" } ] }'`
}
/>
<div className="form-text">
Replace <code>{"__JSON_FILE_NAME__"}</code> with the path to your
JSON file containing the sample data. {shellType === 'bash' && <span>or use <code>-</code> to read from standard input.</span>}
</div>
</div>
</div>
</div>
</div>
</div>
</Box>
</Paper>
</Grid>
</Grid>
</Box>
);
}

View File

@@ -1,27 +1,58 @@
import React from 'react';
import { VERSION } from '../version';
import React from "react";
import { Box, Typography, Container, Link, Grid } from "@mui/material";
import { VERSION } from "../version";
function Footer() {
return (
<footer className="bg-light border-top mt-2 py-2 flex-shrink-0">
<div className="container">
<div className="row">
<div className="col-md-6">
<p className="mb-0 text-muted small">
<strong>JMESPath Testing Tool</strong> {VERSION === 'unknown' ? VERSION : `v${VERSION}`} - Created for testing and validating JMESPath expressions
</p>
</div>
<div className="col-md-6 text-md-end">
<p className="mb-0 text-muted small">
Licensed under <a href="https://opensource.org/licenses/MIT" target="_blank" rel="noopener noreferrer" className="text-decoration-none">MIT License</a> |
<a href="https://jmespath.org/" target="_blank" rel="noopener noreferrer" className="text-decoration-none ms-2">
<Box
component="footer"
sx={{
py: 2,
mt: 2,
borderTop: 1,
borderColor: "divider",
bgcolor: "background.paper",
flexShrink: 0,
}}
>
<Container maxWidth="xl">
<Grid container spacing={2} alignItems="center">
<Grid size={{ xs: 12, md: 6 }}>
<Typography variant="body2" color="text.secondary">
<strong>JMESPath Testing Tool</strong>{" "}
{VERSION === "unknown" ? VERSION : `v${VERSION}`} - Created for
testing and validating JMESPath expressions
</Typography>
</Grid>
<Grid size={{ xs: 12, md: 6 }} sx={{ textAlign: { md: "right" } }}>
<Typography variant="body2" color="text.secondary">
Licensed under{" "}
<Link
href="https://opensource.org/licenses/MIT"
target="_blank"
rel="noopener noreferrer"
color="primary"
underline="hover"
sx={{ fontWeight: 500 }}
>
MIT License
</Link>{" "}
|{" "}
<Link
href="https://jmespath.org/"
target="_blank"
rel="noopener noreferrer"
color="primary"
underline="hover"
sx={{ ml: 1, fontWeight: 500 }}
>
Learn JMESPath
</a>
</p>
</div>
</div>
</div>
</footer>
</Link>
</Typography>
</Grid>
</Grid>
</Container>
</Box>
);
}

View File

@@ -1,71 +1,88 @@
import React from 'react';
import React from "react";
import {
Box,
Typography,
Button,
ToggleButton,
ToggleButtonGroup,
Tooltip,
AppBar,
Toolbar,
Container,
Divider,
} from "@mui/material";
import KeyIcon from "@mui/icons-material/Key";
import HomeIcon from "@mui/icons-material/Home";
import BrightnessAutoIcon from "@mui/icons-material/BrightnessAuto";
import LightModeIcon from "@mui/icons-material/LightMode";
import DarkModeIcon from "@mui/icons-material/DarkMode";
function Header({ theme, onThemeChange, currentPage, onPageChange }) {
return (
<div className="header-section">
<div className="container-fluid px-4">
<div className="row align-items-center">
<div className="col-12 text-center position-relative">
<h2 className="mb-1">JMESPath Testing Tool</h2>
{/* Right side controls - better positioning */}
<div className="position-absolute top-50 end-0 translate-middle-y d-flex align-items-center gap-2 me-4">
{/* API Key Management Button - more prominent */}
<button
type="button"
className={`btn btn-sm ${
currentPage === 'apikey'
? 'btn-warning fw-bold text-dark'
: 'btn-outline-warning'
}`}
onClick={() => onPageChange(currentPage === 'main' ? 'apikey' : 'main')}
title="API Key Management"
<AppBar position="static" color="default" elevation={1} sx={{ borderBottom: 1, borderColor: "divider" }}>
<Container maxWidth="xl">
<Toolbar disableGutters sx={{ display: "flex", justifyContent: "space-between", height: 64 }}>
{/* Brand/Title */}
<Box sx={{ display: "flex", alignItems: "center" }}>
<Typography
variant="h6"
noWrap
component="div"
sx={{
fontWeight: 700,
color: "primary.main",
letterSpacing: ".05rem",
}}
>
🔐 API Keys
</button>
{/* Theme switcher with theme-aware classes */}
<div className="btn-group btn-group-sm" role="group" aria-label="Theme switcher">
<button
type="button"
className={`btn ${
theme === 'auto'
? 'btn-light active'
: 'btn-outline-light'
}`}
onClick={() => onThemeChange('auto')}
title="Auto (follow system)"
JMESPath Playground
</Typography>
</Box>
{/* Right side controls */}
<Box sx={{ display: "flex", alignItems: "center", gap: 1 }}>
{/* API Key Management Button */}
<Tooltip title={currentPage === "main" ? "API Key Management" : "Back to Testing"}>
<Button
variant={currentPage === "apikey" ? "contained" : "text"}
color={currentPage === "apikey" ? "primary" : "primary"}
size="medium"
startIcon={currentPage === "main" ? <KeyIcon /> : <HomeIcon />}
onClick={() => onPageChange(currentPage === "main" ? "apikey" : "main")}
>
🌓 Auto
</button>
<button
type="button"
className={`btn ${
theme === 'light'
? 'btn-light active'
: 'btn-outline-light'
}`}
onClick={() => onThemeChange('light')}
title="Light theme"
{currentPage === "main" ? "API Keys" : "Home"}
</Button>
</Tooltip>
<Divider orientation="vertical" flexItem sx={{ my: 2, mx: 1 }} />
{/* Theme switcher */}
<ToggleButtonGroup
value={theme}
exclusive
onChange={(e, nextTheme) => nextTheme && onThemeChange(nextTheme)}
aria-label="theme switcher"
size="small"
>
Light
</button>
<button
type="button"
className={`btn ${
theme === 'dark'
? 'btn-light active'
: 'btn-outline-light'
}`}
onClick={() => onThemeChange('dark')}
title="Dark theme"
>
🌙 Dark
</button>
</div>
</div>
</div>
</div>
</div>
</div>
<Tooltip title="Follow system theme">
<ToggleButton value="auto" aria-label="Auto">
<BrightnessAutoIcon sx={{ fontSize: "1.2rem" }} />
</ToggleButton>
</Tooltip>
<Tooltip title="Light mode">
<ToggleButton value="light" aria-label="Light">
<LightModeIcon sx={{ fontSize: "1.2rem" }} />
</ToggleButton>
</Tooltip>
<Tooltip title="Dark mode">
<ToggleButton value="dark" aria-label="Dark">
<DarkModeIcon sx={{ fontSize: "1.2rem" }} />
</ToggleButton>
</Tooltip>
</ToggleButtonGroup>
</Box>
</Toolbar>
</Container>
</AppBar>
);
}

View File

@@ -1,4 +1,31 @@
import React, { useState, useEffect } from "react";
import {
Box,
Typography,
Paper,
TextField,
Button,
Grid,
Tooltip,
IconButton,
Alert,
Stack,
Divider,
} from "@mui/material";
import {
Search as SearchIcon,
DataObject as DataObjectIcon,
Output as OutputIcon,
UploadFile as UploadFileIcon,
FileOpen as FileOpenIcon,
Restore as RestoreIcon,
FormatAlignLeft as FormatAlignLeftIcon,
Clear as ClearIcon,
ContentCopy as ContentCopyIcon,
Download as DownloadIcon,
Check as CheckIcon,
Refresh as RefreshIcon,
} from "@mui/icons-material";
import jmespath from "jmespath";
function MainPage({
@@ -160,173 +187,275 @@ function MainPage({
};
return (
<>
{/* Description paragraph */}
<div className="row mb-2">
<div className="col-12">
<p className="text-muted text-center mb-2 small">
Validate and test JMESPath expressions against JSON data in
real-time. Enter your JMESPath query and JSON data below to see the
results instantly.
</p>
</div>
</div>
<Box component="main" sx={{ flexGrow: 1, py: 3, px: { xs: 2, md: 4 } }}>
<Box sx={{ mb: 4, maxWidth: 800, mx: "auto" }}>
<Typography
variant="body1"
color="text.secondary"
align="center"
sx={{ mb: 3 }}
>
Validate and test JMESPath expressions against JSON data in real-time.
Enter your JMESPath query and JSON data below to see the results
instantly.
</Typography>
</Box>
{/* Middle Section: JMESPath Expression Input */}
<div className="row mb-2">
<div className="col-12">
<div className="card">
<div className="card-header py-2">
<h6 className="mb-0">
<i className="bi bi-search me-2"></i>
<Paper
sx={{
mb: 4,
p: 0,
borderRadius: 2,
overflow: "hidden",
bgcolor: "background.paper",
}}
>
<Box
sx={{
px: 3,
py: 1.5,
display: "flex",
alignItems: "center",
gap: 1.5,
bgcolor: "action.hover",
}}
>
<SearchIcon sx={{ fontSize: 24 }} color="primary" />
<Typography variant="subtitle1" fontWeight="600">
JMESPath Expression
</h6>
</div>
<div className="card-body">
<input
type="text"
className={`form-control jmespath-input ${error ? "error" : "success"}`}
</Typography>
</Box>
<Box sx={{ px: 3, pb: 2 }}>
<TextField
fullWidth
placeholder="Enter JMESPath expression (e.g., people[*].name)"
value={jmespathExpression}
onChange={handleJmespathChange}
placeholder="Enter JMESPath expression (e.g., people[*].name)"
/>
<div
className={`alert mt-2 mb-0 d-flex justify-content-between align-items-center ${error ? "alert-danger" : "alert-success"}`}
>
<small className="mb-0">
{error || "Expression is correct"}
</small>
{showReloadButton && (
<button
className="btn btn-light btn-sm ms-2 border"
onClick={() => {
onReloadSampleData();
error={!!error}
helperText={error || " "}
FormHelperTextProps={{
sx: { color: error ? "error.main" : "success.main", fontWeight: 500 }
}}
title="New sample data is available"
slotProps={{
input: {
style: { fontFamily: "'JetBrains Mono', 'Fira Code', monospace", fontSize: "1rem" },
},
}}
sx={{
"& .MuiOutlinedInput-root": {
borderRadius: 3,
bgcolor: "background.paper",
}
}}
/>
{showReloadButton && (
<Box sx={{ display: "flex", justifyContent: "center", mt: -1, mb: 2 }}>
<Button
variant="contained"
color="secondary"
onClick={onReloadSampleData}
startIcon={<RefreshIcon />}
size="small"
>
<i className="bi bi-arrow-clockwise me-1"></i>
Reload Sample Data
</button>
New data available - Reload
</Button>
</Box>
)}
</div>
</div>
</div>
</div>
</div>
</Box>
</Paper>
{/* Lower Middle Section: Input and Output Areas */}
<div className="row flex-grow-1" style={{ minHeight: 0 }}>
{/* Left Panel: JSON Data Input */}
<div className="col-md-6">
<div className="card h-100 d-flex flex-column">
<div className="card-header d-flex justify-content-between align-items-center py-2">
<h6 className="mb-0">
<i className="bi bi-file-earmark-code me-2"></i>
JSON Data
</h6>
<div>
<button
className="btn btn-outline-success btn-sm me-2"
onClick={loadFromDisk}
title="Load JSON object from file"
<Grid container spacing={3} sx={{ flexGrow: 1, minHeight: 0 }}>
<Grid size={{ xs: 12, md: 6 }} sx={{ display: "flex", flexDirection: "column" }}>
<Paper
sx={{
flexGrow: 1,
display: "flex",
flexDirection: "column",
borderRadius: 4,
overflow: "hidden",
bgcolor: "background.paper",
}}
>
📄 Load an Object
</button>
<button
className="btn btn-outline-info btn-sm me-2"
onClick={loadLogFile}
title="Load JSON Lines log file"
<Box
sx={{
px: 2,
py: 2,
bgcolor: "action.hover",
borderBottom: 1,
borderColor: "divider",
display: "flex",
justifyContent: "space-between",
alignItems: "center",
flexWrap: "wrap",
gap: 1,
}}
>
📋 Load a Log File
</button>
<button
className="btn btn-outline-primary btn-sm me-2"
onClick={loadSample}
title="Load sample data"
>
Load Sample
</button>
<button
className="btn btn-outline-secondary btn-sm me-2"
onClick={formatJson}
title="Format JSON"
>
Format JSON
</button>
<button
className="btn btn-outline-danger btn-sm"
onClick={clearAll}
title="Clear all inputs"
>
Clear All
</button>
</div>
</div>
<div
className="card-body flex-grow-1 d-flex flex-column"
style={{ minHeight: 0 }}
>
<textarea
className={`form-control json-input flex-grow-1 ${jsonError ? "error" : "success"}`}
<Box sx={{ display: "flex", alignItems: "center" }}>
<DataObjectIcon sx={{ mr: 1, fontSize: 20 }} color="primary" />
<Typography variant="subtitle2" color="text.primary">
JSON Input
</Typography>
</Box>
<Stack direction="row" spacing={1} flexWrap="wrap">
<Tooltip title="Load from Disk">
<span>
<IconButton size="medium" onClick={loadFromDisk} color="primary" aria-label="Load from Disk">
<FileOpenIcon fontSize="small" />
</IconButton>
</span>
</Tooltip>
<Tooltip title="Load Logs">
<span>
<IconButton size="medium" onClick={loadLogFile} color="primary" aria-label="Load Logs">
<UploadFileIcon fontSize="small" />
</IconButton>
</span>
</Tooltip>
<Tooltip title="Load Sample">
<span>
<IconButton size="medium" onClick={loadSample} color="primary" aria-label="Load Sample">
<RestoreIcon fontSize="small" />
</IconButton>
</span>
</Tooltip>
<Tooltip title="Format">
<span>
<IconButton size="medium" onClick={formatJson} color="primary" aria-label="Format">
<FormatAlignLeftIcon fontSize="small" />
</IconButton>
</span>
</Tooltip>
<Divider orientation="vertical" flexItem sx={{ mx: 0.5 }} />
<Tooltip title="Clear">
<span>
<IconButton size="medium" onClick={clearAll} color="secondary" aria-label="Clear all inputs">
<ClearIcon fontSize="small" />
</IconButton>
</span>
</Tooltip>
</Stack>
</Box>
<Box sx={{ p: 2, flexGrow: 1, display: "flex", flexDirection: "column" }}>
<TextField
multiline
fullWidth
value={jsonData}
onChange={handleJsonChange}
placeholder="Enter JSON data here..."
style={{ minHeight: 0, resize: "none" }}
error={!!jsonError}
variant="standard"
slotProps={{
input: {
disableUnderline: true,
style: {
fontFamily: "'JetBrains Mono', 'Fira Code', monospace",
height: "100%",
alignItems: "flex-start",
fontSize: "0.85rem",
lineHeight: 1.5,
},
},
}}
sx={{
flexGrow: 1,
"& .MuiInputBase-root": { height: "100%", overflow: "auto" },
}}
/>
{jsonError && (
<div className="alert alert-danger mt-2 mb-0">
<small>{jsonError}</small>
</div>
<Alert severity="error" sx={{ mt: 1, borderRadius: 2 }} variant="filled">
{jsonError}
</Alert>
)}
</div>
</div>
</div>
</Box>
</Paper>
</Grid>
{/* Right Panel: Results */}
<div className="col-md-6">
<div className="card h-100 d-flex flex-column">
<div className="card-header py-2 d-flex justify-content-between align-items-center">
<h6 className="mb-0">
<i className="bi bi-output me-2"></i>
Results
</h6>
<div>
<button
className={`btn btn-sm me-2 ${copySuccess ? "btn-success" : "btn-outline-secondary"}`}
<Grid size={{ xs: 12, md: 6 }} sx={{ display: "flex", flexDirection: "column" }}>
<Paper
sx={{
flexGrow: 1,
display: "flex",
flexDirection: "column",
borderRadius: 4,
overflow: "hidden",
bgcolor: "background.paper",
}}
>
<Box
sx={{
px: 2,
py: 2,
bgcolor: "action.hover",
borderBottom: 1,
borderColor: "divider",
display: "flex",
justifyContent: "space-between",
alignItems: "center",
}}
>
<Box sx={{ display: "flex", alignItems: "center" }}>
<OutputIcon sx={{ mr: 1, fontSize: 20 }} color="primary" />
<Typography variant="subtitle2" color="text.primary">
Query Result
</Typography>
</Box>
<Stack direction="row" spacing={1}>
<Tooltip title="Copy to Clipboard">
<span>
<IconButton
size="medium"
onClick={copyToClipboard}
disabled={!result || result === "null"}
title="Copy result to clipboard"
color={copySuccess ? "success" : "primary"}
>
<i className={`bi ${copySuccess ? "bi-check-lg" : "bi-clipboard"} me-1`}></i>
{copySuccess ? "Copied!" : "Copy"}
</button>
<button
className="btn btn-outline-secondary btn-sm"
{copySuccess ? <CheckIcon fontSize="small" /> : <ContentCopyIcon fontSize="small" />}
</IconButton>
</span>
</Tooltip>
<Tooltip title="Download Result">
<span>
<IconButton
size="medium"
onClick={downloadResult}
disabled={!result || result === "null"}
title="Download result as JSON file"
color="primary"
>
<i className="bi bi-download me-1"></i>
Download
</button>
</div>
</div>
<div
className="card-body flex-grow-1 d-flex flex-column"
style={{ minHeight: 0 }}
>
<textarea
className="form-control result-output flex-grow-1"
<DownloadIcon fontSize="small" />
</IconButton>
</span>
</Tooltip>
</Stack>
</Box>
<Box sx={{ p: 2, flexGrow: 1, display: "flex", flexDirection: "column" }}>
<TextField
multiline
fullWidth
value={result}
readOnly
slotProps={{
input: {
readOnly: true,
disableUnderline: true,
style: {
fontFamily: "'JetBrains Mono', 'Fira Code', monospace",
height: "100%",
alignItems: "flex-start",
fontSize: "0.85rem",
lineHeight: 1.5,
},
},
}}
variant="standard"
placeholder="Results will appear here..."
style={{ minHeight: 0, resize: "none" }}
sx={{
flexGrow: 1,
"& .MuiInputBase-root": { height: "100%", overflow: "auto" },
}}
/>
</div>
</div>
</div>
</div>
</>
</Box>
</Paper>
</Grid>
</Grid>
</Box>
);
}

View File

@@ -1,8 +1,7 @@
import React from 'react';
import ReactDOM from 'react-dom/client';
import 'bootstrap/dist/css/bootstrap.min.css';
import './index.css';
import App from './App';
import React from "react";
import ReactDOM from "react-dom/client";
import "./index.css";
import App from "./App";
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(