gitlab-fastlane 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 39e26903f5b2b921f37fc29efc74def0ef6f86192c30295322db99363b96398f
+  data.tar.gz: 65c3df9b026d81b14370192128659a1645c98b2ecf6ec5e0007dfde10639205e
+SHA512:
+  metadata.gz: 3e012d8b52275993f61c8747048fe730d55370cf8956e383c147d3b0fe8f4fe75fa019d2978fa7b506799b1af13c150d16f9e83641433357d44d28f47084697e
+  data.tar.gz: 54a0c83df82f4129fd5efcc54b126a25a14e45d6fd453c6aae378cdb5928cbe027619c61dfdd7f20f27d6e04b074328dda57b149617230100c030fdeaa3d78f9

data/.commitlintrc.js

@@ -0,0 +1,10 @@
+module.exports = {
+    extends: ['@commitlint/config-conventional'],
+    rules: {
+      "header-case": [1, 'always', 'sentence-case'],
+      "subject-empty": [2, 'always'],
+      "type-empty": [0, 'always'],
+      "header-max-length": [2, 'always', 50],
+      "body-max-line-length": [2, 'always', 120],
+    },
+};

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/.rubocop.yml

@@ -0,0 +1,22 @@
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 15

data/.ruby-version

@@ -0,0 +1 @@
+3.4.6

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Revision history for gitlab-fastlane
+
+The version numbers below try to follow the conventions at http://semver.org/.
+
+Please add new changes under the **Unreleased** section as list items from the newest on top to the oldest.
+
+## Unreleased
+
+* Add deploy step to CI
+* Add local pipeline execution with gitlab-ci-local
+* Add git status check feature
+* Add commit-linting to CI pipeline
+* Add bundler-audit security check to CI pipeline
+* Add SimpleCov for test coverage reporting
+* Add gem build step to CI pipeline
+* Update CI to use Ruby 3.4.6
+* Configure custom GitLab CI pipeline
+* Create CLI entry point with basic commands
+* Set up RuboCop for linting
+* Set up RSpec for testing
+* Configure gemspec with project metadata and URLs
+* Initialize Ruby gem structure with bundler
+* Update README and HACKING with gem information
+* Add documentation files
+* Update README with project description
+* Add Issue template
+* Add Merge Request template
+* Configure SAST and Secret Detection in `.gitlab-ci.yml`
+* Create project

data/COPYING.md

@@ -0,0 +1 @@
+All rights reserved to Irya Solutions.

data/HACKING.md

@@ -0,0 +1,90 @@
+# HACKING
+
+Here you will find relevant information for developers working in this project.
+
+## Dependencies
+
+This is a Ruby gem. You'll need:
+- Ruby 3.4.6 or higher
+- Bundler
+- gitlab-ci-local (for running CI locally): `npm install -g gitlab-ci-local`
+
+To install dependencies:
+
+```bash
+bundle install
+```
+
+## Development Setup
+
+After checking out the repo, run:
+
+```bash
+bin/setup
+```
+
+This will install dependencies. You can run `bin/console` for an interactive prompt to experiment.
+
+To install this gem locally:
+
+```bash
+bundle exec rake install
+```
+
+## Project Structure
+
+- `lib/gitlab/fastlane.rb` - Main library code
+- `lib/gitlab/fastlane/cli.rb` - CLI command handling
+- `lib/gitlab/fastlane/version.rb` - Version management
+- `exe/` - Executable scripts (CLI entry point)
+- `bin/` - Development helper scripts
+
+## Testing the CLI
+
+After installing locally, you can test the CLI:
+
+```bash
+bundle exec exe/gitlab-fastlane help
+bundle exec exe/gitlab-fastlane version
+```
+
+## Linting
+
+Run RuboCop to check code style:
+
+```bash
+bundle exec rubocop
+```
+
+Auto-fix issues:
+
+```bash
+bundle exec rubocop -a
+```
+
+## Security Audits
+
+Check for vulnerable dependencies:
+
+```bash
+gem install bundler-audit
+bundle audit --update
+```
+
+## Automated tests
+
+Run RSpec tests:
+
+```bash
+bundle exec rspec
+```
+
+Run both linting and tests:
+
+```bash
+bundle exec rake
+```
+
+## Known issues
+
+None so far :)

data/README.md

