{"id":18656618,"url":"https://github.com/zendesk/zendesk_apps_tools","last_synced_at":"2025-05-15T18:08:47.138Z","repository":{"id":5216765,"uuid":"6392706","full_name":"zendesk/zendesk_apps_tools","owner":"zendesk","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-07T05:31:40.000Z","size":1146,"stargazers_count":74,"open_issues_count":45,"forks_count":40,"subscribers_count":439,"default_branch":"master","last_synced_at":"2025-04-11T23:58:24.044Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"saltstack-formulas/vim-formula","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zendesk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2012-10-25T18:57:26.000Z","updated_at":"2024-12-08T13:01:01.000Z","dependencies_parsed_at":"2024-06-18T22:48:44.667Z","dependency_job_id":"9173c6ce-2b64-4195-993a-dc3e6325d9d9","html_url":"https://github.com/zendesk/zendesk_apps_tools","commit_stats":{"total_commits":966,"total_committers":86,"mean_commits":"11.232558139534884","dds":0.8612836438923396,"last_synced_commit":"e01fce5c5745b0a047b0ca02c76ea094c4026f62"},"previous_names":[],"tags_count":195,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zendesk%2Fzendesk_apps_tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zendesk%2Fzendesk_apps_tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zendesk%2Fzendesk_apps_tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zendesk%2Fzendesk_apps_tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zendesk","download_url":"https://codeload.github.com/zendesk/zendesk_apps_tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254394722,"owners_count":22063984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T07:24:21.441Z","updated_at":"2025-05-15T18:08:47.096Z","avatar_url":"https://github.com/zendesk.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IN MAINTENANCE MODE\n\nZendesk Apps Tools is in maintenance mode. This means no additional feature enhancements or non-security bugs will be fixed. **We recommend switching to using [ZCLI](https://github.com/zendesk/zcli) for our best CLI experience.**\n\n\n# Zendesk Apps Tools\n\n## Description\nZendesk Apps Tools (ZAT) are a collection of local development tools that simplify building and deploying [Zendesk apps](https://developer.zendesk.com/apps/docs/apps-v2/getting_started).\n\n## Owners\nThis repo is owned and maintained by the Zendesk Apps team. You can reach us on vegemite@zendesk.com. We are located in Melbourne.\n\n## Install and use ZAT\nZAT is a Ruby gem. You don't need to know Ruby to use the tools but you do need to install Ruby to install the gem.\n\nTo install, run `gem install zendesk_apps_tools`.\n\nTo get the latest version, run `gem update zendesk_apps_tools`.\n\nFor information on using the tools, see  [Zendesk App Tools](https://developer.zendesk.com/apps/docs/developer-guide/zat) on developer.zendesk.com.\n\n## Work on ZAT\nIf you want to help **develop** this tool, clone this repo and run `bundle install`.\n\nIf you receive this error:\n    Installing nokogiri 1.10.10 with native extensions\n    Gem::Ext::BuildError: ERROR: Failed to build gem native extension.\nThen run `gem install nokogiri -- --use-system-libraries` followed by run `bundle config build.nokogiri --use-system-libraries` and try running `bundle install` again.\n\nZAT uses a gem called [ZAS](https://github.com/zendesk/zendesk_apps_support/). If you're developing ZAT, you'll probably want to edit code in ZAS too. To do so, you need to clone the ZAS repo and add the following line at the end of `Gemfile` in the ZAT project:\n\n`gem 'zendesk_apps_support', path: '../zendesk_apps_support'`\n\nThen, comment-out the line referring to `zendesk_apps_support` in this project's `.gemspec` file.\n\n```\n# s.add_runtime_dependency 'zendesk_apps_support', '~\u003e X.YY.ZZ'\n```\n\nThe path should point to your local ZAS directory. In this way, your clone of ZAT will use a local version of ZAS, which is very helpful for development. Run a `bundle install` after changing the Gemfile.\n\n## Deploy ZAT\n\n* To bump ZAT version, run `bump patch|minor|major --no-bundle` from the root directory. **Note:** `--no-bundle` is required in order to prevent `bundle update` command from running, which is by default triggered by the [bump](https://github.com/gregorym/bump) gem and could lead to incompatible dependencies.\n* To publish ZAT to [Rubygems](https://rubygems.org/gems/zendesk_apps_tools), run `bundle exec rake release`.\n\n## Testing\nThis project uses rspec, which you can run with `bundle exec rake`.\n\n## Contribute\nImprovements are always welcome. To contribute:\n\n* Put up a PR into the master branch.\n* CC and get two +1 from @zendesk/vegemite.\n\nThis repo contains the ZAT documentation published on the developer portal at https://developer.zendesk.com. Please cc **@zendesk/documentation** on any PR that adds or updates the documentation.\n\n## Bugs\nYou can report bugs as issues here on GitHub. You can also submit a bug to support@zendesk.com. Mention \"zendesk_apps_tools\" in the ticket so it can be assigned to the right team.\n\n# Copyright and license\nCopyright 2013 Zendesk\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzendesk%2Fzendesk_apps_tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzendesk%2Fzendesk_apps_tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzendesk%2Fzendesk_apps_tools/lists"}