brittainscript 0.1.0__py3-none-any.whl

brittainscript-0.1.0.dist-info/METADATA

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: brittainscript
+Version: 0.1.0
+Summary: The BrittainScript programming language interpreter
+Author-email: Luke Brittain <luke.brittain@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 AstraStudios
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Keywords: programming-language,interpreter,scripting
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Interpreters
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ply>=3.11
+Dynamic: license-file
+
+# BrittainScript
+
+A custom scripting language built in Python using PLY (Python Lex-Yacc), created as a genius hour project.
+
+## Requirements
+
+Python 3 and PLY must be installed:
+
+```
+pip install ply
+```
+
+---
+
+## Running BrittainScript
+
+All commands below are run from the `BrittainScriptInternals/` directory.
+
+### Run a .bs file
+
+Pass the path to any `.bs` file as an argument:
+
+```
+python3 main.py path/to/yourfile.bs
+```
+
+For example, to run the included test file:
+
+```
+python3 main.py ../TestFiles/test.bs
+```
+
+Each non-blank line in the file is parsed and executed top to bottom. Lines starting with `#` are treated as comments and skipped.
+
+### Interactive REPL
+
+Run without any arguments to get a live prompt where you can type expressions one at a time:
+
+```
+python3 main.py
+```
+
+```
+BrittainScript — type 'exit' to quit
+bs> 3 + 4
+7
+bs> push("hello")
+hello
+bs> exit
+```
+
+---
+
+## Language Syntax
+
+### Basic Math
+
+```
+3 + 4
+10 - 3 * 2
+8 / 2
+```
+
+### Power and Square Root
+
+```
+4^2          => 16
+sqrroot(16)  => 4.0
+```
+
+### Pi
+
+```
+5 * pi       => 15.707...
+```
+
+### Trigonometry (input in degrees)
+
+```
+sin(90)      => 1.0
+cos(0)       => 1.0
+tan(45)      => 1.0
+```
+
+### Print (`push`)
+
+```
+push(3 + 4)        => prints 7
+push("hello")      => prints hello
+```
+
+`push()` only prints. It does not return the printed value.
+
+### Variables
+
+```
+name = "BrittainScript"
+count = 3
+```
+
+### Comments
+
+```
+# Full-line comment
+push("hello") # Inline comment
+```
+
+### Conditionals
+
+```
+cond (count > 1)
+    push("count is greater than one")
+end
+```
+
+### Loops
+
+```
+x = 0
+while x < 3:
+    x = x + 1
+    push(x)
+end
+
+for i in space(1, 4):
+    push(i)
+end
+```
+
+Use `break` to exit a loop and `continue` to skip to the next iteration.
+
+### Functions
+
+```
+func double(x):
+    return x * 2
+end
+
+push(double(5))
+```
+
+Functions return values with `return`.
+
+### Input
+
+```
+name = input("Enter your name: ")
+push(name)
+```
+
+### Strings
+
+```
+push("hello" + " world")
+push(len("hello"))
+
+name = " BrittainScript "
+push(name[1])
+push(name[1:5])
+push(name.trim().upper())
+
+push(tonum("42") + 8)
+push(tostr(42) + "!")
+```
+
+### Lists
+
+```
+nums = [1, 2, 3, 4]
+push(nums[0])
+nums.add(5)
+push(len(nums))
+```
+
+### Grouping
+
+```
+(2 + 3) * 4   => 20
+```
+
+---
+
+## Test Files
+
+There are two standalone test suites in `TestFiles/`. These are self-contained and independent from the main interpreter — they were used to prototype the lexer and parser separately.
+
+### Math test (`TestFiles/TestMath/`)
+
+Tests a basic arithmetic lexer and parser (addition, subtraction, multiplication, division). Run from inside the `TestMath` folder:
+
+```
+cd TestFiles/TestMath
+python3 testcalc.py
+```
+
+You'll see a `Test:` prompt. Type a math expression and it prints the tokens it found, then the parsed result:
+
+```
+Test: 3 + 4
+LexToken(NUMBER,3,1,0)
+LexToken(PLUS,'+',1,2)
+LexToken(NUMBER,4,1,4)
+Yacc parsed:  7
+```
+
+### Text test (`TestFiles/TestText/`)
+
+Tests a minimal text lexer and parser. Run from inside the `TestText` folder:
+
+```
+cd TestFiles/TestText
+python3 testtext.py
+```
+
+You'll see an `Enter some text:` prompt. Type anything and it prints the token and the parsed result:
+
+```
+Enter some text: hello world
+LexToken(TEXT,'hello world',1,0)
+Parsed: hello world
+```
+
+---
+
+## Project Structure
+
+```
+BrittainScript/
+├── BrittainScriptInternals/
+│   ├── main.py       — entry point (REPL + file runner)
+│   ├── lexer.py      — tokenizer
+│   └── parser.py     — grammar and evaluator
+├── TestFiles/
+│   ├── TestMath/     — standalone arithmetic test
+│   └── TestText/     — standalone text test
+└── Documentation/
+    └── mathdocs.txt  — language reference for math features
+```

