Ask version 1.1.0 (#72)

* Repl. mode.
* F-strings.
* Raw strings.
* Abnex & Regex.

Author: Buscedv

.gitignore

@@ -98,7 +98,7 @@ __pypackages__/
 celerybeat-schedule
 celerybeat.pid
 
-# SageMath parsed files
+# SageMath translated files
 *.sage.py
 
 # Environments

CONTRIBUTING.md

@@ -15,28 +15,16 @@
 - (You can also add **tags** if you want)
 
 - If your PR is **approved** it will get merged either into `dev` or `master`.
-- If it gets marked as **Changes requested**, do the chanages, **commit** & **push**, and request **re-review* by @buscedv
+- If it gets marked as **Changes requested**, do the chanages, **commit** & **push**, and request **re-review** by @buscedv.
 
 ## Code style
 - Use tabs.
 - Use single quotes `'` and not double quotes `"`.
 - If you have to use some sort of string formating use f-strings.
-- Don't put unneccesary comments.
-- Follow the PEP8 guidelines, ex. two empty lines between methods.
-- Ask is supposed to be in a single python script i.e. `ask.py`.
-- A transpiled Ask program `app.py` should be able to run completely standalone. So all neccesary function, classes, utilities, etc. needs to be added to the transpiled code. This means no module importing.
-
-## Dev environment
-1. Create a vritual environment:
-- `python3 -m venv venv`
-2. Activate it:
-- `source venv/bin/activate`
-3. Install dependencies:
-- `pip install -r requirements.txt`
-
-**When running ask**
-
-4. Get helpful info and debug messages:
-
-- Run ask with the `-d` flag.
-  - `python3 ask.py [my file].ask -d`
+- Don't put unnecessary comments.
+- But when you do add comments make sure that:
+  - There is a space after the pund/hashtag.
+  - The comment starts with a capital letter.
+  - It ends with a full-stop/period.
+- Follow the PEP8 guidelines, e.g. two empty lines between function definitions.
+- A transpiled Ask program `app.py` should be able to run completely standalone. So all necessary functions, classes, utilities, etc. needs to be added to the transpiled code. This means no module importing in the output file!

README.md

@@ -34,6 +34,16 @@ The transpiled app is completely standalone and doesn't require Ask in any way.
 - `$ pipx install ask-lang`.
 - Then run your apps with: `$ ask [your file].ask`.
 
+## Run locally
+1. Clone this repo: `https://github.com/Buscedv/Ask.git`.
+2. Install [Poetry](https://python-poetry.org/).
+3. Create a new virtual environment: `python3 venv venv`.
+4. Activate it: `source venv/bin/activate`.
+5. Install dependencies: `poetry install`.
+6. (Optional but helpful in some cases) Run Ask in development mode: [Docs](https://docs.ask-lang.org/development-tools/running-in-development-mode1).
+
+If you want to contribute please read the CONTRIBUTING.md file for code style, standards, etc.
+
 ## Example (Ask vs Flask)
 Here is the same basic app with one GET route written in Ask and in Python with Flask.
 
@@ -88,9 +98,9 @@ if __name__ == '__main__':
 As you can see Ask hides away all the clutter and boilerplate.
 
 ## Documentation
-You can find the full documentation on [docs.ask-lang.org](https://docs.ask-lang.org)
+You can find the full documentation on [docs.ask-lang.org](https://docs.ask-lang.org).
 
 ## Contact
-- Website: [ask-lang.org](https://ask-lang.org)
-- Email: [me(a)edvard.dev](mailto:me@edvard.dev)
-- GitHub: [Buscedv](https://github.com/Buscedv)
+- Website: [ask-lang.org](https://ask-lang.org).
+- Email: [me(a)edvard.dev](mailto:me@edvard.dev).
+- GitHub: [Buscedv](https://github.com/Buscedv).

ask_lang/__main__.py

@@ -2,36 +2,109 @@
 
 import os
 import sys
+from typing import List, Tuple
+
+from tabulate import tabulate
 
 from ask_lang import cfg
 from ask_lang.transpiler import transpiler
-from ask_lang.utilities import utils
+from ask_lang.utilities import files, serve_run, printing, askfile
+
+
+def parse_sys_args(sys_args: List[str]) -> Tuple[str, bool]:
+	flags = ['-d', '--dev', '-xd', '--extra-dev', '-v', '--version', '-h', '--help']
+
+	file_name = ''
+	no_valid_flags = True
+
+	for param in sys_args[1:]:
+		if param in flags:
+			no_valid_flags = False
+
+			if param in ['-d', '--dev']:
+				cfg.is_dev = True
+			if param in ['-xd', '--extra-d']:
+				cfg.is_extra_dev = True
+				printing.style_print('Extra Dev Mode Activated!', 'red', ['bold'])
+			elif param in ['-v', '--version']:
+				printing.style_print('- Version:', color='blue', end=' ')
+				print(cfg.project_information["version"])
+			elif param in ['-h', '--help']:
+				print('Usage: ask_lang [OPTIONS] [FILE]...', end='\n\n')
+				print(tabulate(
+					[
+						['-h', '--help', 'Show this message.'],
+						['-v', '--version', 'Show version information.'],
+						['-d', '--d', 'Turn on developer/debug mode.'],
+					],
+					headers=['Option', 'Long Format', 'Description']
+				))
+				print()
+				print('Other configurations can be added to a file called `Askfile.toml`.')
+				print('Go to: https://docs.ask-lang.org for more information', end='\n\n')
+		else:
+			file_name = param
+
+	if cfg.is_dev and file_name == '':
+		no_valid_flags = True
+
+	return file_name, no_valid_flags
+
+
+def repl(first_time: bool = False):
+	cfg.is_repl = True
+
+	if first_time:
+		printing.style_print('Type "q" to quit.', color='gray')
+
+	line = input('Ask >>> ')
+
+	# Quit/Exit
+	if line == 'q':
+		files.maybe_delete_app(True)
+		return
+
+	transpiler.transpile([line])
+	serve_run.run_server()
+
+	repl()
 
 
 def main():
-	utils.initial_print()
+	printing.initial_print()
 
 	if len(sys.argv) > 1:
-		param_file_name, no_valid_flags = utils.parse_sys_args(sys.argv)
+		param_file_name, no_valid_flags = parse_sys_args(sys.argv)
+
+		if not param_file_name and True in [x in sys.argv for x in ['-d', '--dev', '-xd', '--extra-dev']]:
+			repl(True)
 
 		cfg.source_file_name = param_file_name
 		if os.path.isfile(f'{os.getcwd()}/{cfg.source_file_name}'):
 			# Transpiles.
 			with open(cfg.source_file_name) as f:
 				source_lines = f.readlines()
 
+			if not source_lines:
+				printing.style_print('\t- The file is empty!', color='red')
+				exit(1)
+
 			transpiler.transpile(source_lines)
 
-			# Starts server
-			utils.run_server()
+			if askfile.get(['system', 'server'], True):
+				# Starts server
+				serve_run.run_server()
+			else:
+				printing.style_print('\nAuto start server is turned OFF.', styles=['bold'])
+				print('\t - The transpiled code can be found in:', end=' ')
+				printing.style_print(askfile.get(['system', 'output_path'], 'app.py'), color='blue', end='')
+				print('.')
 		else:
 			if no_valid_flags:
-				utils.style_print('- The file could not be found!', color='red')
+				printing.style_print('- The file could not be found!', color='red')
 	else:
-		# TODO: Launch Repl.
-		utils.style_print('- Please provide a script file!', color='red')
+		repl(True)
 
 
 if __name__ == '__main__':
 	main()
-

ask_lang/cfg.py

@@ -44,10 +44,12 @@
 ask_config = {}
 
 project_information = {
-	'version': '1.0.0',
+	'version': '1.1.0',
 }
 
 source_file_name = ''
 is_dev = False
 is_extra_dev = False
+is_repl = False
+repl_previous_transpiled = ''
 transpilation_result = defaultdict(lambda: '', {})

ask_lang/tests/transpiler/test_parser.py

@@ -0,0 +1,18 @@
+# coding=utf-8
+import unittest
+
+from ask_lang.transpiler import translator
+
+
+class TestTranspilerTranslatorInsertBasicDecoratorCodeToInsert(unittest.TestCase):
+	# TODO: Add advanced tests here.
+	pass
+
+
+class TestTranspilerTranslatorTranslate(unittest.TestCase):
+	# TODO: Add advanced tests here.
+	pass
+
+
+if __name__ == '__main__':
+	unittest.main()

ask_lang/tests/transpiler/test_translator.py

@@ -76,7 +76,9 @@ def test_add_new_line_at_the_end(self):
 		self.assertEqual('word\n', lexer_utils.reformat_line('word\n'))
 
 	def test_quotes(self):
-		self.assertEqual('"Hello, World!"\n', lexer_utils.reformat_line('\'Hello, World!\''))
+		self.assertEqual('\'Hello, World!\'\n', lexer_utils.reformat_line('\'Hello, World!\''))
+		self.assertEqual('"Hello, World!"\n', lexer_utils.reformat_line('"Hello, World!"'))
+		self.assertEqual('"Hello, World!" test\n', lexer_utils.reformat_line('"Hello, World!" test'))
 
 	def test_space_before_parenthesis(self):
 		self.assertEqual('print()\n', lexer_utils.reformat_line('print ()\n'))