Your next favourite Ruby gem for interacting with Mangadex.org

Set of fully typed utility classes and interfaces integrated with Sorbet.

# mdtoc - Markdown Table of Contents Read Markdown files and output a table of contents. ## Installation Requirements: * [Ruby](https://www.ruby-lang.org/en/) (see [.ruby-version](./.ruby-version)) ```bash gem install mdtoc ``` ## Usage ```bash $ mdtoc --help Usage: mdtoc [options] files or directories... -h, --help Show this message -o, --output PATH Update a table of contents in the file at PATH -a, --[no-]append Append to the --output file if a <!-- mdtoc --> tag isn't found -c, --[no-]create Create the --output file if it does not exist ``` 1. Add a `<!-- mdtoc -->` tag to a Markdown file. ```bash echo '<!-- mdtoc -->' >> README.md ``` 2. Run `mdtoc` and specify input files or directories (eg. the "test/samples" directory) and an output file (eg. "README.md"). ```bash mdtoc -aco README.md test/samples ``` ## Example Rakefile Create a `Rakefile` with the contents below, then run [`rake`](https://github.com/ruby/rake) to: * `git pull` * `git add` any *.md files * Run `mdtoc` to update the generated table of contents in the ./README.md file * Git commit and push any changes ```ruby task default: %w[mdtoc] desc 'Update Markdown table of contents and push changes to the git repository' task :mdtoc do command = <<~CMD set -e if [ -n "$(git diff --name-only --diff-filter=U)" ]; then echo 'Error: conflicts exist' >&2 exit 1 fi mdtoc --append --create --output README.md docs/ git add *.md **/*.md git commit -qm 'Update TOC' || true git pull git push CMD sh command, verbose: false do |ok, status| unless ok fail "Failed with status: #{status.exitstatus}" end end end ``` See [andornaut/til](https://github.com/andornaut/til/blob/master/Rakefile) for an example. ## Development ### Setup Requirements: * [Bundler](https://bundler.io/) ```bash # Install dependencies bundle ``` ### Tasks ```bash # List rake tasks $ rake -T rake build # Build mdtoc-0.1.5.gem into the pkg directory rake default # Run the build, rubocop:autocorrect_all, sorbet and test tasks rake install # Build and install mdtoc-0.1.5.gem into system gems rake install:local # Build and install mdtoc-0.1.5.gem into system gems without network access rake release[remote] # Create tag v0.1.5 and build and push mdtoc-0.1.5.gem to rubygems.org rake rubocop # Run RuboCop rake rubocop:autocorrect # Autocorrect RuboCop offenses (only when it's safe) rake rubocop:autocorrect_all # Autocorrect RuboCop offenses (safe and unsafe) rake sorbet # Run the Sorbet type checker rake test # Run tests # Run mdtoc with test inputs $ ruby -Ilib bin/mdtoc test/samples # Run mdtoc with test inputs, and write to a newly created output file $ f=$(mktemp) && ruby -Ilib bin/mdtoc -aco ${f} test/samples ; cat ${f} ```

A Rails view helper that provides custom rendering functionality

Ruby Client SDK Generated by Speakeasy

Inspired by Haskell's NonEmpty list

ONLYOFFICE Docs Integration Ruby SDK provides common interfaces and default implementations for integrating ONLYOFFICE Document Server into your own website or application on Ruby.

CLI to run commands for AWS OpsWorks

Simplifies getting the right configuration options for a process using pre-loaded configurations from files to manage options for experiments or flights.

Helps convert hashes to immutable objects.

Ruby implementation of [`best-effort-json-parser`](https://github.com/beenotung/best-effort-json-parser) to parse potentially incomplete JSON in a best effort manner.

Package protections for Rails apps

Fill this out!

Ruby Client SDK Generated by Speakeasy

Paperback is a library for creating printable paper backups of small amounts of sensitive data like cryptographic keys.

Automatically renew your parking ticket when it expires.

Export from Pinboard to Logseq

I was looking to create a turn-based sports game which, inevitably, would include a playoffs simulator. This library provides a few, easy-to-use APIs to create, simulate, and complete a team & series-based tournament with one clear winner.

Ruby Client SDK Generated by Speakeasy

The most reusable components from several domain-focused libraries will be extracted here as a common consumption point.