{"id":21474273,"url":"https://github.com/codingtuto/tgbotstat","last_synced_at":"2025-08-04T08:39:49.840Z","repository":{"id":197792553,"uuid":"699405944","full_name":"codingtuto/tgbotstat","owner":"codingtuto","description":"Un outil pour suivre les statistiques d'utilisation des commandes d'un bot Telegram.","archived":false,"fork":false,"pushed_at":"2023-10-02T17:10:07.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-12T03:51:40.723Z","etag":null,"topics":["pypi-package","python","statistics","telegram-bot"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/tgbotstat/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codingtuto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-02T15:11:51.000Z","updated_at":"2023-10-02T16:14:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"c8b7e448-d93c-41d8-b118-66a0416aecb1","html_url":"https://github.com/codingtuto/tgbotstat","commit_stats":null,"previous_names":["codingtuto/tgbotstat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codingtuto/tgbotstat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingtuto%2Ftgbotstat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingtuto%2Ftgbotstat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingtuto%2Ftgbotstat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingtuto%2Ftgbotstat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codingtuto","download_url":"https://codeload.github.com/codingtuto/tgbotstat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingtuto%2Ftgbotstat/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268671957,"owners_count":24288242,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pypi-package","python","statistics","telegram-bot"],"created_at":"2024-11-23T10:21:34.690Z","updated_at":"2025-08-04T08:39:49.813Z","avatar_url":"https://github.com/codingtuto.png","language":"Python","readme":"# 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é ces commandes, les heures auxquelles les commandes sont utilisées, et plus encore.\n\n## Installation\n\nVous pouvez installer **tgbotstat** à l'aide de `pip`. Assurez-vous d'avoir `pip` installé, puis exécutez la commande suivante :\n\n```bash\npip install tgbotstat\n```\n\n# Utilisation\n\nUne 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 :\n\n```python\nfrom tgbotstat import *\n\n# Charger les statistiques existantes\nstatistiques = charger_statistiques()\n\n# Mettre à 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ées 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 é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.\n\n# Contribution\n\nLes 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.\n\n## Travail prévu\n\nNous prévoyons d'ajouter plusieurs fonctionnalités et améliorations à `tgbotstat` dans les futures versions. Voici un aperçu des travaux prévus :\n\n- 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.\n- Extension des données analytiques pour fournir des informations plus détaillées sur l'utilisation des commandes.\n- Prise en charge de la personnalisation des statistiques, notamment la possibilité de définir des plages de dates personnalisées pour l'analyse.\n- Améliorations de la gestion des utilisateurs, y compris la possibilité de suivre les comportements individuels des utilisateurs.\n- Documentation étendue avec des exemples d'utilisation avancés.\n- Correction de bugs et optimisations de performances.\n\nNous 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\nN'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 !\n\n# License\n\nCe projet est sous licence MIT. Pour plus d'informations, consultez le fichier LICENSE.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingtuto%2Ftgbotstat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodingtuto%2Ftgbotstat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingtuto%2Ftgbotstat/lists"}