c0decycle / pyterpreter

A interpreter founded during the UZH software construction module.

PyTerpreter

A interpreter founded during the UZH software construction module.

Pattern

Issue: "CATEGORY-TYPE: Issue Summary"
Branch: "category-type-branchname"
Commit: "CATEGORY-TYPE: Commit message"

Categories: "DOCUMENTATION", "INTERPRETER", "TRACING", "EXAMPLE"
Types: "FEATURE", "BUGFIX"

Issue summary: Standard english sentence casing.
Branch name: All lower case.
Commit message: message: All lower case with first letter uppercase.

Workflow

1. In meating create issues based on roadmap.
2. Assign issues to members.
3. Members create branches and commit changes.
4. Members open pull requests which the others review.
5. When merged, issue gets closed.

Structure

Repository level: Repository, administrative and dev related things.
Distribution level: UZH module assignment.

pyterpreter's Issues

EXAMPLES-FEATURE: Provide examples

DOCUMENATION-FEATURE: Make readme and finish

INTERPRETER-FEATURE: Mathematical Operations

• add: ["add", number, number]: number
• sub: ["sub", number, number]: number
• abs: ["abs", number]: number
• multiply: ["multiply", number, number]: number
• division: ["division", number, number]: number
• power: ["power", number, number]: number

DOCUMENTATION-FEATURE: Add ReadMe design decision

INTERPRETER-FEATURE: Dictionary and Dictionary Operations

• dictionary: ["dictionary"]: dict
• set: ["dictionarySet", dict, "key", value]: "illegal"
• get: ["dictionaryGet", dict, "key"]: value
• merge: ["dictionaryMerge", dict, dict]: dict

INTERPRETER-FEATURE: Object and Object Operation

• object: ["object", ["class", ?inheritance, instructions], value[]]: environment
• set: ["objectSet", environment, "name", value]: "illegal"
• get: ["objectGet", environment, "name"]: value

INTERPRETER-FEATURE: Class and Class Operation

• class: ["class", ?inheritance, instructions]: ["class", ?inheritance, instructions]
  ! Inheritance is entire class definition !
• inherit: ["inherit", "function"]: ["function", "parameter"[], instructions]
  ! One and only one constructor !
  ! When inherited instructions get merged and overwritten ones get cached !
  ! Inherit operation fetches from cache !

DOCUMENTATION-FEATURE: Add ReadMe design decision

INTERPRETER-FEATURE: Array and Array Operation

• array: ["array", size]: list
• set: ["arraySet", list, index, value]: "illegal"
• get: ["arrayGet", list, index]: value

INTERPRETER-FEATURE: System Operation: print

• print: ["print", value]: "illegal"

TRACING-FEATURE: Logging

DOCUMENTATION-FEATURE: Add ReadMe design decision

DOCUMENTATION-FEATURE: Add ReadMe design decision

TRACING-FEATURE: Reporting

INTERPRETER-FEATURE: Loops

• while: ["while", boolean, instructions]: "illegal"

INTERPRETER-FEATURE: Variables

• set: ["set", "name", value]: "illegal"
• get: ["get", "name"]: value
  ! Get operation environment bottom to top !
  ! Set operation environment top to bottom !

INTERPRETER-FEATURE: Boolean Operations

• and: ["and", boolean, boolean]: boolean
• or: ["or", boolean, boolean]: boolean
• not: ["not", boolean]: boolean
• equal: ["equal", value, value]: boolean
• less: ["less", value, value]: boolean
• greater: ["greater", value, value]: boolean
• less equal: ["lessEqual", value, value]: boolean
• greater equal: ["greaterEqual", value, value]: boolean

INTERPRETER-FEATURE: Repeat

• repeat: ["repeat", count, instructions]: "illegal"

INTERPRETER-FEATURE: Conditionals

• if: ["if", boolean, then instructions, ?else instructions]: "illegal"
• equal: ["equal", value, value]: boolean

INTERPRETER-FEATURE: Function and Function Operations

• function: ["function", "parameter"[], instructions]: ["function", "parameter"[], instructions]
• call: ["call", ["function", "parameter"[], instructions], value[]]: value
• ?return: ["return", value]: "illegal"
  ! No return then none !
  ! Return ends instructions !
  ! Return only allowed when environment usage is function !