ts_routes

1.0.3last stable release 5 years ago
Complexity Score
Low
Open Issues
N/A
Dependent Projects
0
Weekly Downloadsglobal
592

License

  • Apache-2.0
    • Yesattribution
    • Permissivelinking
    • Permissivedistribution
    • Permissivemodification
    • Yespatent grant
    • Yesprivate use
    • Permissivesublicensing
    • Notrademark grant

Downloads

Readme

TsRoutes for Rails

This gem generates Rails URL helpers in TypeScript, which is synchronized to routes.rb.

This is inspired by js-routes, which invents the great idea to export URL helpers to JavaScript.

Usage

In your lib/tasks/ts_routes.rake:

namespace :ts do
  TS_ROUTES_FILENAME = "javascripts/generated/routes.ts"

  desc "Generate #{TS_ROUTES_FILENAME}"
  task routes: :environment do
    Rails.logger.info("Generating #{TS_ROUTES_FILENAME}")
    source = TsRoutes.generate(
        exclude: [/admin/, /debug/],
    )
    File.write(TS_ROUTES_FILENAME, source)
  end
end

Then, execute rake ts:routes to generate routes.ts in your favorite path.

And you can import it in TypeScript code:

import * as Routes from './generated/routes';

console.log(Routes.entriesPath({ page: 1, per: 20 })); // => /entries?page=1&per=20
console.log(Routes.entryPath(1)); // => /entries/1

// "anchor" is a special keyword to add anchors (as Rails's does)
console.log(Routes.entryPath(1, { anchor: 'foo' })); // => /entries/1#foo

Generated URL helpers are almost compatible with Rails, but they have some restriction:

  • You must pass required parameters to the helpers as non-named (i.e. normal) arguments
    • i.e. Routes.entryPath(1) for /entries/:id
    • Routes.entryPath({ id }) is not allowed
  • Required parameters must not be null nor undefined
    • i.e. Routes.entyPath(null) does not compile
  • You must pass optional parameters as the last argument
    • i.e. Routes.entriesPath({ page: 1, per: 2 })

Options

Here are options for TsRoutes.generate:

namedescriptiondefault routesRails routes to exportRails.application.routes camel_casenaming style; doesn't change if falsetrue route_suffixsuffix for each route"path" includeArray of Regexp patterns to includenil excludeArray of Regexp patterns to excludenil headeradditional parts of generated files"/* tslint:disable */"

Note that TsRoutes.generate(options) is a shortcut of TsRoutes::Generator.new(options).generate.

How to Keep routes.ts Up-To-Date

Use Guard:

# In Guardfile

# Run `rake ts:routes` when routes.rb is updated.
guard :rake, task: 'ts:routes' do
  watch(%r{config/routes\.rb$})
end

Installation

Add this line to your application’s Gemfile:

gem 'ts_routes'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ts_routes

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/bitjourney/ts_routes-rails.

Copyright and Licenses

Copyright 2017 Bit Journey, Inc.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Dependencies

CVE IssuesActive
0
Scorecards Score
No Data
Test Coverage
No Data
Follows Semver
Yes
Github Stars
38
Dependenciestotal
3
DependenciesOutdated
0
DependenciesDeprecated
0
Threat Modelling
No Data
Repo Audits
No Data

Learn how to distribute ts_routes in your own private RubyGems registry

gem install ts_routes
Processing...
Done

13 Releases

RubyGems on Cloudsmith

Getting started with RubyGems on Cloudsmith is fast and easy.