{"id":23473582,"url":"https://github.com/tmorrell/cheminv","last_synced_at":"2025-04-14T19:04:14.225Z","repository":{"id":31355631,"uuid":"34918464","full_name":"tmorrell/cheminv","owner":"tmorrell","description":"Web-Based Chemical Inventory System","archived":false,"fork":false,"pushed_at":"2018-08-16T22:26:26.000Z","size":1359,"stargazers_count":8,"open_issues_count":2,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T07:22:53.376Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmorrell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-01T18:55:11.000Z","updated_at":"2024-07-17T13:33:57.000Z","dependencies_parsed_at":"2022-09-08T09:11:02.549Z","dependency_job_id":null,"html_url":"https://github.com/tmorrell/cheminv","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmorrell%2Fcheminv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmorrell%2Fcheminv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmorrell%2Fcheminv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmorrell%2Fcheminv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmorrell","download_url":"https://codeload.github.com/tmorrell/cheminv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248943458,"owners_count":21186958,"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-12-24T17:29:36.130Z","updated_at":"2025-04-14T19:04:14.191Z","avatar_url":"https://github.com/tmorrell.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"README\n====\n\n## What is cheminv\n\nCheminv is a web-based chemical inventory system.  This responsive database provides an accessable way to organize and order chemicals, and is provided as an open-source package for all non-commercial users.\n\nCheminv organizes chemicals by their location in a lab. Locations are included in a MySQL database, and the home page provides the ability to sort chemicals by location. You can also search the database by terms such as chemical name or CAS number. The home page provides links to add new chemicals to the database, a shopping list that contains chemicals that have been requested, and a project based listing of chemicals that are in use. You can also export the entire database as a csv file, and view chemicals that have been used in the past (Archived Chemicals).\n\n![Overall](img/about/Overview.png)\n\nEach chemical has a page with pertinent information, such as the quantity, manufacturer, CAS number, amount, dates, bar codes, and much more. On the item page users can also indicate that more of a chemical is required, which automatically adds the chemical to a list to be ordered.\n\n![Detail](img/about/chemical.png)\n\nThe page for adding new chemicals includes fields for all the options above.\n\n![Add](img/about/add_chemical.png)\n\n## Who and Why\n\nCheminv was created by Thomas Morrell for the Haw Yang Lab at Princeton University\n\nCheminv is based on ecDB [www.ecDB.net](http://www.ecdb.net), which was created by [Nils Fredriksson](http://nilsf.se) aka. ElectricMan and designed by [Buildlog](http://buildlog.se). \n\n### Requirements\n\n-  Web Server.\n-  PHP Version 5.2.4 or above.\n-  MySQL Version 5.0 - 5.6 (not tested on other versions).\n\n## Installation\n\n- Download the latest stable release from the [download page](https://github.com/tmorrell/cheminv/downloads).\n- Create a MySQL database. (mysql -p -e create database cheminv)\n- Import `cheminv.sql` database structure to your MySQL-database. (mysql -p cheminv \u003c cheminv.sql)\n- Make sure you can access the database (mysql -p grant alter,create,delete,drop,insert,update,select,index ON cheminv.* TO 'cheminvuser'@'localhost' IDENTIFIED BY 'password';) \n- Insert your MySQL data in the configuration files, `include/mysql_connect.php` and 'include/login/config.php'.\n- **You are now set to go!** The default username and password should automatically be entered.\n\n- You'll want to edit locations to match your lab setup.  The easiest way in to\n  install mysql-workbench and edit table data.  Select cheminv and the\ncategory_head or category_sub tables\n\n## Contributing\n\ncheminv is a community driven project and accepts contributions of code\nand documentation from the community. These contributions are made in the form\nof Issues or [Pull Requests](http://help.github.com/send-pull-requests/) on\nthe [cheminv repository](https://github.com/tmorrell/cheminv) on GitHub.\n\nIssues are a quick way to point out a bug. If you find a bug or documentation\nerror in cheminv then please check a few things first:\n\n- There is not already an open Issue\n- The issue has already been fixed (check the develop branch, or look for\n  closed Issues)\n- Is it something really obvious that you fix it yourself?\n\nReporting issues is helpful but an even better approach is to send a Pull\nRequest, which is done by \"Forking\" the main repository and committing to your\nown copy. This will require you to use the version control system called Git.\n\nOne thing at a time: A pull request should only contain one change. That does\nnot mean only one commit, but one change - however many commits it took. The\nreason for this is that if you change X and Y but send a pull request for both\nat the same time, we might really want X but disagree with Y, meaning we\ncannot merge the request. Using the Git-Flow branching model you can create\nnew branches for both of these features and send two requests.\n\n### Submitting a change\n\nThere are two ways to make changes, the easy way and the hard way. Either way\nyou will need to [create a GitHub account](https://github.com/signup/free).\n\nEasy way GitHub allows in-line editing of files for making simple typo changes\nand quick-fixes. This is not the best way as you are unable to test the code\nworks. If you do this you could be introducing syntax errors, etc, but for a\nGit-phobic user this is good for a quick-fix.\n\nHard way The best way to contribute is to \"clone\" your fork of ecDB to\nyour development area. That sounds like some jargon, but \"forking\" on GitHub\nmeans \"making a copy of that repo to your account\" and \"cloning\" means\n\"copying that code to your environment so you can work on it\".\n\n-  Set up Git (Windows, Mac \u0026 Linux)\n-  Go to the cheminv repo\n-  Fork it\n-  Clone your cheminv repo: git@github.com:\u003cyour-name\u003e/cheminv.git\n-  Checkout the \"develop\" branch At this point you are ready to start making\n   changes. \n-  Fix existing bugs on the Issue tracker after taking a look to see nobody\n   else is working on them.\n-  Commit the files\n-  Push your develop branch to your fork\n-  Send a pull request http://help.github.com/send-pull-requests/\n\nIf your PR is helpful it will be merged into this repo.\n\n## License\n\n-  cheminv is licensed under a Creative Commons [Attribution-NonCommercial-ShareAlike 3.0 Unported License](http://creativecommons.org/licenses/by-nc-sa/3.0/).\n-  You are allowed to set up a private cheminv database for yourself, or within an organization.\n\n- cheminv is derived from edDB, which is also licensed under a Creative Commons [Attribution-NonCommercial-ShareAlike 3.0 Unported License](http://creativecommons.org/licenses/by-nc-sa/3.0/).\n-  The ecDB code is not allowed for public use other than on  [www.ecDB.net](http://www.ecdb.net).\n\n\n###### Parts of this readme originates from [CodeIgniter](https://github.com/EllisLab/CodeIgniter)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmorrell%2Fcheminv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmorrell%2Fcheminv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmorrell%2Fcheminv/lists"}