mirror of
https://github.com/gchq/CyberChef.git
synced 2024-11-16 08:58:30 +01:00
function tidy, add comments
This commit is contained in:
parent
fca4ed7013
commit
b8b98358d0
3 changed files with 119 additions and 69 deletions
|
@ -1,54 +0,0 @@
|
||||||
/**
|
|
||||||
* Wrap operations in a
|
|
||||||
*
|
|
||||||
* @author d98762625 [d98762625@gmail.com]
|
|
||||||
* @copyright Crown Copyright 2018
|
|
||||||
* @license Apache-2.0
|
|
||||||
*/
|
|
||||||
|
|
||||||
import Dish from "../core/Dish";
|
|
||||||
import log from "loglevel";
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract default arg value from operation argument
|
|
||||||
* @param {Object} arg - an arg from an operation
|
|
||||||
*/
|
|
||||||
function extractArg(arg) {
|
|
||||||
if (arg.type === "option" || arg.type === "editableOption") {
|
|
||||||
return arg.value[0];
|
|
||||||
}
|
|
||||||
|
|
||||||
return arg.value;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Wrap an operation to be consumed by node API.
|
|
||||||
* new Operation().run() becomes operation()
|
|
||||||
* @param Operation
|
|
||||||
*/
|
|
||||||
export default function wrap(Operation) {
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
return async (input, args=null) => {
|
|
||||||
const operation = new Operation();
|
|
||||||
const dish = new Dish(input);
|
|
||||||
|
|
||||||
try {
|
|
||||||
dish.findType();
|
|
||||||
} catch (e) {
|
|
||||||
log.debug(e);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!args) {
|
|
||||||
args = operation.args.map(extractArg);
|
|
||||||
} else {
|
|
||||||
// Allows single arg ops to have arg defined not in array
|
|
||||||
if (!(args instanceof Array)) {
|
|
||||||
args = [args];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const transformedInput = await dish.get(Dish.typeEnum(operation.inputType));
|
|
||||||
return operation.run(transformedInput, args);
|
|
||||||
};
|
|
||||||
}
|
|
112
src/node/apiUtils.mjs
Normal file
112
src/node/apiUtils.mjs
Normal file
|
@ -0,0 +1,112 @@
|
||||||
|
/**
|
||||||
|
* Wrap operations for consumption in Node
|
||||||
|
*
|
||||||
|
* @author d98762625 [d98762625@gmail.com]
|
||||||
|
* @copyright Crown Copyright 2018
|
||||||
|
* @license Apache-2.0
|
||||||
|
*/
|
||||||
|
|
||||||
|
import Dish from "../core/Dish";
|
||||||
|
import log from "loglevel";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extract default arg value from operation argument
|
||||||
|
* @param {Object} arg - an arg from an operation
|
||||||
|
*/
|
||||||
|
function extractArg(arg) {
|
||||||
|
if (arg.type === "option" || arg.type === "editableOption") {
|
||||||
|
return arg.value[0];
|
||||||
|
}
|
||||||
|
|
||||||
|
return arg.value;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrap an operation to be consumed by node API.
|
||||||
|
* new Operation().run() becomes operation()
|
||||||
|
* Perform type conversion on input
|
||||||
|
* @param {Operation} Operation
|
||||||
|
* @returns {Function} The operation's run function, wrapped in
|
||||||
|
* some type conversion logic
|
||||||
|
*/
|
||||||
|
export function wrap(Operation) {
|
||||||
|
/**
|
||||||
|
* Wrapped operation run function
|
||||||
|
*/
|
||||||
|
return async (input, args=null) => {
|
||||||
|
const operation = new Operation();
|
||||||
|
const dish = new Dish(input);
|
||||||
|
|
||||||
|
try {
|
||||||
|
dish.findType();
|
||||||
|
} catch (e) {
|
||||||
|
log.debug(e);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!args) {
|
||||||
|
args = operation.args.map(extractArg);
|
||||||
|
} else {
|
||||||
|
// Allows single arg ops to have arg defined not in array
|
||||||
|
if (!(args instanceof Array)) {
|
||||||
|
args = [args];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const transformedInput = await dish.get(Dish.typeEnum(operation.inputType));
|
||||||
|
return operation.run(transformedInput, args);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
* @param searchTerm
|
||||||
|
*/
|
||||||
|
export function search(searchTerm) {
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extract properties from an operation by instantiating it and
|
||||||
|
* returning some of its properties for reference.
|
||||||
|
* @param {Operation} Operation - the operation to extract info from
|
||||||
|
* @returns {Object} operation properties
|
||||||
|
*/
|
||||||
|
function extractOperationInfo(Operation) {
|
||||||
|
const operation = new Operation();
|
||||||
|
return {
|
||||||
|
name: operation.name,
|
||||||
|
module: operation.module,
|
||||||
|
description: operation.description,
|
||||||
|
inputType: operation.inputType,
|
||||||
|
outputType: operation.outputType,
|
||||||
|
args: Object.assign([], operation.args),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param {Object} operations - an object filled with operations.
|
||||||
|
* @param {String} searchTerm - the name of the operation to get help for.
|
||||||
|
* Case and whitespace are ignored in search.
|
||||||
|
* @returns {Object} listing properties of function
|
||||||
|
*/
|
||||||
|
export function help(operations, searchTerm) {
|
||||||
|
if (typeof searchTerm === "string") {
|
||||||
|
const operation = operations[Object.keys(operations).find(o =>
|
||||||
|
o.toLowerCase() === searchTerm.replace(/ /g, "").toLowerCase())];
|
||||||
|
if (operation) {
|
||||||
|
return extractOperationInfo(operation);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* SomeName => someName
|
||||||
|
* @param {String} name - string to be altered
|
||||||
|
* @returns {String} decapitalised
|
||||||
|
*/
|
||||||
|
export function decapitalise(name) {
|
||||||
|
return `${name.charAt(0).toLowerCase()}${name.substr(1)}`;
|
||||||
|
}
|
|
@ -2,11 +2,14 @@
|
||||||
* Node view for CyberChef.
|
* Node view for CyberChef.
|
||||||
*
|
*
|
||||||
* @author n1474335 [n1474335@gmail.com]
|
* @author n1474335 [n1474335@gmail.com]
|
||||||
* @copyright Crown Copyright 2017
|
* @copyright Crown Copyright 2018
|
||||||
* @license Apache-2.0
|
* @license Apache-2.0
|
||||||
*/
|
*/
|
||||||
import "babel-polyfill";
|
import "babel-polyfill";
|
||||||
|
|
||||||
|
import {wrap, help, decapitalise} from "./apiUtils";
|
||||||
|
import * as operations from "../core/operations/index";
|
||||||
|
|
||||||
// Define global environment functions
|
// Define global environment functions
|
||||||
global.ENVIRONMENT_IS_WORKER = function() {
|
global.ENVIRONMENT_IS_WORKER = function() {
|
||||||
return typeof importScripts === "function";
|
return typeof importScripts === "function";
|
||||||
|
@ -19,24 +22,13 @@ global.ENVIRONMENT_IS_WEB = function() {
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
||||||
import wrap from "./Wrapper";
|
|
||||||
|
|
||||||
import * as operations from "../core/operations/index";
|
|
||||||
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
* @param name
|
|
||||||
*/
|
|
||||||
function decapitalise(name) {
|
|
||||||
return `${name.charAt(0).toLowerCase()}${name.substr(1)}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// console.log(operations);
|
|
||||||
const chef = {};
|
const chef = {};
|
||||||
|
|
||||||
|
// Add in wrapped operations with camelCase names
|
||||||
Object.keys(operations).forEach(op =>
|
Object.keys(operations).forEach(op =>
|
||||||
chef[decapitalise(op)] = wrap(operations[op]));
|
chef[decapitalise(op)] = wrap(operations[op]));
|
||||||
|
|
||||||
|
chef.help = help.bind(null, operations);
|
||||||
|
|
||||||
export default chef;
|
export default chef;
|
||||||
export {chef};
|
export {chef};
|
||||||
|
|
Loading…
Reference in a new issue