panos 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c1a7d8a2853451710b3b9bbc1d9658e988cb6c1c2bc1c0b75c371f4e7b9f13e8
+  data.tar.gz: 10c24fa8b2225a170b3c72b2ec43bb8ee411a26b3093937ca0b5e637e5f5eedf
+SHA512:
+  metadata.gz: '029da9de36a973fb35244d0ff82561f4ae7e447e34756883fe44ae1a7ff337b56d0cca0aed8054e8ce4e2f6febc032ac3f32d6f9fdf8b30d89653b2cfaf871fa'
+  data.tar.gz: 2bdcf4a4b594e7a9e94bfa65ad0ac311d09a99b1cadc819bef256bf7cb0a5c77fa2741964b4475b4591bf5173e5b3aa432c888bd99e425c06eb701c8d6ceaaf6

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0 - 2026-10-16
+
+- 初始化 gem 命名空间、版本常量和基础异常。
+- 集成 Ruby 3.3、3.4、4.0 CI、gem 隔离安装验证和 GitHub Release 自动发布。
+- 当前版本为项目骨架，尚未实现设备连接或命令操作。

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gatework
+
+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.

data/README.md

@@ -0,0 +1,61 @@
+# panos
+
+[![CI](https://github.com/gatework/panos/actions/workflows/ci.yml/badge.svg)](https://github.com/gatework/panos/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/panos.svg)](https://rubygems.org/gems/panos)
+
+面向 Panos 设备自动化的 Ruby gem。目前为初始骨架，提供命名空间、版本常量与基础异常；设备连接、配置解析和命令操作尚未实现。
+
+## 安装
+
+要求 Ruby 3.3 或更高版本。
+
+```sh
+gem install panos
+```
+
+或在 Gemfile 中添加：
+
+```ruby
+gem "panos", "~> 0.1.0"
+```
+
+## 使用
+
+```ruby
+require "panos"
+
+Panos::VERSION # => "0.1.0"
+Panos::Error   # StandardError 的子类
+```
+
+## 开发
+
+```sh
+bundle install
+bundle exec rake
+bundle exec rake package
+```
+
+CI 覆盖 Ruby 3.3、3.4、4.0。打包步骤在临时 GEM_HOME 中安装并加载 gem，检查版本与加载路径。
+
+## 发布
+
+1. 更新 `lib/panos/version.rb` 与 `CHANGELOG.md`，提交并推送到 `main`。
+2. 等待该提交的 CI 通过，创建并推送同版本标签，例如 `v0.1.1`。
+3. 在 GitHub 发布该标签的 Release；`release.yml` 会重新运行完整 CI，下载通过验证的 gem，发布到 RubyGems，再将相同的 gem 与 `SHA256SUMS` 附加到 Release。
+
+```sh
+git tag -a v0.1.1 -m "Release 0.1.1"
+git push origin v0.1.1
+gh release create v0.1.1 --verify-tag --title v0.1.1 --notes-file CHANGELOG.md
+```
+
+本仓库已配置 [RubyGems Trusted Publishing](https://guides.rubygems.org/trusted-publishing/)，通过 GitHub OIDC 获取短期发布凭据，无需长期 API key 或手动 OTP。RubyGems 上的 gem `panos` 信任 owner `gatework`、repository `panos`、workflow `release.yml`、environment `release`；发布环境仅允许 `v*` 标签。
+
+只有主动切换为 API key 认证时，才需要设置 `release` environment 的 `RUBYGEMS_API_KEY` secret。
+
+发布后最多等待 10 分钟，核对 RubyGems 版本与下载字节。失败时优先重新运行失败的 job，以复用原 CI 产物。`workflow_dispatch` 仅接受版本标签，并要求 GitHub Release 已存在。已发布的相同版本只有校验和一致才可继续；不同内容必须提升版本号。
+
+## 许可
+
+MIT，见 [LICENSE](LICENSE)。本项目由 gatework 维护，与设备厂商无隶属关系。

data/lib/panos/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Panos
+  VERSION = "0.1.0"
+end

data/lib/panos.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "panos/version"
+
+module Panos
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: panos
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- gatework
+bindir: bin
+cert_chain: []
+date: 2026-10-16 00:00:00.000000000 Z
+dependencies: []
+description: Initial Panos gem scaffold with a versioned namespace and error class.
+  Device connections and operations are not implemented yet.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/panos.rb
+- lib/panos/version.rb
+homepage: https://github.com/gatework/panos
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/gatework/panos
+  bug_tracker_uri: https://github.com/gatework/panos/issues
+  changelog_uri: https://github.com/gatework/panos/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/gatework/panos/blob/main/README.md
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Ruby library foundation for Panos device automation
+test_files: []