Initial commit

Add readme.
Add license.
Add .gitignore.
Add .gitattributes.
Add repository logo.

Author: krobbi

.gitattributes

@@ -0,0 +1,2 @@
+# Prevent Linguist from detecting Funcy files as Fancy files:
+*.fy linguist-language=Text

.gitignore

@@ -0,0 +1,23 @@
+# OS:
+.DS_Store
+desktop.ini
+Thumbs.db
+
+# IDE:
+.idea/*
+.vscode/*
+*.code-workspace
+*.sublime-project
+*.sublime-workspace
+*.suo
+
+# Python:
+__pycache__/*
+*$py.class
+*.pyc
+*.pyd
+*.pyo
+*.so
+
+# Ignore:
+ignore/*

license.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Chris Roberts
+
+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.

logo.png

@@ -0,0 +1,93 @@
+# Funcy
+_A toy functional language written in Python._  
+__Copyright © 2022 Chris Roberts__ (Krobbizoid).
+
+# Contents
+1. [About](#about)
+2. [Example](#example)
+3. [Grammar](#grammar)
+4. [License](#license)
+
+# About
+Funcy is a toy functional language written in Python. It is developed as an
+exercise to test implementing functions in an interpreted language. It is _not_
+suitable as a practical language, or as a guide for creating a programming
+language.
+
+# Example
+Below is a 'hello world' program written in Funcy that demonstrates the feature
+set for its initial implementation. The initial implementation is only useful
+for printing a fixed sequence of integers:
+```
+/*
+* Funcy uses C-like line and block comments. Funcy source code files should be
+* named with the file extension '.fy'.
+*
+* /*
+* * Block comments may be nested inside of other block comments.
+* */
+*/
+
+/*
+* A Funcy program contains 0 or more top-level function declarations. These
+* begin with the 'func' keyword and a function name, followed by a list of
+* parameter names in parentheses, and a function body in a compound statement.
+* In the initial implementation, functions are not callable and their
+* parameters can't be used.
+*/
+func foo(bar, baz){}
+
+/*
+* If a function named 'main' exists, it will be used as the entry point for the
+* program.
+*/
+func main(){
+	/*
+	* In the initial implementation, 'print' is a keyword, and not the name of
+	* a standard function. In this example, '(123)' is actually a parenthesized
+	* expression. The parentheses may be omitted, but they improve
+	* compatibility with potential future versions. Only integers are available
+	* in the initial implementation, so '123' is printed instead of a hello
+	* world message.
+	*/
+	print(123);
+	
+	/*
+	* Curly braces mark compound statements that contain 0 or more statements
+	* in their own scope.
+	*/
+	{
+		/*
+		* A statement may contain a standalone expression. No operations are
+		* available in the initial implementation.
+		*/
+		456;
+		
+		; // A semicolon on its own marks a no operation statement.
+	}
+}
+```
+
+# Grammar
+The EBNF (Extended Backus-Naur Form) grammar for Funcy's initial implementation
+is as follows:
+```EBNF
+program     = { func_decl }, EOF ;
+func_decl   = "func", IDENTIFIER, "(", [ param_decls ], ")", stmt_compound ;
+param_decls = IDENTIFIER, { ",", IDENTIFIER } ;
+
+stmt          = stmt_compound | stmt_nop | stmt_print | stmt_expr ;
+stmt_compound = "{", { stmt }, "}" ;
+stmt_nop      = ";" ;
+stmt_print    = "print", expr, ";" ;
+stmt_expr     = expr, ";" ;
+
+expr         = expr_primary ;
+expr_primary = "(", expr, ")" | LITERAL_INT ;
+```
+
+# License
+Funcy is released under the MIT License:  
+https://krobbi.github.io/license/2022/mit.txt
+
+See [license.txt](./license.txt) for a full copy of the license text.