brittainscript-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+brittainscript-0.1.0.dist-info/licenses/LICENSE,sha256=l1YEIDdUaOnj2CbfATge48VA5-9Po7Eqol1xuFJtzTg,1069
+core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+core/lexer.py,sha256=9Wr8rjDubOBfyhS_jFlbuNejM5UrwJ3uFQKuxco7cS8,2110
+core/main.py,sha256=D_UfIwdWwFkBgjSWrFTPn9zRsojCUaOxfG05m-yyvLI,11633
+core/parser.py,sha256=v2j_ePuKs0jckeBmKCFnNoGDCcezGa00f7DsMQRNOSU,10666
+core/parsetab.py,sha256=cQHbA6ggV9byqChUBpFzyAYzHLt_Nqgw5T58M4Pzt7U,16741
+libs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+libs/convert.bs,sha256=V-fS78lKvPp9GFInMMh-0oSADGpY-5PgGqNFZ8bXgcM,736
+libs/math.bs,sha256=UiKyDy9BW4i1ijRwoRd5H1zGGDEPbzsYIGHK_-zhiYo,605
+brittainscript-0.1.0.dist-info/METADATA,sha256=KYX5CXcxMZqDF_l7ZZHOQg0PzTmprLmG2dZFAtPtQCk,5543
+brittainscript-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+brittainscript-0.1.0.dist-info/entry_points.txt,sha256=yuSEUxEK7wjUmUNNyJuQMJv_ix_pcbPcZ2f8QIYFrVU,43
+brittainscript-0.1.0.dist-info/top_level.txt,sha256=Uho0PL9kAm6KaNujlGM3OewfhOEu_LIj2riui6E3kE4,10
+brittainscript-0.1.0.dist-info/RECORD,,

brittainscript-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

brittainscript-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bs = core.main:cli_entry

brittainscript-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AstraStudios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

brittainscript-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+core
+libs

core/lexer.py

@@ -0,0 +1,132 @@
+import ply.lex as lex
+
+tokens = (
+    'NUMBER',
+    'PLUS',
+    'MINUS',
+    'DIVIDE',
+    'MULTIPLY',
+    'POWER',
+    'MODULO',
+    'LPAREN',
+    'RPAREN',
+    'LBRACKET',
+    'RBRACKET',
+    'COMMA',
+    'COLON',
+    'DOT',
+    'STRING',
+    # keywords — resolved from ID
+    'SQUAREROOT',
+    'SINE',
+    'COSINE',
+    'TANGENT',
+    'PI',
+    'PRINT',
+    # variables
+    'NAME',
+    'EQ',
+    # booleans and logic comparsions
+    'AND',
+    'OR',
+    'NOT',
+    'EQUALTO',
+    'NOTEQUALTO',
+    'GREATERTHAN',
+    'LESSTHAN',
+    'GREATERTHANEQUALTO',
+    'LESSTHANEQUALTO',
+    'TRUE',
+    'FALSE',
+    # control flow
+    'COND',
+    'RANGE',
+    # import
+    'ADD'
+)
+
+reserved = {
+    'sqrroot': 'SQUAREROOT',
+    'sin':     'SINE',
+    'cos':     'COSINE',
+    'tan':     'TANGENT',
+    'pi':      'PI',
+    'push':    'PRINT',
+    'and':     'AND',
+    'or':      'OR',
+    'not':     'NOT',
+    'true':    'TRUE',
+    'false':   'FALSE',
+    'cond':    'COND',
+    'space':   'RANGE',
+}
+
+t_PLUS     = r'\+'
+t_MINUS    = r'\-'
+t_DIVIDE   = r'\/'
+t_MULTIPLY = r'\*'
+t_POWER    = r'\^'
+t_MODULO   = r'\%'
+t_LPAREN   = r'\('
+t_RPAREN   = r'\)'
+t_LBRACKET = r'\['
+t_RBRACKET = r'\]'
+t_COMMA    = r','
+t_COLON    = r':'
+t_DOT      = r'\.'
+t_EQ       = r'='
+
+def t_EQUALTO(t):
+    r'=='
+    return t
+
+def t_NOTEQUALTO(t):
+    r'!='
+    return t
+
+def t_GREATERTHANEQUALTO(t):
+    r'>='
+    return t
+
+def t_LESSTHANEQUALTO(t):
+    r'<='
+    return t
+
+def t_GREATERTHAN(t):
+    r'>'
+    return t
+
+def t_LESSTHAN(t):
+    r'<'
+    return t
+
+def t_NUMBER(t):
+    r'\d+(\.\d+)?'
+    t.value = float(t.value) if '.' in t.value else int(t.value)
+    return t
+
+def t_NAME(t):
+    r'[a-zA-Z_][a-zA-Z0-9_]*'
+    t.type = reserved.get(t.value, 'NAME')
+    return t
+
+def t_STRING(t):
+    r'"([^"\\]|\\.)*"'
+    t.value = bytes(t.value[1:-1], "utf-8").decode("unicode_escape")
+    return t
+
+def t_COMMENT(t):
+    r'\#.*'
+    pass
+
+def t_newline(t):
+    r'\n+'
+    t.lexer.lineno += len(t.value)
+
+t_ignore = ' \t'
+
+def t_error(t):
+    print("Illegal character: '%s'" % t.value[0])
+    t.lexer.skip(1)
+
+lexer = lex.lex()