{"id":18271844,"url":"https://github.com/jakimowicz/app_store","last_synced_at":"2025-04-05T02:30:45.939Z","repository":{"id":645632,"uuid":"287792","full_name":"jakimowicz/app_store","owner":"jakimowicz","description":"TODO: one-line summary of your gem","archived":false,"fork":false,"pushed_at":"2011-08-22T19:38:45.000Z","size":271,"stargazers_count":28,"open_issues_count":1,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-22T04:47:10.586Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jakimowicz.png","metadata":{"files":{"readme":"README.rdoc","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}},"created_at":"2009-08-25T16:43:37.000Z","updated_at":"2018-04-24T05:25:47.000Z","dependencies_parsed_at":"2022-08-16T10:35:10.915Z","dependency_job_id":null,"html_url":"https://github.com/jakimowicz/app_store","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakimowicz%2Fapp_store","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakimowicz%2Fapp_store/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakimowicz%2Fapp_store/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakimowicz%2Fapp_store/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jakimowicz","download_url":"https://codeload.github.com/jakimowicz/app_store/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247279282,"owners_count":20912857,"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-05T11:39:32.818Z","updated_at":"2025-04-05T02:30:44.492Z","avatar_url":"https://github.com/jakimowicz.png","language":"Ruby","funding_links":[],"categories":["etc"],"sub_categories":[],"readme":"= AppStore\n\n== DESCRIPTION\nAppStore is an unofficial implementation of the Apple AppStore API.\nIt provides way to search for applications, navigate through categories.\n\n== SYNOPSIS\n=== Examples\n* Simple search\n   @applications = AppStore::Application.search('upnp')\n   @applications.class            # =\u003e Array\n   @applications.length           # =\u003e 8\n   @applications.first.title      # =\u003e \"PlugPlayer\"\n   @applications.first.price      # =\u003e 4.99\n\n* Find an application by id\n   @fontpicker = AppStore::Application.find_by_id(327076783)\n   @fontpicker.class             # =\u003e AppStore::Application\n   @fontpicker.title             # =\u003e \"FontPicker\"\n   @fontpicker.price             # =\u003e 0.0\n   @fontpicker.company.title     # =\u003e \"Etienne Segonzac\"\n\n* Medias\n   @fontpicker.screenshots            # =\u003e [#\u003cAppStore::Image:0x1017683e0 @width=320, @ra ...\n   @fontpicker.screenshots.first.url  # =\u003e \"http://a1.phobos.apple.com/us/r1000/017/Purple/c4/99/6d/mzl.jtoxfers.480x480-75.jpg\"\n   @fontpicker.icon.url               # =\u003e \"http://a1.phobos.apple.com/us/r1000/026/Purple/39/40/54/mzl.yrrhymuu.100x100-75.jpg\"\n\n* User reviews\n   @remote = AppStore::Application.find_by_id(284417350)\n   @remote.title                # =\u003e \"Remote\"\n   @remote.user_reviews.length  # =\u003e 10\n\n   @review = @remote.user_reviews.first\n\n   @review.user_name            # =\u003e \"Ebolavoodoo on Aug 27, 2009\"\n   @review.average_user_rating  # =\u003e 1.0\n   @review.text                 # =\u003e \"Simply amazing. My new favorite app. Instantly responds. Easy to navigate and control. For those who say it doesn't work. Stinks to be you.\"\n\n* Categories\n   # Fetch featured categories\n   @categories = AppStore::Category.featured\n   @categories.class              # =\u003e Array\n   @categories.length             # =\u003e 20\n   \n   # Use category\n   @category = @categories.first\n   @category.title                # =\u003e \"Games\"\n   @category.item_count           # =\u003e 1573\n\n   # Category by id\n   @category = AppStore::Category.find_by_id(6014)\n   @category.title                # =\u003e \"Games\"\n\n   # Iterate through subcategories and applications\n   # This example will display all categories with all applications available in the current AppStore\n   def go_deeper(category)\n     puts \"Category #{category.title}\"\n     category.items.each do |item|\n       if item.is_a?(AppStore::Category)\n         go_deeper item\n       else\n         puts \" =\u003e #{item.title} has id #{item.item_id}\"\n       end\n     end\n   end\n\n   AppStore::Category.featured.each {|category| go_deeper category}\n\n=== List\nEvery list elements returned by the Apple AppStore are limited to 25 elements.\nAn additional element is provided at the end of the list to fetch the next elements.\nAppStore::List provides an abstraction to this list and allows to iterate through each element like a traditional enumerable object.\n\n   list = AppStore::Category.featured.first\n   list = Category.featured.first.items\n   list.count                          # =\u003e 23453\n   list.elements                       # =\u003e [AppStore::Category, AppStore::Category, ...]\n   list.collect {|item| item.item_id}  # =\u003e [9843509, 9028423, 8975435, 987345, ...]\n\n=== Agent\nThere are several Apple AppStore defined by their country. You will have different results (applications, comments) from different store front. You can use AppStore::Agent to ensure you make all yours calls to a specific AppStore (store front).\nYou have a list of available store fronts in the constant StoreFronts defined in AppStore::Client.\n\n   agent = AppStore::Agent.new(:store_front =\u003e :fr)\n   agent.category.featured                           # =\u003e will call Category.featured with store front set to :fr\n   agent.application.find_by_id(42)                  # =\u003e will call Application.find_by_id(42) with store front set to :fr\n   agent.application.find_by_id(42, :bleh =\u003e 'yeah') # =\u003e also accepts extra arguments and merge them with store front\n\n\n== REQUIREMENTS\n\n* mechanize gem\n* plist gem\n\n== INSTALL\n  gem install app_store\n\n== DOCUMENTATION\n\n* http://rdoc.info/projects/jakimowicz/app_store/\n\n\n== TODO\n* use FakeMechanize to unit test each calls\n* handle multiple store/language\n\n== LICENSE\n\n(The MIT License)\n\nCopyright (c) 2009, Fabien Jakimowicz \u003cfabien@jakimowicz.com\u003e\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies\nof the Software, and to permit persons to whom the Software is furnished to do\nso, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakimowicz%2Fapp_store","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakimowicz%2Fapp_store","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakimowicz%2Fapp_store/lists"}