# zpp-args
## Informations
Module pour le traitement des arguments d'une ligne de commande.
<br>Trois sources possibles:
- sys.argv
- une chaîne de caractère
- une liste
### Prérequis
- Python 3
<br>
# Installation
```console
pip install zpp_args
```
# Utilisation
### Conseil d'importation du module
```python
from zpp_args import parser
```
<br>
### Initialisation du parser
```python
parse = parser(SOURCE, error_lock=False)
```
>En paramètre supplémentaire, nous pouvons mettre:<br/>
>- error_lock: Purge le retour de la fonction si une erreur s'est produite (Par défaut: False)
<br>
### Initialisation des arguments
```python
parse.set_argument(NAME)
```
L'initialisation doit prendre au moins un des deux paramètres suivants:
- shortcut: Pour les arguments courts (1 caractère)
- longname: Pour les arguments explicites (1 mot ou ensemble de mots séparés par le symbole \_)
_Si non précisé, la fonction initialise shortcut_
>En paramètre supplémentaire, nous pouvons mettre:<br/>
>- error_lock: Purge le retour de la fonction si une erreur s'est produite (Par défaut: )
>- type: Pour forcer l'argument reçu à un str ou un digit (Par défaut: None)
>- default: Pour choisir une valeur par défaut(Par défaut: None)
>- description: Pour ajouter une description à l'argument à afficher lors de l'appel de la commande help(Par défaut: None)
>- required: Choisir si cet argument est nécessaire (Par défaut: False)
>- store: Choisir si l'argument' est un simple True/False ou s'il attends une variable (Par défaut: bool)
>- category: Choisir une catégorie pour l'affichage du help
<br>
### Initialisation des paramètres
L'initialisation des paramètres va permettre d'agrémenter la commande help et de fixer une limite minimum lors de la récupération des paramètres
```python
parse.set_argument(NAME)
```
>En paramètre supplémentaire, nous pouvons mettre:<br/>
>- description: Pour ajouter une description au paramètre à afficher lors de l'appel de la commande help(Par défaut: None)
<br>
### Execution du parseur
```python
argument, parameter = parse.load()
```
Retourne une liste avec les paramètres et une classe (StoreArgument) avec les arguments
La StoreArgument peut retourner un dictionnaire en appelant argument.list_all()
<br>
### Initialisation de la description de la commande
```python
parse.set_description(DESCRIPTION)
```
<br>
### Affichage de l'aide
```python
parse.help()
```
<br>
### Désactiver le check sur les paramètres
Pour désactiver le check du nombre de paramètres à envoyer, il suffit d'appeler la fonction suivante.
```python
parse.disable_check()
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ZephyrOff/zpp_args",
"name": "zpp_args",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "terminal args zephyroff",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/dd/bd/8984ce1bf18455989d35fb6f99980ae3a0d7b2c4e5659a60f32208a9b6a3/zpp_args-1.3.4-py3-none-any.whl",
"platform": null,
"description": "# zpp-args\r\n## Informations\r\nModule pour le traitement des arguments d'une ligne de commande.\r\n<br>Trois sources possibles:\r\n- sys.argv\r\n- une cha\u00c3\u00aene de caract\u00c3\u00a8re\r\n- une liste\r\n\r\n### Pr\u00c3\u00a9requis\r\n- Python 3\r\n<br>\r\n\r\n# Installation\r\n```console\r\npip install zpp_args\r\n```\r\n\r\n# Utilisation\r\n### Conseil d'importation du module\r\n```python\r\nfrom zpp_args import parser\r\n```\r\n<br>\r\n\r\n### Initialisation du parser\r\n```python\r\nparse = parser(SOURCE, error_lock=False)\r\n```\r\n>En param\u00c3\u00a8tre suppl\u00c3\u00a9mentaire, nous pouvons mettre:<br/>\r\n>- error_lock: Purge le retour de la fonction si une erreur s'est produite (Par d\u00c3\u00a9faut: False)\r\n<br>\r\n\r\n### Initialisation des arguments\r\n```python\r\nparse.set_argument(NAME)\r\n```\r\nL'initialisation doit prendre au moins un des deux param\u00c3\u00a8tres suivants:\r\n- shortcut: Pour les arguments courts (1 caract\u00c3\u00a8re)\r\n- longname: Pour les arguments explicites (1 mot ou ensemble de mots s\u00c3\u00a9par\u00c3\u00a9s par le symbole \\_)\r\n\r\n_Si non pr\u00c3\u00a9cis\u00c3\u00a9, la fonction initialise shortcut_\r\n\r\n>En param\u00c3\u00a8tre suppl\u00c3\u00a9mentaire, nous pouvons mettre:<br/>\r\n>- error_lock: Purge le retour de la fonction si une erreur s'est produite (Par d\u00c3\u00a9faut: )\r\n>- type: Pour forcer l'argument re\u00c3\u00a7u \u00c3\u00a0 un str ou un digit (Par d\u00c3\u00a9faut: None)\r\n>- default: Pour choisir une valeur par d\u00c3\u00a9faut(Par d\u00c3\u00a9faut: None)\r\n>- description: Pour ajouter une description \u00c3\u00a0 l'argument \u00c3\u00a0 afficher lors de l'appel de la commande help(Par d\u00c3\u00a9faut: None)\r\n>- required: Choisir si cet argument est n\u00c3\u00a9cessaire (Par d\u00c3\u00a9faut: False)\r\n>- store: Choisir si l'argument' est un simple True/False ou s'il attends une variable (Par d\u00c3\u00a9faut: bool)\r\n>- category: Choisir une cat\u00c3\u00a9gorie pour l'affichage du help\r\n<br>\r\n\r\n### Initialisation des param\u00c3\u00a8tres\r\nL'initialisation des param\u00c3\u00a8tres va permettre d'agr\u00c3\u00a9menter la commande help et de fixer une limite minimum lors de la r\u00c3\u00a9cup\u00c3\u00a9ration des param\u00c3\u00a8tres\r\n```python\r\nparse.set_argument(NAME)\r\n```\r\n>En param\u00c3\u00a8tre suppl\u00c3\u00a9mentaire, nous pouvons mettre:<br/>\r\n>- description: Pour ajouter une description au param\u00c3\u00a8tre \u00c3\u00a0 afficher lors de l'appel de la commande help(Par d\u00c3\u00a9faut: None)\r\n<br>\r\n\r\n### Execution du parseur\r\n```python\r\nargument, parameter = parse.load()\r\n```\r\nRetourne une liste avec les param\u00c3\u00a8tres et une classe (StoreArgument) avec les arguments\r\nLa StoreArgument peut retourner un dictionnaire en appelant argument.list_all()\r\n\r\n<br>\r\n\r\n### Initialisation de la description de la commande\r\n```python\r\nparse.set_description(DESCRIPTION)\r\n```\r\n<br>\r\n\r\n### Affichage de l'aide\r\n```python\r\nparse.help()\r\n```\r\n<br>\r\n\r\n### D\u00c3\u00a9sactiver le check sur les param\u00c3\u00a8tres\r\nPour d\u00c3\u00a9sactiver le check du nombre de param\u00c3\u00a8tres \u00c3\u00a0 envoyer, il suffit d'appeler la fonction suivante.\r\n```python\r\nparse.disable_check()\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Module pour le traitement des arguments d'une ligne de commande",
"version": "1.3.4",
"project_urls": {
"Documentation": "https://github.com/ZephyrOff/zpp_args",
"Homepage": "https://github.com/ZephyrOff/zpp_args"
},
"split_keywords": [
"terminal",
"args",
"zephyroff"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ddbd8984ce1bf18455989d35fb6f99980ae3a0d7b2c4e5659a60f32208a9b6a3",
"md5": "2c536c55ec7c4f0fa306a8c4ed9e1684",
"sha256": "a1e8936553018273d08ed44b3d5c417b0159baa8ccee54bdef58296fb75156d6"
},
"downloads": -1,
"filename": "zpp_args-1.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c536c55ec7c4f0fa306a8c4ed9e1684",
"packagetype": "bdist_wheel",
"python_version": "source",
"requires_python": null,
"size": 6311,
"upload_time": "2024-09-11T09:34:17",
"upload_time_iso_8601": "2024-09-11T09:34:17.886240Z",
"url": "https://files.pythonhosted.org/packages/dd/bd/8984ce1bf18455989d35fb6f99980ae3a0d7b2c4e5659a60f32208a9b6a3/zpp_args-1.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9b6c2396a49d7e7756e9de7e12c7cf38f5a9c32f9ca661595f13655cbeb96cb8",
"md5": "faacb632055359c877b2fbbc7a732858",
"sha256": "de9a363faa28ee22e07f371011c8c746c7e7885efe1f90a103eea5daa6506c68"
},
"downloads": -1,
"filename": "zpp_args-1.3.4.tar.gz",
"has_sig": false,
"md5_digest": "faacb632055359c877b2fbbc7a732858",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5828,
"upload_time": "2024-09-11T09:34:19",
"upload_time_iso_8601": "2024-09-11T09:34:19.491823Z",
"url": "https://files.pythonhosted.org/packages/9b/6c/2396a49d7e7756e9de7e12c7cf38f5a9c32f9ca661595f13655cbeb96cb8/zpp_args-1.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-11 09:34:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ZephyrOff",
"github_project": "zpp_args",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "zpp_args"
}
JSON
