tgbotstat


Nametgbotstat JSON
Version 1.0.1 PyPI version JSON
download
home_pagehttps://github.com/codingtuto/tgbotstat
SummaryUn outil pour suivre les statistiques d'utilisation des commandes d'un bot Telegram.
upload_time2023-10-02 17:01:40
maintainer
docs_urlNone
authorCoding Team
requires_python
license
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # tgbotstat

**tgbotstat** est un package Python qui vous permet de suivre et d'enregistrer des statistiques d'utilisation de votre bot Telegram. Il peut enregistrer le nombre d'utilisations de chaque commande, les utilisateurs qui ont utilisé ces commandes, les heures auxquelles les commandes sont utilisées, et plus encore.

## Installation

Vous pouvez installer **tgbotstat** à l'aide de `pip`. Assurez-vous d'avoir `pip` installé, puis exécutez la commande suivante :

```bash
pip install tgbotstat
```

# Utilisation

Une fois que vous avez installé **tgbotstat**, vous pouvez l'importer dans votre code Python pour suivre et enregistrer des statistiques d'utilisation. Voici comment vous pouvez l'utiliser dans votre projet :

```python
from tgbotstat import *

# Charger les statistiques existantes
statistiques = charger_statistiques()

# Mettre à jour les statistiques pour une commande
commande = "/start"
user_id = 12345
heure_commande = "14"
jour_semaine = "Lundi"
mettre_a_jour_statistiques_commande(statistiques, commande, user_id, heure_commande, jour_semaine)

# Enregistrer de nouvelles statistiques
sauvegarder_statistiques(statistiques)

# Afficher les données d'utilisation
stats_text = "Statistiques d'utilisation des commandes:\n"
for date, commands in statistiques['commands'].items():
    stats_text += f"\nDate: {date}\n"
    for command, data in commands.items():
        nombre_utilisations = data['nombre_utilisations']
        utilisateurs_commande = len(data['utilisateurs'])
        heures = data.get('heures', {})
        heures_text = ', '.join([f"{heure}: {utilisations} utilisations" for heure, utilisations in heures.items()])
        stats_text += f"- {command} : {nombre_utilisations} utilisations par {utilisateurs_commande} utilisateurs ({heures_text})\n"

print(stats_text)
```

Vous pouvez également utiliser d'autres fonctions et classes exposées par le package, telles que **charger_utilisateurs**, **enregistrer_utilisateur**, **suivre_commandes_populaires**, etc., pour personnaliser vos statistiques en fonction de vos besoins.

# Contribution

Les contributions sont les bienvenues ! Si vous souhaitez améliorer tgbotstat ou ajouter de nouvelles fonctionnalités, n'hésitez pas à ouvrir une demande d'extraction (Pull Request) ou à signaler des problèmes (Issues) sur https://github.com/codingtuto/tgbotstat.

## Travail prévu

Nous prévoyons d'ajouter plusieurs fonctionnalités et améliorations à `tgbotstat` dans les futures versions. Voici un aperçu des travaux prévus :

- Ajout d'un système de génération de statistiques sous forme de graphiques pour une visualisation plus conviviale des données d'utilisation.
- Extension des données analytiques pour fournir des informations plus détaillées sur l'utilisation des commandes.
- Prise en charge de la personnalisation des statistiques, notamment la possibilité de définir des plages de dates personnalisées pour l'analyse.
- Améliorations de la gestion des utilisateurs, y compris la possibilité de suivre les comportements individuels des utilisateurs.
- Documentation étendue avec des exemples d'utilisation avancés.
- Correction de bugs et optimisations de performances.

