fujin-cli 0.13.2__tar.gz

fujin_cli-0.13.2/.github/workflows/publish.yml

@@ -0,0 +1,169 @@
+name: Publish package
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build-python-wheel-and-sdist:
+    name: Build a pure Python wheel and source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Build
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels
+          path: dist/*
+          if-no-files-found: error
+          overwrite: true
+
+  build-binaries:
+    name: Build binary application for ${{ matrix.job.target }} (${{ matrix.job.os }})
+    runs-on: ${{ matrix.job.os }}
+    needs: build-python-wheel-and-sdist
+    strategy:
+      fail-fast: false
+      matrix:
+        job:
+          # Linux
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+            cross: true
+            release_suffix: x86_64-linux
+          - target: x86_64-unknown-linux-musl
+            os: ubuntu-latest
+            cross: true
+            release_suffix: x86_64-linux-musl
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-latest
+            cross: true
+            release_suffix: aarch64-linux
+          # - target: i686-unknown-linux-gnu
+          #  os: ubuntu-latest
+          #  cross: true
+          #  release_suffix: i686-linux
+          # Windows
+#          - target: x86_64-pc-windows-msvc
+#            os: windows-2022
+#            release_suffix: x86_64-windows
+#          - target: i686-pc-windows-msvc
+#            os: windows-2022
+#            release_suffix: i686-windows
+          # macOS
+          # - target: aarch64-apple-darwin
+          #   os: macos-12
+          #   release_suffix: aarch64-osx
+          # - target: x86_64-apple-darwin
+          #   os: macos-12
+          #   release_suffix: x86_64-osx
+
+    env:
+      CARGO_BUILD_TARGET: ${{ matrix.job.target }}
+
+    steps:
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install just
+        uses: extractions/setup-just@v2
+
+      - name: Code Checkout
+        uses: actions/checkout@v4
+
+      - name: Install musl-tools on Linux
+        run: sudo apt-get install --yes musl musl-dev musl-tools
+        if: ${{ matrix.job.os == 'ubuntu-latest' }}
+
+      - name: Install Rust toolchain
+        if: ${{ !matrix.job.cross }}
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.job.target }}
+
+      - name: Set up cross compiling tools
+        if: matrix.job.cross
+        uses: taiki-e/setup-cross-toolchain-action@v1
+        with:
+          target: ${{ matrix.job.target}}
+
+      - name: Show toolchain information
+        run: |-
+          rustup toolchain list
+          rustup default
+          rustup -V
+          rustc -V
+          cargo -V
+          uv --version
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: ${{ github.workspace }}/dist
+          merge-multiple: true
+
+      - name: Build binary
+        run: just build-bin
+
+      - name: Rename
+        working-directory: ${{ github.workspace }}
+        run: |-
+          mv dist/bin/fujin_cli* dist/bin/fujin_cli-${{ matrix.job.release_suffix }}
+
+      - name: Upload built binary package
+        uses: actions/upload-artifact@v4
+        with:
+          name: binaries-${{ matrix.job.release_suffix }}
+          path: dist/bin/*
+          if-no-files-found: error
+  
+  publish-to-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    needs: [build-python-wheel-and-sdist, build-binaries]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: dist
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  release:
+    name: Create a GitHub release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    needs: [build-python-wheel-and-sdist, build-binaries]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Generate Changelog
+        run: |
+          awk '/^## /{if (p) exit; p=1; next} p' ${{ github.workspace }}/CHANGELOG.md | tee ${{ github.workspace }}-CHANGELOG.txt
+      
+      - name: Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: ${{ github.workspace }}-CHANGELOG.txt
+          files: dist/*
+          fail_on_unmatched_files: true

fujin_cli-0.13.2/.github/workflows/test.yml

@@ -0,0 +1,21 @@
+name: Test
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install just
+        uses: extractions/setup-just@v2
+
+      - name: Run tests
+        run: just test

fujin_cli-0.13.2/.gitignore

@@ -0,0 +1,152 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+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/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+*.sqlite3
+*.sqlite3-journal
+*.sqlite3-shm
+*.sqlite3-wal
+*.db
+*.db-journal
+*.db-shm
+*.db-wal
+*staticfiles/
+*media
+
+# db dumps
+*.dump
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.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
+examples/django/bookstore/.env.prod
+.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/
+
+# Pycharm
+.idea/
+
+# MacOs
+.DS_Store
+
+id_rsa
+id_rsa.pub
+aws.pem
+.vagrant

fujin_cli-0.13.2/.pre-commit-config.yaml

@@ -0,0 +1,43 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: local
+    hooks:
+      - id: fmt
+        name: ruff format
+        entry: uvx ruff format
+        language: system
+        files: '\.py$'
+
+      - id: logchanges
+        name: update changelog
+        entry: just logchanges || true
+        language: system
+        pass_filenames: false
+
+  - repo: https://github.com/myint/autoflake
+    rev: v2.3.1
+    hooks:
+      - id: autoflake
+        exclude: .*/__init__.py
+        args:
+          - --in-place
+          - --remove-all-unused-imports
+          - --expand-star-imports
+          - --remove-duplicate-keys
+          - --remove-unused-variables
+
+
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.11.1
+    hooks:
+      - id: pyproject-fmt
+        args: [ "pyproject.toml" ]
+        exclude: ^(examples/)
+
+  # - repo: https://github.com/asottile/reorder_python_imports
+  #   rev: v3.13.0
+  #   hooks:
+  #     - id: reorder-python-imports
+  #       args:
+  #         - "--application-directories=src"

