{"id":2202,"url":"https://github.com/Howardw3/HamsterUIKit","last_synced_at":"2025-08-02T23:32:13.707Z","repository":{"id":56914361,"uuid":"89179420","full_name":"Howardw3/HamsterUIKit","owner":"Howardw3","description":"A simple and elegant UIKit for iOS.","archived":false,"fork":false,"pushed_at":"2020-04-08T02:40:24.000Z","size":2932,"stargazers_count":30,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-24T02:02:58.623Z","etag":null,"topics":["barchart","chart","chart-demo","curve","ios-ui","ios10","protocol","swift","swift-3","swift-library","swift4","uikit"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Howardw3.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}},"created_at":"2017-04-23T23:34:02.000Z","updated_at":"2024-09-09T07:54:49.000Z","dependencies_parsed_at":"2022-08-21T03:50:27.282Z","dependency_job_id":null,"html_url":"https://github.com/Howardw3/HamsterUIKit","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Howardw3%2FHamsterUIKit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Howardw3%2FHamsterUIKit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Howardw3%2FHamsterUIKit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Howardw3%2FHamsterUIKit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Howardw3","download_url":"https://codeload.github.com/Howardw3/HamsterUIKit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228503142,"owners_count":17930520,"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":["barchart","chart","chart-demo","curve","ios-ui","ios10","protocol","swift","swift-3","swift-library","swift4","uikit"],"created_at":"2024-01-05T20:16:07.462Z","updated_at":"2024-12-06T17:30:49.308Z","avatar_url":"https://github.com/Howardw3.png","language":"Swift","funding_links":[],"categories":["UI"],"sub_categories":["Other free courses","Font","Other Testing"],"readme":"# HamsterUIKit\nA simple and elegant UIKit(Chart) for iOS, written in Swift.\n\n[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n[![Platform](https://cocoapod-badges.herokuapp.com/p/HamsterUIKit/badge.png)](https://cocoapods.org/pods/HamsterUIKit)\n[![Build Status](https://travis-ci.org/Howardw3/HamsterUIKit.svg?branch=master)](https://travis-ci.org/Howardw3/HamsterUIKit)\n\n:bar_chart: Curve and bar Charts.   \n:bulb: Protocols are designed based on UIKit(UITableView).  \n:keycap_ten: Draw a complex but elegant graph in 10 minutes.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"Img/CurveChart.gif\" width=\"300\" height=\"160\"  style=\"margin-right: 10px;margin-bottom: 10px;\"\u003e\u003cimg src=\"Img/SimpleBarChart.gif\" width=\"300\" style=\"margin-left: 10px;margin-bottom: 10px;\"\u003e\u003cimg src=\"Img/GroupedBarChart.png\" width=\"300\" style=\"margin-right: 10px;margin-top: 10px;\"\u003e\u003cimg src=\"Img/StackedBarChart.png\" width=\"300\" style=\"margin-left: 10px;margin-top: 10px;\"\u003e\n\n\u003c/p\u003e\n\n## Protocols\n### Initialize and reload\n| UITableView     | HamsCurveChart | HamsBarChart |\n| :---            |     :---:      |          :---: |\n| init(frame: CGRect)   | same     | same    |\n| init?(coder aDecoder: NSCoder)   | same     | same    |\n| reloadData   | same     | same    |\n\n### DataSource\n| UITableView     | HamsCurveChart    | HamsBarChart      |\n| ---            | ---            | ---            |\n| numberOfSections(in tableView: UITableView) -\u003e Int   | numberOfCharts(in curveChart: HamsCurveChart) -\u003e Int | numberOfCharts(in barChart: HamsBarChart) -\u003e Int|\n| tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -\u003e UITableViewCell | curveChart(_ curveChart: HamsCurveChart, pointForChart indexPath: HamsIndexPath) -\u003e HamsCurveChartPoint | barChart(_ barChart: HamsBarChart, barForChart indexPath: HamsIndexPath) -\u003e HamsBarChartRect |\n| tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -\u003e Int | curveChart(_ curveChart: HamsCurveChart, numberOfValuesInChart chart: Int) -\u003e Int | barChart(_ barChart: HamsBarChart, numberOfValuesInChart chart: Int) -\u003e Int|\n\n### Delegate\n|HamsCurveChart | HamsBarChart |\n|     :---      |          :--- |\n| curveChart(_ curveChart: HamsCurveChart, configureForCharts chart: Int)     | barChart(_ barChart: HamsBarChart, configureForCharts chart: Int)    |\n\n\n## Installation\n### Carthage\n```\ngithub \"Howardw3/HamsterUIKit\"\n```\n\n### CocoaPods\n1. Add to your Podfile:\n``` \nuse_frameworks!\npod 'HamsterUIKit'\n```\n2. Type in terminal:\n```\npod install\n```\n3. Import the framework\n```\nimport HamsterUIKit\n```\n\n### Manually \n\n``` sh\ngit clone https://github.com/Haneke/HanekeSwift.git\n```\n0. Copy and paste the above command in your terminal, it will clone the repo into your disk.\n1. Drag `HamsterUIKit.xcodeproj` to your project in the _Project Navigator_.\n2. Select your project and then your app target. Open the _Build Phases_ panel.\n3. Expand the _Target Dependencies_ group, and add `HamsterUIKit.framework`.\n4. Click on the `+` button at the top left of the panel and select _New Copy Files Phase_. Set _Destination_ to _Frameworks_, and add `HamsterUIKit.framework`.\n5. `import HamsterUIKit` whenever you want to use Haneke.\n\n\n## Demo\n[Bar Chart Demo](https://github.com/ChromieIsDangerous/HamsterUIKit/blob/master/HamsterUIKitExample/BarChartViewController.swift)\n\n[Curve Chart Demo](https://github.com/ChromieIsDangerous/HamsterUIKit/blob/master/HamsterUIKitExample/HamsCurveChartController.swift)\n\n## Advanced Configuration\n### Bar Chart\n\n\n## Bar Chart Quick start\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"Img/QuickStart.png\"  height=\"200\"  style=\"margin-right: 10px;margin-bottom: 10px;\"\u003e\u003c/p\u003e\n\n```swift\nimport UIKit\nimport HamsterUIKit\n\nclass HelloBarChartViewController: UIViewController, HamsBarChartDelegate, HamsBarChartDataSource {\n\tvar barChart:HamsBarChart = HamsBarChart()\n\tvar dataSets = [CGFloat]()\n    override func viewDidLoad() {\n        super.viewDidLoad()\n\t\tbarChart = HamsBarChart(frame: CGRect(x: 0, y: 0, width: view.frame.width, height: 300))\n\n\t\tbarChart.delegate = self\n\t\tbarChart.dataSource = self\n\t\tview.addSubview(barChart)\n    }\n\n\tfunc barChart(_ barChart: HamsBarChart, numberOfValuesInChart chart: Int) -\u003e Int {\n\t\treturn dataSets.count\n\t}\n\n\tfunc numberOfCharts(in barChart: HamsBarChart) -\u003e Int {\n\t\treturn 1\n\t}\n\n\tfunc barChart(_ barChart: HamsBarChart, barForChart indexPath: HamsIndexPath) -\u003e HamsBarChartRect {\n\t\tlet rect = HamsBarChartRect()\n\t\trect.value = .plain(dataSets[indexPath.column])\n\t\trect.color = .plain(.white)\n\t\treturn rect\n\t}\n\n\toverride func viewWillAppear(_ animated: Bool) {\n\t\tsuper.viewWillAppear(animated)\n\t\tdataSets = [1,4,6,1]\n\t\tbarChart.reloadData()\n\t}\n\n\tfunc barChart(_ barChart: HamsBarChart, configureForCharts view: Int) {\n\n\t\tbarChart.title = \"BarChart(plain)\"\n\t}\n    override func didReceiveMemoryWarning() {\n        super.didReceiveMemoryWarning()\n    }\n}\n```\n\n## Todo\nAdvanced Configuration\n\n## Created By:\nHoward Wang - [Hire me](https://www.linkedin.com/in/jiongzhi-wang-a32483132/)\n\n[Zhiye Jin](http://www.zhiye-jin.com)(UI Designer)\n\nHealthy Fridge Project - [Hamster Fridge Management](https://itunes.apple.com/us/app/hamster-fridge-management/id1227220933?mt=8)\n\n## License\nHamsterUIKit is Copyright (c) 2017 Howard Wang and released as open source under the attached [Apache 2.0 license](https://github.com/ChromieIsDangerous/HamsterUIKit/blob/master/LICENSE).\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHowardw3%2FHamsterUIKit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHowardw3%2FHamsterUIKit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHowardw3%2FHamsterUIKit/lists"}