DEV Community: Kerem Bozdas

New Release: turkish_id v1.7.0

Kerem Bozdas — Sun, 10 Nov 2024 15:15:21 +0000

This version of turkish_id adds support for querying the government registry for blue card holders. Read more on RubyDoc: #foreigner_registered?

Turkish ID 🔖

This gem provides methods to validate Turkish Identification Numbers.

Installation

Add this line to your application's Gemfile:

gem 'turkish_id'

And then execute:

$ bundle

Or install it yourself as:

$ gem install turkish_id

Usage

Validating ID Numbers

Create a new instance:

identity_number = TurkishId.new(10000000146)

Use valid? method to check validity:

identity_number.valid?  #=> true

Querying the Government Registry

Create a new instance:

identity_number = TurkishId.new(10000000146)

Use registered? method to query the government registry:

identity_number.registered?("Ahmet", "Yılmaz", 1987)  #=> false

There is also a convenience method called not_in_registry? which is the logical equivalent of !registered?.

Use foreigner_registered? method to query the foreigner registry:

identity_number.foreigner_registered?("Yukihiro", "Matsumoto", 14, 4, 1965)  #=> false

There is also a convenience method called foreigner_not_in_registry? which is the logical equivalent of !foreigner_registered?.

Generating Relatives

You can generate ID numbers for your younger or elder relatives.

me = TurkishId.new(10000000146)

Calling younger_relative or elder_relative will return an Enumerable class.

me.elder_relative  #=> #<Enumerator:0x00007f9e629032d0>

You can perform standard Enumerable operations on it.

me.elder_relative.first  #=> 10003000082

3.times do
 puts me.elder_relative.next
end

#=> 10035998982
#=> 10005999902
#=> 10008999848

me.elder_relative.take(5)  #=> [10003000082, 10005999902, 10008999848, 10011999774, 10014999610]

And so on.

CLI (Command Line Interface)

You can use the CLI for quick lookups:

$ turkish_id 10000000078  #=> true

The executable terminates with a proper exit status:

$ turkish_id 10000000078  #=> true
$ echo $?                 #=> 0
$ turkish_id 10000000079  #=> false
$ echo $?                 #=> 1

Run turkish_id --help to learn more:

Usage
  turkish_id ID_NUMBER [GIVEN_NAME SURNAME YEAR_OF_BIRTH]

Description
  turkish_id validates Turkish identity numbers.
  Only providing ID_NUMBER performs numerical validation (offline).
  Providing all arguments will query government registry (online).

Examples
  turkish_id 10000000078
  turkish_id 10000000146 Ahmet Yılmaz 1984
  turkish_id 10005999902 "Ayşe Nur" Yılmaz 1996

Anatomy of the Turkish ID Number

The Turkish Identification Number consists of 11 digits.

There are three conditions for a valid identification number:

d1 > 0
d10 == ((d1 + d3 + d5 + d7 + d9) * 7 - (d2 + d4 + d6 + d8)) mod 10
d11 == (d1 + d2 + d3 + d4 + d5 + d6 + d8 + d9 + d10) mod 10

Where dn refers to the n-th digit of the identification number.

Remember that a valid identification number does not imply the existence of an ID. It could only be used as a preliminary check e.g. before querying a government website. This is very similar to credit card validation.

Support

Ruby Versions Tested Against

This gem is used in production and tested against the following Ruby versions:

✅ 3.3.5 (stable)
✅ 3.2.6 (stable)
⏳ 3.1.6 (security maintenance)
🪦 3.0.7 (end of life)

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec 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

Fork the repository
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Donations ❤️

You can donate me at Liberapay. Thanks! ☕️

Is it any good?

Yes.

Since you made it this far.. 🤓

Don't forget to ⭐️ my repository if you like it!

Bug reports and pull requests are welcome! ♥️

Happy Hacking,
Kerem

Photo Courtesy of Umit Okan

New Release: viabtc v0.4.0

Kerem Bozdas — Thu, 14 Feb 2019 18:15:45 +0000

ViaBTC 📈

An HTTP client to interface with the open-source ViaBTC Exchange Server.

Interested in creating a cryptocurrency exchange? This gem can help you.

Installation

Add viabtc to your Gemfile and run bundle OR install it yourself with gem install viabtc.

Configuration

If using Rails, create a file named viabtc.rb under config/initializers and add the following block of code.

ViaBTC.configure do |config|
  config.http_base_url = 'http://localhost:18080'
end

If not, add it anywhere in your code that runs before a new client is initialized. Read more at: 📖Configuration Wiki

Usage

Create a new instance:

viabtc_http_client = ViaBTC::HTTP::Client.new

Make an API request:

viabtc_http_client.market_status(market: 'ETHBTC')

#=> {"error"=>nil, "result"=>{"low"=>"0", "period"=>86400, "last"=>"0", "high"=>"0", "open"=>"0", "volume"=>"0", "close"=>"0", "deal"=>"0"}, "id"=>0}

