rostainer-deploy 0.0.3__tar.gz

rostainer_deploy-0.0.3/.gitignore

@@ -0,0 +1,213 @@
+# Created by https://www.toptal.com/developers/gitignore/api/visualstudiocode,python,emacs
+# Edit at https://www.toptal.com/developers/gitignore?templates=visualstudiocode,python,emacs
+
+# Docker ROS Tools - This is a tool repository, not a workspace
+# Ignore any test workspaces or temporary files created during development
+.compose_starter_info
+.docker-compose.override.yml
+.direnv/
+builds/
+# Generated from git tags by hatch-vcs at build/install time
+scripts/cli/rostainer_cli/_version.py
+### Emacs ###
+# -*- mode: gitignore; -*-
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Org-mode
+.org-id-locations
+*_archive
+
+# flymake-mode
+*_flymake.*
+
+# eshell files
+/eshell/history
+/eshell/lastdir
+
+# elpa packages
+/elpa/
+
+# reftex files
+*.rel
+
+# AUCTeX auto folder
+/auto/
+
+# cask packages
+.cask/
+dist/
+
+# Flycheck
+flycheck_*.el
+
+# server auth directory
+/server/
+
+# projectiles files
+.projectile
+
+# directory configuration
+.dir-locals.el
+
+# network security
+/network-security.data
+
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+### VisualStudioCode ###
+.vscode/
+
+# Local History for Visual Studio Code
+.history/
+
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+.ionide
+
+# End of https://www.toptal.com/developers/gitignore/api/visualstudiocode,python,emacs

rostainer_deploy-0.0.3/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.5
+Name: rostainer-deploy
+Version: 0.0.3
+Summary: rostainer plugin: push package updates to robots over ssh, through a local registry
+Project-URL: Homepage, https://git.whoi.edu/bmillerklugman/rostainer
+Project-URL: Documentation, https://bmillerklugman.pages.whoi.edu/rostainer/
+Author: rostainer contributors
+License-Expression: MIT
+Keywords: deployment,docker,fleet,ros,ros2,rostainer
+Requires-Python: >=3.7
+Requires-Dist: rich>=12
+Requires-Dist: rostainer
+Requires-Dist: rostainer-package
+Description-Content-Type: text/markdown
+
+# rostainer-deploy
+
+A [rostainer](https://bmillerklugman.pages.whoi.edu/rostainer/) plugin that pushes
+package updates (from [`rostainer-package`](../rostainer-package)) to robots over
+ssh. Images go through a registry on your machine, so each robot downloads only the
+layers it doesn't have yet - after a code change, typically just the workspace's
+build. No image tar is copied, and robots need only ssh, Docker and Python 3.
+
+```bash
+pipx inject rostainer rostainer-deploy     # or: pip install 'rostainer[deploy]'
+rostainer init --with deploy               # adds [plugins.deploy] to .rostainer.toml
+```
+
+```toml
+[plugins.deploy]
+[plugins.deploy.groups]
+robots = ["robot1", "robot2"]
+
+[plugins.deploy.targets.robot1]
+host = "10.0.0.5"          # or a ~/.ssh/config alias
+user = "ros"
+
+[plugins.deploy.targets.robot2]
+host = "robot2"
+```
+
+```bash
+rostainer deploy setup                     # first time: copy your ssh key, check the robots, push
+rostainer package create                   # build a new version
+rostainer deploy push                      # send it to every robot (or: push robots, push robot1)
+rostainer deploy status                    # what each robot runs
+rostainer deploy rollback robot1           # back to the version it ran before
+```
+
+See the [Deploy guide](https://bmillerklugman.pages.whoi.edu/rostainer/plugins/deploy.html).

rostainer_deploy-0.0.3/README.md

@@ -0,0 +1,35 @@
+# rostainer-deploy
+
+A [rostainer](https://bmillerklugman.pages.whoi.edu/rostainer/) plugin that pushes
+package updates (from [`rostainer-package`](../rostainer-package)) to robots over
+ssh. Images go through a registry on your machine, so each robot downloads only the
+layers it doesn't have yet - after a code change, typically just the workspace's
+build. No image tar is copied, and robots need only ssh, Docker and Python 3.
+
+```bash
+pipx inject rostainer rostainer-deploy     # or: pip install 'rostainer[deploy]'
+rostainer init --with deploy               # adds [plugins.deploy] to .rostainer.toml
+```
+
+```toml
+[plugins.deploy]
+[plugins.deploy.groups]
+robots = ["robot1", "robot2"]
+
+[plugins.deploy.targets.robot1]
+host = "10.0.0.5"          # or a ~/.ssh/config alias
+user = "ros"
+
+[plugins.deploy.targets.robot2]
+host = "robot2"
+```
+
+```bash
+rostainer deploy setup                     # first time: copy your ssh key, check the robots, push
+rostainer package create                   # build a new version
+rostainer deploy push                      # send it to every robot (or: push robots, push robot1)
+rostainer deploy status                    # what each robot runs
+rostainer deploy rollback robot1           # back to the version it ran before
+```
+
+See the [Deploy guide](https://bmillerklugman.pages.whoi.edu/rostainer/plugins/deploy.html).

rostainer_deploy-0.0.3/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rostainer-deploy"
+dynamic = ["version"]
+description = "rostainer plugin: push package updates to robots over ssh, through a local registry"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.7"
+authors = [{ name = "rostainer contributors" }]
+keywords = ["ros", "ros2", "docker", "rostainer", "deployment", "fleet"]
+# Compatibility with rostainer itself is the plugin API version
+# (DeployPlugin.api_version), which rostainer checks when it loads it.
+dependencies = ["rostainer", "rostainer-package", "rich>=12"]
+
+[project.entry-points."rostainer.plugins"]
+deploy = "rostainer_deploy:DeployPlugin"
+
+[project.urls]
+Homepage = "https://git.whoi.edu/bmillerklugman/rostainer"
+Documentation = "https://bmillerklugman.pages.whoi.edu/rostainer/"
+
+# Versioned with rostainer, from the same repository's tags.
+[tool.hatch.version]
+source = "vcs"
+fallback-version = "0.0.0.dev0"
+raw-options = { root = "../.." }
+
+[tool.hatch.build.targets.wheel]
+packages = ["rostainer_deploy"]