https://github.com/postmodern/rubygems-tasks

Simple Rake tasks for managing and releasing Ruby projects.
https://github.com/postmodern/rubygems-tasks

Last synced: 8 days ago
JSON representation

Simple Rake tasks for managing and releasing Ruby projects.

• Host: GitHub
• URL: https://github.com/postmodern/rubygems-tasks
• Owner: postmodern
• License: mit
• Created: 2011-09-03T02:39:34.000Z (about 13 years ago)
• Default Branch: main
• Last Pushed: 2023-09-07T23:08:44.000Z (about 1 year ago)
• Last Synced: 2024-10-12T19:45:02.652Z (22 days ago)
• Language: Ruby
• Homepage:
• Size: 207 KB
• Stars: 78
• Watchers: 6
• Forks: 5
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-ruby-toolbox - rubygems-tasks - Agnostic and unobtrusive Rake tasks for managing and releasing Ruby Gems. (Developer Tools / Gem Creation)

README

        
# rubygems-tasks

[![CI](https://github.com/postmodern/rubygems-tasks/actions/workflows/ruby.yml/badge.svg)](https://github.com/postmodern/rubygems-tasks/actions/workflows/ruby.yml)

[![Code Climate](https://codeclimate.com/github/postmodern/rubygems-tasks.svg)](https://codeclimate.com/github/postmodern/rubygems-tasks)

* [Source](https://github.com/postmodern/rubygems-tasks)

* [Issues](https://github.com/postmodern/rubygems-tasks/issues)

* [Email](mailto:postmodern.mod3 at gmail.com)

## Description

rubygems-tasks provides agnostic and unobtrusive Rake tasks for building,

installing and releasing Ruby Gems.

    require 'rubygems/tasks'

    Gem::Tasks.new

## Philosophy

The Rake tasks which you use to manage a Ruby project should not be coupled

to the project generator which you used to create the project.

Project generators have nothing to do with the Rake tasks used to build,

install and release a Ruby project.

Recently, many Ruby Developers began creating Ruby projects by hand,

building/releasing RubyGems using `gem build` / `gem push`. Sometimes this

resulted in RubyGems being released with uncommitted changes, or the developer

forgetting to tag the release. Ruby Developers should have access to

**agnostic** and **unobtrusive** Rake tasks, to **automate** the release

process.

This is what rubygems-tasks seeks to provide.

## Features

* Provides tasks to build, install and push gems to [rubygems.org].

  * Loads all project metadata from the `.gemspec` file.

  * Supports loading multiple `.gemspec` files.

  * Supports pushing gems to alternate [gem server]s.

* Supports optionally building `.tar.gz` and `.zip` archives.

  * `build:tar`

  * `build:zip`

* Supports [Git], [Mercurial] and [SubVersion] Source-Code-Managers

  (SCMs).

  * Supports creating PGP signed Git/Mercurial tags.

* Provides optional `sign` tasks for package integrity:

  * `sign:checksum`

  * `sign:pgp`

* Provides a `console` task, for jumping right into your code.

* Defines task aliases for users coming from [Jeweler] or [Hoe].

* ANSI coloured messages!

## Anti-Features

* **Does not** parse project metadata from the README or the ChangeLog.

* **Does not** generate or modify code.

* **Does not** automatically commit changes.

* **Does not** inject dependencies into gems.

* **Zero** dependencies.

## Requirements

* [ruby] >= 2.0.0

* [rake]

## Install

    $ gem install rubygems-tasks

## Examples

Specifying an alternate Ruby Console to run:

    Gem::Tasks.new do |tasks|

      tasks.console.command = 'pry'

    end

Enable pushing gems to an in-house [gem server]:

    Gem::Tasks.new do |tasks|

      tasks.push.host = 'gems.company.com'

    end

Disable the `push` task:

    Gem::Tasks.new(push: false)

Enable building `.tar.gz` and `.zip` archives:

    Gem::Tasks.new(build: {tar: true, zip: true})

Enable Checksums and PGP signatures for built packages:

    Gem::Tasks.new(sign: {checksum: true, pgp: true})

Selectively defining tasks:

    Gem::Tasks::Build::Tar.new

    Gem::Tasks::SCM::Status.new

    Gem::Tasks::SCM::Tag.new(format: 'REL-%s')

    Gem::Tasks::Sign::Checksum.new

    Gem::Tasks::Console.new

## Synopsis

    rake build    # Builds all packages

    rake console  # Spawns an Interactive Ruby Console

    rake install  # Installs all built gem packages

    rake release  # Performs a release

## Copyright

Copyright (c) 2011-2020 Hal Brodigan

See {file:LICENSE.txt} for details.

[Git]: http://git-scm.com/

[Mercurial]: http://mercurial.selenic.com/

[SubVersion]: http://subversion.tigris.org/

[Jeweler]: https://github.com/technicalpickles/jeweler#readme

[Hoe]: https://github.com/seattlerb/hoe#readme

[rubygems.org]: https://rubygems.org/

[gem server]: https://github.com/rubygems/rubygems.org#readme

[ruby]: https://www.ruby-lang.org/

[rake]: https://rubygems.org/gems/rake