# ez-docs
### What'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.
#### Realised features
- [x] Generate doc's in .pdf [#20](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/20)
- [ ] e-mail generated doc's [#24](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/24)
- [x] Package pip installation [#30](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/30)
- [x] Argparse commands [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)
- [x] Run package via CLI [#43](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/43)
#### Realised doc's
- [x] Github Page [#31](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/31)
- [x] README [#32](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/32)
- [x] Product Backlog [#33](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/33)
- [x] about [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)
- [x] architecture [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)
- [x] help [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)
- [x] list [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)
#### Bugs
* Semicolon separator on .csv files not working.
* Format .xlsx
* key_pattern optionality.
* flag=1/flag=2 always generating .md files.
## Prerequisites
Before 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 the [project GitPage](https://fga-eps-mds.github.io/2022-2-ez-docs/index.html).
## Installation
To install *ez-docs*, open an interactive shell and run:
```bash
$ python3 -m pip install ez-docs
```
Then, to assure the faultless installation, run:
```bash
$ ez-docs --about
```
The 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-docs
To start using *ez-docs*, you'll need a markdown template, a database (.csv, .txt, .xls) and a pattern of keys.
* directory_template: str - template.md
In 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>>
* database: str - database.(csv, txt, xls)
* 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.pdf
- Barnardo_2718281828.pdf
- Caliban_4815162342.pdf
Valid separators: registration_name, registration-name, registration:name, registration name.
* flag: int - optional parameter that defines the final output format.
- 1 (def.) - The doc will be converted to .pdf
- 2 - The doc will remain in .md
With that, you may open an interactive shell and run:
```bash
$ ez-docs <~/template.md> <~/database.csv> <pattern_keys> --flag=1 or 2
```
## Special functionalities
ez-docs has some in-line functionalities. To use it, type one of the commands below in your terminal:
Project overview, contributors, etc:
```bash
$ ez-docs --about
```
Architecture stuff:
```bash
$ ez-docs --architecture
```
How to use tutorial:
```bash
$ ez-docs --help
```
List of all command line commands:
```bash
$ ez-docs --list
```
## Getting involved
1. Read the [CONTRIBUTING.md](https://github.com/fga-eps-mds/2022-2-ez-docs/blob/main/docs/CONTRIBUTING.md) guide.
2. Fork this repository.
3. Create a branch on your local machine: `git checkout -b <branch_name>`.
4. Make your changes and confirm them following the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/): `git commit -m "commit_message"`
5. Send to origin branch: `git push origin <branch_name> / <local>`
6. Create pull request through Github.
## Open source licensing info
This project is under license. See the [LICENSE](LICENSE) file for details.
---
## So, take it easy, and use ez-docs to make your docs!
#### Special thanks to:
Dr. [Carla Rocha Aguiar](https://github.com/RochaCarla), our professor at the University of Brasília.
**_ez-docs Team_**
*Created by [Bruno Ribeiro](https://github.com/BrunoRiibeiro), [Bruno Martins](https://github.com/gitbmvb), [Diógenes Dantas](https://github.com/diogjunior100), [Igor Penha](https://github.com/igorpenhaa), [Lucas Bergholz](https://github.com/LucasBergholz) and [Rafael Nobre](https://github.com/RafaelN0bre) in 2022*
Raw data
{
"_id": null,
"home_page": "https://github.com/diogjunior100/pacotepip.git",
"name": "pacotepip",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "pacotepip",
"author": "Bruno, Igor e Di\u00f3genes",
"author_email": "bruno.martval@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/67/09/9bd092461a031bb280efe40c5ddd6f6a72ae850a81c0050e1149e325590e/pacotepip-1.0.0.tar.gz",
"platform": null,
"description": "# ez-docs\n\n### What's up everyone!\n\nez-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.\n\nSo, 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.\n\n#### Realised features\n\n- [x] Generate doc's in .pdf [#20](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/20)\n- [ ] e-mail generated doc's [#24](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/24)\n- [x] Package pip installation [#30](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/30)\n- [x] Argparse commands [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)\n- [x] Run package via CLI [#43](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/43)\n\n#### Realised doc's\n\n- [x] Github Page [#31](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/31)\n- [x] README [#32](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/32)\n- [x] Product Backlog [#33](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/33)\n- [x] about [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)\n- [x] architecture [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)\n- [x] help [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)\n- [x] list [#39](https://github.com/fga-eps-mds/2022-2-ez-docs/issues/39)\n\n#### Bugs\n\n* Semicolon separator on .csv files not working.\n* Format .xlsx\n* key_pattern optionality.\n* flag=1/flag=2 always generating .md files.\n\n## Prerequisites\n\nBefore starting, make sure you've met the following requirements:\n* You have installed the latest version of `<Python>`.\n* You have a `<Windows / Linux / Mac>` machine.\n* You read the [project GitPage](https://fga-eps-mds.github.io/2022-2-ez-docs/index.html).\n\n\n## Installation\n\nTo install *ez-docs*, open an interactive shell and run:\n```bash\n$ python3 -m pip install ez-docs\n```\nThen, to assure the faultless installation, run:\n```bash\n$ ez-docs --about\n```\nThe terminal ought to print something like this:\n```\n=====About this project=====\n\n\tThis 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.\n ...\n```\n\n## Using ez-docs\n\nTo start using *ez-docs*, you'll need a markdown template, a database (.csv, .txt, .xls) and a pattern of keys.\n\n* directory_template: str - template.md\n \n In 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>> \n \n\n ![Template file example](/docs/images/template.png \"Template file example\")\n\n* database: str - database.(csv, txt, xls)\n \n ![Database file example](/docs/images/database.png \"Database file example\")\n\n* file_name_pattern: str - parameter concerning the denominator key of the document name, which must follow the format {key_pattern}.\nFor example, for a template that has the keys \"name\" and \"registration\", the output could be \"name_registration\", generating the following results:\n - Aaron_3141592653.pdf\n - Barnardo_2718281828.pdf\n - Caliban_4815162342.pdf\n\n Valid separators: registration_name, registration-name, registration:name, registration name.\n\n* flag: int - optional parameter that defines the final output format.\n - 1 (def.) - The doc will be converted to .pdf\n - 2 - The doc will remain in .md\n\nWith that, you may open an interactive shell and run:\n```bash\n$ ez-docs <~/template.md> <~/database.csv> <pattern_keys> --flag=1 or 2\n```\n\n\n\n## Special functionalities\n\nez-docs has some in-line functionalities. To use it, type one of the commands below in your terminal:\n\nProject overview, contributors, etc:\n```bash\n$ ez-docs --about\n```\n\nArchitecture stuff:\n```bash\n$ ez-docs --architecture\n```\n\nHow to use tutorial:\n```bash\n$ ez-docs --help\n```\n\nList of all command line commands:\n```bash\n$ ez-docs --list\n```\n\n## Getting involved\n1. Read the [CONTRIBUTING.md](https://github.com/fga-eps-mds/2022-2-ez-docs/blob/main/docs/CONTRIBUTING.md) guide.\n2. Fork this repository.\n3. Create a branch on your local machine: `git checkout -b <branch_name>`.\n4. Make your changes and confirm them following the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/): `git commit -m \"commit_message\"`\n5. Send to origin branch: `git push origin <branch_name> / <local>`\n6. Create pull request through Github.\n\n\n## Open source licensing info\n\nThis project is under license. See the [LICENSE](LICENSE) file for details.\n\n---\n## So, take it easy, and use ez-docs to make your docs!\n\n#### Special thanks to:\nDr. [Carla Rocha Aguiar](https://github.com/RochaCarla), our professor at the University of Bras\u00edlia.\n\n**_ez-docs Team_** \n\n*Created by [Bruno Ribeiro](https://github.com/BrunoRiibeiro), [Bruno Martins](https://github.com/gitbmvb), [Di\u00f3genes Dantas](https://github.com/diogjunior100), [Igor Penha](https://github.com/igorpenhaa), [Lucas Bergholz](https://github.com/LucasBergholz) and [Rafael Nobre](https://github.com/RafaelN0bre) in 2022*\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Pacote de teste",
"version": "1.0.0",
"split_keywords": [
"pacotepip"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f94eb0f5caed2a8e52327fcb22100c1a72e8c398530d5e399a9c30ed81377cf2",
"md5": "22b6f7288d127df78eebd80e68d3cdc3",
"sha256": "1e44827cae85559b7d04999bcb09683c39ed6b4c10a524793025c646771fb341"
},
"downloads": -1,
"filename": "pacotepip-1.0.0-py3.10.egg",
"has_sig": false,
"md5_digest": "22b6f7288d127df78eebd80e68d3cdc3",
"packagetype": "bdist_egg",
"python_version": "1.0.0",
"requires_python": null,
"size": 17805,
"upload_time": "2023-01-20T01:00:05",
"upload_time_iso_8601": "2023-01-20T01:00:05.461822Z",
"url": "https://files.pythonhosted.org/packages/f9/4e/b0f5caed2a8e52327fcb22100c1a72e8c398530d5e399a9c30ed81377cf2/pacotepip-1.0.0-py3.10.egg",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "063641ba4034b9e5dc9cfd11509c9755a1a05a8237aa327fd732f23d5911d12f",
"md5": "510181dee55e7d3edf2852deda0af042",
"sha256": "f842b508119163aef94729fb970cdb9e7ad4d32d1d3303928e1518c29d2b7453"
},
"downloads": -1,
"filename": "pacotepip-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "510181dee55e7d3edf2852deda0af042",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 12769,
"upload_time": "2023-01-20T01:00:03",
"upload_time_iso_8601": "2023-01-20T01:00:03.518490Z",
"url": "https://files.pythonhosted.org/packages/06/36/41ba4034b9e5dc9cfd11509c9755a1a05a8237aa327fd732f23d5911d12f/pacotepip-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "67099bd092461a031bb280efe40c5ddd6f6a72ae850a81c0050e1149e325590e",
"md5": "95205598920742d16ff0e0a4feec3d64",
"sha256": "527d8af50cc5bd5b16251cc705554ecdbe40076375a64e5877c3474166bfd15a"
},
"downloads": -1,
"filename": "pacotepip-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "95205598920742d16ff0e0a4feec3d64",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 11277,
"upload_time": "2023-01-20T01:00:07",
"upload_time_iso_8601": "2023-01-20T01:00:07.730268Z",
"url": "https://files.pythonhosted.org/packages/67/09/9bd092461a031bb280efe40c5ddd6f6a72ae850a81c0050e1149e325590e/pacotepip-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-20 01:00:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "diogjunior100",
"github_project": "pacotepip.git",
"lcname": "pacotepip"
}
JSON