@@ -0,0 +1,50 @@
+# Gitlab Fastlane
+
+Gitlab Fastlane is a Ruby gem that allows developers to run GitLab CI pipelines locally before opening merge requests. This tool helps ensure that CI checks pass before creating merge requests by running the pipeline locally, checking for uncommitted changes, and tagging commits with validation markers.
+
+## Installation
+
+Install the gem by executing:
+
+```bash
+gem install gitlab-fastlane
+```
+
+Or add it to your Gemfile:
+
+```ruby
+gem 'gitlab-fastlane'
+```
+
+### Prerequisites
+
+This gem requires `gitlab-ci-local` to run pipelines locally. Install it using npm:
+
+```bash
+npm install -g gitlab-ci-local
+```
+
+For alternative installation methods, visit: https://github.com/firecow/gitlab-ci-local
+
+## Usage
+
+```bash
+gitlab-fastlane run
+```
+
+This will:
+1. Check for unstaged/untracked/uncommited files and warn if found
+2. Run your GitLab CI pipeline locally using gitlab-ci-local
+3. Amend the most recent commit with a validation tag
+
+## Technical aspects
+
+* On how to get started developing, check the [HACKING](HACKING.md) file
+* On what are the code standards, check the [CONTRIBUTING](CONTRIBUTING.md) file
+* On how to install, check the [DEPLOYING](DEPLOYING.md) file
+* On how to keep the application up and running, check the [MAINTENANCE](MAINTENANCE.md) file
+* On how to recover from disasters, check the [DISASTER_RECOVERY](DISASTER_RECOVERY.md) file
+
+## License
+
+[Copyright - All rights reserved to Irya Solutions](COPYING.md)

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+task default: %i[rubocop spec]

data/exe/gitlab-fastlane

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "gitlab/fastlane"
+
+Gitlab::Fastlane::CLI.start(ARGV)

data/lib/gitlab/fastlane/cli.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Fastlane
+    # Command-line interface for gitlab-fastlane
+    class CLI
+      def self.start(args)
+        command = args.first || "help"
+
+        case command
+        when "run"
+          run_command
+        when "version", "-v", "--version"
+          version_command
+        when "help", "-h", "--help"
+          show_help
+        else
+          unknown_command(command)
+        end
+      end
+
+      def self.run_command
+        return unless git_status_clean?
+
+        unless gitlab_ci_local_installed?
+          puts "Error: gitlab-ci-local is not installed."
+          puts "Install it with: npm install -g gitlab-ci-local"
+          puts "Or visit: https://github.com/firecow/gitlab-ci-local"
+          return
+        end
+
+        puts "Running GitLab CI locally..."
+        success = system("gitlab-ci-local")
+
+        return if success
+
+        puts "\nPipeline failed. Fix the issues and try again."
+        exit 1
+      end
+
+      def self.gitlab_ci_local_installed?
+        !`which gitlab-ci-local 2>/dev/null`.strip.empty?
+      end
+
+      def self.git_status_clean?
+        status = `git status --porcelain`.strip
+
+        return true if status.empty?
+
+        puts "Warning: You have unstaged/untracked changes:"
+        puts status
+        puts "\nDo you want to continue? (y/N)"
+
+        response = $stdin.gets.chomp.downcase
+        response == "y"
+      end
+
+      def self.version_command
+        puts "gitlab-fastlane #{VERSION}"
+      end
+
+      def self.unknown_command(command)
+        puts "Unknown command: #{command}"
+        show_help
+      end
+
+      def self.show_help
+        puts <<~HELP
+          gitlab-fastlane - Run GitLab CI pipelines locally
+
+          Usage:
+            gitlab-fastlane run              Run CI pipeline locally
+            gitlab-fastlane version          Show version
+            gitlab-fastlane help             Show this help
+
+          Options:
+            -h, --help                       Show this help
+            -v, --version                    Show version
+        HELP
+      end
+    end
+  end
+end

data/lib/gitlab/fastlane/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Fastlane
+    VERSION = "0.1.0"
+  end
+end

data/lib/gitlab/fastlane.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "fastlane/version"
+require_relative "fastlane/cli"
+
+module Gitlab
+  module Fastlane
+    class Error < StandardError; end
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: gitlab-fastlane
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ricardo Lira
+- Rafael Manzo
+- Diego Camarinha
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Gitlab Fastlane allows developers to run GitLab CI pipelines locally,
+  check for uncommitted changes, and tag commits with validation markers to ensure
+  CI passes before creating merge requests.
+email:
+- contato@iryasolutions.com.br
+executables:
+- gitlab-fastlane
+extensions: []
+extra_rdoc_files: []
+files:
+- ".commitlintrc.js"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- COPYING.md
+- DEPLOYING.md
+- DISASTER_RECOVERY.md
+- HACKING.md
+- MAINTENANCE.md
+- README.md
+- Rakefile
+- exe/gitlab-fastlane
+- lib/gitlab/fastlane.rb
+- lib/gitlab/fastlane/cli.rb
+- lib/gitlab/fastlane/version.rb
+homepage: https://git.pragmacode.com.br/irya-solutions-open/gitlab-fastlane
+licenses:
+- LGPL-3.0-or-later
+metadata:
+  source_code_uri: https://git.pragmacode.com.br/irya-solutions-open/gitlab-fastlane
+  changelog_uri: https://git.pragmacode.com.br/irya-solutions-open/gitlab-fastlane/-/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Run GitLab CI pipelines locally before opening merge requests
+test_files: []