{"id":17030626,"url":"https://github.com/vsoch/cookies","last_synced_at":"2026-04-16T19:36:10.148Z","repository":{"id":141667693,"uuid":"92350869","full_name":"vsoch/cookies","owner":"vsoch","description":"the cookies dataset is an example dataset that shows turning a static repository into a JSON API standardized resources for images and text","archived":false,"fork":false,"pushed_at":"2017-05-25T19:15:46.000Z","size":1806,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-24T12:36:04.068Z","etag":null,"topics":["api","dataset","json"],"latest_commit_sha":null,"homepage":"https://vsoch.github.io/cookies/","language":"CSS","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/vsoch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2017-05-25T01:12:42.000Z","updated_at":"2018-12-20T16:33:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"faacfe9d-4615-4836-8fcc-2952ea8603fd","html_url":"https://github.com/vsoch/cookies","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vsoch/cookies","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fcookies","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fcookies/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fcookies/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fcookies/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vsoch","download_url":"https://codeload.github.com/vsoch/cookies/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fcookies/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31901924,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["api","dataset","json"],"created_at":"2024-10-14T08:07:41.860Z","updated_at":"2026-04-16T19:36:10.127Z","avatar_url":"https://github.com/vsoch.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cookies Dataset\n\n[https://expfactory-data.github.io/cookies](https://expfactory-data.github.io/cookies)\n\nThis is an example dataset that is being distributed by using the [JSON API](http://jsonapi.org/) specification. The entire thing is rendered statically using [Jekyll on Github Pages](https://help.github.com/articles/using-jekyll-as-a-static-site-generator-with-github-pages/).\n\n## How do I use this?\nYou can parse the entire dataset programatically by starting at the base [datasets json](/datasets).\n\n## Where is the data?\nThe dataset can be viewed in entity on \u003ca href=\"{{ site.github }}\" target=\"_blank\"\u003eGithub\u003c/a\u003e. \nEach dataset is a separate folder within `_datasets`, and this means that you can add a new dataset by simply adding a folder with the appropriate subfolders and metadata. \n\n\n### Dataset\nA dataset folder includes top level files for metadata, images, and texts, and subfolders with the actual `images` and `texts`. The organization might look like the following:\n\n```\n_datasets\n   cookie-1\n      metadata.txt\n      images.txt\n      texts.txt\n      images\n          image1.txt\n          image1/image1.jpg\n      texts\n          text1.txt\n          text1/text1.csv\n```\n\nIn the above example, we have an entity named \"cookie-1\" with a metadata.txt file that will be rendered at the url `/datasets/cookie-1/metadata` as json, and this metadata file will have an `includes` section that will indicate if we have images and/or text, or neither, and then link to `/datasets/cookie-1/images` and/or `/datasets/cookie-1/texts`. Details about the metadata file, images and text files, are below. For the above, we should note that the folder name `cookie-1` is going to coincide with the `dataset-id`.\n\n### Metadata\n`metadata.txt` should be a text file located at the top level of the subject folder. Note that the `dataset-id` coincides with the folder name for the dataset. THe `metadata.txt` includes the fields specified in [meta.yml](https://www.github.com/expfactory-data/cookies/master/_data/meta.yml), organized according to being required or not. We can look at an example:\n\n```\n---\ntitle: Cookie Tumor 1\ntype: entity\ndataset-id: cookie-1\nhidden: false\n\ndescription: This is a cookie tumor. I am describing the cookie tumor!\n\nlicense: This is a license for this dataset.\n\nattributes:\n  - cookie_type: sugar\n  - cookie_age: 2\n  - cookie_candy: m\u0026ms\n\nincludes:\n  - images\n  - texts\n---\n```\n\nAny features about the dataset should be put in the list of `attributes`. The `includes` section indicates that the entity has subfolders \"images\" and \"texts,\" and an images.txt and texts.txt file to describe the contents.  This file could be very minimumal, and perhaps only have the following:\n\n```\n---\ntype: entity\ndataset-id: cookie-1\n\nincludes:\n  - images\n---\n```\n\n\n### Images and Texts\nEach of the images.txt and texts.txt file in a dataset folder simply need to have a list of the files that you want published, with type \"images\" for images, and \"texts\" for texts:\n\n```\n---\ntype: images\ndataset-id: cookie-1\n\nimages:\n  - image1\n---\n```\n\nAs a reminder, in the example above, we have a folder that looks like this, and we are viewing the images.txt file:\n\n```\n      images.txt\n      images\n          image1.txt\n          image1/image1.jpg\n\n```\n\nWithin the images folder, we should have an image1.txt file for each image that we want to serve, and include with this text file metadata (features or attributes) specified to the image:\n\n```\n---\ntype: image\ndataset-id: image1\n\nfiles:\n  - image1.jpg\n\nattributes:\n  - EXIF SubjectDistance\": 0\n  - EXIF SceneType: 0\n  - Image Resolution: 768/17\n  - EXIF FlashEnergy: 1800\n---\n```\n\nWe also have added a list of files that are expected to be located within a subdirectory named by the image id, followed by the filename. In the example above, `image1.jpg` described in the file `images/image1.txt` would be located in `images/image1/image1.jpeg`.\n\n#### Why do I have to list my files?\nWhile these variables could be sniffied programmatically, it is important that you are able to include a data object in a repository, but turn it's \"published\" status on or off. If an image is not included in the list above, it will not be rendered in the json data structure for the API.\n\n#### Why does each image need it's own text file?\nThe richness for data comes with it's metadata, meaning labels and attributes about the image. Thus, we want to represent this data on the same level as the image.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsoch%2Fcookies","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvsoch%2Fcookies","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsoch%2Fcookies/lists"}