fastweb3-console 0.1.0__tar.gz

fastweb3_console-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iamdefinitelyahuman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fastweb3_console-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: fastweb3-console
+Version: 0.1.0
+Summary: Interactive console and script runner for working with EVM blockchains.
+Author: iamdefinitelyahuman
+License: MIT
+Project-URL: Homepage, https://github.com/iamdefinitelyahuman/fastweb3-console
+Project-URL: Repository, https://github.com/iamdefinitelyahuman/fastweb3-console
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastweb3-objects<0.2.0,>=0.1.3
+Requires-Dist: lazy-object-proxy>=1.12.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: prompt-toolkit<4.0.0,>=3.0.52
+Requires-Dist: pygments>=2.18
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff>=0.9; extra == "dev"
+Requires-Dist: pre-commit>=3; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: mkdocs>=1.6; extra == "dev"
+Requires-Dist: mkdocs-material>=9.5; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Dynamic: license-file
+
+# fastweb3-console
+
+Interactive console and script runner for working with EVM blockchains.
+
+**NOTE**: This library is still in early alpha development. Prior to a `v1.0.0` (which may never come), expect breaking changes and no backward compatibility between versions.
+
+## Installation
+
+You can install the latest release via `pip`:
+
+```bash
+pip install fastweb3-console
+```
+
+Or clone the repository for the most up-to-date version:
+
+```bash
+git clone https://github.com/iamdefinitelyahuman/fastweb3-console.git
+cd fastweb3-console
+pip install -e .
+```
+
+## Usage
+
+Launch the console with:
+
+```bash
+fw3
+```
+
+The console starts as a normal Python REPL with the main [`fastweb3-objects`](https://github.com/iamdefinitelyahuman/fastweb3-objects) entry points already available:
+
+```py
+>>> accounts
+<Accounts ...>
+>>> Chain
+<class 'fw3_objects.chain.Chain'>
+>>> Contract
+<class 'fw3_objects.contract.Contract'>
+>>> Transaction
+<class 'fw3_objects.transaction.Transaction'>
+```
+
+Users familiar with the Brownie console should feel right at home.
+
+## Development
+
+First, install the dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Run the test suite with:
+
+```bash
+pytest
+```
+
+Run linting with:
+
+```bash
+ruff check .
+```
+
+## License
+
+This project is licensed under the MIT license.

fastweb3_console-0.1.0/README.md

@@ -0,0 +1,68 @@
+# fastweb3-console
+
+Interactive console and script runner for working with EVM blockchains.
+
+**NOTE**: This library is still in early alpha development. Prior to a `v1.0.0` (which may never come), expect breaking changes and no backward compatibility between versions.
+
+## Installation
+
+You can install the latest release via `pip`:
+
+```bash
+pip install fastweb3-console
+```
+
+Or clone the repository for the most up-to-date version:
+
+```bash
+git clone https://github.com/iamdefinitelyahuman/fastweb3-console.git
+cd fastweb3-console
+pip install -e .
+```
+
+## Usage
+
+Launch the console with:
+
+```bash
+fw3
+```
+
+The console starts as a normal Python REPL with the main [`fastweb3-objects`](https://github.com/iamdefinitelyahuman/fastweb3-objects) entry points already available:
+
+```py
+>>> accounts
+<Accounts ...>
+>>> Chain
+<class 'fw3_objects.chain.Chain'>
+>>> Contract
+<class 'fw3_objects.contract.Contract'>
+>>> Transaction
+<class 'fw3_objects.transaction.Transaction'>
+```
+
+Users familiar with the Brownie console should feel right at home.
+
+## Development
+
+First, install the dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Run the test suite with:
+
+```bash
+pytest
+```
+
+Run linting with:
+
+```bash
+ruff check .
+```
+
+## License
+
+This project is licensed under the MIT license.

fastweb3_console-0.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fastweb3-console"
+version = "0.1.0"
+description = "Interactive console and script runner for working with EVM blockchains."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [
+    { name = "iamdefinitelyahuman" }
+]
+
+dependencies = [
+    "fastweb3-objects>=0.1.3,<0.2.0",
+    "lazy-object-proxy>=1.12.0",
+    "platformdirs>=4.0",
+    "prompt-toolkit>=3.0.52,<4.0.0",
+    "pygments>=2.18",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "ruff>=0.9",
+    "pre-commit>=3",
+    "build",
+    "twine",
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+]
+docs = [
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+]
+
+[project.scripts]
+fw3 = "fw3_console.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/iamdefinitelyahuman/fastweb3-console"
+Repository = "https://github.com/iamdefinitelyahuman/fastweb3-console"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.pytest.ini_options]
+addopts = [
+  "--cov=fw3_console",
+  "--cov-report=term-missing",
+  "--cov-report=xml",
+]
+testpaths = ["tests"]

fastweb3_console-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fastweb3_console-0.1.0/src/fastweb3_console.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: fastweb3-console
+Version: 0.1.0
+Summary: Interactive console and script runner for working with EVM blockchains.
+Author: iamdefinitelyahuman
+License: MIT
+Project-URL: Homepage, https://github.com/iamdefinitelyahuman/fastweb3-console
+Project-URL: Repository, https://github.com/iamdefinitelyahuman/fastweb3-console
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastweb3-objects<0.2.0,>=0.1.3
+Requires-Dist: lazy-object-proxy>=1.12.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: prompt-toolkit<4.0.0,>=3.0.52
+Requires-Dist: pygments>=2.18
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff>=0.9; extra == "dev"
+Requires-Dist: pre-commit>=3; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: mkdocs>=1.6; extra == "dev"
+Requires-Dist: mkdocs-material>=9.5; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Dynamic: license-file
+
+# fastweb3-console
+
+Interactive console and script runner for working with EVM blockchains.
+
+**NOTE**: This library is still in early alpha development. Prior to a `v1.0.0` (which may never come), expect breaking changes and no backward compatibility between versions.
+
+## Installation
+
+You can install the latest release via `pip`:
+
+```bash
+pip install fastweb3-console
+```
+
+Or clone the repository for the most up-to-date version:
+
+```bash
+git clone https://github.com/iamdefinitelyahuman/fastweb3-console.git
+cd fastweb3-console
+pip install -e .
+```
+
+## Usage
+
+Launch the console with:
+
+```bash
+fw3
+```
+
+The console starts as a normal Python REPL with the main [`fastweb3-objects`](https://github.com/iamdefinitelyahuman/fastweb3-objects) entry points already available:
+
+```py
+>>> accounts
+<Accounts ...>
+>>> Chain
+<class 'fw3_objects.chain.Chain'>
+>>> Contract
+<class 'fw3_objects.contract.Contract'>
+>>> Transaction
+<class 'fw3_objects.transaction.Transaction'>
+```
+
+Users familiar with the Brownie console should feel right at home.
+
+## Development
+
+First, install the dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Run the test suite with:
+
+```bash
+pytest
+```
+
+Run linting with:
+
+```bash
+ruff check .
+```
+
+## License
+
+This project is licensed under the MIT license.

fastweb3_console-0.1.0/src/fastweb3_console.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+LICENSE
+README.md
+pyproject.toml
+src/fastweb3_console.egg-info/PKG-INFO
+src/fastweb3_console.egg-info/SOURCES.txt
+src/fastweb3_console.egg-info/dependency_links.txt
+src/fastweb3_console.egg-info/entry_points.txt
+src/fastweb3_console.egg-info/requires.txt
+src/fastweb3_console.egg-info/top_level.txt
+src/fw3_console/__init__.py
+src/fw3_console/autosuggest.py
+src/fw3_console/cli.py
+src/fw3_console/completion.py
+src/fw3_console/contracts.py
+src/fw3_console/display.py
+src/fw3_console/history.py
+src/fw3_console/parser.py
+src/fw3_console/proxy_warnings.py
+src/fw3_console/resolver.py
+tests/test_autosuggest.py
+tests/test_branches.py
+tests/test_completion.py
+tests/test_displayhook.py
+tests/test_history.py
+tests/test_parser.py
+tests/test_proxy_warnings.py

fastweb3_console-0.1.0/src/fastweb3_console.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fastweb3_console-0.1.0/src/fastweb3_console.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fw3 = fw3_console.cli:main

fastweb3_console-0.1.0/src/fastweb3_console.egg-info/requires.txt

@@ -0,0 +1,19 @@
+fastweb3-objects<0.2.0,>=0.1.3
+lazy-object-proxy>=1.12.0
+platformdirs>=4.0
+prompt-toolkit<4.0.0,>=3.0.52
+pygments>=2.18
+
+[dev]
+pytest>=8
+pytest-cov>=5
+ruff>=0.9
+pre-commit>=3
+build
+twine
+mkdocs>=1.6
+mkdocs-material>=9.5
+
+[docs]
+mkdocs>=1.6
+mkdocs-material>=9.5

fastweb3_console-0.1.0/src/fastweb3_console.egg-info/top_level.txt

@@ -0,0 +1 @@
+fw3_console

fastweb3_console-0.1.0/src/fw3_console/autosuggest.py

@@ -0,0 +1,63 @@
+from __future__ import annotations
+
+"""Ghost-text call suggestions for the interactive console."""
+
+from prompt_toolkit.auto_suggest import AutoSuggest, Suggestion
+
+from .contracts import call_suggestion_parts
+from .parser import active_call_context
+
+
+def make_call_suggestion(method, arg_index, current_arg, bound_receiver=False, invocation=None):
+    """Build the visible ghost text for the active call, if it is unambiguous."""
+    parts = call_suggestion_parts(method, bound_receiver, invocation)
+    if parts is None:
+        return None
+
+    if parts and isinstance(parts[0], list):
+        matches = [item for item in parts if len(item) > arg_index or (not item and arg_index == 0)]
+        if len(matches) != 1:
+            return None
+        parts = matches[0]
+
+    if arg_index >= len(parts):
+        return Suggestion(")")
+
+    current_part = parts[arg_index]
+    next_parts = parts[arg_index + 1 :]
+    typed = current_arg.lstrip()
+
+    if typed:
+        if len(typed) < len(current_part):
+            suggestion = current_part[len(typed) :]
+            if next_parts:
+                suggestion += ", " + ", ".join(next_parts)
+        else:
+            suggestion = ", ".join(next_parts)
+            if suggestion:
+                suggestion = ", " + suggestion
+        return Suggestion(suggestion + ")")
+
+    remaining = ", ".join(parts[arg_index:])
+    prefix = " " if current_arg else ""
+    return Suggestion(prefix + remaining + ")")
+
+
+class ConsoleAutoSuggest(AutoSuggest):
+    """Prompt-toolkit autosuggest adapter backed by call-context parsing."""
+
+    def __init__(self, namespace):
+        self.namespace = namespace
+
+    def get_suggestion(self, buffer, document):
+        context = active_call_context(document.text_before_cursor, self.namespace)
+        if context is None:
+            return None
+
+        return make_call_suggestion(
+            context.obj,
+            context.arg_index,
+            context.current_arg,
+            context.bound_receiver,
+            context.invocation,
+        )

fastweb3_console-0.1.0/src/fw3_console/cli.py

@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+"""Interactive console entry point and prompt-toolkit wiring."""
+
+import sys
+from code import InteractiveConsole
+from importlib.metadata import version
+from pathlib import Path
+
+from fw3_objects import Accounts, Chain, Contract, Transaction
+from platformdirs import user_cache_dir
+from prompt_toolkit import PromptSession
+from prompt_toolkit.key_binding import KeyBindings
+from prompt_toolkit.lexers import PygmentsLexer
+from prompt_toolkit.styles import style_from_pygments_cls
+from pygments.lexers import PythonLexer
+
+from .autosuggest import ConsoleAutoSuggest
+from .completion import ConsoleCompleter
+from .display import PYGMENTS_STYLE, displayhook, write_highlighted
+from .history import SafeFileHistory
+from .proxy_warnings import warn_proxy_identity_comparisons
+
+_CONSOLE_STYLE = style_from_pygments_cls(PYGMENTS_STYLE)
+
+
+def _console_key_bindings():
+    """Return console key bindings that override awkward prompt defaults."""
+    key_bindings = KeyBindings()
+
+    @key_bindings.add("right")
+    def _(event):
+        event.current_buffer.cursor_right(count=event.arg)
+
+    return key_bindings
+
+
+class Console(InteractiveConsole):
+    """Interactive fastweb3 console.
+
+    This class owns the small amount of glue that makes the shell feel different
+    from a plain Python REPL: prompt-toolkit completions/autosuggest, sanitized
+    history, highlighted output, and warnings for proxy identity comparisons.
+    """
+
+    def __init__(self):
+        history_path = Path(user_cache_dir("fw3-console")) / "history"
+        history_path.parent.mkdir(parents=True, exist_ok=True)
+
+        namespace = {
+            "accounts": Accounts(unlock=False),
+            "Contract": Contract,
+            "Chain": Chain,
+            "Transaction": Transaction,
+        }
+
+        self.prompt_session = PromptSession(
+            completer=ConsoleCompleter(namespace),
+            lexer=PygmentsLexer(PythonLexer),
+            auto_suggest=ConsoleAutoSuggest(namespace),
+            key_bindings=_console_key_bindings(),
+            history=SafeFileHistory(history_path, namespace),
+            style=_CONSOLE_STYLE,
+        )
+
+        super().__init__(namespace)
+
+    def raw_input(self, prompt=""):
+        return self.prompt_session.prompt(prompt)
+
+    def runsource(self, source, filename="<input>", symbol="single"):
+        """Compile and run one input block with pre-execution console checks."""
+        try:
+            code = self.compile(source, filename, symbol)
+        except (OverflowError, SyntaxError, ValueError):
+            self.showsyntaxerror(filename)
+            return False
+
+        if code is None:
+            return True
+
+        warn_proxy_identity_comparisons(source, self.locals)
+        self.runcode(code)
+        return False
+
+    def runcode(self, code):
+        """Run code with the console displayhook installed temporarily."""
+        old_displayhook = sys.displayhook
+        sys.displayhook = displayhook
+        try:
+            super().runcode(code)
+        finally:
+            sys.displayhook = old_displayhook
+
+    def write(self, data):
+        write_highlighted(data)
+
+
+def main():
+    """Start the interactive console."""
+    ver = version("fastweb3-console")
+    print(f"fastweb3-console v{ver}: interactive console for EVM blockchains")
+    console = Console()
+    console.interact(banner="")