Skip to main content

A compiler for Pseudocode written in python

Project description

Python Pseudocode Compiler

Introduction

PsPse is a interpreted compiler for teaching purposes.

Features:

  • Compile codes in AS-Level Computer Science Syllabus
  • Portable with no environemt requirements
  • Available in Windows and Linux
  • Continuously developing

I am a senior high student learning A2 Computer Science currently, and I am new to compilers. Feel free to raise issues or contribute.

demo_screenshot

Why?

Pseudocode is used to express ideas without truly writing code. However,

  • AS-Level has specific grammar for this language
  • AS-Level International Test marks based on the grammar
  • There is no compiler for it, and there is no way to test it or execute it.

As a result, there is a clear need to write such compiler, also as a project of mine for interest. :smirk:

Get Started

First, Clone the repo in terminal:

git clone https://github.com/HankelBao/PyPse

Now, you will have the PyPse folder in your current path. CD to PyPse/bin/ and you will have pypse.bin and pypse.exe under the folder.

If you are using Windows,

.\pypse.exe ..\test\test.5.pse

If you are using Linux,

.\pypse.bin ..\test\test.5.pse

If you see the Hello World! message showing up just like the demo, you are ready to go!

Usage

Remember, you should always use pypse.bin for linux and pypse.exe for windows.

Pseudocode File ends in .pse, so you should create a file with such extension for execution.

Write your own pseudocode and execute it!

Progress

  • Warnings and Errors
  • Full types support
    • INT
    • REAL
    • STRING
    • BOOL
    • More...
  • Declaration
  • Arrays
  • Dicts
  • Custom Types
  • Debug Block
  • Assign
  • Output
  • Input
  • IF...
  • WHILE...
  • REPEAT...
  • FOR...
  • Procedure...
  • CALL...
  • FUNCTION...
  • RETURN...
  • CASE...
  • More Features...

Contributing

If you want to see the debug info for the compiler, call the command with --debug

For example

.\pypse.exe ..\test\test.5.pse --debug

Feel free to report issues and make contributions

Promote

Spread it around your classes if you also find the need for such a compiler!

Thanks for your support.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pypse-0.0.1.tar.gz (11.8 kB view hashes)

Uploaded Source

Built Distribution

pypse-0.0.1-py3-none-any.whl (14.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page