https://github.com/phronmophobic/spreadsheet
https://github.com/phronmophobic/spreadsheet
Last synced: over 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/phronmophobic/spreadsheet
- Owner: phronmophobic
- License: epl-1.0
- Created: 2022-10-15T01:42:38.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-27T22:15:01.000Z (over 1 year ago)
- Last Synced: 2025-02-27T05:02:43.831Z (over 1 year ago)
- Language: Clojure
- Size: 197 KB
- Stars: 4
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Spreadsheet
Alpha software.
## Dependency
Leiningen dependency:
```clojure
[com.phronemophobic/spreadsheet "0.1.4"]
```
deps.edn dependency:
```clojure
com.phronemophobic/spreadsheet {:mvn/version "0.1.4"}
```
## Usage
### Try it!
```sh
clj -Sdeps {:deps\ {com.phronemophobic/spreadsheet\ {:mvn/version\ \"0.1.4\"}}} -M -m com.phronemophobic.membrane.spreadsheet
```
### Programmatic usage
Open a spreadsheet window. Expressions will be evaluated in the caller's namespace.
```clojure
(require '[com.phronemophobic.membrane.spreadsheet :as ss])
(ss/run)
```
## "Tutorial"
This isn't a real tutorial, but just enough info to do _something_ with the tool.
The toolbar buttons:
`+` : add a new row of name, form, and value.
`+42`: add a new row of name, number slider, and value.
`+[]`: add a new row of name, ui editor, and value. The UI editor behavior is WIP and undocumented. Good luck!
`+:)`: add a new row of name, custom component, and value. The first field is the name of a defui component and the second field is the initial value. Try `membrane.basic-components/counter` and `{:num 42}` and hit the `reset` button.
`+!!`: adds a new row of name, form, and value. Most fields will eval when you type. This field will only reevalute when you hit the `go` button. Useful for side effects, long computations, or `require`s.
The checkbox will cause the form to `def` the value when it is reevaluated. The value doesn't def until the form is reevaluated. WARNING: if you type into the name field while the checkbox is checked, then it will def a new var for _every_ character you type.
The `edit` button let's you switch the namespace the forms are evaluated in. The `save` and `load` buttons are intended for saving/loading documents from a database, but are currently disabled.
## Hidden Features
### make-fn
You can do example based programming with `make-fn`. It's a special form of `(make-fn [cell1 cell2 cell3 ...] result-cell)`. The first arg is a list of arguments the function will take. The second argument is the value the function will return. Any intermediate cells required to derive `result-cell` from the inputs is automatically included.
## License
Copyright © 2021 Adrian
Distributed under the Eclipse Public License version 1.0.