Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inhouse-work/cosing
A ruby gem that easily packages up and parses the COSING database
https://github.com/inhouse-work/cosing
cosing ruby skincare
Last synced: about 2 months ago
JSON representation
A ruby gem that easily packages up and parses the COSING database
- Host: GitHub
- URL: https://github.com/inhouse-work/cosing
- Owner: inhouse-work
- License: mit
- Created: 2024-01-03T00:21:13.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-05-14T03:05:44.000Z (8 months ago)
- Last Synced: 2024-09-18T11:46:34.338Z (4 months ago)
- Topics: cosing, ruby, skincare
- Language: Ruby
- Homepage: https://www.inhouse.work
- Size: 4.77 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Cosing
This is a gem to make the COSING database easier to work with.
Created by the team at [inhouse.work](https://www.inhouse.work)
## Installation
Install the gem and add to the application's Gemfile by executing:
$ bundle add cosing
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install cosing
## Usage
```ruby
database = Cosing.load
database.ingredients #=> Hash
database.ingredients.values.sample(2)
database.save("output.json", pretty: true) # Will save the whole database to a json file
```
```json
[
{
"reference_number":"90000",
"inci_name":"ECKLONIA CAVA WATER",
"inn":"",
"ph_eur_name":"",
"cas_numbers":[],
"einecs_numbers":[],
"description":"Ecklonia Cava Water is the aqueous solution of the steam distillates obtained from the whole plant, Ecklonia cava, Lessoniaceae.",
"restrictions":[],
"functions":["SKIN PROTECTING"],
"regulations":[]
},
{
"reference_number":"32549",
"inci_name":"CETEARTRIMONIUM CHLORIDE",
"inn":"",
"ph_eur_name":"",
"cas_numbers":["68002-62-0"],
"einecs_numbers":["268-075-4"],
"description":"Quaternary ammonium compounds, C16-18-alkyltrimethyl, chlorides",
"restrictions":["V/44"],
"functions":[
"ANTISTATIC",
"HAIR CONDITIONING",
"PRESERVATIVE"
],
"regulations":[
{
"annex":"Cosing Annex V",
"cas_numbers":[
"17301-53-0",
"57-09-0",
"112-02-7",
"1119-94-4",
"112-00-5",
"1120-02-1",
"112-03-8"
],
"chemical_name":"",
"cmr":"",
"ec_numbers":[
"241-327-0",
"200-311-3",
"203-928-6",
"214-290-3",
"203-927-0",
"214-294-5",
"203-929-1"
],
"identified_ingredients":[
"BEHENTRIMONIUM CHLORIDE",
"CETEARTRIMONIUM CHLORIDE",
"CETRIMONIUM BROMIDE",
"CETRIMONIUM CHLORIDE",
"COCOTRIMONIUM CHLORIDE",
"HYDROGENATED PALMTRIMONIUM CHLORIDE",
"HYDROGENATED TALLOWTRIMONIUM CHLORIDE",
"LAURTRIMONIUM BROMIDE",
"LAURTRIMONIUM CHLORIDE",
"MYRTRIMONIUM BROMIDE",
"SOYTRIMONIUM CHLORIDE",
"STEARTRIMONIUM BROMIDE",
"STEARTRIMONIUM CHLORIDE",
"TALLOWTRIMONIUM CHLORIDE"
],
"other_regulations":"",
"reference_number":"44",
"regulated_by":"91/184/EEC",
"regulation":"(EU) No 866/2014",
"sccs_opinions":[
{
"code":"0917/05",
"description":"Opinion on Alkyl (C16, C18, C22) trimethylammonium chloride - For other uses than as a preservative"
},
{
"code":"1087/07",
"description":"Opinion on Alkyl (C16, C18, C22) trimethylammonium chloride - For other uses than as a preservative"
},
{
"code":"1246/09",
"description":"Opinion on Alkyl (C16, C18, C22) trimethylammonium chloride - For other uses than as a preservative"
}
],
"inn":"Alkyl (C12 -C22) trimethyl ammonium bromide and chloride",
"maximum_concentration":"0.1%",
"other_restrictions":"",
"product_type":"",
"wording_of_conditions":""
}
]
}
]
```
## Benchmarks
The library is fast to load on an SSD. You can run the benchmarks by running
`bin/benchmark`
```
user system total real
Cosing.load 0.676430 0.011551 0.687981 ( 0.688974)
Cosing::Annex.load 0.065957 0.001479 0.067436 ( 0.067588)
```
The above benchmark was run on an M3 Pro Macbook.
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run
`rake spec` to run the tests. You can also run `bin/console` for an interactive
prompt that will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`. To
release a new version, update the version number in `version.rb`, and then run
`bundle exec rake release`, which will create a git tag for the version, push
git commits and the created tag, and push the `.gem` file to
[rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/inhouse/cosing.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).