Updated to version 0.20.2. Fixed bug with Netscript arrays. Updated documentation

This commit is contained in:
Daniel Xie 2017-06-11 15:28:20 -05:00
parent 59817db626
commit 5de47f600a
4 changed files with 81 additions and 18 deletions

@ -1,5 +1,5 @@
CONSTANTS = { CONSTANTS = {
Version: "0.20.1", Version: "0.20.2",
//Max level for any skill, assuming no multipliers. Determined by max numerical value in javascript for experience //Max level for any skill, assuming no multipliers. Determined by max numerical value in javascript for experience
//and the skill level formula in Player.js. Note that all this means it that when experience hits MAX_INT, then //and the skill level formula in Player.js. Note that all this means it that when experience hits MAX_INT, then
@ -251,11 +251,11 @@ CONSTANTS = {
"Here are some Terminal commands that are useful when working with scripts: <br>" + "Here are some Terminal commands that are useful when working with scripts: <br>" +
"free - Shows the current server's RAM usage and availability <br>" + "free - Shows the current server's RAM usage and availability <br>" +
"kill [script] - Stops a script that is running <br>" + "kill [script] - Stops a script that is running <br>" +
"mem [script] - Check how much RAM a script requires to run<br>" + "mem [script] [-t] [n] - Check how much RAM a script requires to run with n threads<br>" +
"nano [script] - Create/Edit a script <br>" + "nano [script] - Create/Edit a script <br>" +
"ps - Displays all scripts that are actively running on the current server<br>" + "ps - Displays all scripts that are actively running on the current server<br>" +
"rm [script] - Delete a script<br>" + "rm [script] - Delete a script<br>" +
"run [script] - Run a script <br>" + "run [script] [-t] [n] - Run a script with n threads<br>" +
"tail [script] - Displays a script's logs<br>" + "tail [script] - Displays a script's logs<br>" +
"top - Displays all active scripts and their RAM usage <br><br>" + "top - Displays all active scripts and their RAM usage <br><br>" +
"<u><h1> Multithreading scripts </h1></u><br>" + "<u><h1> Multithreading scripts </h1></u><br>" +
@ -318,13 +318,22 @@ CONSTANTS = {
"&nbsp;==<br>" + "&nbsp;==<br>" +
"&nbsp;!=<br><br>" + "&nbsp;!=<br><br>" +
"<u><h1> Arrays </h1></u><br>" + "<u><h1> Arrays </h1></u><br>" +
"Note: Currently arrays are fixed-size once they are declared. Eventually, functionality will be added to make these " +
"dynamic arrays <br><br>" +
"Arrays are special container objects. Arrays can holy many values under a single name. Each value in the array " + "Arrays are special container objects. Arrays can holy many values under a single name. Each value in the array " +
"can be accessed using an index number. The following example shows how to declare an array: <br><br>" + "can be accessed using an index number. The following example shows how to declare an array: <br><br>" +
"var thisIsAnArray = Array[1, 2, 3, 'bitburner!', false];<br><br>" + "thisIsAnArray = Array[1, 2, 3, 'bitburner!', false];<br><br>" +
"Note that the values in an array can be different types. To access this array we just declared, we can use the index " + "Note that the values in an array can be different types. To access this array we just declared, we can use the index " +
"operator on the array's name: <br><br>" + "operator on the array's name: <br><br>" +
"print(thisIsAnArray[0]); <br>" + "print(thisIsAnArray[0]); <br>" +
"thisIsAnArray[1] = 5" + "thisIsAnArray[1] = 5<br>" +
"thisIsAnArray[3] = 'string concatenation ' + 123<br><br>" +
"Note that arrays are indexed starting at index 0. Using an index that is too large or less than 0 will result in an " +
"out of bounds runtime error. <br><br>" +
"If an element in an array is assigned to a value that includes a variable, then it holds a reference to that variable. " +
"What this means is that if the variable changes, the array element will also change accordingly. For example:<br><br>" +
"x = 10;<br>testArr = Array[x];<br>print(testArr[0]);<br>x = 20;<br>print(testArr[0]);<br><br>" +
"This code will print: <br><br>10<br>20<br><br>" +
"<u><h1> Functions </h1></u><br>" + "<u><h1> Functions </h1></u><br>" +
"You can NOT define you own functions in Netscript (yet), but there are several built in functions that " + "You can NOT define you own functions in Netscript (yet), but there are several built in functions that " +
"you may use: <br><br> " + "you may use: <br><br> " +
@ -361,14 +370,14 @@ CONSTANTS = {
"<i>sqlinject(hostname/ip)</i><br>Run SQLInject.exe on the target server. SQLInject.exe must exist on your home computer. Does NOT work while offline <br> Example: sqlinject('foodnstuff');<br><br>" + "<i>sqlinject(hostname/ip)</i><br>Run SQLInject.exe on the target server. SQLInject.exe must exist on your home computer. Does NOT work while offline <br> Example: sqlinject('foodnstuff');<br><br>" +
"<i>run(script, [numThreads])</i> <br> Run a script as a separate process. The first argument that is passed in is the name of the script as a string. This function can only " + "<i>run(script, [numThreads])</i> <br> Run a script as a separate process. The first argument that is passed in is the name of the script as a string. This function can only " +
"be used to run scripts located on the current server (the server running the script that calls this function). The second argument " + "be used to run scripts located on the current server (the server running the script that calls this function). The second argument " +
"is optional, and it specifies how many threads to run the script with. If it is omitted, then the script is run single-threaded. " + "is optional, and it specifies how many threads to run the script with. If it is omitted, then the script will be run single-threaded. " +
"This second argument must be a number that is greater than 0. " + "This second argument must be a number that is greater than 0. " +
"Returns true if the script is successfully started, and false otherwise. Requires a significant amount " + "Returns true if the script is successfully started, and false otherwise. Requires a significant amount " +
"of RAM to run this command. Does NOT work while offline <br>Example: run('hack-foodnstuff.script'); <br> The example above will try and launch the 'hack-foodnstuff.script' script on " + "of RAM to run this command. Does NOT work while offline <br>Example: run('hack-foodnstuff.script'); <br> The example above will try and launch the 'hack-foodnstuff.script' script on " +
"the current server, if it exists. <br><br>" + "the current server, if it exists. <br><br>" +
"<i>exec(script, hostname/ip, [numThreads])</i><br>Run a script as a separate process on another server. The first argument is the name of the script as a string. The " + "<i>exec(script, hostname/ip, [numThreads])</i><br>Run a script as a separate process on another server. The first argument is the name of the script as a string. The " +
"second argument is a string with the hostname or IP of the 'target server' on which to run the script. The specified script must exist on the target server. " + "second argument is a string with the hostname or IP of the 'target server' on which to run the script. The specified script must exist on the target server. " +
"The third argument is optional, and it specifies how many threads to run the script with. If it is omitted, then the script is run single-threaded. " + "The third argument is optional, and it specifies how many threads to run the script with. If it is omitted, then the script will be run single-threaded. " +
"This argument must be a number that is greater than 0. Returns " + "This argument must be a number that is greater than 0. Returns " +
"true if the script is successfully started, and false otherwise. Does NOT work while offline<br> " + "true if the script is successfully started, and false otherwise. Does NOT work while offline<br> " +
"Example: exec('generic-hack.script', 'foodnstuff'); <br> The example above will try to launch the script 'generic-hack.script' on the 'foodnstuff' server.<br><br>" + "Example: exec('generic-hack.script', 'foodnstuff'); <br> The example above will try to launch the script 'generic-hack.script' on the 'foodnstuff' server.<br><br>" +

@ -1,5 +1,6 @@
/* Netscript Functions /* Netscript Functions
* Implementation for Netscript features */ * Implementation for Netscript features */
/*
function netscriptAssign(exp, workerScript) { function netscriptAssign(exp, workerScript) {
var env = workerScript.env; var env = workerScript.env;
return new Promise(function(resolve, reject) { return new Promise(function(resolve, reject) {
@ -65,6 +66,58 @@ function netscriptAssign(exp, workerScript) {
} }
}); });
} }
*/
function netscriptAssign(exp, workerScript) {
var env = workerScript.env;
return new Promise(function(resolve, reject) {
if (env.stopFlag) {return reject(workerScript);}
if (exp.left.type != "var") {
return reject(makeRuntimeRejectMsg(workerScript, "Cannot assign to " + JSON.stringify(exp.left)));
}
//Assigning an element in an array
if (exp.left.index) {
try {
var res = env.get(exp.left.value);
if (res.constructor === Array || res instanceof Array) {
var i = 0;
var iPromise = evaluate(exp.left.index.value, workerScript);
iPromise.then(function(idx) {
if (idx >= res.length || idx < 0) {
return reject(makeRuntimeRejectMsg(workerScript, "Out of bounds: Invalid index in [] operator"));
} else {
//Clone res to be exp.right
i = idx;
res[i] = Object.assign({}, exp.right);
return evaluate(exp.right, workerScript);
}
}).then(function(finalRes) {
resolve(finalRes);
}).catch(function(e) {
return reject(e);
});
} else {
return reject(makeRuntimeRejectMsg(workerScript, "Trying to access a non-array variable using the [] operator"));
}
} catch(e) {
return reject(makeRuntimeRejectMsg(workerScript, e.toString()));
}
} else {
var expRightPromise = evaluate(exp.right, workerScript);
expRightPromise.then(function(expRight) {
try {
env.set(exp.left.value, expRight);
} catch (e) {
return reject(makeRuntimeRejectMsg(workerScript, "Failed to set environment variable: " + e.toString()));
}
resolve(false); //Return false so this doesnt cause conditionals to evaluate
}, function(e) {
reject(e);
});
}
});
}
function netscriptBinary(exp, workerScript) { function netscriptBinary(exp, workerScript) {
var env = workerScript.env; var env = workerScript.env;

@ -706,7 +706,7 @@ processSingleServerGrowth = function(server, numCycles) {
server.moneyAvailable = server.moneyMax; server.moneyAvailable = server.moneyMax;
return 1; return 1;
} }
server.fortify(2 * CONSTANTS.ServerFortifyAmount); server.fortify(2 * CONSTANTS.ServerFortifyAmount * numServerGrowthCycles);
return serverGrowth; return serverGrowth;
} }

@ -730,7 +730,7 @@ var Terminal = {
break; break;
case "mem": case "mem":
if (commandArray.length != 2) { if (commandArray.length != 2) {
post("Incorrect usage of mem command. usage: mem [scriptname]"); return; post("Incorrect usage of mem command. usage: mem [scriptname] [-t] [number threads]"); return;
} }
var scriptName = commandArray[1]; var scriptName = commandArray[1];
var numThreads = 1; var numThreads = 1;
@ -825,7 +825,7 @@ var Terminal = {
case "run": case "run":
//Run a program or a script //Run a program or a script
if (commandArray.length != 2) { if (commandArray.length != 2) {
post("Incorrect number of arguments. Usage: run [program/script]"); post("Incorrect number of arguments. Usage: run [program/script] [-t] [number threads]");
} else { } else {
var executableName = commandArray[1]; var executableName = commandArray[1];
//Check if its a script or just a program/executable //Check if its a script or just a program/executable
@ -1153,13 +1153,6 @@ var Terminal = {
runScript: function(scriptName) { runScript: function(scriptName) {
var server = Player.getCurrentServer(); var server = Player.getCurrentServer();
//Check if this script is already running
for (var i = 0; i < server.runningScripts.length; i++) {
if (server.runningScripts[i] == scriptName) {
post("ERROR: This script is already running. Cannot run multiple instances");
return;
}
}
var numThreads = 1; var numThreads = 1;
//Get the number of threads //Get the number of threads
@ -1177,6 +1170,14 @@ var Terminal = {
scriptName = results[0]; scriptName = results[0];
} }
//Check if this script is already running
for (var i = 0; i < server.runningScripts.length; i++) {
if (server.runningScripts[i] == scriptName) {
post("ERROR: This script is already running. Cannot run multiple instances");
return;
}
}
//Check if the script exists and if it does run it //Check if the script exists and if it does run it
for (var i = 0; i < server.scripts.length; i++) { for (var i = 0; i < server.scripts.length; i++) {
if (server.scripts[i].filename == scriptName) { if (server.scripts[i].filename == scriptName) {