EZCode 2.5.0

There is a newer version of this package available.
See the version list below for details.

dotnet add package EZCode --version 2.5.0

NuGet\Install-Package EZCode -Version 2.5.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="EZCode" Version="2.5.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add EZCode --version 2.5.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: EZCode, 2.5.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install EZCode as a Cake Addin
#addin nuget:?package=EZCode&version=2.5.0

// Install EZCode as a Cake Tool
#tool nuget:?package=EZCode&version=2.5.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

EZCode

Main Image

<details open> <summary><h2>Welcome!</h2></summary>

Welcome to EZCode! EZCode is a comprehensive programming language built off of Microsoft WinForms. EZCode strives to make it as easy as possible to build a Windows program ranging from a Visual Application to simple console programs. Refer to Community to learn more on how to contribute and where to join our Discord Server! </details>

The Official Docs are on the our GitHub Wiki Page. Please refer to this for any detailed instrictions. </details>

The EZCode API is designed to make it easier to integrate EZCode into your program. </details>

<details open> <summary><h2>Community</h2></summary>

Contribute to the community in many ways including the EZCode Project Repository. Create a pull request and it will be accepted as soon as possible. There is also the Discussions for anybody who has questions or wants to share. If you need any help, you can look over the Wiki which includes instructions and documentation.

Please join our Discord Server to get closer to the community! </details>

<details open> <summary><h2>Example</h2></summary>

Here's a simple example of an EZCode program that creates a window with a button. When the button is clicked, it displays a message in the console.

method start
    // Create a new window with quit event
    window mainWindow new : text: Hello EZCode!, width: 300, height: 200
    event mainWindow close Quit
    
    // Create a button with click event and display it in the window
    button btnClickMe text: Click Me, width: 100, height: 30
    event btnClickMe click BtnClick
    window mainWindow display btnClickMe
    
    // Open the window and keep it open
    window mainWindow open
    await true
endmethod

// Method for the button click event
method BtnClick
    print Hello from EZCode!
endmethod

// Method to quit program when window closes
method Quit
    stop all
endmethod

This program creates a window with a button. When you click the button, it prints "Hello from EZCode!" to the console. When the Window closes, the program ends. </details>

<details open> <summary><h2>License</h2></summary>

EzCode is released under the MIT License. </details>

<details open> <summary><h2>Overview</h2></summary>

EZCode is a multipurpose programming language built off of C# and WinForms. It has simple syntax and is designed to be user friendly. Use it no matter your programming experince. From just getting started to a seasoned developer, EZCode can help you develop your projects with a minimal amount of code. Download the Official Installer and choose from the options on what to install. This is a brief overview, but to go indepth, go to the Programs Docs.

EZCode Player

This is a neccessary option for EZCode and will play any EZCode file (.ezcode or .ezproj). It will play the file no matter what type of project it is (Windows, Console, Console + Visual, or Console + Windows). Go to the Player in the wiki to learn more.

SLN Builder

This is an optional application to install and it creates a Microsoft Visual Studio Project from an EZProject file (.ezproj). Input the project and the desired output directory. Go to the SLB Builder in the wiki to learn more.

EZ IDE

This is the official IDE (Integrated Development Environment) for EZCode. This is the best way to develop with EZCode. It has features including Debugging, Project settings, and more. Go to the EZ IDE Docs to learn more.

</details>

<details open> <summary><h2>Basic Syntax</h2></summary>

This is the Basic Syntax and keywords for EZCode v2.0.0. It has not been updated since the release of v2.0.0. Please view the EZCode Docs to view the latest docs.

<details open> <summary><h3>Keywords</h3></summary>

Keyword	Syntax	Function
Await	await miliseconds	Delays the program by miliseconds
	await argument	Delays program until argument is true
BringTo	bringto front control	Brings a control to the front of the screen
	bringto back control	Sends cotrolto the back of the screen
Button	button name	Creates a button control
	button name properties	Creates a button control and sets its properties
Clear	clear	Clears the console
	clear argument	Clears the console if argument is true
Destroy	destroy control	Destroys the control completely from the program
	destroy control argument	Destroys the control only if the argument is true
Else	else :	Goes after an 'If' statement and is only executed if the 'If' is false. Only executes the line of code after the colon, whether it is on the same line or not
	else : { }	Goes after an 'If' statement and is only executed if the 'If' is false. Executes only the code in the brackets
Event	event control_or_window eventType method	Executes the method if event is triggered.
	event control_or_window eventType filepath	Executes the file (assuming ezcode) if event is triggered.
