fusion-lang 0.0.1.alpha1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e0d1da5a83d2c41381cc04c4fd850a157469fdf91718dc306ed0ef3149ce9259
+  data.tar.gz: 6c39994be87efa19c5a6dda7e4c61b9325dfb91b13f1a9c25999ec0435e22a09
+SHA512:
+  metadata.gz: e268696a925a14546b58fa19ab7f474fc7235b88051910ff861cb649fb6b6842ada3a62cbaf11b2f823026b86debf7431c4b95117b83b9b35f1e6f6601219cc1
+  data.tar.gz: 539eb8f3e2f7de51f882c83aa4af6bde340aae4d4312d066ca05d7fc8151adf0a765565d1c8622d26ee2645a44e3cee3a50d8bc129562b876e58ce0c8b34eaf3

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Klaus Weidinger
+
+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.

data/README.md

@@ -0,0 +1,79 @@
+# Fusion
+
+The reference implementation of the Fusion language.
+
+> :warning: This project is in an Alpha stage and still subject to rapid and unannounced breaking changes.
+
+**Fusion** is a small programming language. It is "functional JSON". It is JSON's data
+model (atomic values, arrays, objects) plus one more ingredient, the function. Functions take
+one input and one output and work by pattern-matching.
+
+## Elevator pitch - a 1-minute taste of the ideas
+
+**A file is one value**:
+- A program is simply a file containing a single function.
+- Executing it means evaluating `STDIN | thatFunction`.
+- Regular result values get printed to `STDOUT`.
+- Errors get printed to `STDERR` and set exit code `1`.
+
+**Pattern matching is the only control flow**:
+- Pattern matching is a better `if` statement.
+- A `for` loop is recursion on lists.
+
+**Bare words are holes**:
+- They bind in patterns and read in results
+- So a pattern and a result are mirror images: `([a, b] => [b, a])` swaps a pair.
+
+**Types are predicates**:
+- `n ? @Integer` matches only integers.
+- `@Integer` is just a built-in function and you could use any of your own functions as well.
+
+**Errors have payloads**:
+- An error is `!` followed by a payload value (e.g. `!"divide by zero"`, `!42`, `!{"kind":"missing_key",...}`).
+- Errors propagate unless caught with an error pattern like `!msg`, `!42`, or just `!`.
+- Pattern matching works the same way on error payloads as on regular values.
+
+**One `@` namespace for everything**:
+- `@name` can access a sibling file `name.fsn`, a standard library file `$STDLIB_DIR/name.fsn` or the builtin `name`.
+- Sibling files can shadow the standard library and builtins.
+- A bare `@` refers to the current file for easier recursion.
+- `@ENV` allows read access to environment variables.
+- `name | @load` loads a file by name. Useful for dynamic file access or file names with special characters.
+
+## Installation
+
+To use **Fusion** as a real scripting language, install it globally on your system:
+```bash
+gem install fusion-lang
+```
+
+To use any `Fusion` modules from another Ruby program, add it to your `Gemfile`:
+```ruby
+gem "fusion-lang", require: "fusion"
+```
+
+## How to run your code
+
+```sh
+echo '5' | fusion examples/factorial.fsn        # => 120
+echo '15' | fusion examples/fizzbuzz.fsn        # => "FizzBuzz"
+fusion examples/factorial.fsn 5                 # => 120 (input as an argument)
+fusion -e '(n => [n,2] | @multiply)' 21         # => 42 (inline program)
+```
+
+- Input is read from stdin (or the 2nd CLI arg) as JSON and parsed into a Fusion value.
+- The file's function gets applied to this value: `value | function`
+- The result gets printed as JSON to stdout.
+- Errors get printed to stderr instead and set exit code `1`.
+
+## Documentation
+
+Refer to the [Documentation](docs/index.md) for further information.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/docs/index.md

@@ -0,0 +1,34 @@
+# Fusion documentation
+
+## How this documentation is organised
+
+The user documentation follows the [Diátaxis](https://diataxis.fr/) system, which
+separates documentation into four kinds by the need each serves. Pick the one that
+matches what you want right now:
+
+| If you want to…                                    | Read                                   | Diataxis categories |
+| -------------------------------------------------- | -------------------------------------- | ------------------- |
+| **learn** the language from scratch                | [Tutorial](user/tutorial.md)           | study / action      |
+| **accomplish a specific task** you already have    | [How-to guides](user/how-to-guides.md) | apply / action      |
+| **look up** exact syntax, built-ins, and behavior  | [Reference](user/reference.md)         | apply / cognition   |
+| **understand why** the language is shaped this way | [Explanation](user/explanation.md)     | study / cognition   |
+
+Keeping these separate is deliberate:
+- A recipe should not digress into theory.
+- A reference should not try to teach.
+
+If you are new to this language, start with the [Tutorial](user/tutorial.md).
+
+## Design documentation
+
+Separate from the user docs and mostly aimed at language designers and contributors rather
+than users:
+
+- **[Design documentation](lang/design.md)** — the full decision ledger: every
+  design choice, who made it (designer vs. interpreter implementation), the
+  alternatives considered, and the pros and cons.
+- **[Roadmap](lang/roadmap.md)** — planned ergonomics, open questions,
+  and bigger experiments.
+
+These are the places to understand what the language is and what is still
+unfinished.