glyph
A proof-of-concept package manager for Cairo contracts/libraries. Distribution through pypi. Installation through existing package managers -- pip, pipenv, poetry.
Intended to be a lightweight layer on top of existing python package management. Sole responsibility is collecting contracts/libraries registered to the contracts namespace package, and copying their contents to a new contracts/lib folder.
NOTE: solely experimental to play around one potential strategy, doubtful that this would be a real package management solution for the ecosystem
Usage
Install with pip install cairo-glyph. Additionally, pip install cairo-nile and nile init to intialize a starter project.
Check out the help command (auto-gen from code, will always be more up to date than this README):
(venv) [email protected]:~/dev/eth/tmp$ glyph --help
Usage: glyph [OPTIONS] COMMAND [ARGS]...
A proof-of-concept package manager for Cairo.
Options:
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to copy it or
customize the installation.
--help Show this message and exit.
Commands:
clean Remove everything in the lib directory
use Install one or all added cairo packages in the project
Use all libraries installed to the venv:
(venv) [email protected]:~/dev/eth/tmp$ glyph use --all
π Discovering installed contracts...
β
Done.
For now, nothing is installed. To change that, do a pip install cairo-placeholder
Then do it again:
(venv) $ glyph use --all
π Discovering installed contracts...
β’ Using contracts.placeholder
β
Done.
If we inspect our project directory we now see it's installed in a contracts/lib folder:
βββ accounts.json
βββ contracts
β βββ contract.cairo
β βββ libs
β βββ placeholder
β βββ contract.cairo
βββ Makefile
βββ tests
β βββ test_contract.p
Your Own Library Setup
In order to allow your contracts to be installed, a few conventions must be followed.
contracts # The "namespace package" that the contracts are installed to
βββ placeholder # The library you are distributing
βββ contract.cairo
βββ __init__.py # Required to be installable.
setup.py # The installer
The actual setup.py will look something like this:
from setuptools import setup
setup(
name="placeholder",
version="1",
description="",
long_description="",
author="Jane Doe",
author_email="[email protected]",
license="MIT License",
packages=["contracts.placeholder"],
# Include all extra package data. Possible to include *.cairo only
package_data={"": ["*"]},
zip_safe=False,
)
If using poetry, have pyproject.toml like:
[tool.poetry]
name = "cairo-placeholder"
version = "0.0.2"
description = "Example project for cairo-glyph"
authors = ["Your Name
"]
license = "MIT License"
readme = "README.md"
packages = [
{ include = "contracts/*" },
]
[tool.poetry.dependencies]
python = "^3.7"
cairo-nile = "^0.3.0"
[tool.poetry.dev-dependencies]
[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"
Once distributed on pypi, one could:
(venv) $ pip install cairo-glyph cairo-placeholder
...
(venv) $ glyph use placeholder
π Discovering installed contracts...
β’ Using contracts.placeholder
β
Done.
Adding the following to your project:
contracts/
βββ libs
βββ placeholder
βββ contract.cairo
7 Feb 28, 2022
54 Nov 14, 2022
422 Dec 30, 2022
1 Nov 30, 2021
3 Aug 04, 2021
148 Dec 11, 2022
1 Nov 23, 2021
4 Nov 20, 2022
1 Jan 09, 2022
13 Nov 10, 2022
67 Dec 23, 2022
1 Jan 21, 2022
3 Sep 12, 2021
2 Jul 21, 2022
1 Feb 04, 2022
11 Aug 27, 2021
5 Sep 23, 2022
10 Sep 28, 2021
1 Feb 12, 2022
1 Jan 12, 2022