| Name | solcix JSON |
| Version |
0.1.7
JSON |
| download |
| home_page | |
| Summary | A Python wrapper for the Solidity compiler. Switch between versions, compile, and manage artifacts. |
| upload_time | 2023-04-07 11:28:22 |
| maintainer | |
| docs_url | None |
| author | alan890104 |
| requires_python | >=3.8,<4.0 |
| license | |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Solcix
[](https://pypi.org/project/solcix?style=flat) [](https://github.com/Solratic/solcix) [](https://pypi.org/project/solcix/) [](https://github.com/psf/black) [](https://github.com/Solratic/solcix) [](https://github.com/Solratic/solcix/blob/main/LICENSE)
Solcix is a Solidity version manager written in Python that allows for seamless switching between versions, easy compilation, and simple management of artifacts.
## Installation
To install Solcix, you can use pip, the Python package manager:
### With pip For Windows
```bash
pip install solcix
```
### With pip3 For Linux / Mac
```bash
pip3 install solcix
```
### With pipx
[pipx](https://github.com/pypa/pipx) installs packages in their own virtual environment, so there's less chance of conflicting dependencies. You can run the following command in your terminal to install:
```bash
pipx install solcix
```
### With poetry
Uses the [poetry](https://github.com/python-poetry/poetry) package manager to install solcix in a project-specific virtual environment. poetry manages dependencies for you and allows you to isolate your project from the global environment. You can run the following command in your terminal to add solcix to your poetry project, and use our wrapped solc api in your code:
```bash
poetry add solcix
```
### With pipenv
Uses the [pipenv](https://pipenv.pypa.io/en/latest/) package manager to install solcix in a project-specific virtual environment. pipenv also manages dependencies and isolates your project from the global environment, and use our wrapped solc api in your code. You can run the following command in your terminal to install:
```bash
pipenv install solcix
```
### With pip for main branch
You can also install solcix from github main branch:
```bash
pip install git+https://github.com/Solratic/solcix.git@main
```
## Enable Auto-Completion
Enable auto-completion for `solcix` by running the following command:
### With Bash
```bash
_SOLCIX_COMPLETE=bash_source solcix > ~/.solcix-complete.bash
source ~/.solcix-complete.bash
```
### With Zsh
```zsh
_SOLCIX_COMPLETE=zsh_source solcix > ~/.solcix-complete.zsh
source ~/.solcix-complete.zsh
```
### With Fish
```fish
_SOLCIX_COMPLETE=fish_source solcix > ~/.config/fish/completions/solcix.fish
```
## Usage - CLI
Solcix can be used as a library or as a command line tool. Here are the available commands:
### Listing available Solidity compilers
The `ls` command can be used to list all available versions of the Solidity compiler:
Example usage:
```bash
solcix ls
```
### Installing Solidity compilers
The `install` command can be used to install one or more versions of the Solidity compiler:
Example usage:
```bash
solcix install 0.8.4 0.7.6 latest
```
### Listing installed Solidity compilers
The `installed` command can be used to list all available versions of the Solidity compiler:
Example usage:
```bash
solcix installed
```
If global / local version is set, it will be displayed as below:
```bash
0.5.0
0.8.0
0.8.16
0.8.17
0.8.18 <- current
0.8.19
```
### Switching between Solidity compilers
The `use` command can be used to switch between installed versions of the Solidity compiler, either globally or locally.
- If the specified version is not installed, it will be installed automatically.
- If you use the `local` option, it will create a `.solcix` file in the current directory.
Example usage:
```bash
# Setting global version to 0.8.16
solcix use global 0.8.16
```
```bash
# Setting local version to 0.8.16, it will create a .solcix file in the current directory
solcix use local 0.8.16
```
```bash
# You can also use the alias `latest` to use the latest version
solcix use global latest
```
Simply run the command will see the changes:
```bash
solc --version
```
### Show current Solidity compiler version
The `current` command can be used to show the current version of the Solidity compiler (local version takes precedence over global version):
Example usage:
```bash
solcix current
```
### Uninstalling Solidity compilers
The `uninstall` command can be used to uninstall one or more versions of the Solidity compiler:
```bash
solcix uninstall 0.8.4 0.7.6
```
### Uninstall all Solidity compilers
To uninstall all versions of Solidity compiler that have been installed using solcix, you can use the following command:
```bash
solcix purge
```
This will remove all versions of the Solidity compilers that have been installed by solcix, all cached files, and the solcix configuration file (local config takes precedence over global config).
### Verify Solidity compilers
The `verify` command is used to verify the checksums of installed solc binaries and to reinstall any that are malformed.
Example usage:
```bash
solcix verify 0.8.0 0.8.1
```
### Clear cache of Solidity compilers
The `clear` command is used to remove all cached files. The cache is used to store the downloaded file list. The binary will not be deleted.
Example usage:
```bash
solcix clear
```
### Compile Solidity files
The `compile` command is used to compile Solidity files and print the result. If the output is a TTY, the result will be formatted. Otherwise, the result will be printed as a JSON string.
Example usage:
```bash
solcix compile <file.sol>
```
The command also supports the `-o` or `--output` option to specify an output directory for the compilation result.
Example usage:
```bash
solcix compile <filename>.sol -o <output_dir>
```
Additional optional arguments can be passed to the command using the kwargs argument, it will be taken by the [solc command](https://docs.soliditylang.org/en/v0.8.19/using-the-compiler.html#basic-usage).
Example usage:
```bash
solcix compile <file.sol> --optimize=True --optimize-runs=200 --overwrite=True
```
Or you can redirect the output to a single json file:
```bash
solcix compile <file.sol> > output.json
```
### Resolve compatible versions from solidity file
The `resolve` command is used to determine the recommended solc version for a Solidity file based on its pragma statement. It can also be used to list all versions that are compatible with the Solidity file.
Example usage:
```bash
solcix resolve <file.sol>
```
By default, the command prints the recommended solc version for the Solidity file.
Solidity Example:
```solidity
// SPDX-License-Identifier: MIT
// compiler version must be `0.8.5`, `0.8.6` or `0.8.7`
pragma solidity >=0.8.5 <=0.8.7;
contract HelloWorld {
string public greet = "Hello World!";
}
```
Example output:
```bash
The recommended version is 0.8.5, use `solcix resolve --no-recommand` to see all compatible versions.
```
If the `--no-recommand` option is used, the command will print all compatible versions for the Solidity file.
Example output:
```bash
These versions are compatible with the pragma.
0.8.5
0.8.6
0.8.7
```
### Upgrade Solcix
The `upgrade` command is used to upgrade the architecture of the installed solc binaries, it will remove all old binaries and download the new ones.
Example usage:
```bash
pip3 install -U
# Migrate to the new architecture and Reinstall all binaries
solcix upgrade
```
### Project Acknowledgements
We would like to thank the original projects [solc-select](https://github.com/crytic/solc-select) and [py-solc-x](https://github.com/ApeWorX/py-solc-x) for providing excellent code base, upon which we have optimized and improved to make the project more robust and user-friendly.
Our project is an improved and optimized version of solc-select and py-solc-x, with more features and excellent performance.
If you enjoyed the original projects, we strongly recommend trying out our project to enjoy a better user experience and more efficient code execution.
Raw data
{
"_id": null,
"home_page": "",
"name": "solcix",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "alan890104",
"author_email": "alan890104@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8a/72/e9c9b675b528e0b751e215b7bf74cd09e8e6ce60a2ce330f24b758315006/solcix-0.1.7.tar.gz",
"platform": null,
"description": "# Solcix\n\n[](https://pypi.org/project/solcix?style=flat) [](https://github.com/Solratic/solcix) [](https://pypi.org/project/solcix/) [](https://github.com/psf/black) [](https://github.com/Solratic/solcix) [](https://github.com/Solratic/solcix/blob/main/LICENSE)\n\nSolcix is a Solidity version manager written in Python that allows for seamless switching between versions, easy compilation, and simple management of artifacts.\n\n## Installation\n\nTo install Solcix, you can use pip, the Python package manager:\n\n### With pip For Windows\n\n```bash\npip install solcix\n```\n\n### With pip3 For Linux / Mac\n\n```bash\npip3 install solcix\n```\n\n### With pipx\n\n[pipx](https://github.com/pypa/pipx) installs packages in their own virtual environment, so there's less chance of conflicting dependencies. You can run the following command in your terminal to install:\n\n```bash\npipx install solcix\n```\n\n### With poetry\n\nUses the [poetry](https://github.com/python-poetry/poetry) package manager to install solcix in a project-specific virtual environment. poetry manages dependencies for you and allows you to isolate your project from the global environment. You can run the following command in your terminal to add solcix to your poetry project, and use our wrapped solc api in your code:\n\n```bash\npoetry add solcix\n```\n\n### With pipenv\n\nUses the [pipenv](https://pipenv.pypa.io/en/latest/) package manager to install solcix in a project-specific virtual environment. pipenv also manages dependencies and isolates your project from the global environment, and use our wrapped solc api in your code. You can run the following command in your terminal to install:\n\n```bash\npipenv install solcix\n```\n\n### With pip for main branch\n\nYou can also install solcix from github main branch:\n\n```bash\npip install git+https://github.com/Solratic/solcix.git@main\n```\n\n## Enable Auto-Completion\n\nEnable auto-completion for `solcix` by running the following command:\n\n### With Bash\n\n```bash\n_SOLCIX_COMPLETE=bash_source solcix > ~/.solcix-complete.bash\nsource ~/.solcix-complete.bash\n```\n\n### With Zsh\n\n```zsh\n_SOLCIX_COMPLETE=zsh_source solcix > ~/.solcix-complete.zsh\nsource ~/.solcix-complete.zsh\n```\n\n### With Fish\n\n```fish\n_SOLCIX_COMPLETE=fish_source solcix > ~/.config/fish/completions/solcix.fish\n```\n\n## Usage - CLI\n\nSolcix can be used as a library or as a command line tool. Here are the available commands:\n\n### Listing available Solidity compilers\n\nThe `ls` command can be used to list all available versions of the Solidity compiler:\n\nExample usage:\n\n```bash\nsolcix ls\n```\n\n### Installing Solidity compilers\n\nThe `install` command can be used to install one or more versions of the Solidity compiler:\n\nExample usage:\n\n```bash\nsolcix install 0.8.4 0.7.6 latest\n```\n\n### Listing installed Solidity compilers\n\nThe `installed` command can be used to list all available versions of the Solidity compiler:\n\nExample usage:\n\n```bash\nsolcix installed\n```\n\nIf global / local version is set, it will be displayed as below:\n\n```bash\n0.5.0\n0.8.0\n0.8.16\n0.8.17\n0.8.18 <- current\n0.8.19\n```\n\n### Switching between Solidity compilers\n\nThe `use` command can be used to switch between installed versions of the Solidity compiler, either globally or locally.\n\n- If the specified version is not installed, it will be installed automatically.\n\n- If you use the `local` option, it will create a `.solcix` file in the current directory.\n\nExample usage:\n\n```bash\n# Setting global version to 0.8.16\nsolcix use global 0.8.16\n```\n\n```bash\n# Setting local version to 0.8.16, it will create a .solcix file in the current directory\nsolcix use local 0.8.16\n```\n\n```bash\n# You can also use the alias `latest` to use the latest version\nsolcix use global latest\n```\n\nSimply run the command will see the changes:\n\n```bash\nsolc --version\n```\n\n### Show current Solidity compiler version\n\nThe `current` command can be used to show the current version of the Solidity compiler (local version takes precedence over global version):\n\nExample usage:\n\n```bash\nsolcix current\n```\n\n### Uninstalling Solidity compilers\n\nThe `uninstall` command can be used to uninstall one or more versions of the Solidity compiler:\n\n```bash\nsolcix uninstall 0.8.4 0.7.6\n```\n\n### Uninstall all Solidity compilers\n\nTo uninstall all versions of Solidity compiler that have been installed using solcix, you can use the following command:\n\n```bash\nsolcix purge\n```\n\nThis will remove all versions of the Solidity compilers that have been installed by solcix, all cached files, and the solcix configuration file (local config takes precedence over global config).\n\n### Verify Solidity compilers\n\nThe `verify` command is used to verify the checksums of installed solc binaries and to reinstall any that are malformed.\n\nExample usage:\n\n```bash\nsolcix verify 0.8.0 0.8.1\n```\n\n### Clear cache of Solidity compilers\n\nThe `clear` command is used to remove all cached files. The cache is used to store the downloaded file list. The binary will not be deleted.\n\nExample usage:\n\n```bash\nsolcix clear\n```\n\n### Compile Solidity files\n\nThe `compile` command is used to compile Solidity files and print the result. If the output is a TTY, the result will be formatted. Otherwise, the result will be printed as a JSON string.\n\nExample usage:\n\n```bash\nsolcix compile <file.sol>\n```\n\nThe command also supports the `-o` or `--output` option to specify an output directory for the compilation result.\n\nExample usage:\n\n```bash\nsolcix compile <filename>.sol -o <output_dir>\n```\n\nAdditional optional arguments can be passed to the command using the kwargs argument, it will be taken by the [solc command](https://docs.soliditylang.org/en/v0.8.19/using-the-compiler.html#basic-usage).\n\nExample usage:\n\n```bash\nsolcix compile <file.sol> --optimize=True --optimize-runs=200 --overwrite=True\n```\n\nOr you can redirect the output to a single json file:\n\n```bash\nsolcix compile <file.sol> > output.json\n```\n\n### Resolve compatible versions from solidity file\n\nThe `resolve` command is used to determine the recommended solc version for a Solidity file based on its pragma statement. It can also be used to list all versions that are compatible with the Solidity file.\n\nExample usage:\n\n```bash\nsolcix resolve <file.sol>\n```\n\nBy default, the command prints the recommended solc version for the Solidity file.\n\nSolidity Example:\n\n```solidity\n// SPDX-License-Identifier: MIT\n// compiler version must be `0.8.5`, `0.8.6` or `0.8.7`\npragma solidity >=0.8.5 <=0.8.7;\ncontract HelloWorld {\n string public greet = \"Hello World!\";\n}\n```\n\nExample output:\n\n```bash\nThe recommended version is 0.8.5, use `solcix resolve --no-recommand` to see all compatible versions.\n```\n\nIf the `--no-recommand` option is used, the command will print all compatible versions for the Solidity file.\n\nExample output:\n\n```bash\nThese versions are compatible with the pragma.\n0.8.5\n0.8.6\n0.8.7\n```\n\n### Upgrade Solcix\n\nThe `upgrade` command is used to upgrade the architecture of the installed solc binaries, it will remove all old binaries and download the new ones.\n\nExample usage:\n\n```bash\npip3 install -U\n\n# Migrate to the new architecture and Reinstall all binaries\nsolcix upgrade\n```\n\n### Project Acknowledgements\n\nWe would like to thank the original projects [solc-select](https://github.com/crytic/solc-select) and [py-solc-x](https://github.com/ApeWorX/py-solc-x) for providing excellent code base, upon which we have optimized and improved to make the project more robust and user-friendly.\n\nOur project is an improved and optimized version of solc-select and py-solc-x, with more features and excellent performance.\n\nIf you enjoyed the original projects, we strongly recommend trying out our project to enjoy a better user experience and more efficient code execution.\n",
"bugtrack_url": null,
"license": "",
"summary": "A Python wrapper for the Solidity compiler. Switch between versions, compile, and manage artifacts.",
"version": "0.1.7",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "36d88bb976bb5368cf9a42685f77103abf053e3952139c8c031f6aeae28ee502",
"md5": "a0b61fd9cc062d8bad2b985cb1e4efd2",
"sha256": "e6ca6c87e28e7cb67098c7cd1ea8bdf485e3aca4f715bb6f4f9148b8e818ae6b"
},
"downloads": -1,
"filename": "solcix-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a0b61fd9cc062d8bad2b985cb1e4efd2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 37026,
"upload_time": "2023-04-07T11:28:21",
"upload_time_iso_8601": "2023-04-07T11:28:21.626633Z",
"url": "https://files.pythonhosted.org/packages/36/d8/8bb976bb5368cf9a42685f77103abf053e3952139c8c031f6aeae28ee502/solcix-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8a72e9c9b675b528e0b751e215b7bf74cd09e8e6ce60a2ce330f24b758315006",
"md5": "958f4eb15eb630940c9c27950e8c1994",
"sha256": "45813c6dd6ab42144386ac2d1fdc7d7c2d7c6087a1bb56a4c03c471ca3ed5532"
},
"downloads": -1,
"filename": "solcix-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "958f4eb15eb630940c9c27950e8c1994",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 34781,
"upload_time": "2023-04-07T11:28:22",
"upload_time_iso_8601": "2023-04-07T11:28:22.953348Z",
"url": "https://files.pythonhosted.org/packages/8a/72/e9c9b675b528e0b751e215b7bf74cd09e8e6ce60a2ce330f24b758315006/solcix-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-07 11:28:22",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "solcix"
}
