Getting Started

Up & Running

Welcome to the lands of Pa (dont question the name), This is the entry to our small village located in the highs of this great mountain.
I see you are a traveler seeking knowledge from this place, buckle up my friend.

Ok you are ready? Great. This is a practical guide to install Pa in your machine.
I will introduce you to PBuild, It's a pre-built tool to download and build Pa!

But...There are prerequisites, To Build the language in your own machine you need a C Compiler!
These are the supported compilers by PBuild as of now (links):

Done? PBuild is located in the releases section of the its repository.
Choose the zipfile named after your platform and download the zip.
Extract the zip and nagivate to PBuild_(platform) -> pbuild -> pbuild(.exe).

Open up your console or terminal in the current directory (or use cd)
Execute the download command like so:

pbuild download


This will download the Pa repository as a zipfile in your home directory & extracts it.

Then Execute the build command, it takes a required option specifying
the compiler to build with.

pbuild build --cc-type=(compiler name)


This will build the cloned repository.

The executable file is located in (your-home)\Pa\Pa-master\bin after building is finished.

Hooray! You successfully downloaded and built Pa.

Usage

To use Pa, you can either launch the executable directly or from a console/terminal.
You can execute from a file like so:

pa file.pc


Lets try it.

Create a new file named file.pc and open it in your text editor of choice.
A classic print!


print("Hello reader!");
                    


Save it and Run it!
You should see a Hello reader! in your console.

Uninstalling Pa.

To uninstall Pa, you can run the command uninstall :(

pbuild uninstall


Tooling.

As of now, there is only a syntax highlighter for the vscode text editor, avaliable in the marketplace here



Thank you for reading all this! Any form of contribution is appreciated from a typo here to an issue in the language by submitting an issue in the repository here.