pymox-tools 0.0.0__tar.gz

pymox_tools-0.0.0/.env_example

@@ -0,0 +1,2 @@
+GH_TOKEN=ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXX
+PYPI_TOKEN=pypi-XXXXXXXXXXXXXXXXXXXXXXXXXXXX

pymox_tools-0.0.0/.github/workflows/publish.yml

@@ -0,0 +1,57 @@
+name: Semantic Release
+
+on:
+  push:
+    branches:
+      - main
+    # tags:
+    #   - 'v*' # Pour ne publier PyPI que les tag numérotés faits à la main
+
+jobs:
+  build-and-publish:
+    name: Run semantic-release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install python-semantic-release build twine setuptools_scm
+
+      - name: Run semantic-release
+        env:
+          GH_TOKEN: ${{ secrets.SEMANTIC_RELEASE }}
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          semantic-release version
+          semantic-release publish
+
+      - name: Re-checkout after tagging
+        run: |
+          git fetch --tags
+          git checkout $(git describe --tags --abbrev=0)
+
+      - name: Clean dist folder
+        run: rm -rf dist/
+
+      - name: Build the package
+        # env:
+        #   SETUPTOOLS_SCM_PRETEND_VERSION: ${{ steps.get_tag.outputs.tag }}
+        run: python -m build
+
+      - name: Publish to PyPI
+        # if: success()  # ou if: steps.semantic-release.outcome == 'success'
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: twine upload dist/*

pymox_tools-0.0.0/.gitignore

@@ -0,0 +1,32 @@
+.env
+# Byte-compiled / optimized / DLL files
+**/__pycache__
+**/.pytest_cache
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# virtual envs
+**/.venv/
+
+# GitHub
+# **/.github/
+
+# VSCode
+**/.vscode/
+
+# Coverage
+**/.coverage
+
+# truc bizarre
+**/.DS_Store
+
+# site construit
+site/
+_build/
+dist/
+src/*.egg-info/
+
+pws.txt
+src/gc7/_version.py
+CHANGE.LOG

pymox_tools-0.0.0/.zencoder/rules/repo.md

@@ -0,0 +1,86 @@
+---
+description: Repository Information Overview
+alwaysApply: true
+---
+
+# GC7 Information
+
+## Summary
+GC7 is a Python utility toolkit for PyMoX developers (PY-thon - MO-jo - Flet-X). The project is set up as a Python package that can be published to PyPI using semantic versioning. It uses GitHub Actions for automated releases and follows conventional commits for version management.
+
+## Structure
+- **src/gc7/**: Main package source code
+- **.github/workflows/**: CI/CD pipeline configurations
+- **.venv/**: Python virtual environment
+- **.zencoder/**: Configuration for Zencoder
+
+## Language & Runtime
+**Language**: Python
+**Version**: Python 3.10+
+**Build System**: setuptools
+**Package Manager**: pip
+
+## Dependencies
+**Main Dependencies**:
+- setuptools_scm: For version management
+- python-dotenv: For environment variable loading
+
+**Development Dependencies**:
+- python-semantic-release: For automated versioning and releases
+- build: For building Python packages
+- twine: For publishing to PyPI
+
+## Build & Installation
+```bash
+python -m venv .venv
+.\.venv\Scripts\activate
+pip install -r requirements.txt
+
+# Build package
+python -m build
+
+# Check distribution
+twine check dist/* --verbose
+
+# Upload to PyPI
+twine upload dist/* --verbose
+```
+
+## Version Management
+**Tool**: python-semantic-release
+**Configuration**: pyproject.toml
+**Version Source**: Git tags
+**Commands**:
+```bash
+# Check if a new version would be generated
+semantic-release --noop version
+
+# Create a new version locally
+semantic-release version --commit --tag --no-push
+
+# Publish a new version
+semantic-release publish
+```
+
+## CI/CD
+**Platform**: GitHub Actions
+**Workflow**: .github/workflows/publish.yml
+**Trigger**: Push to main branch
+**Process**:
+1. Checkout code
+2. Set up Python 3.10
+3. Install dependencies
+4. Run semantic-release to version and publish
+
+## Environment Variables
+**Required**:
+- GH_TOKEN: GitHub token for releases
+- PYPI_TOKEN: PyPI token for package publishing
+
+## Project Configuration
+**Package Structure**:
+- Dynamic versioning using setuptools_scm
+- Source code in src/gc7/
+- Requires Python 3.10+
+- Uses conventional commits for version management
+- Current version: v1.1.9 (as of 2025-08-02)

pymox_tools-0.0.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.6 (2025-08-04)
+
+### Bug Fixes
+
+- Try 1.0.6
+  ([`2738278`](https://github.com/PyMoX-fr/GC7/commit/2738278da8c7c33dac1ada54b33dafb04ca4a859))
+
+
+## v1.0.5 (2025-08-03)
+
+### Bug Fixes
+
+- Try v5
+  ([`a3054f8`](https://github.com/PyMoX-fr/GC7/commit/a3054f8608157acf7cfb1c98af8b68bf646c44a8))
+
+
+## v1.0.4 (2025-08-03)
+
+### Bug Fixes
+
+- Set local dev for tokens()
+  ([`3183e15`](https://github.com/PyMoX-fr/GC7/commit/3183e15b25687c51da31870827091a5e81f756ff))
+
+
+## v1.0.3 (2025-08-03)
+
+
+## v1.0.2 (2025-08-03)
+
+
+## v1.0.1 (2025-08-03)
+
+### Bug Fixes
+
+- Set hello()
+  ([`03efc80`](https://github.com/PyMoX-fr/GC7/commit/03efc8032804e20feadba5fd246e07c1bc133b4b))
+
+
+## v1.0.0 (2025-08-03)
+
+- Initial Release

pymox_tools-0.0.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: pymox_tools
+Version: 0.0.0
+Summary: Un module avec plein d'outils utiles pour devs en PyMoX (PY-thon - MO-jo - Flet-X)
+Author-email: GrCOTE7 <GrCOTE7@gmail.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv
+
+# PyMoX - GC7
+
+Trousse à outils utiles pour devs en PyMoX
+
+v1.06 2ème
+
+---
+
+## Rapide mémo
+
+```bash
+py -m venv .venv
+.\.venv\Scripts\activate
+pip install -r requirements.txt
+
+py -m build
+twine check dist/*
+twine upload dist/* --verbose
+
+git log --oneline
+
+semantic-release version
+semantic-release version --print
+
+semantic-release publish
+
+semantic-release --noop version
+Cela te dira si une version serait générée.
+
+semantic-release version --commit --tag --no-push
+
+Cela va :
+Lire les commits
+Calculer la prochaine version (ex: 0.2.0)
+Modifier __version__ dans gc7/__init__.py
+Créer un commit et un tag localement
+
+Remove-Item -Recurse -Force dist, src/gc7/gc7.egg-info
+
+git commit --allow-empty -m "feat: add dummy feature for version bump"
+git commit --allow-empty -m "fix: déclenchement de la release 1.0.1" 
+git push origin main
+
+voir conventional commits: https://www.conventionalcommits.org/en/v1.0.0/
+
+En cas de volonté de revenir sur une version précédente (Problème avec PyPI: Interdit de reculer):
+git revert <hash du commit> (pour ramener la main du dépôt GH)
+dans le __ini__.py, mettre : __version__='x.y.z' (> au dernier de PyPI)
+refaire le build + renvoi:
+py -m build    
+twine upload dist/*
+
+Désinstaller tous les packages de l'env global :
+pip freeze | ForEach-Object { pip uninstall -y $_ }
+
+# 1. Crée une branche temporaire pour garder les fichiers
+git checkout --orphan temp_branch
+
+# 2. Ajoute tous les fichiers à cette nouvelle branche
+git add .
+
+# 3. Fais un commit initial
+git commit -m "Initial commit"
+
+# 4. Supprime l'ancienne branche main
+git branch -D main
+
+# 5. Renomme la branche temporaire en main
+git branch -m main
+
+# 6. Force le push vers GitHub (⚠️ cela écrase l’historique distant)
+git push -f origin main
+
+git log main --decorate --oneline
+
+---
+
+from pymox_tools1 import greetings as gt
+from pymox_tools1 import tokens as tk
+
+if __name__ == "__main__":
+    tk.tokens()
+    print(gt.hello(), "\n" + gt.bye())
+
+```

pymox_tools-0.0.0/README.md

@@ -0,0 +1,85 @@
+# PyMoX - GC7
+
+Trousse à outils utiles pour devs en PyMoX
+
+v1.06 2ème
+
+---
+
+## Rapide mémo
+
+```bash
+py -m venv .venv
+.\.venv\Scripts\activate
+pip install -r requirements.txt
+
+py -m build
+twine check dist/*
+twine upload dist/* --verbose
+
+git log --oneline
+
+semantic-release version
+semantic-release version --print
+
+semantic-release publish
+
+semantic-release --noop version
+Cela te dira si une version serait générée.
+
+semantic-release version --commit --tag --no-push
+
+Cela va :
+Lire les commits
+Calculer la prochaine version (ex: 0.2.0)
+Modifier __version__ dans gc7/__init__.py
+Créer un commit et un tag localement
+
+Remove-Item -Recurse -Force dist, src/gc7/gc7.egg-info
+
+git commit --allow-empty -m "feat: add dummy feature for version bump"
+git commit --allow-empty -m "fix: déclenchement de la release 1.0.1" 
+git push origin main
+
+voir conventional commits: https://www.conventionalcommits.org/en/v1.0.0/
+
+En cas de volonté de revenir sur une version précédente (Problème avec PyPI: Interdit de reculer):
+git revert <hash du commit> (pour ramener la main du dépôt GH)
+dans le __ini__.py, mettre : __version__='x.y.z' (> au dernier de PyPI)
+refaire le build + renvoi:
+py -m build    
+twine upload dist/*
+
+Désinstaller tous les packages de l'env global :
+pip freeze | ForEach-Object { pip uninstall -y $_ }
+
+# 1. Crée une branche temporaire pour garder les fichiers
+git checkout --orphan temp_branch
+
+# 2. Ajoute tous les fichiers à cette nouvelle branche
+git add .
+
+# 3. Fais un commit initial
+git commit -m "Initial commit"
+
+# 4. Supprime l'ancienne branche main
+git branch -D main
+
+# 5. Renomme la branche temporaire en main
+git branch -m main
+
+# 6. Force le push vers GitHub (⚠️ cela écrase l’historique distant)
+git push -f origin main
+
+git log main --decorate --oneline
+
+---
+
+from pymox_tools1 import greetings as gt
+from pymox_tools1 import tokens as tk
+
+if __name__ == "__main__":
+    tk.tokens()
+    print(gt.hello(), "\n" + gt.bye())
+
+```

pymox_tools-0.0.0/pyproject.toml

@@ -0,0 +1,71 @@
+[project]
+name = "pymox_tools"
+dynamic = ["version"]
+# version = "v0.1.2"  # sera géré automatiquement par semantic-release
+# version = "0.0.6"  # valeur placeholder, ignorée par semantic-release
+description = "Un module avec plein d'outils utiles pour devs en PyMoX (PY-thon - MO-jo - Flet-X)"
+authors = [{ name = "GrCOTE7", email = "GrCOTE7@gmail.com" }]
+# readme = {file = "README.md", encoding = "utf-8"}
+readme = "README.md"
+# readme = {file = "README.md", content-type = "text/markdown", encoding = "utf-8"}
+license = "MIT"
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+dependencies = [
+  # Ajoute ici tes dépendances, ex:
+  # "requests >=2.0.0"
+  "python-dotenv",
+  # "setuptools_scm"
+]
+requires-python = ">=3.10"
+
+[build-system]
+requires = ["setuptools>=77.0.0", "setuptools_scm", "wheel"]
+# requires = ["setuptools>=61.0", "setuptools_scm>=7.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.semantic_release]
+tag_format = "v{version}"
+version_variable = "src/pymox_tools1/__init__.py:__version__"
+repository = "https://github.com/PyMoX-fr/GC7"
+hvcs = "github"
+github_token = "env:GH_TOKEN"
+
+pypi_token = "env:PYPI_TOKEN"
+version_source = "tag"
+build_command = "python -m build"
+log_level = "DEBUG"
+
+
+upload_sdist = true          # publie également le source distribution sur PyPI
+upload_wheel = true          # publie également le wheel sur PyPI
+verify_release_commit = true
+
+# commit_version_number = true
+# commit_message = "chore(release): version {version}"
+
+branch = "main"                # branch de travail
+# commit_parser = "conventional" # essayer emoji
+# commit_parser = "semantic_release.commit_parser.emoji:parse_commit_message:"
+
+
+# upload_to_repository = true # active la publication sur PyPI
+# upload_to_pypi = true       # active la publication sur PyPI
+
+# [tool.semantic_release.changelog.default_templates]
+# changelog_file = "CHANGELOG.md"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+packages = ["pymox_tools1"]           # dossier Python
+
+[tool.setuptools.package-data]
+"*" = ["*.txt", "*.json"] # si tu as des fichiers à inclure
+
+# version_scheme = "release-branch-semver" # empêche les suffixes .devX ou .dirty
+# [tool.setuptools_scm]
+# # local_scheme = "no-local-version"
+# tag_regex = "^v?(?P<version>[0-9]+(\\.[0-9]+)+)$"
+# write_to = "src/pymox_tools1/_version.py"

pymox_tools-0.0.0/set_semantic.sh

@@ -0,0 +1,20 @@
+mkdir test-semantic
+cd test-semantic
+python -m venv .venv
+.venv\Scripts\activate  # ou source .venv/bin/activate sur Unix
+pip install python-semantic-release build
+
+mkdir testpkg
+echo '__version__ = "0.1.0"' > testpkg/__init__.py
+
+echo '''
+[tool.semantic_release]
+version_variable = "testpkg/__init__.py:__version__"
+build_command = "python -m build"
+upload_to_pypi = false
+log_level = "DEBUG"
+''' > pyproject.toml
+
+git init
+git add .
+git commit -m "feat: initial commit"

pymox_tools-0.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pymox_tools-0.0.0/src/pymox_tools.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: pymox_tools
+Version: 0.0.0
+Summary: Un module avec plein d'outils utiles pour devs en PyMoX (PY-thon - MO-jo - Flet-X)
+Author-email: GrCOTE7 <GrCOTE7@gmail.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv
+
+# PyMoX - GC7
+
+Trousse à outils utiles pour devs en PyMoX
+
+v1.06 2ème
+
+---
+
+## Rapide mémo
+
+```bash
+py -m venv .venv
+.\.venv\Scripts\activate
+pip install -r requirements.txt
+
+py -m build
+twine check dist/*
+twine upload dist/* --verbose
+
+git log --oneline
+
+semantic-release version
+semantic-release version --print
+
+semantic-release publish
+
+semantic-release --noop version
+Cela te dira si une version serait générée.
+
+semantic-release version --commit --tag --no-push
+
+Cela va :
+Lire les commits
+Calculer la prochaine version (ex: 0.2.0)
+Modifier __version__ dans gc7/__init__.py
+Créer un commit et un tag localement
+
+Remove-Item -Recurse -Force dist, src/gc7/gc7.egg-info
+
+git commit --allow-empty -m "feat: add dummy feature for version bump"
+git commit --allow-empty -m "fix: déclenchement de la release 1.0.1" 
+git push origin main
+
+voir conventional commits: https://www.conventionalcommits.org/en/v1.0.0/
+
+En cas de volonté de revenir sur une version précédente (Problème avec PyPI: Interdit de reculer):
+git revert <hash du commit> (pour ramener la main du dépôt GH)
+dans le __ini__.py, mettre : __version__='x.y.z' (> au dernier de PyPI)
+refaire le build + renvoi:
+py -m build    
+twine upload dist/*
+
+Désinstaller tous les packages de l'env global :
+pip freeze | ForEach-Object { pip uninstall -y $_ }
+
+# 1. Crée une branche temporaire pour garder les fichiers
+git checkout --orphan temp_branch
+
+# 2. Ajoute tous les fichiers à cette nouvelle branche
+git add .
+
+# 3. Fais un commit initial
+git commit -m "Initial commit"
+
+# 4. Supprime l'ancienne branche main
+git branch -D main
+
+# 5. Renomme la branche temporaire en main
+git branch -m main
+
+# 6. Force le push vers GitHub (⚠️ cela écrase l’historique distant)
+git push -f origin main
+
+git log main --decorate --oneline
+
+---
+
+from pymox_tools1 import greetings as gt
+from pymox_tools1 import tokens as tk
+
+if __name__ == "__main__":
+    tk.tokens()
+    print(gt.hello(), "\n" + gt.bye())
+
+```

pymox_tools-0.0.0/src/pymox_tools.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+.env_example
+.gitignore
+CHANGELOG.md
+README.md
+pyproject.toml
+requirements.txt
+set_semantic.sh
+teste_write_version.py
+.github/workflows/publish.yml
+.zencoder/rules/repo.md
+src/pymox_tools.egg-info/PKG-INFO
+src/pymox_tools.egg-info/SOURCES.txt
+src/pymox_tools.egg-info/dependency_links.txt
+src/pymox_tools.egg-info/requires.txt
+src/pymox_tools.egg-info/top_level.txt
+src/pymox_tools1/__init__.py
+src/pymox_tools1/commits_semantic.md
+src/pymox_tools1/compare_keys.py
+src/pymox_tools1/convert_readme.py
+src/pymox_tools1/greetings.py
+src/pymox_tools1/tokens.py

pymox_tools-0.0.0/src/pymox_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pymox_tools-0.0.0/src/pymox_tools.egg-info/requires.txt

@@ -0,0 +1 @@
+python-dotenv

pymox_tools-0.0.0/src/pymox_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+pymox_tools1

pymox_tools-0.0.0/src/pymox_tools1/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.0"

pymox_tools-0.0.0/src/pymox_tools1/commits_semantic.md

@@ -0,0 +1,22 @@
+### 📦 Version SemVer : MAJOR.MINOR.PATCH
+
+| Type de changement          | Préfixe anglais           | Traduction française                               | Incrément                       |
+|-----------------------------|---------------------------|----------------------------------------------------|---------------------------------|
+| 🧨 Rupture de compatibilité | `BREAKING CHANGE:` ou `!` | Changement majeur (rupture API, suppression, etc.) | **MAJOR** (ex: `1.2.3 → 2.0.0`) |
+| ✨ Nouvelle fonctionnalité   | `feat:`                   | Fonctionnalité (ajout sans rupture)                | **MINOR** (ex: `1.2.3 → 1.3.0`) |
+| 🐛 Correction de bug        | `fix:`                    | Correction (bug, typo, etc.)                       | **PATCH** (ex: `1.2.3 → 1.2.4`) |
+
+
+### 🧠 Autres types de commits (ne changent pas la version)
+
+| Préfixe anglais | Traduction française           | Impact sur version                                          |
+|-----------------|--------------------------------|-------------------------------------------------------------|
+| `docs:`         | Documentation                  | Aucun                                                       |
+| `style:`        | Formatage (indentation, etc.)  | Aucun                                                       |
+| `refactor:`     | Refactorisation                | Aucun                                                       |
+| `perf:`         | Optimisation de performance    | Aucun                                                       |
+| `test:`         | Ajout ou modification de tests | Aucun                                                       |
+| `chore:`        | Tâches diverses                | Aucun                                                       |
+| `ci:`           | Intégration continue           | Aucun                                                       |
+| `build:`        | Configuration de build         | Aucun                                                       |
+| `revert:`       | Annulation d’un commit         | Aucun (sauf si le commit annulé était un `feat:` ou `fix:`) |

pymox_tools-0.0.0/src/pymox_tools1/compare_keys.py

@@ -0,0 +1,28 @@
+import os
+from dotenv import dotenv_values, load_dotenv
+
+# Charge les variables du fichier .env
+env_file_values = dotenv_values(".env")  # dict sans override
+load_dotenv(override=False)  # ne modifie pas l'environnement
+
+# Variables d'environnement actuelles
+env_runtime_values = {
+    "GH_TOKEN": os.getenv("GH_TOKEN"),
+    "PYPI_TOKEN": os.getenv("PYPI_TOKEN"),
+}
+
+# Comparaison
+print("\n🔍 Comparaison des clés GH_TOKEN et PYPI_TOKEN\n")
+
+for key in ["GH_TOKEN", "PYPI_TOKEN"]:
+    file_val = env_file_values.get(key)
+    env_val = env_runtime_values.get(key)
+
+    if file_val == env_val:
+        print(f"✅ {key} est identique dans .env et l'environnement")
+    else:
+        print(f"❌ {key} est différent !")
+        print(f"    .env        : {file_val}")
+        print(f"    environnement : {env_val}")
+
+print("\n" + "-" * 60)

pymox_tools-0.0.0/src/pymox_tools1/convert_readme.py

@@ -0,0 +1,6 @@
+# convert_readme.py
+with open("README.md", "r", encoding="cp1252", errors="replace") as f:
+    content = f.read()
+
+with open("README2.md", "w", encoding="utf-8") as f:
+    f.write(content)

pymox_tools-0.0.0/src/pymox_tools1/greetings.py

@@ -0,0 +1,10 @@
+def hello():
+    return f"Salut les gens !"
+
+
+def bye():
+    return f"Bye-bye les gens !"
+
+
+if __name__ == "__main__":
+    print(hello(), "\n" + bye())

pymox_tools-0.0.0/src/pymox_tools1/tokens.py

@@ -0,0 +1,26 @@
+def tokens():
+    from setuptools_scm import get_version
+
+    print("\nDernière version pymox_tools1: " + get_version() + "\n" + ("-" * 71))
+    from dotenv import load_dotenv
+    import os
+
+    load_dotenv()  # Charge les variables depuis .env
+    # load_dotenv(override=True)
+
+    gh_token = os.getenv("GH_TOKEN")
+    pypi_token = os.getenv("PYPI_TOKEN")
+
+    print(f"GH_TOKEN: {gh_token}\n\nPYPI_TOKEN: {pypi_token}\n")
+
+    return f"Salut les gens !"
+
+
+if __name__ == "__main__":
+
+    tokens()
+
+    # import greetings as gt
+    from pymox_tools1 import greetings as gt
+
+    print(gt.hello(), "\n" + gt.bye())

pymox_tools-0.0.0/teste_write_version.py

@@ -0,0 +1,10 @@
+import re
+
+with open("gc7/__init__.py", "r+") as f:
+    content = f.read()
+    content = re.sub(
+        r'__version__\s*=\s*["\'].*?["\']', '__version__ = "1.1.0"', content
+    )
+    f.seek(0)
+    f.write(content)
+    f.truncate()