ECS34-Project 4 Solved

You will be developing C++ wrappers for two C libraries. The wrappers will allow for reading and writing of both CSV and XML files. You have been provided headers for the CSV and XML wrapper types. You must keep the public interface but may develop the private implementation however you wish. The two libraries that you will be wrapping are libcsv (for CSV) and libexpat (for XML). Fortunately, libexpat is installed on the CSIF, but libcsv is not. The source code for libcsv has been provided for you and you will need to build it in order to include it in your project. After you have created your wrapper classes, you will be developing a program that will convert files between CSV and XML. The files that your program will need to convert are course grade files described later in this project. Make sure to add the temporary files created for your projects (*.o, *.lo, *.la, etc.) to your

.gitignore file.   

 

Create a Makefile to configure, make, and install libcsv. Open source libraries for Linux typically follow the same pattern for being built. The typical workflow is to configure, make, and then install (you will be “installing” into your project directory).  Configuration is done by changing into the library source directory and executing the command:

./configure --prefix=INSTALLPATH 

The INSTALLPATH is the prefix of where you would like to install the headers and the libraries. On a typical system this is in either /usr, /usr/local, /opt, or /opt/local; however, you will be just “installing” into your local project which should be the directory containing libcsv-3.0.3 directory. You can get the absolute path of the Makefile with the command

$(shell pwd). There should be a lot of output where the configuration is figured out. The building of the project should be done next with executing the command: make 

This should also output a lot of lines but should complete successfully. Next the library should be installed by executing the command:

make install 

This should install the libraries into the lib directory in the INSTALLPATH, and move the header file into the include directory of the INSTALLPATH. After you build the library correctly there should be a libcsv.a file (this is the static library you will link against) in your lib directory, and a csv.h in in your include directory.  

 

Once the library is built, add to your Makefile to build your CSVReader and CSVWriter object files and to build and run your google test for the CSV. The CCSVReader and CCSVWriter classes have simple interfaces.

 

// Constructor for CSV reader, CCSVReader should have a  

// std::istream & as part of it 

CCSVReader(std::istream &in); 

 

// Destructor for CSV reader 

~CCSVReader(); 

 

// Returns true if all rows have been read from the CSV bool End() const; 

 

// Returns true if the row is successfully read, one string will 

// be put in the row per column 

bool ReadRow(std::vector< std::string &row); 

 

 

// Constructor for CSV writer, CCSVWriter should have a  

// std::ostream & as part of it 

CCSVWriter(std::ostream &ou); 

 

// Destructor for CSV writer 

~CCSVWriter(); 

 

// Returns true if the row is successfully written, one string  

// per column should be put in the row vector bool WriteRow(const std::vector< std::string &row);

 

Once your CSV wrappers are complete, add to your Makefile to build your XMLReader and XMLWriter object files and to build and run your google test for the XML. The CXMLReader and CXMLWriter classes have simple interfaces. The SXMLEntity struct is used by both classes and has been provided. You will want to build programs with your wrappers by linking in libexpat with -lexpat as a linker option.

 

SXMLEntity{ 

    EType DType; // Type of entity start/end/complete element     std::string DNameData; 

    std::vector< TAttribute DAttributes; 

} 

 

// returns true if the attribute name is in the DAttributes bool AttributeExists(const std::string &name) const; 

     

// returns the value of the attribute, or empty string if  

// doesn't exist 

std::string AttributeValue(const std::string &name) const; 

     

// Sets the attribute name to the value 

bool SetAttribute(const std::string &name, const std::string 

&value); 

 

// Constructor for XML reader, CXMLReader should have a  

// std::istream & as part of it 

CXMLReader(std::istream &is); 

 

// Destructor for XML reader 

~CXMLReader(); 

         

// Returns true if all entities have been read from the XML bool End() const; 

 

// Returns true if the entity is successfully read if skipcdata // is true only element type entities will be returned bool ReadEntity(SXMLEntity &entity, bool skipcdata = false); 

 

 

// Constructor for XML writer, CXMLWriter should have a  

// std::ostream & as part of it 

CXMLWriter(std::ostream &ou); 

 

// Destructor for XML writer 

~CXMLWriter(); 

 

// Outputs all end elements for those that have been started bool Flush(); 

 

// Writes out the entity to the output stream 

bool WriteEntity(const SXMLEntity &entity); 

 

Once you have completed writing the XML wrapper classes, you will be ready to begin developing the student file converter. Course information is in two different systems, one uses CSV, the other uses XML. You are tasked with writing a program that will take in any number of CSV or XML files as arguments and converting each of them to the other type. The CSV files will have the following naming convention SUBJ_CRSE_SEC.csv where SUBJ is the course subject, CRSE is the course number, and SEC is the section number. Inside each CSV file there will be a header with the following column headings, though not guaranteed to be in any particular order.

SEAT – The seat number of the student

SID – The student ID

SURNAME – The last name of the student PREFNAME – The student’s preferred first name

LEVEL – The student’s level UG for undergrad, etc.

UNITS – The number of units the student received

CLASS – The student’s class standing

MAJOR – The student’s major code

GRADE – The grade the student received in the course

STATUS – The student’s registration status

EMAIL – The student’s e-mail address

There will be one row for each student that was part of the course.

 

The XML files will contain the SUBJ, CRSE, and SEC information inside them. The elements in the XML file will be an outer course element with inner student elements. The SUBJ, CRSE, and SEC are attributes of the course element. The CSV headings are the attributes of the student elements.  

 

The output file must be put in the same directory as the input file and must have name of the form SUBJ_CRSE_SEC.EXT where SUBJ is the course subject, CRSE is the course number, SEC is the section number, and EXT is the extension (either csv or xml).

 

An example program can be found in /home/cjnitta/ecs34/studconv, and sample files for conversion can be found in /home/cjnitta/ecs34/proj4samples/.

 

You can unzip the given tgz file with utilities on your local machine, or if you upload the file to the CSIF, you can unzip it with the command:

tar -xzvf proj4given.tgz