Typhon-Language 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

{typhon_language-0.1.1.dist-info → typhon_language-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Typhon-Language
-Version: 0.1.1
+Version: 0.1.2
 Summary: Typhon programming language
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -17,14 +17,50 @@ Dynamic: license-file
 
 Typhon is a modernized syntax sugar for Python, designed to improve developer experience with features like static typing, brace-based scoping, and expressive functional programming capabilities.
 
-GitHub repository: [Typhon](https://github.com/hnakamura5/Typhon)
-PyPI package: [Typhon-Language](https://pypi.org/project/Typhon-Language/)
+- GitHub repository: [Typhon](https://github.com/hnakamura5/Typhon)
+- PyPI package: [Typhon-Language](https://pypi.org/project/Typhon-Language/)
+- VSCode extension: [Typhon Language Support](https://marketplace.visualstudio.com/items?itemName=hnakamura5.typhon-language-support) from [GitHub Repository](https://github.com/hnakamura5/typhon-language-support)
+
+## Getting Started
+
+Install Typhon via pip:
+
+```bash
+pip install typhon-language
+```
+
+Run Typhon from the command line:
+
+```bash
+typhon --help
+```
+Create a simple Typhon program in `hello.typh`:
+
+```typhon
+def main() {
+    print("Hello, Typhon!")
+}
+main()
+```
+
+Run the program:
+
+```bash
+typhon run hello.typh
+```
+
+Or run directly using uvx:
+
+```bash
+uvx --from typhon-language typhon run hello.typh
+```
+
 
 ## Design Concepts
 
 Typhon is built on three core pillars:
 
-1. **Safety**: As expected from modern programming languages, Typhon enforces safety through static typing, lexical scopes, immutable-by-default variables (`let`), and null safety features (`?.`, `??`).
+1. **Safety**: As expected in modern programming languages, Typhon enforces safety through static typing, lexical scopes, immutable-by-default variables (`let`), and null safety features (`?.`, `??`, `?()`, `?[]`).
 2. **Expressiveness**: Expression-oriented design with functional programming features. Control comprehension forms for `if`, `match`, `try`, and so on enable concise, value-returning expressions. Function literals, placeholders and pipe operators facilitate clean and readable code.
 3. **Python Interoperability**: Typhon compiles directly to Python, allowing you to use the vast ecosystem of Python libraries seamlessly while enjoying a modern syntax.
 
@@ -48,8 +84,8 @@ Typhon retains most of Python's semantics but introduces significant syntax chan
 
 ### Main Changes
 
-- **Brace Scoping**: Typhon uses `{ ... }` for blocks, replacing indentation-based scoping. Both `;` and line breaks can also act as delimiters. See [Lexical Structure](doc/reference/lexical_structure.md).
-- **Static Typing**: Type checking is enforced at compile time.
+- **Brace Scoping**: Typhon uses `{ ... }` for blocks, replacing indentation-based scoping. Both `;` and line breaks can also act as delimiters. See [Lexical Structure](doc/reference/lexical_structure.md) for more details.
+- **Static Typing**: Type checking is enforced at compile time. Currently powered by [basedpyright](https://docs.basedpyright.com/latest/) type checker.
 - **Declarations**: Variables must be declared with `let` (immutable) or `var` (mutable). See [Variables](doc/reference/variables.md).
 
 ### Syntax Extensions
@@ -83,6 +119,10 @@ Some Python features are removed to enforce safety and clarity. See [Removed Fea
 
 Typhon can be run directly or translated to Python.
 
+`.typh` files are Typhon source files. In directory mode, all `.typh` files are processed.
+
+Note Typhon uses `.typhon` directory in source paths to place translated Python files and caches.
+
 ### Run
 
 Run a Typhon source file or directory.

{typhon_language-0.1.1.dist-info → typhon_language-0.1.2.dist-info}/RECORD

@@ -40,9 +40,9 @@ Typhon/Transform/visitor.py,sha256=PrBI-QFYFILpFLK2EmfoH6wx3Qa9fVVs72Jiw2Qz3cg,1
 Typhon/Typing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 Typhon/Typing/pyright.py,sha256=ScJOZ9uMsIovj_4xcZmPJ2ggDqI3Ju17n6dfkLku7jI,4867
 Typhon/Typing/result_diagnostic.py,sha256=rXHlqoWPl6yQbYamJPRO08Xo4D5CXxUxSfLnix06mAs,3679
-typhon_language-0.1.1.dist-info/licenses/LICENSE,sha256=k1dBJysU0_U_eCiP1Nt6MhoHmhhOaaXgDHeagjORZs0,1074
-typhon_language-0.1.1.dist-info/METADATA,sha256=HNITksFf84wH_HU4M4ba_ftqR396ZXZBxLyWWlWaG7s,5232
-typhon_language-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-typhon_language-0.1.1.dist-info/entry_points.txt,sha256=a_tTwpYswStM7ViRyF0j7qn9jV3lN0TpGiYG8TQEjMw,48
-typhon_language-0.1.1.dist-info/top_level.txt,sha256=H83GWRaycF_6jk0COdUlzXliigwTNM00Svnlp_k9F5Y,7
-typhon_language-0.1.1.dist-info/RECORD,,
+typhon_language-0.1.2.dist-info/licenses/LICENSE,sha256=k1dBJysU0_U_eCiP1Nt6MhoHmhhOaaXgDHeagjORZs0,1074
+typhon_language-0.1.2.dist-info/METADATA,sha256=3BSU3oyc6wVm75et82GdgzGhCT4c-XCC4G6H8AwVLxU,6204
+typhon_language-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+typhon_language-0.1.2.dist-info/entry_points.txt,sha256=a_tTwpYswStM7ViRyF0j7qn9jV3lN0TpGiYG8TQEjMw,48
+typhon_language-0.1.2.dist-info/top_level.txt,sha256=H83GWRaycF_6jk0COdUlzXliigwTNM00Svnlp_k9F5Y,7
+typhon_language-0.1.2.dist-info/RECORD,,