Popularity
1.2
Declining
Activity
6.3
Declining
2
1
0

Programming language: Crystal
Tags: Third-party APIs    
Latest version: v0.2.0

ynab.cr alternatives and similar shards

Based on the "Third-party APIs" category

Do you think we are missing an alternative of ynab.cr or a related project?

Add another 'Third-party APIs' Shard

README

ynab

Build Status GitHub license GitHub release

This is an API client for YNAB. It has most of the basic operations for fetching your data from YNAB. See the issues for this project for missing functionality. The primary functionality that still needs implementation is Delta Requests.

Installation

Add this to your application's shard.yml:

dependencies:
  ynab:
    github: jaredsmithse/ynab

Usage

The YNAB API has two base objects, Budget and User. User has no other nested resources, while every other resource is nested under Budget. If you have a budget_id you can initialize the resource you want directly. All available resources are in the ./src/api/ folder.

Examples

Configuration

Instructions for obtaining your own API token can be found on the YNAB website here.

require "ynab"

YNAB::Client.configure do |settings|
  settings.access_token = ynab_api_token
  settings.base_url = "https://api.youneedabudget.com/v1/"
end
client = YNAB::Client

Getting All Budgets For An Account

client = YNAB::Client
budgets = client.budgets.get_all.each do |budget|
  puts budget.name
end

Working With Resources For A Budget

client = YNAB::Client
# Get a list of accounts with a pre-fetched budget_id
budgets = client.budgets.get_all

# you can alternatively do budgets.first.accounts.get_all
accounts = client.accounts(budgets.first.id).get_all
accounts.each { |account| "#{account.name}: $#{account.balance / 100}" }

# Find how many times you use Lyft every month
transactions = budgets.first.transactions.get_all
transactions.
  select { |txn| txn.payee_name == "Lyft" }.
  group_by { |txn| "#{txn.date.year}-#{txn.date.month}" }.
  transform_values(&.size)

Development

For development, you will need a personal access token from YNAB. You can find instructions on how to get one for your account here.

Contributing

  1. Fork it (https://github.com/your-github-user/ynab/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors


*Note that all licence references and agreements mentioned in the ynab.cr README section above are relevant to that project's source code only.