🟣 EVA-01 Shell

The Eva-01 Shell is an immersive CLI experience. Inspired by NERV and EVAs from Neon Genesis Evangelion.

Eva-01 features:

Clean, organized, and minimal.

Faster command parsing & execution.

Built to be developer-friendly, extendable, and modular.

Table of Contents

1. FEATURES
2. DOCUMENTATION
   • COMMANDS
   • INTERNET
3. GETTING STARTED
4. FUTURE FEATURES
5. CONTRIBUTING
6. SUPPORT
7. LICENSE

🚀 Features

• Light Weight
• Fast
• Cross-Platform
• User friendly

(back to top)

Documentation

I have seen the Neon Genesis Evangelion anime by Hideaki Anno, and was really moved by the concepts of EVAs. EVA-01 run by the protagonist was a special one for me as it could change to berserk mode and many other different capabilites. Also, I was moved by the NERV HQ as mentioned in anime and its computer system having central dogma and terminal dogma.

Based on this computer system mentioned in anime, the eva-01 also has two header files - CentralDogma.hpp and TerminalDogma.hpp.

About the CentralDogma

• The main parseCommand() function, is used to execute commands, store them in history, also the logic for ||,;, and && are implemented. Along with that the command to run a command from history with its index is also implemented - !<index_number>
• Inside it has a registry keeping the records of the commands along with the names with which they will be called. The registry filling is done inside the main function.
• searchHistory() function is used by history function inside the TerminalDogma to search particular commands with related names.

About the TerminalDogma

• It has a brief abstract base class for all eva-01 shell commands. It defines the common interface for every shell command. Each command has its own behaviour in execute() and the description() is written inside the header file only.
• All the commands implemented inside it are described in the commands section.
• For the calc() function many other functions like isNumber(), isLeftAssociative(), precedence(), postfix() - to change infix to postfix along with brackets, solvePostfix() are implemented.
• sys() -

  • For windows (took help from learn.microsoft.com, all the link are provided for the documentation of specific functions) -

    1. For the harware information - getting harware information
    2. For the system information - getting system information
    3. For getting the processes - taking snapshot and view process
    4. For getting the information of DNS server, adapters information - ip helper from microsoft

  • In linux -

    1. For getting info about network and adapters - man getifaddrs; inet_ntop() → convert IP addresses, sockaddr_ll → read MAC addresses

Commands:

• probe - Network diagnostics tool with real-time latency visualization. probe <host> [-c count] [-t] [-i interval] -c : Number of packets to send (default: 4) -t : Continuous ping -i : Interval between pings in ms (default: 1000)
• history - It shows all the previous commands executed and also searches commands related with command name(s) given. To run a particular command from history with their index - !<index_number>
• shift - Moves and renames files/folders. shift <file1> <folder1/file1> or shift <folder2/folder3> <folder4/folder3> You need to give the name of the file/folder along with the destination you want to move. For renaming you just need to give a new name in the second arguement.
• view - Displays the content of the files. view <file1> <file2> <...>
• time - It just shows you the time.
• forge - It makes directory. Command - forge <directory1> <directory2> <...>
• sys - It can be used to interact with the system and processes. Also it shows specific things related to the system.
  • sys - shows system and hardware informations.
  • -p | --proc - shows all the processes.
  • -n | --network - shows information about your network and it's adapters.
  • -a | --adapters - shows information about adapters.
• calc - Just a simple calculator.
• say - Prints text to the console and also write and appends text into files which are in double quotes only and ends with >> and file name with proper space. say <text> or say <"text"> >> <filename>
• clear - Clears the console.
• show - Shows all the folder and files present in the working directory.
• jump - Changes the directory to the given directory.
• help - Gives information about the commands
• erase - Deletes the provided files and folders. erase <file1> <folder1> <file2> <...>
• craft - Creates files only. craft <file1> <file2> <...>
• run - Runs the commands stored in <filename.eva> or <filename.txt>, one by one.

(back to top)

Internet

• sys -n and sys -a shows information about dns server, IF index (Windows), ipv4 or ipv6 address for adapters.

• probe function basically works like ping as in windows to ping a given host. It is a simple packet sniffer with some basic details and a graph (simple). If you give the -t flag it will run continuously unless you stop it. -i flag is just interval the function will sleep between two consecutive pinging.

  Sample of probe -

(back to top)

GETTING STARTED

Run (windows only)- g++ -Iinclude src\main.cpp src\CentralDogma.cpp src\TerminalDogma.cpp -lPsapi -lkernel32 -ladvapi32 -o eva-01 then run the eva-01.exe

or

mingw32-make or make to run the makefile

Go to the latest release and download the eva-01.exe Then run it.

Run (linux/unix) -

g++ -Iinclude src/*.cpp -o eva-01

Example Commands -

1.  calc 96/2 || say ok  ------>(It shows 48 as the first command is running successfully, so the second command will not run)
    view a.txt && say hello ------>(If a.txt is there then its content along with hello is displayed. But if it is not present, then hello will not be displayed)
    view a.txt ; say hello; craft "hello world.txt" ------>(All this commands will be executed one by one, irrespective of the output)
   
   
   

2. run << hello.txt ----> All the commands inside hello.txt written one by one are executed. Sample hello.txt -

   calc 2+4/(3*1)
   craft a.txt && say "hello world" >> a.txt

Future Features

1. A tool to ping or a packet sniffer.
2. A tool to make api requests.
3. Command to kill or run processes.
4. Executing commands that run other processes like running a python or cpp file.

CONTIBUTING

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b my-branch)
3. Commit your Changes (git commit -m 'Add some advices')
4. Push to the Branch (git push origin my-branch)
5. Open a Pull Request

(back to top)

SUPPORT

Support me by giving a ✨ to this project

(back to top)

LICENSE

The license is GNU public license see more n LICENSE

(back to top)

This is all the things about my program. If you like it, then please share with others. This is a project which the begineers as well as intermediate programmers can build. Support me by following my github account. Thank you.