Go to file
SporeStack 18ff8ea3f5 5.2.2: Improve `sporestack list` expired server handling 2022-02-24 23:30:58 +00:00
src/sporestack 5.2.2: Improve `sporestack list` expired server handling 2022-02-24 23:30:58 +00:00
tests 5.2.1 2022-02-24 23:29:31 +00:00
.editorconfig 5.2.1 2022-02-24 23:29:31 +00:00
.gitignore 5.2.1 2022-02-24 23:29:31 +00:00
.pre-commit-config.yaml 5.2.1 2022-02-24 23:29:31 +00:00
.woodpecker.yml 5.2.1 2022-02-24 23:29:31 +00:00
CHANGELOG.md 5.2.1 2022-02-24 23:29:31 +00:00
LICENSE.txt 5.2.1 2022-02-24 23:29:31 +00:00
Makefile 5.2.1 2022-02-24 23:29:31 +00:00
Pipfile 5.2.1 2022-02-24 23:29:31 +00:00
Pipfile.lock 5.2.1 2022-02-24 23:29:31 +00:00
README.md 5.2.1 2022-02-24 23:29:31 +00:00
pyproject.toml 5.2.1 2022-02-24 23:29:31 +00:00
setup.cfg 5.2.2: Improve `sporestack list` expired server handling 2022-02-24 23:30:58 +00:00

README.md

Python 3 library and CLI for SporeStack .onion

Requirements

  • Python 3.7-3.10 (or maybe newer)

Installation

  • pip install sporestack
  • Recommended: Create a virtual environment, first. Can use pipenv, as well.

Running without installing (preferred)

  • Make sure pipx is installed.
  • pipx run sporestack
  • Make sure you're on the latest version with sporestack version.

Screenshot

sporestack CLI screenshot

Usage

  • sporestack launch SomeHostname --flavor vps-1vcpu-1gb --days 7 --ssh-key ~/.ssh/id_rsa.pub --operating-system debian-10 --currency btc
  • sporestack topup SomeHostname --days 3 --currency xmr
  • sporestack launch SomeOtherHostname --flavor vps-1vcpu-2gb --days 7 --ssh-key ~/.ssh/id_rsa.pub --operating-system debian-11 --currency btc
  • sporestack stop SomeHostname
  • sporestack start SomeHostname
  • sporestack list
  • sporestack remove SomeHostname # If expired
  • sporestack settlement-token-generate
  • sporestack settlement-token-enable (token) --dollars 10 --currency xmr
  • sporestack settlement-token-add (token) --dollars 25 --currency btc
  • sporestack settlement-token-balance (token)

More examples on the website.

Notes

  • You can use --settlement-token if you don't want to pay with QR codes all the time.
  • If using a .onion API endpoint, will try to use a local Tor proxy if connecting to a .onion URL. (127.0.0.1:9050)

Developing

  • pip install pipenv pre-commit
  • pipenv install --deploy --dev
  • pipenv run make test (If you don't have make, use almake)
  • Hint: pre-commit run is a faster way to run some of the tests/autofixers.

Licence

Unlicense/Public domain