-
-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
d188c1d
commit d4f7101
Showing
4 changed files
with
249 additions
and
36 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,41 +1,213 @@ | ||
| # Exercism Arturo Track | ||
| <div align="center"> | ||
|
|
||
| [](https://github.com/exercism/arturo/actions?query=workflow%3Aconfiglet) [](https://github.com/exercism/arturo/actions?query=workflow%3Atest) | ||
| <img align="center" width="150" src="docs/images/logo.png#gh-light-mode-only"/> | ||
| <img align="center" width="150" src="docs/images/logo-lightgray.png#gh-dark-mode-only"/> | ||
|
|
||
| Exercism exercises in Arturo. | ||
| <h1>Arturo</h1> | ||
|
|
||
| ## Testing | ||
| ### Simple, expressive & portable<br>programming language for efficient scripting<br><br>  [](https://github.com/arturo-lang/arturo/actions) <a href="https://discord.gg/YdVK2CB" target="_blank"></a> | ||
| </div> | ||
|
|
||
| To test the exercises, run `./bin/verify-exercises`. | ||
| This command will iterate over all exercises and check to see if their exemplar/example implementation passes all the tests. | ||
| --- | ||
|
|
||
| <!--ts--> | ||
| * [The Language](#the-language) | ||
| * [Documentation](#documentation) | ||
| * [Installation](#installation) | ||
| * [Pre-built binaries](#pre-built-binaries) | ||
| * [The alternative way](#the-alternative-way) | ||
| * [Manually](#manually) | ||
| * [Other methods](#other-methods) | ||
| * [Docker](#docker) | ||
| * [Homebrew](#homebrew) | ||
| * [Showcase](#showcase) | ||
| * [Community](#community) | ||
| * [FAQ](#faq) | ||
| * [Contributing](#contributing) | ||
| * [Donations](#donations) | ||
| * [How can I donate?](#how-can-i-donate) | ||
| * [License](#license) | ||
| <!--te--> | ||
|
|
||
| ### Track linting | ||
| --- | ||
|
|
||
| [`configlet`](https://exercism.org/docs/building/configlet) is an Exercism-wide tool for working with tracks. You can download it by running: | ||
| The Language | ||
| ------------------------------ | ||
|
|
||
| ```shell | ||
| $ ./bin/fetch-configlet | ||
| Arturo is an independently-developed, modern programming language, vaguely related to various other ones - including but not limited to: Logo, Rebol, Forth, Ruby, Haskell, D, Smalltalk, Tcl, and Lisp. | ||
|
|
||
| The language has been designed following some very simple and straightforward principles: | ||
|
|
||
| - Code is just a list of words, symbols and literal values | ||
| - Words and symbols within a block are interpreted - when needed - according to the context | ||
| - No reserved words or keywords - look for them as hard as you can; there are absolutely none | ||
|
|
||
| ```red | ||
| factorial: function [n][ | ||
| if? n > 0 -> n * factorial n-1 | ||
| else -> 1 | ||
| ] | ||
| loop 1..19 [x]-> | ||
| print ["Factorial of" x "=" factorial x] | ||
| ``` | ||
|
|
||
| > ➤ Want to see more? | ||
| > | ||
| > For more - working - examples, just have a look at the [Examples](https://arturo-lang.io/documentation/examples/) in the official website. | ||
| Documentation | ||
| ------------------------------ | ||
|
|
||
| For more information about the language and access to the library reference, please visit the official [Arturo Programming Language documentation](https://arturo-lang.io/documentation/) website. | ||
|
|
||
| | <p align="center"><img width="50%" src="docs/images/icons/getting-started.png#gh-light-mode-only"><img width="50%" src="docs/images/icons/getting-started-white.png#gh-dark-mode-only"></p> | <p align="center"><img width="50%" src="docs/images/icons/in-a-nutshell.png#gh-light-mode-only"><img width="50%" src="docs/images/icons/in-a-nutshell-white.png#gh-dark-mode-only"></p> | <p align="center"><img width="50%" src="docs/images/icons/language.png#gh-light-mode-only"><img width="50%" src="docs/images/icons/language-white.png#gh-dark-mode-only"></p> | | ||
| |-------------------------|-------------------|-------------------| | ||
| | <p align="center">**[Getting Started](https://arturo-lang.io/documentation/getting-started/)**</p> | <p align="center">**[In A Nutshell](https://arturo-lang.io/documentation/in-a-nutshell/)**</p> | <p align="center">**[Language](https://arturo-lang.io/documentation/language/)**</p> | | ||
| | <p align="center"><img width="50%" src="docs/images/icons/command-line.png#gh-light-mode-only"><img width="50%" src="docs/images/icons/command-line-white.png#gh-dark-mode-only"></p> | <p align="center"><img width="50%" src="docs/images/icons/library.png#gh-light-mode-only"><img width="50%" src="docs/images/icons/library-white.png#gh-dark-mode-only"></p> | <p align="center"><img width="50%" src="docs/images/icons/examples.png#gh-light-mode-only"><img width="50%" src="docs/images/icons/examples-white.png#gh-dark-mode-only"></p> | | ||
| | <p align="center">**[Command Line](https://arturo-lang.io/documentation/command-line/)**</p> | <p align="center">**[Library](https://arturo-lang.io/documentation/library)**</p> | <p align="center">**[Examples](https://arturo-lang.io/documentation/examples)**</p> | | ||
|
|
||
|
|
||
| Installation | ||
| ------------------------------ | ||
|
|
||
| ### Pre-built binaries | ||
|
|
||
| Arturo comes with its own pre-built binaries - for, practically, all OSes - so, technically, it doesn't require any "installation". All you have to do is download one of them and run it - that's it! | ||
|
|
||
| | ||
| ### <p align="center">[⇩ Download Arturo](https://arturo-lang.io/#download)</p> | ||
| | ||
|
|
||
| > ➤ Wanna be as up-to-date as possible? | ||
| > | ||
| > Head over to the [Nightlies repo](https://github.com/arturo-lang/nightly/releases) and simply download the latest release! | ||
| ### The alternative way | ||
|
|
||
| ```bash | ||
| curl -sSL https://get.arturo-lang.io | sh | ||
| ``` | ||
|
|
||
| Run its [`lint` command](https://exercism.org/docs/building/configlet/lint) to verify if all exercises have all the necessary files and if config files are correct: | ||
|
|
||
| ```shell | ||
| $ ./bin/configlet lint | ||
|
|
||
| The lint command is under development. | ||
| Please re-run this command regularly to see if your track passes the latest linting rules. | ||
|
|
||
| Basic linting finished successfully: | ||
| - config.json exists and is valid JSON | ||
| - config.json has these valid fields: | ||
| language, slug, active, blurb, version, status, online_editor, key_features, tags | ||
| - Every concept has the required .md files | ||
| - Every concept has a valid links.json file | ||
| - Every concept has a valid .meta/config.json file | ||
| - Every concept exercise has the required .md files | ||
| - Every concept exercise has a valid .meta/config.json file | ||
| - Every practice exercise has the required .md files | ||
| - Every practice exercise has a valid .meta/config.json file | ||
| - Required track docs are present | ||
| - Required shared exercise docs are present | ||
| For Unix/Mac, you may also copy-paste the code above in your terminal and Arturo's most recent stable version will be automatically installed. | ||
| To get the most recent (nightly) build, just use: `curl -sSL https://get.arturo-lang.io/latest | sh` | ||
|
|
||
| ### Manually | ||
|
|
||
| In order to build Arturo manually, you may have a look here at the [instructions here](https://github.com/arturo-lang/arturo/wiki/Building-Arturo). | ||
|
|
||
| ### Other methods | ||
|
|
||
| #### Docker | ||
|
|
||
| Although it won't cut it, if what you need is the real-deal compiler for everyday use, if you just need a taste of it, the Docker image will absolutely do. | ||
|
|
||
| Just use the existing docker image: | ||
|
|
||
| docker run -it arturolang/arturo | ||
|
|
||
| or (to run a specific local script): | ||
|
|
||
| docker run -it -v $(pwd):/home arturolang/arturo <yourscript.art> | ||
|
|
||
| #### Homebrew | ||
|
|
||
| If you are on macOS, you can easily install Arturo using [Homebrew](https://brew.sh/) as well - although I cannot guarantee it will be the latest version: | ||
|
|
||
| ```bash | ||
| brew install arturo | ||
| ``` | ||
|
|
||
| > ➤ Trouble with the installation? | ||
| > | ||
| > If there is any issue with the installation, just let me know (by opening an issue) and I'll try to fix it. In any case, it would be safer to try one of the pre-built binaries.* | ||
| Showcase | ||
| ------------------------------ | ||
|
|
||
| <p align="center"> | ||
| <img align="center" width="250" src="https://raw.githubusercontent.com/arturo-lang/grafito/master/logo.png#gh-light-mode-only"><img align="center" width="250" src="https://raw.githubusercontent.com/arturo-lang/grafito/master/logo-dark.png#gh-dark-mode-only"> | ||
| </p> | ||
| <p align="center"> | ||
| <a href="https://github.com/arturo-lang/grafito"><b>Portable, Serverless & Lightweight<br>SQLite-based Graph Database</b></a> | ||
| </p> | ||
|
|
||
| --- | ||
|
|
||
| <p align="center"> | ||
| <img align="center" width="250" src="https://raw.githubusercontent.com/arturo-lang/aguila/master/docs/assets/logo.png"> | ||
| </p> | ||
| <p align="center"> | ||
| <a href="https://github.com/arturo-lang/aguila"><b>Modern cross-platform webview-based desktop apps<br>without HTML/CSS/JS</b></a> | ||
| </p> | ||
|
|
||
| Community | ||
| ------------------------------ | ||
|
|
||
| In case you want to ask a question, suggest an idea, or practically anything related to Arturo - feel free! Everything and everyone is welcome. | ||
|
|
||
| For that, the most convenient place for me would be the [GitHub Issues](https://github.com/arturo-lang/arturo/issues) page. | ||
|
|
||
| For questions, quick ideas, and discussing generally the language, there is also a [dedicated Discord Server](https://discord.gg/YdVK2CB) for all things Arturo. | ||
|
|
||
| <img src="https://starchart.cc/arturo-lang/arturo.svg#gh-light-mode-only"> | ||
|
|
||
| FAQ | ||
| ------------------------------ | ||
|
|
||
| **What's in a name?** | ||
|
|
||
| In case you're wondering why I went for a programming language with a... Spanish male name, let me shed some light: Arturo was the name of my little pet [Emperor Scorpion](https://en.wikipedia.org/wiki/Emperor_scorpion) - hence the logo -, or *Pandinus Imperator*, who passed away in early 2020. | ||
|
|
||
| Despite being seemingly intimidating - as most scorpions do to those who don't know about the species - he was a very quiet, totally docile, easy-going and noble creature. | ||
|
|
||
| So, the name is a subtle hommage to him; and also a hint as to what this programming language aspires to be. | ||
|
|
||
| Contributing | ||
| ------------------------------ | ||
|
|
||
| Please read [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for more details and the process for submitting pull requests. | ||
|
|
||
| Donations | ||
| ------------------------------ | ||
|
|
||
| Given that Arturo is written and maintained by people for free, in their own free time, that also have their daily jobs, any donation would give the project the help it needs to get to the next level. And for that, we'd also need you help. | ||
|
|
||
| So... | ||
|
|
||
| ### How can I donate? | ||
|
|
||
| We have different options for you: | ||
|
|
||
| - [GitHub Sponsors](https://github.com/sponsors/drkameleon) | ||
| - [Patreon](https://patreon.com/arturolang) | ||
| - [OpenCollective](https://opencollective.com/arturo-lang) | ||
|
|
||
| You may also donate [via Bitcoin](https://blockchain.info/address/bc1qpjlmktrz79muz4yksm8aadz3d3srh0rmnn3hhd): | ||
|
|
||
| <img width="150" src="docs/images/bitc.png"/> | ||
|
|
||
| License | ||
| ------------------------------ | ||
|
|
||
| MIT License | ||
|
|
||
| Copyright (c) 2019-2024 Yanis Zafirópulos (aka Dr.Kameleon) | ||
|
|
||
| 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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,43 @@ | ||
| #!/usr/bin/env bash | ||
|
|
||
| # Synopsis: | ||
| # Install arturo | ||
|
|
||
| # We currently install the nightly version as that has features we use. | ||
| # Once the next stable version has been released, we can use that. | ||
|
|
||
| # Uncomment the below line once https://github.com/arturo-lang/arturo/issues/1644 is fixed | ||
| # curl -sSL https://get.arturo-lang.io/latest | sh | ||
|
|
||
| function download_nightly() { | ||
| local install_dir="${1}" | ||
| local install_file="${install_dir}/arturo-full.tar.gz" | ||
| local repo="arturo-lang/nightly" | ||
|
|
||
| tag=$(gh release view --repo "${repo}" --json tagName --jq '.tagName') | ||
| gh release download --repo "${repo}" --pattern '*-full.tar.gz' --output "${install_file}" --skip-existing "${tag}" | ||
|
|
||
| tar -xzf "${install_file}" -C "${install_dir}" | ||
| rm -f "${install_file}" | ||
| } | ||
|
|
||
| function update_shell { | ||
| local install_dir="${1}" | ||
| local file="${HOME}/${2}" | ||
|
|
||
| if [[ -f "${file}" ]]; then | ||
| echo "export PATH=${install_dir}:\$PATH" >> "${file}" | ||
| source "${file}" | ||
| fi | ||
| } | ||
|
|
||
| install_dir="${HOME}/.arturo/bin" | ||
|
|
||
| download_nightly "${install_dir}" | ||
|
|
||
| if [[ -z "${GITHUB_ACTIONS}" ]]; then | ||
| update_shell "${install_dir}" ".bashrc" | ||
| update_shell "${install_dir}" ".zshrc" | ||
| else | ||
| echo "${install_dir}" >> "${GITHUB_PATH}" | ||
| fi |