File	file read filepath	Reads the file and outputs the text as a var through using ':' or '=>' see here
	file write text_or_var filepath	Writes to the file and outputs successful 1 or unsuccessful *0 using ':' or '=>' see here
	file validpath filepath	Checks if the inputted file is a correct file path and outputs 1 as yes and 0 as no using ':' or '=>' see here
	file play filepath	Plays the file (assuming ezcode) and outputs the output of the program through ':' or '=>' see here
	file playproj filepath	Plays the file (assuming ezproj) and outputs the output of the program through ':' or '=>' see here
	file create filepath	Creates the file and outputs successful 1 or unsuccessful 0 using ':' or '=>' see here
	file exists filepath	Checks if the inputted file exists and outputs 1 as yes and 0 as no using ':' or '=>' see here
	file delete filepath	Deletes the file and outputs successful 1 or unsuccessful 0 using ':' or '=>' see here
Global	global var ...	Creates a variable and makes it global, meaning it can be accessed from any method. See 'var' for details
	global controlType ...	Creates a control and makes it global, meaning it can be accessed from any method See any of the controls (button, label, shape, or textbox) fot details
	global list ...	Creates a list and makes it global, meaning it can be accessed from any method. See 'list' for details
	global group ...	Creates a group and makes it global, meaning it can be accessed from any method. See 'group' for details
Group	group name new : controls, ...	Creates a group that can hold as many controls as needed
	group name add control	Adds a control to the group
	group name equals index control	Finds a control by its index and sets it to the inputted control
	group name remove index_or_name	Removes a control from the group by its index or name
	group name clear	Clears all controls from the group
	group name destroy	Destroys the group completely
	group name destroyall	Destroys the group and all controls in it
	group name change : properties	Changes all controls in the group relative to the inputted properties (Ex: controls's 'x' value is '5.' the inputted properties are '10' so the new control's properties are '15')
	group name argument change : properties	If the agrument is true, this changes all controls in the group to the properties, else it changes them relative to the controls properties
If	if argument :	Executes the line if the argument is true. Only executes the line of code after the colon, whether it is on the same line or not
	if argument : { }	Executes the line if the argument is true. Executes only the code in the brackets
Input	input console	Waits for the user to input into the console and gives that as output through ':' or '=>' see here
	input key	Outputs the keys pressed as (Key, Key, Key (EX: A, Up)) using ':' or '=>' see here
	input key keyName	Checks if the specified key is beng pressed and outputs 1 as yes and 0 as no using ':' or '=>' see here
	input mouse wheel	Outputs the state of the mouse wheel as (-1, 0, or 1) using ':' or '=>' see here
	input mouse wheel raw	Outputs the state of the mouse wheel as the raw value the computer is getting through ':' or '=>' see here
	input mouse button	Outputs the state of the mouse button as (Button, Button (EX: Left, Middle)) using ':' or '=>' see here
	input mouse button buttonName	Checks if the specified button is beng pressed and outputs 1 as yes and 0 as no using ':' or '=>' see here
	input mouse position	Outputs the position of the mouse as (X:pos, Y:pos (EX: X:840, Y:92)) using ':' or '=>' see here
	input mouse position X_or_Y	Outputs the position of the mouse axis using ':' or '=>' see here
Intersects	intersects conntol_1 control_2	Checks if the specified controls are overlapping and outputs 1 as yes and 0 as no using ':' or '=>' see here
Label	label name	Creates a label control
	label name properties	Creates a label control and sets its properties
list	list name new : value, value	Creates a list that can hold different values
	list name add value	Adds a value to the list
	list name equals index value	Finds a value by its index and sets it to the inputted value
	list name remove index_or_name	Removes a value from the list by its index or name
	list name clear	Clears all values from the list
	list name destroy	Destroys the list completely
Loop	loop loopTimes { }	Loops through the code in the brackets the inputted amount of times
	loop argument { }	Loops through the code in the brackets the while the argument is true
MessageBox	messagebox title text	Pops up a Windows messagebox with the inputted title and text
Print	print text...	prints all of the text after the keyword
Shape	shape name	Creates a shape control
	shape name properties	Creates a shape control and sets its properties
Stop	stop all	Quits the entire program
	stop file	Stops the current file running
	stop method	Stops the current method running
Sound	sound stopall	Stops all sounds playing
	sound volume value	Sets the volume of all sounds (0 - 1)
	sound name new filepath	Creates a new sound instance from the file
	sound name play	Plays the sound
	sound name playloop	Plays the sound in a loop
	sound name stop	Stops the sound
	sound name destroy	Destroys the sound completely
Textbox	textbox name	Creates a textbox control
	textbox name properties	Creates a textbox control and sets its properties
Variable	var name	Creates a variable
	var name value	Creates a variable and gives it the specified value
	var name : code_output	Creates a variable and sets its output to the output the inpputted code (EZ: var x : input mouse position x)
Window	window name new	Creates a window
	window name new : properties, ...	Creates a window and sets its properties
	window name change : properties, ...	Changes the window's properties
	window name clear	Clears all controls from the window
	window name open	Opens the window
	window name close	Closes the window
	window name display control	Adds a control to the window
	window name display group	Adds all of the controls in the group to the window
	window name destroy	Destroys the window completely

</details>

<details open> <summary><h3>Modifier</h3></summary>