Support

Ruby Versions Tested Against

✅ 2.6.1 (stable)
✅ 2.5.3 (stable)
✅ 2.4.5 (stable)
⏳ 2.3.8 (security maintenance phase)

ViaBTC Exchange Server API Support

API Method	Corresponding Methods
`balance.query`	`#balance`
`balance.update`	`#withdraw` `#deposit`
`balance.history`	`#balance_history`
`asset.list`	`#asset_list`
`asset.summary`	`#asset_summary`
`order.put_limit`	`#limit_sell` `#limit_buy`
`order.put_market`	`#market_sell` `#market_buy`
`order.cancel`	`#cancel_order`
`order.deals`	`#order_deals`
`order.book`	`#sell_orders` `#buy_orders`
`order.depth`	`#order_depth`
`order.pending`	`#pending_orders`
`order.pending_detail`	`#pending_order_details`
`order.finished`	`#finished_orders` `#finished_sell_orders` `#finished_buy_orders`
`order.finished_detail`	`#finished_order_detail`
`market.last`	`#market_last`
`market.deals`	`#market_deals`
`market.user_deals`	`#user_executed_orders`
`market.kline`	`#market_kline`
`market.status`	`#market_status`
`market.status_today`	`#market_status_today`
`market.list`	`#market_list`
`market.summary`	`#market_summary`

Development

Contributing

Fork the repository
Switch to develop branch (git checkout develop)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Donations ❤️

You can donate me at Librepay. Thanks! ☕️

Is it any good?

Yes.

Since you made it this far.. 🤓

Don't forget to ⭐️ my repository if you like it!

Bug reports and pull requests are welcome! ♥️

Happy Hacking,
Kerem

Photo Courtesy of Chris Liverani

New Release: Tate v1.0.0

Kerem Bozdas — Thu, 27 Sep 2018 15:19:36 +0000

💎 Just released a major update for tate! (v1.0.0) 💎

Release highlights:
👉 Custom filter support
👉 Support for 11 new languages
👉 Improved command line tool

🔗 Check it out!

Tate ✍️

Tate converts accented characters and transliterates non-latin scripts to their closest ASCII equivalent.

Tate is a productivity tool, it behaves like a standard Unix application and can be chained with other Unix commands. It reads from standard input and writes to standard output. You can use it either as a commandline utility or a library.

Examples

Let's say you have a French sentence with a lot of weird characters and you want to convert it into ASCII in the most representative way. You can use:

echo 'Le cœur de la crémiére' | tate  #=> Le coeur de la cremiere

Or some Bulgarian text you can't read:

echo 'Здравей!' | tate --lang=bg  #=> Zdravey!

Set language using lang option for custom filters, e.g. German:

echo 'Von großen Blöcken haut man große Stücke.' | tate --lang=de

Letters ö, ü and ß will be transliterated based on German transliteration rules:

Von grossen Bloecken haut man grosse Stuecke.

Language specific punctuation will be converted to closest ASCII equivalent.

For example, in Catalan, notice how the quotes (cometes franceses) and the interpunct (punt volat) are transliterated:

«Dóna amor que seràs feliç!». Això, il·lús company geniüt, ja és un lluït rètol blavís d’onze kWh.
"Dona amor que seras felic!". Aixo, il-lus company geniut, ja es un lluit retol blavis d'onze kWh.

Installation

Add this line to your application's Gemfile:

gem 'tate'

And then execute:

$ bundle

Or install it yourself as:

$ gem install tate

Usage

Ruby Library

require 'tate'
Tate::transliterate('Zəfər', language='az')  #=> Zefer

Commandline Utility

Usage: tate [options]
-l, --lang=[LANGUAGE]            Set language for custom filters
-h, --help                       Show this message
-v, --version                    Show version

Interactive Mode

If you call tate without providing any arguments, it will expect you to provide input using standard input (keyboard). After you are done typing you can use cmd + D to trigger EOL (End of Line) and the result will printed in the next line.

Standard Streams

You can pipe the output of another command into tate.

curl gov.bg/bg | tate --lang=bg > index.html

Language Support

There are custom filters for:

Azeri, Bulgarian, Catalan, French, German, Hungarian, Polish, Romanian, Spanish, and Vietnamese.

The following languages are known to work (w/o custom filters):

Croatian, Czech, Danish, Esperanto, Estonian, Finnish, Icelandic, Latvian, Lithuania, Norwegian, Portuguese, Scottish, Slovak, Slovenian, Swedish, Turkish, and Welsh.

What's next?

Russian, Irish, Arabic, and Yoruba.

Is it any good?

Yes.

Donations

You can donate me at Librepay. Thanks! ☕️

Trivia

tate is short for t ransliter ate.

Nobody has time to type transliterate in the terminal. 🤷‍♂️

Since you made it this far.. 🤓

Don't forget to ⭐️ my repository if you like it!

Bug reports and pull requests are welcome! ♥️

Happy Hacking,
Kerem