Package: ez-docs
ez-docsWhat's up everyone!ez-docs is a MVP (minimum viable product) Python project that were build for an SDM (Software Development Methods) class, with the aim of learn the goals of different approaches for creating software through agile practices.So, we contribute to the Open Source community with ez-docs, which helps users to issue a wide range of certificates, declarations, resumes, receipts, slips, or whatever else the imagination allows through a database and a template in markdown format.PrerequisitesBefore starting, make sure you've met the following requirements:You have installed the latest version of<Python>.You have a<Windows / Linux / Mac>machine.You read theproject GitPage.InstallationTo installez-docs, open an interactive shell and run:$python3-mpipinstallez-docsThen, to assure the faultless installation, run:$ez-docs--aboutThe terminal ought to print something like this:=====About this project=====

	This project was developed by Software Engineering students at the University of Brasilia - Campus Gama (UnB-FGA) - during the 2022.2 semester, in the course of Software Development Methods (SDM), under the guidance of prof. Dr. Carla Rocha Aguiar.
    ...Using ez-docsTo start usingez-docs, you'll need a markdown template, a database (.csv, .xlsx, .json) and a pattern of keys.directory_template: str - template.mdIn your markdown template you must to indicate the fields that you want to replace for the values in database, with the following pattern of keys:  <<SAME_DATABASE_COLUMN_NAME>> . You can use images in your markdown but can't use HTML and CSS tags.database: str - database.(csv, txt, xlsx)file_name_pattern: str - parameter concerning the denominator key of the document name, which must follow the format {key_pattern}.
For example, for a template that has the keys "name" and "registration", the output could be "name_registration", generating the following results:Aaron_3141592653.pdfBarnardo_2718281828.pdfCaliban_4815162342.pdfValid separators: registration_name, registration-name, registration:name, registration name.flag: int - optional parameter that defines the final format of each document.0 - The doc will remain in .md1 (def.) - The doc will be converted to .pdfzip: int - optional parameter that defines the final format of the set.0 (def.) - The set will be kept at folder ./output;1 - The files will be joint in a output.zip;constraint: str - optional parameter that sets a constraint for data filtering.
Exemple: Suppose you have a data set of students' grades, and you would like to generate a certificate for those whose grades are greater or equal than 8. In this case, you could simply type: "... --constraint 'Grade >= 8.0' (assuming you really have a column named "Grade").With that, you may open an interactive shell and run:$ez-docs<~/template.md><~/database.csv><pattern_keys>--flag=0or1--zip=0or1Special functionalitiesez-docs has some in-line functionalities. To use it, type one of the commands below in your terminal:Project overview, contributors, etc:$ez-docs--aboutArchitecture stuff:$ez-docs--architectureHow to use tutorial:$ez-docs--helpList of all command line commands:$ez-docs--listGetting involvedRead theCONTRIBUTING.mdguide.Fork this repository.Create a branch on your local machine:git checkout -b <branch_name>.Make your changes and confirm them following theConventional Commits:git commit -m "commit_message"Send to origin branch:git push origin <branch_name> / <local>Create pull request through Github.Product BacklogTo get access to the project backlog, clickhere.Contact usYou may email toezdocsteam@gmail.com. We would be happy to answer your questions and set up a meeting with you.Open source licensing infoThis project is under license. See theLICENSEfile for details.So, take it easy, and use ez-docs to make your docs!Special thanks to:Dr.Carla Rocha Aguiar, our professor at the University of Brasília.ez-docs TeamCreated byBruno Ribeiro,Bruno Martins,Diógenes Dantas,Igor Penha,Lucas BergholzandRafael Nobrein 2022