Metadata-Version: 2.3
Name: sneko
Version: 0.1.3a0
Summary: Terminal GUI for Ethereum smart contracts
Author-email: Marc Garreau <marc@ethereum.org>
Requires-Python: >=3.10
Requires-Dist: eth-tester>=0.12.0b1
Requires-Dist: py-evm>=0.10.1b1
Requires-Dist: py-solc-x
Requires-Dist: pyperclip
Requires-Dist: snekmate>=0.1.0
Requires-Dist: textual[syntax]>=0.85.1
Requires-Dist: tree-sitter-types==0.0.2
Requires-Dist: tree-sitter>=0.20.1
Requires-Dist: vyper==0.4.0
Requires-Dist: web3==7.0.0b7
Description-Content-Type: text/markdown

# sneko

Terminal GUI for compiling (Solidity and Vyper) smart contracts.

<img width="760" alt="sneko-v0.1.1" src="https://github.com/user-attachments/assets/4975a2d3-b635-417d-947f-385e04a3ce85">

## install & usage

- install [pipx](https://pipx.pypa.io/latest/installation/)
- `pipx install sneko`
- `sneko` - to view default contracts
- `sneko <path>` - to display an arbitrary directory

## local development

- install [rye](https://rye.astral.sh/guide/installation/)
- clone repo, then `rye sync`
- `textual console` in one pane
- `textual run src/sneko/__init__.py --dev` in another pane
- if not using textual devtools: `rye run sneko <path>`

## motivation

`sneko` started from a desire to "dogfood" EF Python tools (e.g., [web3.py](https://github.com/ethereum/web3.py)) in order to identify pain points and opportunities for improvement. Currently viewed as an experimental prototype editor - the sort of thing that will help you get off and running more quickly at a hackathon or illustrate a concept within a workshop. The aim is to grow `sneko` to include a well-rounded baseline of contracts and inspection tools for educational and prototyping purposes - not to be a production deployment environment.