fujin_cli-0.13.2/.readthedocs.yaml

@@ -0,0 +1,24 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Optionally, but recommended,
+# declare the Python requirements required to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+    - requirements: docs/requirements.txt
+
+

fujin_cli-0.13.2/CHANGELOG.md

@@ -0,0 +1,118 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.13.2] - 2025-11-28
+
+### 🐛 Bug Fixes
+
+- Hanging interactive shell on 3.14
+
+## [0.13.1] - 2025-11-28
+
+### 🐛 Bug Fixes
+
+- Broken cli because of missing gevent
+
+## [0.13.0] - 2025-11-27
+
+### 🚀 Features
+
+- [**breaking**] Refactor to ejectable defaults, enhanced config, and new docs
+
+## [0.12.2] - 2025-11-16
+
+### 🐛 Bug Fixes
+
+- Dummy proxy
+
+### 🚜 Refactor
+
+- Use custom caddy server name
+- Less files
+
+## [0.12.1] - 2025-03-12
+
+### 🚀 Features
+
+- Add process name to systemd service
+- Add fujin version info
+- Set system as the default secrets adapter
+- Add system secret reader
+
+### 🐛 Bug Fixes
+
+- Force .venv removal on deploy
+- Env content parse logic
+
+### 🚜 Refactor
+
+- Rename env_content to env
+
+### 📚 Documentation
+
+- Document integration with ci ci platforms
+- Apply a more consistent writing style
+
+### ⚙️ Miscellaneous Tasks
+
+- Specify source package to avoid failing build backend
+
+## [0.10.0] - 2024-11-24
+
+### 🚀 Features
+
+- Add doppler support to secrets
+
+## [0.9.1] - 2024-11-23
+
+### 🚜 Refactor
+
+- Drop configurable proxy manager
+
+### 📚 Documentation
+
+- Add links to template systemd service files
+
+### ⚡ Performance
+
+- Run systemd commands concurrently using gevent
+
+## [0.9.0] - 2024-11-23
+
+### 🚀 Features
+
+- Env content can be define directly in toml
+
+### 🚜 Refactor
+
+- Avoid running secret adapter if no secret placeholder is found
+
+## [0.8.0] - 2024-11-23
+
+### 🚀 Features
+
+- Rewrite hooks (#30)
+
+## [0.7.1] - 2024-11-23
+
+### 🐛 Bug Fixes
+
+- Broken .venv folder can fail deploy
+
+## [0.7.0] - 2024-11-22
+
+### 🚀 Features
+
+- Inject secrets via bitwarden and 1password (#29)
+- Add certbot_email configuration for nginx
+
+### 🚜 Refactor
+
+- Move requirements copy to transfer_files
+
+## [0.6.0] - 2024-11-19
+
+<!-- generated by git-cliff -->

fujin_cli-0.13.2/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2024-present Tobi DEGNON <tobidegnon@proton.me>
+
+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.

fujin_cli-0.13.2/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: fujin-cli
+Version: 0.13.2
+Summary: Get your project up and running in a few minutes on your own vps.
+Project-URL: Documentation, https://github.com/falcopackages/fujin#readme
+Project-URL: Issues, https://github.com/falcopackages/fujin/issues
+Project-URL: Source, https://github.com/falcopackages/fujin
+Author-email: Tobi DEGNON <tobidegnon@proton.me>
+License-File: LICENSE.txt
+Keywords: caddy,deployment,django,fastapi,litestar,python,systemd
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: <3.14,>=3.10
+Requires-Dist: cappa>=0.24
+Requires-Dist: fabric>=3.2.2
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: msgspec[toml]>=0.18.6
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: rich>=13.9.2
+Description-Content-Type: text/markdown
+
+# fujin
+
+> [!IMPORTANT]
+> This tool currently contains minimal features and is a work-in-progress
+
+<!-- content:start -->
+
+`fujin` is a simple deployment tool that helps you get your project up and running on a VPS in minutes. It manages your app processes using [systemd](https://systemd.io) and runs your apps behind [caddy](https://caddyserver.com).
+
+[![Publish Package](https://github.com/falcopackages/fujin/actions/workflows/publish.yml/badge.svg)](https://github.com/falcopackages/fujin/actions/workflows/publish.yml)
+[![PyPI - Version](https://img.shields.io/pypi/v/fujin-cli.svg)](https://pypi.org/project/fujin-cli)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fujin-cli.svg)](https://pypi.org/project/fujin-cli)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/falcopackages/fujin/blob/main/LICENSE.txt)
+[![Status](https://img.shields.io/pypi/status/fujin-cli.svg)](https://pypi.org/project/fujin-cli)
+
+## Features
+
+- 🚀 One-command server bootstrap
+- 🔄 Rollback broken deployments
+- 🔐 Zero configuration SSL certificates via [Caddy](https://caddyserver.com)
+- 🛠️ Secrets injection from password managers ([Bitwarden](https://bitwarden.com/), [1Password](https://1password.com), etc.)
+- 📝 **Ejectable Defaults**: Full control over `systemd` and `caddy` templates
+- 👨‍💻 Remote application management and log streaming
+- 🐍 Supports packaged python apps and self-contained binaries
+
+For more details, check out the [documentation📚](https://fujin.oluwatobi.dev/en/latest/).
+
+## Why?
+
+I wanted [kamal](https://kamal-deploy.org/) but without Docker, and I thought the idea was fun. At its core, this project automates versions of this [tutorial](https://www.digitalocean.com/community/tutorials/how-to-set-up-django-with-postgres-nginx-and-gunicorn-on-ubuntu). If you've been a Django beginner 
+trying to get your app in production, you probably went through this.
+
+I'm using `caddy` here instead of `nginx` because it's configurable via an API and it's is a no-brainer for SSL certificates. `Systemd` is the default on most Linux distributions and does a good enough job.
+
+Fujin was initially planned to be a Python-only project, but the core concepts can be applied to any language that can produce a single distributable file (e.g., Go, Rust).
+
+The goal is to automate deployment while leaving you in full control of your Linux box. It's not a CLI PaaS - it's simple and expects you to be able to SSH into your server and troubleshoot if necessary. For beginners, it makes the initial deployment easier while you get your hands dirty with Linux.
+If you need a never-break, worry-free, set-it-and-forget-it setup that auto-scales and does all the magic, fujin probably isn't for you.
+
+## Inspiration and alternatives
+
+Fujin draws inspiration from the following tools for their developer experience. These are better alternatives if you need a more robust, set-and-forget solution
+
+- [fly.io](https://fly.io/)
+- [kamal](https://kamal-deploy.org/) (you probably can't just forget this one)
+
+## License
+
+`fujin` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
+
+<!-- content:end -->

fujin_cli-0.13.2/README.md

@@ -0,0 +1,51 @@
+# fujin
+
+> [!IMPORTANT]
+> This tool currently contains minimal features and is a work-in-progress
+
+<!-- content:start -->
+
+`fujin` is a simple deployment tool that helps you get your project up and running on a VPS in minutes. It manages your app processes using [systemd](https://systemd.io) and runs your apps behind [caddy](https://caddyserver.com).
+
+[![Publish Package](https://github.com/falcopackages/fujin/actions/workflows/publish.yml/badge.svg)](https://github.com/falcopackages/fujin/actions/workflows/publish.yml)
+[![PyPI - Version](https://img.shields.io/pypi/v/fujin-cli.svg)](https://pypi.org/project/fujin-cli)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fujin-cli.svg)](https://pypi.org/project/fujin-cli)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/falcopackages/fujin/blob/main/LICENSE.txt)
+[![Status](https://img.shields.io/pypi/status/fujin-cli.svg)](https://pypi.org/project/fujin-cli)
+
+## Features
+
+- 🚀 One-command server bootstrap
+- 🔄 Rollback broken deployments
+- 🔐 Zero configuration SSL certificates via [Caddy](https://caddyserver.com)
+- 🛠️ Secrets injection from password managers ([Bitwarden](https://bitwarden.com/), [1Password](https://1password.com), etc.)
+- 📝 **Ejectable Defaults**: Full control over `systemd` and `caddy` templates
+- 👨‍💻 Remote application management and log streaming
+- 🐍 Supports packaged python apps and self-contained binaries
+
+For more details, check out the [documentation📚](https://fujin.oluwatobi.dev/en/latest/).
+
+## Why?
+
+I wanted [kamal](https://kamal-deploy.org/) but without Docker, and I thought the idea was fun. At its core, this project automates versions of this [tutorial](https://www.digitalocean.com/community/tutorials/how-to-set-up-django-with-postgres-nginx-and-gunicorn-on-ubuntu). If you've been a Django beginner 
+trying to get your app in production, you probably went through this.
+
+I'm using `caddy` here instead of `nginx` because it's configurable via an API and it's is a no-brainer for SSL certificates. `Systemd` is the default on most Linux distributions and does a good enough job.
+
+Fujin was initially planned to be a Python-only project, but the core concepts can be applied to any language that can produce a single distributable file (e.g., Go, Rust).
+
+The goal is to automate deployment while leaving you in full control of your Linux box. It's not a CLI PaaS - it's simple and expects you to be able to SSH into your server and troubleshoot if necessary. For beginners, it makes the initial deployment easier while you get your hands dirty with Linux.
+If you need a never-break, worry-free, set-it-and-forget-it setup that auto-scales and does all the magic, fujin probably isn't for you.
+
+## Inspiration and alternatives
+
+Fujin draws inspiration from the following tools for their developer experience. These are better alternatives if you need a more robust, set-and-forget solution
+
+- [fly.io](https://fly.io/)
+- [kamal](https://kamal-deploy.org/) (you probably can't just forget this one)
+
+## License
+
+`fujin` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
+
+<!-- content:end -->