Nous sommes ouverts aux suggestions de la communauté et aux contributions. Si vous avez des idées d'améliorations ou de nouvelles fonctionnalités que vous aimeriez voir dans `tgbotstat`, n'hésitez pas à ouvrir une issue ou à proposer une pull request sur notre [repository GitHub](https://github.com/codingtuto/tgbotstat).

N'hésitez pas à suivre notre développement et à contribuer à l'amélioration de ce package. Nous sommes impatients de voir comment `tgbotstat` évoluera à l'avenir !

# License

Ce projet est sous licence MIT. Pour plus d'informations, consultez le fichier LICENSE.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/codingtuto/tgbotstat",
    "name": "tgbotstat",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "Coding Team",
    "author_email": "codingteam@telegmail.com",
    "download_url": "https://files.pythonhosted.org/packages/5b/fd/2bf7ace87f16ba7f67a779d4b6e3eed1399a58415f3aed574b1dec8de575/tgbotstat-1.0.1.tar.gz",
    "platform": null,
    "description": "# tgbotstat\n\n**tgbotstat** est un package Python qui vous permet de suivre et d'enregistrer des statistiques d'utilisation de votre bot Telegram. Il peut enregistrer le nombre d'utilisations de chaque commande, les utilisateurs qui ont utilis\u00e9 ces commandes, les heures auxquelles les commandes sont utilis\u00e9es, et plus encore.\n\n## Installation\n\nVous pouvez installer **tgbotstat** \u00e0 l'aide de `pip`. Assurez-vous d'avoir `pip` install\u00e9, puis ex\u00e9cutez la commande suivante :\n\n```bash\npip install tgbotstat\n```\n\n# Utilisation\n\nUne fois que vous avez install\u00e9 **tgbotstat**, vous pouvez l'importer dans votre code Python pour suivre et enregistrer des statistiques d'utilisation. Voici comment vous pouvez l'utiliser dans votre projet :\n\n```python\nfrom tgbotstat import *\n\n# Charger les statistiques existantes\nstatistiques = charger_statistiques()\n\n# Mettre \u00e0 jour les statistiques pour une commande\ncommande = \"/start\"\nuser_id = 12345\nheure_commande = \"14\"\njour_semaine = \"Lundi\"\nmettre_a_jour_statistiques_commande(statistiques, commande, user_id, heure_commande, jour_semaine)\n\n# Enregistrer de nouvelles statistiques\nsauvegarder_statistiques(statistiques)\n\n# Afficher les donn\u00e9es d'utilisation\nstats_text = \"Statistiques d'utilisation des commandes:\\n\"\nfor date, commands in statistiques['commands'].items():\n    stats_text += f\"\\nDate: {date}\\n\"\n    for command, data in commands.items():\n        nombre_utilisations = data['nombre_utilisations']\n        utilisateurs_commande = len(data['utilisateurs'])\n        heures = data.get('heures', {})\n        heures_text = ', '.join([f\"{heure}: {utilisations} utilisations\" for heure, utilisations in heures.items()])\n        stats_text += f\"- {command} : {nombre_utilisations} utilisations par {utilisateurs_commande} utilisateurs ({heures_text})\\n\"\n\nprint(stats_text)\n```\n\nVous pouvez \u00e9galement utiliser d'autres fonctions et classes expos\u00e9es par le package, telles que **charger_utilisateurs**, **enregistrer_utilisateur**, **suivre_commandes_populaires**, etc., pour personnaliser vos statistiques en fonction de vos besoins.\n\n# Contribution\n\nLes contributions sont les bienvenues ! Si vous souhaitez am\u00e9liorer tgbotstat ou ajouter de nouvelles fonctionnalit\u00e9s, n'h\u00e9sitez pas \u00e0 ouvrir une demande d'extraction (Pull Request) ou \u00e0 signaler des probl\u00e8mes (Issues) sur https://github.com/codingtuto/tgbotstat.\n\n## Travail pr\u00e9vu\n\nNous pr\u00e9voyons d'ajouter plusieurs fonctionnalit\u00e9s et am\u00e9liorations \u00e0 `tgbotstat` dans les futures versions. Voici un aper\u00e7u des travaux pr\u00e9vus :\n\n- Ajout d'un syst\u00e8me de g\u00e9n\u00e9ration de statistiques sous forme de graphiques pour une visualisation plus conviviale des donn\u00e9es d'utilisation.\n- Extension des donn\u00e9es analytiques pour fournir des informations plus d\u00e9taill\u00e9es sur l'utilisation des commandes.\n- Prise en charge de la personnalisation des statistiques, notamment la possibilit\u00e9 de d\u00e9finir des plages de dates personnalis\u00e9es pour l'analyse.\n- Am\u00e9liorations de la gestion des utilisateurs, y compris la possibilit\u00e9 de suivre les comportements individuels des utilisateurs.\n- Documentation \u00e9tendue avec des exemples d'utilisation avanc\u00e9s.\n- Correction de bugs et optimisations de performances.\n\nNous sommes ouverts aux suggestions de la communaut\u00e9 et aux contributions. Si vous avez des id\u00e9es d'am\u00e9liorations ou de nouvelles fonctionnalit\u00e9s que vous aimeriez voir dans `tgbotstat`, n'h\u00e9sitez pas \u00e0 ouvrir une issue ou \u00e0 proposer une pull request sur notre [repository GitHub](https://github.com/codingtuto/tgbotstat).\n\nN'h\u00e9sitez pas \u00e0 suivre notre d\u00e9veloppement et \u00e0 contribuer \u00e0 l'am\u00e9lioration de ce package. Nous sommes impatients de voir comment `tgbotstat` \u00e9voluera \u00e0 l'avenir !\n\n# License\n\nCe projet est sous licence MIT. Pour plus d'informations, consultez le fichier LICENSE.\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Un outil pour suivre les statistiques d'utilisation des commandes d'un bot Telegram.",
    "version": "1.0.1",
    "project_urls": {
        "Homepage": "https://github.com/codingtuto/tgbotstat"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2ac6648e3df793f24a5fd4c6cc2caa44c26baddb291716377972b87132e6e32c",
                "md5": "6d11c027c8a036547dae80e283608b7c",
                "sha256": "82c01ee6e117dcc7b2234bff895afb27f9bf69061db98fb1caaba225328b9dd4"
            },
            "downloads": -1,
            "filename": "tgbotstat-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6d11c027c8a036547dae80e283608b7c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 4991,
            "upload_time": "2023-10-02T17:01:36",
            "upload_time_iso_8601": "2023-10-02T17:01:36.732554Z",
            "url": "https://files.pythonhosted.org/packages/2a/c6/648e3df793f24a5fd4c6cc2caa44c26baddb291716377972b87132e6e32c/tgbotstat-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5bfd2bf7ace87f16ba7f67a779d4b6e3eed1399a58415f3aed574b1dec8de575",
                "md5": "3dd424ba6b9e55eec6df1d728550c860",
                "sha256": "1b12d4ff3b2f27965e73c04166deabdadcbf8e31cbdc38a3dc4852b34b00483f"
            },
            "downloads": -1,
            "filename": "tgbotstat-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "3dd424ba6b9e55eec6df1d728550c860",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4670,
            "upload_time": "2023-10-02T17:01:40",
            "upload_time_iso_8601": "2023-10-02T17:01:40.849962Z",
            "url": "https://files.pythonhosted.org/packages/5b/fd/2bf7ace87f16ba7f67a779d4b6e3eed1399a58415f3aed574b1dec8de575/tgbotstat-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-02 17:01:40",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "codingtuto",
    "github_project": "tgbotstat",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "tgbotstat"
}
        
Elapsed time: 0.16453s