https://github.com/tani/acl2-kernel
Jupyter Kernel for ACL2
https://github.com/tani/acl2-kernel
acl2 jupyter jupyter-kernel theorem-prover
Last synced: about 1 year ago
JSON representation
Jupyter Kernel for ACL2
- Host: GitHub
- URL: https://github.com/tani/acl2-kernel
- Owner: tani
- License: other
- Created: 2020-06-17T23:55:26.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-30T08:00:53.000Z (over 1 year ago)
- Last Synced: 2025-03-30T01:35:17.004Z (about 1 year ago)
- Topics: acl2, jupyter, jupyter-kernel, theorem-prover
- Language: Jupyter Notebook
- Size: 155 KB
- Stars: 5
- Watchers: 5
- Forks: 1
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-cl - ACL2-kernel
README
# acl2-kernel [](https://pypi.org/project/acl2-kernel/) [](https://mybinder.org/v2/gh/tani/acl2-kernel/master?filepath=Example.ipynb)
Jupyter Kernel for ACL2
## What is Jupyter and ACL2?
> Project Jupyter exists to develop open-source software, open-standards, and services for interactive computing across dozens of programming languages. (https://jupyter.org/)
> ACL2 is a logic and programming language in which you can model computer systems, together with a tool to help you prove properties of those models. "ACL2" denotes "A Computational Logic for Applicative Common Lisp". (http://www.cs.utexas.edu/users/moore/acl2/)
## Usage
We follow to the standard jupyter kernel installation. So, you will install the kernel by `pip` command,
and will call the installation command like,
```sh
$ pip3 install jupyter acl2-kernel
$ python3 -m acl2_kernel.install
$ jupyter notebook
```
You also can see the deep usage by `python3 -m acl2_kernel.install --help`.
### Docker
In some case, you might want to run the kernel in the Docker containers.
This repository contains Dockerfile example. You can build example image by the following command.
```
$ docker build . -t acl2
```
To run the container, you would type the command like
```
$ docker run --rm -p 8888:8888 acl2 jupyter notebook --ip='0.0.0.0'
```
A running example is available in the `example/` directory.
You can try it on [](https://mybinder.org/v2/gh/tani/acl2-kernel/master?filepath=Example.ipynb).
## Building from source
Install [Poetry](https://python-poetry.org/) and in the root directory, do
```
$ poetry build
$ pip3 install dist/acl2-kernel-.tar.gz
$ python3 -m acl2_kernel.install --acl2
```
## Related Projects
- [Jupyter](https://jupyter.org/) - Softwares for interactive computing
- [ACL2](http://www.cs.utexas.edu/users/moore/acl2/) - Theorem prover based on Common Lisp
## License
This project is released under the BSD 3-clause license.
Copyright (c) 2020, TANIGUCHI Masaya All rights reserved.
We borrow code from the following projects.
- Egison Kernel; Copyright (c) 2017, Satoshi Egi and contributors All rights reserved.
- Bash Kernel; Copyright (c) 2015, Thomas Kluyver and contributors All rights reserved.