Modifier	Use	Example
//	Does not execute any of the code after the double slash	`var result (x * 5) // The result is the 'X' variable multiplied by 5!`
\|	Starts the next line of code	`var x 10 \\| var y 5`
\!	Value is nothing ('')	`var empty \!`
\n	Value of newline	`print Hello\nWorld!`
\_	Value of space (' ')	`file write Hello\_Y'all C:/path.txt`
~\ or ~/	Uses local path	`file play ~\file.ezcode`
\;	Value of colon (':')	`if \; = whatever :`
\q	Value of equal sign ('=')	`if \q = whatever :`
\c	Value of comma (',')	`label name text:Hi\c everybody!`
\e	Value of exclamation mark ('!')	`if \e ! whatever :`
\$	Value of pipe ('\|')	`print Agency \& Thing`
\&	Value of semicolon (';')	`shape name bg:[name\&red;50;50]`
\( and )\	Solves equation inside of the backslashed parenthesis	`print Value = \(10 + 10)\ // outputs 'Value = 20'`
\-	Returns a value with the '\-' taking out the character before it	`var val h3 \\| val = 'val'\-`
\"	Value of single quote (''')	`var val hello \\| print \"'hello'\"`
'variable'	writes out the value of the variable	`var val Hello \\| print 'val' World!`
(equation)	If this is in a place where a number needs to be, it will solve the equation and set the value to it	`shape name x:(10 + 5)`
?(argument)?	If this is in a place where a boolean needs to be, it will solve the equation and set the value to it	`loop ?(0 > 5)? : { }`
⇒	Works only after some keywords, but creates a variable from the output of the line	`input console => consoleOutput`
:	Similar to '=>', but instead of creating a variable, it sets a variable to the output of the line	`var consoleOutput \\| input console : consoleOutput`

</details>

<details open> <summary><h3>System and References</h3></summary>

Reference	Use	Example
system:time	gets the current time. Has many formats so see the Wiki for that.	`print Time: system:time`
system:random	gets a random number from the inputted minumin and maximum	`print Random Number between 1 and 10: system:random:1:10`
system:isnumber	returns 0 or 1 depending on if the value is a number or not	`input console => number \\| var number? system:isnumber:number`
system:machine	gets infornation about the machine. Has many subreferences so see the Wiki for that.	`print User Name: system:machine:username`
system:currentfile	returns the current file being played... if known.	`print Current file: system:currentfile // only really for debugging`
system:currentplaydirectory	gets where the executable application that is running the EZCode file is.	`print Executable Directory: system:currentplaydirectory`
system:space	returns a space. use \_ instead.
system:newline	returns a newline. use \n instead.
system:nothing	returns a space. use \! instead.
system:pipe	returns a space. use \$ instead.
controlName:propertyName	returns the property value of the control	`shape player \\| print X = player:x`
windowName:propertyName	returns the property value of the window	`window main new \\| print Title = main:text`
var_or_list_or_group:length	if var, returns the length of the value (ie. 'hello' has length of 5). If list or group, returns how many values are in the list or group.	`var name John \\| print Number of Name's letters: name:length \\| // or with list \\| list names new : John, Sally \\| print Number of names in list: names:length \\|`
var_or_list_or_group:index	If var, returns the letter that the index corrosponds to (remember index starts from 0). If list, returns the value of the list that corrosponds with the index. If group, it will return the control's name.	`var a abc \\| print a:1 // displays 1 \\| list b new : ab, cd \\| print b:0 // prints ab \\| group c new : label1, shape2, shape3 \\| print c:2 // returns shape3`
var_or_list:contains	returns 0 or 1 if the var's value contains the the inputted value or if a list's value is equal to the inputted value	`var v abcdef \\| var contains? v:contains:g // returns 0 \\| //Or for list \\| list v new : abc, def, ghi \\| var contains? v:contains:ghi // returns 1`
value:index_or_length	If there is a value seperated by commas (a,b,c,d), a colon can be put after that and either an index (number), or 'length' and it will return an output	`print 10,20,30:length // outputs 3 \\| print 10,20,30:2 // outputs 30 (0 would be 10, 1 would be 20 in this example)`

</details> </details>

Product	Compatible and additional computed target framework versions.
.NET	net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net7.0
- NAudio (>= 2.1.0)
- ncalc (>= 1.3.8)
- System.Drawing.Common (>= 7.0.0)
- System.Windows.Extensions (>= 7.0.0)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
3.0.0	110	6/2/2024
2.5.0	144	2/9/2024
2.4.4	112	1/28/2024
2.4.1	112	1/21/2024
2.3.5	125	1/16/2024
2.3.1	119	1/14/2024
2.2.0	110	1/6/2024
2.1.10	114	1/6/2024
2.1.8	116	12/31/2023
2.1.2	103	12/28/2023
2.0.1	151	12/23/2023
1.50.10	211	10/21/2023

EZCode 2.5.0

EZCode

EZCode Player

SLN Builder

EZ IDE

net7.0

NuGet packages

GitHub repositories