cisco_n9k 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4a32d46b0b504cc7d465d83e608e74327b6e7678b26d369881043a7dbce1e28a
+  data.tar.gz: 6efd10bc448ac51f52677b910876e3c797705bd020092201c6508fcc0720a5af
+SHA512:
+  metadata.gz: 8666d22139f264dcbd44a5685c79092e5270f8e9d6472f2c6dd533472924be80b4db4d529be668ae91b63db17b5a83658aad73f3797e76980c2f2847e03e574b
+  data.tar.gz: b56e919d544e3248932ce41e0966081f2f7800d907fa3ce356c23fea58203d447402baa4f4bde7f61f622bcadb279a292b19bfda89fc03fbd7365f916639cb29

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,59 @@
+# cisco_n9k
+
+[![CI](https://github.com/gatework/cisco_n9k/actions/workflows/ci.yml/badge.svg)](https://github.com/gatework/cisco_n9k/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/cisco_n9k.svg)](https://rubygems.org/gems/cisco_n9k)
+
+面向 Cisco Nexus 9000 设备自动化的 Ruby gem。目前为初始骨架，提供命名空间、版本常量与基础异常；设备连接、配置解析和命令操作尚未实现。
+
+## 安装
+
+要求 Ruby 3.3 或更高版本。
+
+```sh
+gem install cisco_n9k
+```
+
+或在 Gemfile 中添加：
+
+```ruby
+gem "cisco_n9k", "~> 0.1.0"
+```
+
+## 使用
+
+```ruby
+require "cisco_n9k"
+
+CiscoN9K::VERSION # => "0.1.0"
+CiscoN9K::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/cisco_n9k/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
+```
+
+发布使用 GitHub `release` environment 的 `RUBYGEMS_API_KEY` secret。API key 需要 `push_rubygem` 权限，并允许非交互式发布；不要提交凭据。也可配置 [RubyGems Trusted Publishing](https://guides.rubygems.org/trusted-publishing/)（owner `gatework`、repository `cisco_n9k`、workflow `release.yml`、environment `release`），随后删除该 secret，工作流将使用 OIDC。
+
+失败时优先重新运行失败的 job，以复用原 CI 产物。`workflow_dispatch` 仅接受版本标签，并要求 GitHub Release 已存在。已发布的相同版本只有校验和一致才可继续；不同内容必须提升版本号。
+
+## 许可
+
+MIT，见 [LICENSE](LICENSE)。本项目由 gatework 维护，与设备厂商无隶属关系。

data/lib/cisco_n9k/version.rb

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

data/lib/cisco_n9k.rb

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

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: cisco_n9k
+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 Cisco Nexus 9000 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/cisco_n9k.rb
+- lib/cisco_n9k/version.rb
+homepage: https://github.com/gatework/cisco_n9k
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/gatework/cisco_n9k
+  bug_tracker_uri: https://github.com/gatework/cisco_n9k/issues
+  changelog_uri: https://github.com/gatework/cisco_n9k/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/gatework/cisco_n9k/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 Cisco Nexus 9000 device automation
+test_files: []