Go to file
SporeStack a0864e413a v10.1.1: Fixed `sporestack server operating-systems` 2023-04-14 21:57:08 +00:00
src/sporestack v10.1.1: Fixed `sporestack server operating-systems` 2023-04-14 21:57:08 +00:00
tests Better test coverage 2023-04-12 00:40:45 +00:00
.editorconfig 5.2.1 2022-02-24 23:29:31 +00:00
.gitignore v10.0.0: Cleanups/refactor 2023-04-13 00:01:33 +00:00
.woodpecker.yml Attempt CI fix 2022-11-28 16:49:50 +00:00
CHANGELOG.md v10.1.1: Fixed `sporestack server operating-systems` 2023-04-14 21:57:08 +00:00
LICENSE.txt 5.2.1 2022-02-24 23:29:31 +00:00
Makefile 9.1.0: Messaging and fixes for API changes 2023-03-29 01:51:06 +00:00
Pipfile 9.1.1: default_factory bugfix 2023-04-12 00:36:08 +00:00
Pipfile.lock 9.1.1: default_factory bugfix 2023-04-12 00:36:08 +00:00
README.md README improvements 2023-02-07 19:42:49 +00:00
integration-test.sh v10.1.1: Fixed `sporestack server operating-systems` 2023-04-14 21:57:08 +00:00
pyproject.toml v10.0.0: Cleanups/refactor 2023-04-13 00:01:33 +00:00
tox.ini v10.0.0: Cleanups/refactor 2023-04-13 00:01:33 +00:00

README.md

Python 3 library and CLI for SporeStack .onion

Changelog

Requirements

  • Python 3.7-3.11 (or maybe newer)

Installation

  • pip install sporestack
  • Recommended: Create a virtual environment, first, and use it inside there.

Running without installing

  • Make sure pipx is installed.
  • pipx run sporestack
  • Make sure you're on the latest stable version comparing sporestack version with git tags in this repository, or releases on PyPI.

Usage

  • sporestack token create --dollars 20 --currency xmr # Can use btc as well.
  • sporestack token list
  • sporestack token balance
  • sporestack server launch SomeHostname --operating-system debian-11 --days 1 # Will use ~/.ssh/id_rsa.pub as your SSH key, by default (You may also want to consider passing --region to have a non-random region. This will use the "primary" token by default, which is the default when you run sporestack token create.)
  • sporestack server stop SomeHostname
  • sporestack server start SomeHostname
  • sporestack server list
  • sporestack server remove SomeHostname # If expired

Notes

  • If you want to communicate with SporeStack APIs using Tor, set this environment variable: SPORESTACK_USE_TOR_ENDPOINT=1

Developing

  • pipenv install --deploy --dev
  • pipenv run make test (If you don't have make, use almake)
  • pipenv run make format to format files and apply ruff fixes.

Licence

Unlicense/Public domain