<img src=“https://api.codeclimate.com/v1/badges/02a925f8fcab4b681b5f/maintainability” /> <img src=“https://api.codeclimate.com/v1/badges/02a925f8fcab4b681b5f/test_coverage” /> <img src=“https://travis-ci.org/rileydcampbell/cs169-parser.svg?branch=master” alt=“Build Status” />
CalTest Central is the file parsing and grouping app for making data consistent over CalCentral test files. The workflow is upload files -> group files -> edit files
To set up the app, please install and use Ruby version 2.4.0. Make sure to run bundle install to get the dependencies.
To run the app, type rails server into the terminal and navigate to localhost:3000.
To reset the database, run $ rake db:reset $ rake db:migrate
When you first load up the app, you will be directed to the index page. To upload a file, click the “New File” button which will direct you to the upload page.
In the upload page, you can upload one file or multiple files.
-
For individual files, you can choose a name. If you do not enter a name, the name will default to the name of the file.
-
For multiple files the app will just default each file to the name of the file.
After you upload a file, you can see it in the index.
To see the contents of a file as well as its properties, click the file’s name in the index and it will take you to the information page.
Here you can see the contents, the groups it is a part of, all its properties, and a graph displaying its properties.
You can also delete the file by clicking the “Delete File” button.
Grouping is facilitated through shared properties between files.
After uploading several files, you will be able to see shared properties among them on the index page. These properties show up in at least two files.
Once you choose a property you would like to group by, click “see more” for that property and you will be directed to more information about that property such as groups with that property and which files have that property. If you would like to create a group for files with that property, click the “create group” button and you will be directed to the grouping page.
At this point, you can unselect any files you would not like in the group. You can also choose a name for the group. If you do not explicitly state a name, the name will default to the grouping property’s name. Once satisfied, click “Create” and the group will be saved into the database.
Because the app’s purpose is to make data consistent across test files, when you edit a property, the change will register for all other files that are grouped by that property.
To do this:
-
Click on the file in the index
-
Select “edit property” for the property you would like to edit, which is bound by a group
-
Multiple groups can be bound by the same property, so you will be able to select which group you would like to edit.
-
Enter the new value for that property, which will replace the old one.
-
click “Save”
-
Now your edit should be registered across all files in that group.
To download a file, just click the download link for that file in the index.
-
highlighting the properties in a file’s contents
-
More user-friendly UI