https://github.com/felipedemacedo/ruby-sheet-manipulator
Methods to load CSV sheets into memory and apply changes to it.
https://github.com/felipedemacedo/ruby-sheet-manipulator
csv loader ruby sheet
Last synced: about 1 year ago
JSON representation
Methods to load CSV sheets into memory and apply changes to it.
- Host: GitHub
- URL: https://github.com/felipedemacedo/ruby-sheet-manipulator
- Owner: felipedemacedo
- License: gpl-3.0
- Created: 2018-08-13T12:37:18.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-31T17:55:41.000Z (almost 8 years ago)
- Last Synced: 2025-02-17T23:45:32.009Z (over 1 year ago)
- Topics: csv, loader, ruby, sheet
- Language: Ruby
- Size: 28.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ruby Sheet Manipulator
Basic sheet manipulator in Ruby. ([Source Code](https://github.com/felipedemacedo/ruby-sheet-manipulator))
### Sample sheet:
```markdown
Col A;Col B;Col C
;;
123;456 ;789
12; 34;56
;
;;
78;90;1
a;b;c
dD;Ee;fF
;;;;;
;;
;;;
```
## Usage examples:
### Point to the sheet file
```markdown
sheet = Sheet.new("./example_sheets/skip_blank_lines/sheet.csv")
------------------------------------------------------
#, @column_separator=";">
```
### Point to the sheet file with custom column separator
```markdown
sheet = Sheet.new("./example_sheets/skip_blank_lines/sheet.csv", ",")
------------------------------------------------------
#, @column_separator=",">
```
### Load the sheet into memory
```markdown
sheet = Sheet.new("./example_sheets/skip_blank_lines/sheet.csv")
sheet.load()
------------------------------------------------------
** LOADING
DATA:
";;\n"
"123;456 ;789\n"
"12; 34;56\n"
";\n"
";;\n"
"78;90;1 \n"
"a;b;c\n"
"\n"
"\n"
"\n"
"dD;Ee;fF\n"
"\n"
"\n"
";;;;;\n"
"\n"
";;\n"
";;;"
--
```
### Load the sheet into memory as an Array
```markdown
sheet = Sheet.new("./example_sheets/skip_blank_lines/sheet.csv")
sheet.load_as_array()
------------------------------------------------------
** LOADING AS ARRAY
DATA:
["", "", "\n"]
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["", "\n"]
["", "", "\n"]
["78", "90", "1 \n"]
["a", "b", "c\n"]
["\n"]
["\n"]
["\n"]
["dD", "Ee", "fF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
[]
--
```
### Load the sheet into memory as a Hash
```markdown
sheet = Sheet.new("./example_sheets/skip_blank_lines/sheet.csv")
sheet.load_as_hash()
------------------------------------------------------
** LOADING AS HASH
DATA:
{"Col A"=>"", "Col B"=>"", "Col C"=>"\n"}
{"Col A"=>"123", "Col B"=>"456 ", "Col C"=>"789\n"}
{"Col A"=>"12", "Col B"=>" 34", "Col C"=>"56\n"}
{"Col A"=>"", "Col B"=>"\n", "Col C"=>nil}
{"Col A"=>"", "Col B"=>"", "Col C"=>"\n"}
{"Col A"=>"78", "Col B"=>"90", "Col C"=>"1 \n"}
{"Col A"=>"a", "Col B"=>"b", "Col C"=>"c\n"}
{"Col A"=>"\n", "Col B"=>nil, "Col C"=>nil}
{"Col A"=>"\n", "Col B"=>nil, "Col C"=>nil}
{"Col A"=>"\n", "Col B"=>nil, "Col C"=>nil}
{"Col A"=>"dD", "Col B"=>"Ee", "Col C"=>"fF\n"}
{"Col A"=>"\n", "Col B"=>nil, "Col C"=>nil}
{"Col A"=>"\n", "Col B"=>nil, "Col C"=>nil}
{"Col A"=>"", "Col B"=>"", "Col C"=>""}
{"Col A"=>"\n", "Col B"=>nil, "Col C"=>nil}
{"Col A"=>"", "Col B"=>"", "Col C"=>"\n"}
{"Col A"=>nil, "Col B"=>nil, "Col C"=>nil}
--
```
### Remove all blank lines from sheet
```markdown
sheet.skip_blank_lines()
------------------------------------------------------
** BACKUP STORED !
REMOVE_BLANK_LINES APPLIED !
DATA:
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["78", "90", "1 \n"]
["a", "b", "c\n"]
["dD", "Ee", "fF\n"]
--
```
### Get rid of leading and trailing whitespaces
```markdown
sheet.skip_whitespaces()
------------------------------------------------------
** BACKUP STORED !
REMOVE_WHITESPACES APPLIED !
DATA:
["", "", "\n"]
["123", "456", "789\n"]
["12", "34", "56\n"]
["", "\n"]
["", "", "\n"]
["78", "90", "1\n"]
["a", "b", "c\n"]
["\n"]
["\n"]
["\n"]
["dD", "Ee", "fF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
--
```
### Remove all line breaks
```markdown
sheet.skip_line_breaks()
------------------------------------------------------
** BACKUP STORED !
REMOVE_LINE_BREAKS APPLIED !
DATA:
["", "", ""]
["123", "456 ", "789"]
["12", " 34", "56"]
["", ""]
["", "", ""]
["78", "90", "1 "]
["a", "b", "c"]
[""]
[""]
[""]
["dD", "Ee", "fF"]
[""]
[""]
["", "", "", "", "", ""]
[""]
["", "", ""]
--
```
### Remove similar lines
```markdown
sheet.uniq()
------------------------------------------------------
** BACKUP STORED !
UNIQ APPLIED !
DATA:
["", "", "\n"]
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["", "\n"]
["78", "90", "1 \n"]
["a", "b", "c\n"]
["\n"]
["dD", "Ee", "fF\n"]
["", "", "", "", "", "\n"]
[]
--
```
### Sort all lines of the sheet
```markdown
sheet.sort()
------------------------------------------------------
** BACKUP STORED !
SORT APPLIED !
DATA:
[]
["", "", "", "", "", "\n"]
["", "", "\n"]
["", "", "\n"]
["", "", "\n"]
["", "\n"]
["\n"]
["\n"]
["\n"]
["\n"]
["\n"]
["\n"]
["12", " 34", "56\n"]
["123", "456 ", "789\n"]
["78", "90", "1 \n"]
["a", "b", "c\n"]
["dD", "Ee", "fF\n"]
--
```
### UPCASE
```markdown
sheet.upcase()
------------------------------------------------------
** BACKUP STORED !
APPLY_UPCASE APPLIED !
DATA:
["", "", "\n"]
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["", "\n"]
["", "", "\n"]
["78", "90", "1 \n"]
["A", "B", "C\n"]
["\n"]
["\n"]
["\n"]
["DD", "EE", "FF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
--
```
### downcase
```markdown
sheet.downcase()
------------------------------------------------------
** BACKUP STORED !
APPLY_DOWNCASE APPLIED !
DATA:
["", "", "\n"]
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["", "\n"]
["", "", "\n"]
["78", "90", "1 \n"]
["a", "b", "c\n"]
["\n"]
["\n"]
["\n"]
["dd", "ee", "ff\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
--
```
### Remove all numeric elements from the sheet.
```markdown
sheet.skip_numeric()
------------------------------------------------------
** BACKUP STORED !
REMOVE_NUMERICS APPLIED !
DATA:
["", "", "\n"]
["", "", ""]
["", "", ""]
["", "\n"]
["", "", "\n"]
["", "", ""]
["a", "b", "c\n"]
["\n"]
["\n"]
["\n"]
["dD", "Ee", "fF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
--
```
### Remove all non-numeric elements from the sheet.
```markdown
sheet.skip_non_numeric()
------------------------------------------------------
** BACKUP STORED !
REMOVE_NON_NUMERICS APPLIED !
DATA:
["", "", ""]
["123", "", ""]
["12", "", ""]
["", ""]
["", "", ""]
["78", "90", ""]
["", "", ""]
[""]
[""]
[""]
["", "", ""]
[""]
[""]
["", "", "", "", "", ""]
[""]
["", "", ""]
[]
--
```
### You can always come back and undo last change.
```markdown
sheet.skip_numeric()
sheet.rollback()
------------------------------------------------------
** BACKUP STORED !
REMOVE_NUMERICS APPLIED !
DATA:
["", "", "\n"]
["", "", ""]
["", "", ""]
["", "\n"]
["", "", "\n"]
["", "", ""]
["a", "b", "c\n"]
["\n"]
["\n"]
["\n"]
["dD", "Ee", "fF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
--
** ROLLED BACK !
DATA:
["", "", "\n"]
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["", "\n"]
["", "", "\n"]
["78", "90", "1 \n"]
["a", "b", "c\n"]
["\n"]
["\n"]
["\n"]
["dD", "Ee", "fF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
[]
--
```
### Some methods can be applied into specific columns only.
For instance: upcase, downcase, skip_line_breaks, skip_whitespaces, skip_numeric, skip_non_numeric
```markdown
sheet.upcase([0,1])
------------------------------------------------------
****************************SPECIFIC COLUMNS: [0,1]
** BACKUP STORED !
APPLY_UPCASE APPLIED !
DATA:
["", "", "\n"]
["123", "456 ", "789\n"]
["12", " 34", "56\n"]
["", "\n"]
["", "", "\n"]
["78", "90", "1 \n"]
["A", "B", "c\n"]
["\n"]
["\n"]
["\n"]
["DD", "EE", "fF\n"]
["\n"]
["\n"]
["", "", "", "", "", "\n"]
["\n"]
["", "", "\n"]
--
```
### Create your own methods and apply it over the sheet (on specific columns if you want)!
For example, let's say you have two methods. The first one duplicates whatever it receives as parameter.
The second one concatenates a string for every cell it gets.
```markdown
def myFirstMethod(str)
str*2 unless str.nil?
end
def mySecondMethod(str)
str + " << OK." unless str.nil?
end
sheet.apply(method(:myFirstMethod))
sheet.rollback()
sheet.apply(method(:mySecondMethod))
sheet.rollback()
sheet.apply(method(:mySecondMethod), [0])
------------------------------------------------------
** BACKUP STORED !
MYFIRSTMETHOD APPLIED !
DATA:
["", "", "\n\n"]
["123123", "456 456 ", "789\n789\n"]
["1212", " 34 34", "56\n56\n"]
["", "\n\n"]
["", "", "\n\n"]
["7878", "9090", "1 \n1 \n"]
["aa", "bb", "c\nc\n"]
["\n\n"]
["\n\n"]
["\n\n"]
["dDdD", "EeEe", "fF\nfF\n"]
["\n\n"]
["\n\n"]
["", "", "", "", "", "\n\n"]
["\n\n"]
["", "", "\n\n"]
[]
--
** ROLLED BACK !
** BACKUP STORED !
MYSECONDMETHOD APPLIED !
DATA:
[" << OK.", " << OK.", "\n << OK."]
["123 << OK.", "456 << OK.", "789\n << OK."]
["12 << OK.", " 34 << OK.", "56\n << OK."]
[" << OK.", "\n << OK."]
[" << OK.", " << OK.", "\n << OK."]
["78 << OK.", "90 << OK.", "1 \n << OK."]
["a << OK.", "b << OK.", "c\n << OK."]
["\n << OK."]
["\n << OK."]
["\n << OK."]
["dD << OK.", "Ee << OK.", "fF\n << OK."]
["\n << OK."]
["\n << OK."]
[" << OK.", " << OK.", " << OK.", " << OK.", " << OK.", "\n << OK."]
["\n << OK."]
[" << OK.", " << OK.", "\n << OK."]
[]
--
** ROLLED BACK !
****************************SPECIFIC COLUMNS: [0]
** BACKUP STORED !
MYSECONDMETHOD APPLIED !
DATA:
[" << OK.", "", "\n"]
["123 << OK.", "456 ", "789\n"]
["12 << OK.", " 34", "56\n"]
[" << OK.", "\n"]
[" << OK.", "", "\n"]
["78 << OK.", "90", "1 \n"]
["a << OK.", "b", "c\n"]
["\n << OK."]
["\n << OK."]
["\n << OK."]
["dD << OK.", "Ee", "fF\n"]
["\n << OK."]
["\n << OK."]
[" << OK.", "", "", "", "", "\n"]
["\n << OK."]
[" << OK.", "", "\n"]
[]
--
```