EZCode 2.3.1
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package EZCode --version 2.3.1
NuGet\Install-Package EZCode -Version 2.3.1
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.3.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add EZCode --version 2.3.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: EZCode, 2.3.1"
#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.3.1 // Install EZCode as a Cake Tool #tool nuget:?package=EZCode&version=2.3.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
EZCode
<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>
<details open> <summary><h2>Docs</h2></summary>
The Official Docs are on the our GitHub Wiki Page. Please refer to this for any detailed instrictions. </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>
<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 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 | Versions 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. |
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.