pyscript-programming-language 1.5.1__tar.gz

pyscript_programming_language-1.5.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+
+recursive-include pyscript/lib *

pyscript_programming_language-1.5.1/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: pyscript-programming-language
+Version: 1.5.1
+Summary: PyScript Programming Language
+Home-page: https://github.com/azzammuhyala/pyscript
+Author: azzammuhyala
+Author-email: azzammuhyala@gmail.com
+License: MIT
+Project-URL: Source, https://github.com/azzammuhyala/pyscript
+Project-URL: Bug Tracker, https://github.com/azzammuhyala/pyscript/issues
+Keywords: pyscript,pys,programming,language,programming language
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: typecheck
+Requires-Dist: beartype; extra == "typecheck"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+# PyScript
+
+<p align="center">
+    <img src="https://github.com/azzammuhyala/pyscript/blob/main/PyScript.png?raw=true" alt="PyScript Logo" width="200">
+</p>
+
+PyScript is a simple programming language built on top of Python. It combines some syntax from Python and JavaScript,
+so if you're already familiar with Python or JavaScript, or both, it should be quite easy to learn.
+
+## Introduction PyScript
+PyScript may not be the language we'll be discussing, but the name PyScript already exists, a flexible and platform for
+running Python in a browser. Since it's inception, the language was inspired by Python and JavaScript, which are
+relatively easy for humans to read. This name was chosen because it wasn't immediately known whether this name was
+already in use.
+
+This language wasn't designed to compete with other modern programming languages, but rather as a learning for
+understanding how programming languages ​​work and how human written code can be understood by machines. Furthermore, this
+language was created as a relatively complex project. Using Python as the foundation for PyScript, it's easy to
+understand syntax makes it easy to understand how the language is built without having to understand complex
+instructions like those in C, C++, and other low-level languages.
+
+To learn more about PyScript, you can see on [PyScript documentation here](https://azzammuhyala.github.io/pyscript) or 
+[PyScript repository](https://github.com/azzammuhyala/pyscript).
+
+## Behind it
+This language created from based up on a
+[YouTube tutorial](https://www.youtube.com/playlist?list=PLZQftyCk7_SdoVexSmwy_tBgs7P0b97yD). At least, it takes
+about 6 months to learn it, and also need to learn general things that exist in other programming languages.

pyscript_programming_language-1.5.1/README.md

@@ -0,0 +1,28 @@
+# PyScript
+
+<p align="center">
+    <img src="https://github.com/azzammuhyala/pyscript/blob/main/PyScript.png?raw=true" alt="PyScript Logo" width="200">
+</p>
+
+PyScript is a simple programming language built on top of Python. It combines some syntax from Python and JavaScript,
+so if you're already familiar with Python or JavaScript, or both, it should be quite easy to learn.
+
+## Introduction PyScript
+PyScript may not be the language we'll be discussing, but the name PyScript already exists, a flexible and platform for
+running Python in a browser. Since it's inception, the language was inspired by Python and JavaScript, which are
+relatively easy for humans to read. This name was chosen because it wasn't immediately known whether this name was
+already in use.
+
+This language wasn't designed to compete with other modern programming languages, but rather as a learning for
+understanding how programming languages ​​work and how human written code can be understood by machines. Furthermore, this
+language was created as a relatively complex project. Using Python as the foundation for PyScript, it's easy to
+understand syntax makes it easy to understand how the language is built without having to understand complex
+instructions like those in C, C++, and other low-level languages.
+
+To learn more about PyScript, you can see on [PyScript documentation here](https://azzammuhyala.github.io/pyscript) or 
+[PyScript repository](https://github.com/azzammuhyala/pyscript).
+
+## Behind it
+This language created from based up on a
+[YouTube tutorial](https://www.youtube.com/playlist?list=PLZQftyCk7_SdoVexSmwy_tBgs7P0b97yD). At least, it takes
+about 6 months to learn it, and also need to learn general things that exist in other programming languages.

pyscript_programming_language-1.5.1/pyscript/__init__.py

@@ -0,0 +1,34 @@
+"""
+PyScript is a programming language written in Python. \
+This language is not isolated and is directly integrated with the Python's library and namespace levels.
+"""
+
+if __import__('sys').version_info < (3, 10):
+    raise ImportError("Python version 3.10 and above is required to run PyScript")
+
+from . import core
+
+from .core.constants import DEFAULT, DEBUG, SILENT, RETRES, COMMENT, NO_COLOR, REVERSE_POW_XOR
+from .core.cache import undefined
+from .core.highlight import HLFMT_HTML, HLFMT_ANSI, pys_highlight
+from .core.runner import pys_exec, pys_eval, pys_shell
+from .core.version import version_info, __version__, __date__
+
+__all__ = (
+    'core',
+    'DEFAULT',
+    'DEBUG',
+    'SILENT',
+    'RETRES',
+    'COMMENT',
+    'NO_COLOR',
+    'REVERSE_POW_XOR',
+    'HLFMT_HTML',
+    'HLFMT_ANSI',
+    'undefined',
+    'version_info',
+    'pys_highlight',
+    'pys_exec',
+    'pys_eval',
+    'pys_shell'
+)

pyscript_programming_language-1.5.1/pyscript/__init__.pyi

@@ -0,0 +1,73 @@
+from typing import TYPE_CHECKING, Any, Callable, Iterator, Literal, Optional
+
+if TYPE_CHECKING:
+    from .core.buffer import PysFileBuffer
+    from .core.cache import PysUndefined
+    from .core.highlight import _HighlightFormatter
+    from .core.position import PysPosition
+    from .core.results import PysExecuteResult
+    from .core.symtab import PysSymbolTable
+    from .core.version import PysVersionInfo
+
+    from io import IOBase
+
+from . import core as core
+
+DEFAULT: int
+DEBUG: int
+SILENT: int
+RETRES: int
+COMMENT: int
+NO_COLOR: int
+REVERSE_POW_XOR: int
+
+HLFMT_HTML: _HighlightFormatter
+HLFMT_ANSI: _HighlightFormatter
+
+undefined: PysUndefined
+version_info: PysVersionInfo
+
+def pys_highlight(
+    source: str | bytes | bytearray | Iterator | Callable | IOBase | PysFileBuffer,
+    format: Optional[
+        Callable[
+            [
+                str | Literal[
+                    'start',
+                    'bracket-unmatch',
+                    'identifier', 'identifier-const', 'identifier-call', 'identifier-class',
+                    'keyword', 'keyword-identifier',
+                    'number', 'string', 'comment', 'newline',
+                    'default',
+                    'end'
+                ],
+                PysPosition,
+                str
+            ],
+            str
+        ]
+    ] = None,
+    max_parenthesis_level: int = 3,
+    flags: int = DEFAULT
+) -> str: ...
+
+def pys_exec(
+    source: str | bytes | bytearray | Iterator | Callable | IOBase | PysFileBuffer,
+    globals: Optional[dict[str, Any] | PysSymbolTable | PysUndefined] = None,
+    flags: int = DEFAULT
+) -> None | PysExecuteResult: ...
+
+def pys_eval(
+    source: str | bytes | bytearray | Iterator | Callable | IOBase | PysFileBuffer,
+    globals: Optional[dict[str, Any] | PysSymbolTable | PysUndefined] = None,
+    flags: int = DEFAULT
+) -> Any | PysExecuteResult: ...
+
+def pys_shell(
+    globals: Optional[dict[str, Any] | PysSymbolTable | PysUndefined] = None,
+    flags: int = DEFAULT
+) -> int | Any: ...
+
+__version__: str
+__date__: str
+__all__: tuple[str]

pyscript_programming_language-1.5.1/pyscript/__main__.py

@@ -0,0 +1,172 @@
+from .core.buffer import PysFileBuffer
+from .core.cache import undefined
+from .core.constants import DEFAULT, DEBUG, NO_COLOR
+from .core.handlers import handle_execute
+from .core.highlight import HLFMT_HTML, HLFMT_ANSI, pys_highlight
+from .core.runner import pys_runner, pys_shell
+from .core.symtab import build_symbol_table
+from .core.utils.general import normalize_path
+from .core.version import __version__
+
+from argparse import ArgumentParser
+
+from sys import executable, version_info, exit, setrecursionlimit
+from os.path import basename, splitext
+
+parser = ArgumentParser(
+    prog=splitext(basename(executable))[0] + ' -m pyscript',
+    description='PyScript Launcher for Python Version ' + '.'.join(map(str, version_info))
+)
+
+parser.add_argument(
+    'file',
+    type=str,
+    nargs='?',
+    default=None,
+    help="file path"
+)
+
+parser.add_argument(
+    '-v', '--version',
+    action='version',
+    version=f"PyScript {__version__}",
+)
+
+parser.add_argument(
+    '-c', '--command',
+    type=str,
+    default=None,
+    help="execute PyScript from argument",
+)
+
+parser.add_argument(
+    '-d', '--debug',
+    action='store_true',
+    help="set a debug flag, this will remove the assert statement"
+)
+
+parser.add_argument(
+    '-i', '--inspect',
+    action='store_true',
+    help="inspect interactively after running a file",
+)
+
+parser.add_argument(
+    '-l', '--highlight',
+    choices=('html', 'ansi'),
+    default=None,
+    help='generate PyScript highlight code from a file'
+)
+
+parser.add_argument(
+    '-n', '--no-color',
+    action='store_true',
+    help="no colorful traceback"
+)
+
+parser.add_argument(
+    '-r', '--py-recursion',
+    type=int,
+    default=None,
+    help="set a python recursion limit"
+)
+
+args = parser.parse_args()
+
+if args.highlight and args.file is None:
+    parser.error("-l, --highlight: file path require")
+
+if args.py_recursion is not None:
+    try:
+        setrecursionlimit(args.py_recursion)
+    except BaseException as e:
+        parser.error(f"-r, --py-recursion: {e}")
+
+code = 0
+flags = DEFAULT
+
+if args.debug:
+    flags |= DEBUG
+if args.no_color:
+    flags |= NO_COLOR
+
+if args.file is not None:
+    path = normalize_path(args.file)
+
+    try:
+        with open(path, 'r', encoding='utf-8') as file:
+            file = PysFileBuffer(file, path)
+
+    except FileNotFoundError:
+        parser.error(f"can't open file {path!r}: No such file or directory")
+
+    except PermissionError:
+        parser.error(f"can't open file {path!r}: Permission denied.")
+
+    except IsADirectoryError:
+        parser.error(f"can't open file {path!r}: Path is not a file.")
+
+    except NotADirectoryError:
+        parser.error(f"can't open file {path!r}: Attempting to access directory from file.")
+
+    except (OSError, IOError):
+        parser.error(f"can't open file {path!r}: Attempting to access a system directory or file.")
+
+    except UnicodeDecodeError:
+        parser.error(f"can't read file {path!r}: Bad file.")
+
+    except BaseException as e:
+        parser.error(f"file {path!r}: Unexpected error: {e}")
+
+    if args.highlight:
+        try:
+            print(
+                pys_highlight(
+                    file,
+                    HLFMT_HTML if args.highlight == 'html' else HLFMT_ANSI
+                )
+            )
+        except BaseException as e:
+            parser.error(f"file {path!r}: Tokenize error: {e}")
+
+    else:
+        symtab = build_symbol_table(file)
+        symtab.set('__name__', '__main__')
+
+        result = pys_runner(
+            file=file,
+            mode='exec',
+            symbol_table=symtab,
+            flags=flags
+        )
+
+        code = handle_execute(result)
+
+        if args.inspect:
+            code = pys_shell(
+                globals=result.context.symbol_table,
+                flags=result.context.flags
+            )
+
+elif args.command is not None:
+    file = PysFileBuffer(args.command)
+
+    symtab = build_symbol_table(file)
+    symtab.set('__name__', '__main__')
+
+    code = handle_execute(
+        pys_runner(
+            file=file,
+            mode='exec',
+            symbol_table=symtab,
+            flags=flags
+        )
+    )
+
+else:
+    code = pys_shell(
+        globals=undefined,
+        flags=flags
+    )
+
+exit(code)

pyscript_programming_language-1.5.1/pyscript/core/__init__.py

@@ -0,0 +1,55 @@
+"""
+PyScript implementations.
+"""
+
+from . import (
+    analyzer,
+    bases,
+    buffer,
+    cache,
+    constants,
+    context,
+    exceptions,
+    handlers,
+    highlight,
+    interpreter,
+    lexer,
+    nodes,
+    objects,
+    parser,
+    position,
+    pysbuiltins,
+    results,
+    runner,
+    symtab,
+    token,
+    utils,
+    version
+)
+
+__all__ = (
+    'analyzer',
+    'bases',
+    'buffer',
+    'cache',
+    'constants',
+    'context',
+    'exceptions',
+    'handlers',
+    'highlight',
+    'immutables',
+    'interpreter',
+    'lexer',
+    'nodes',
+    'objects',
+    'parser',
+    'position',
+    'pysbuiltins',
+    'results',
+    'runner',
+    'singletons',
+    'symtab',
+    'token',
+    'utils',
+    'version'
+)