# sugly

> A conceptual implementation of Sugly programming language.

Latest version **1.0.3** (published 2019-07-28) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install sugly
pnpm add sugly
yarn add sugly
bun add sugly
```

Provides the command `sugly`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.0.3 |
| Published | 2019-07-28 |
| First published | 2016-05-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 1.3 MB |
| Known vulnerabilities | 0 (+25 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 21 |
| Author | Leevi Li |
| Maintainers | leevi |

## Links

- npm: https://www.npmjs.com/package/sugly
- Repository: https://github.com/nirlstudio/sugly-lang
- Homepage: https://github.com/nirlstudio/sugly-lang#readme
- Issues: https://github.com/nirlstudio/sugly-lang/issues
- npm.io page: https://npm.io/package/sugly

## Dependencies (3)

- [axios](https://npm.io/package/axios.md) ^0.19.0
- [colors](https://npm.io/package/colors.md) ^1.3.3
- [node-localstorage](https://npm.io/package/node-localstorage.md) ^1.3.1

## Recent versions

- 1.0.3 (latest) — 2019-07-28
- 1.0.2 — 2019-06-03
- 1.0.1 — 2019-04-04
- 0.9.9 — 2019-03-26
- 0.9.8 — 2019-03-24
- 0.8.1 — 2019-02-21
- 0.6.1 — 2019-01-05
- 0.4.1 — 2018-11-16
- 0.3.6 — 2018-11-10
- 0.3.3 — 2018-03-05
- 0.3.2 — 2018-03-02
- 0.2.1 — 2016-05-22
- 0.1.9 — 2016-05-05
- 0.1.8 — 2016-05-05
- 0.1.7 — 2016-05-05
- … 9 more at https://npm.io/package/sugly/versions

## README

# Sugly-Lang
### A simple & ugly script language, which is mostly inspired by Lisp, Python and JavaScript.
```python
print "Hello, world!";

# or, without sweetener
(print "Hello, world!")
```

# Try it online
### [Sugly.DEV](https://sugly.dev)
```python
help; # for help.

# to verify your browser's compatibility.
selftest;

# to run a quick-sort example
run "examples/qsort1";
# to print its code
print (.loader read "examples/qsort1");

# try to list all examples
.loader list "examples/";

# use print to show a full list.
print (.loader list "examples/");

# break items into lines
.loader list "examples/":: for-each print;

# display source url only
.loader list "examples/":: for-each (= item (print (item 0);

# display item no. for counting
.loader list "examples/":: for-each (= (item, no.) (print '#$(no.), $(item 0)');

 # display path only
.loader list "examples/":: for-each (= (item, no.) (print '#$(no.),', (var url (item 0):: slice (url first-of "examples/");

# Q: What's happening?
var print-examples (=>:() (var examples (.loader list "examples/")) (=> pattern (examples for-each (=> (item, no.) (print (string format (pattern ?* "{0}, {1}, {2}"), no., (item 0), (item 1);

# As a hint, here's a (more) friendly version.
(var print-examples (=>:()
  var examples (.loader list "examples/");
  (=> pattern
    (examples for-each (=> (item, no.)
      print (string format (pattern ?* "{0}, {1}, {2}"), no., (item 0), (item 1);
).

# You may also want to check
print print-examples;

# Finally, the Y-combinator in Sugly
print (.loader read "yc");
```

# Install it
```shell
npm i -g sugly

sugly selftest # optional
```

### run an example, or your own code:
```shell
sugly examples/qsort1
```

### REPL in terminal:
```shell
sugly
```
### You can do [almost the same things](#try-it-online) after calling
```python
fetch "https://sugly.dev/@";

# or try
fetch "https://sugly.dev/@":: finally (=>() (.loader list:: for-each print);
```

# Use it in your JS project
### add it
```shell
npm i --save sugly
```

### use it
```javascript
var $void = require('sugly')
$void.$run('path-to-your-app.s')
```

### use it in web page
```javascript
var $void = require('sugly/web')
$void.$run('path-to-your-app.s')
```

# Check the source code
```shell
git clone https://github.com/NirlStudio/sugly-lang.git
cd sugly-lang

npm install
npm test

bin/sugly

# or, start the local web shell
npm run build-dev & npm run start
```

# IDE Support
### VS Code Extension
In Extensions sidebar, search for **Sugly**

### Atom Plugin
[*language-sugly*](https://github.com/NirlStudio/language-sugly)
```shell
apm install language-sugly
```

# You can help to
### - Test it in various OSes and browsers.
### - Use it in your projects.
### - Recommend it to your friends.
### - Create documentation & tools.
### - Report bugs and help to fix.
### - Request for features.
### - Create interpreters in other native languages
  - Java, Go, Rust, Python, C#, C, etc
### - ...

**Enjoy the sugliness.**

---
_Source: https://npm.io/package/sugly · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._