oktopios-orm 0.1.0__py3-none-any.whl

oktopios_orm/__init__.py

@@ -0,0 +1,2 @@
+"""oktopios-orm — ORM pour le langage Oktopios."""
+__version__ = "0.1.0"

oktopios_orm/orm.okp

@@ -0,0 +1,179 @@
+// =====================================================================
+//  oktopios-framework — Couche ORM
+//  Écrit EN Oktopios, s'appuie sur la réflexion et les décorateurs du
+//  langage (>= 0.6.0). Chargé via :  use "framework/orm.okp"
+//
+//  - Schema : migrations (génère le schéma SQL depuis les modèles décorés)
+//  - Repo   : dépôt générique (save / all / findBy / remove + hydratation)
+//  - Query  : constructeur de requêtes fluide
+//
+//  Décorateurs reconnus :
+//    @Entity("table")   (classe)  -> nom de table
+//    @Column("colonne") (champ)   -> nom de colonne
+//    @Id                (champ)   -> clé primaire
+// =====================================================================
+inject Type
+inject DataImport
+
+// ---------------------------------------------------------------------
+//  Schema — génération de schéma / migrations
+// ---------------------------------------------------------------------
+class Schema {
+    fun sqlType(t: string): string {
+        if (t == "int")   { return "INTEGER" }
+        if (t == "float") { return "REAL" }
+        if (t == "bool")  { return "INTEGER" }
+        return "TEXT"
+    }
+
+    fun tableName(entity: any): string {
+        var e = Type.annotation(entity, "Entity")
+        if (e != null) { return e[0] }
+        return Type.className(entity)
+    }
+
+    fun columnName(entity: any, champ: string): string {
+        var c = Type.fieldAnnotation(entity, champ, "Column")
+        if (c != null) { return c[0] }
+        return champ
+    }
+
+    fun idField(entity: any): string {
+        for (f in Type.fields(entity)) {
+            if (Type.fieldAnnotation(entity, f, "Id") != null) { return f }
+        }
+        return "id"
+    }
+
+    fun createTableSQL(entity: any): string {
+        var defs = ""
+        for (f in Type.fields(entity)) {
+            if (defs != "") { defs = defs + ", " }
+            var ligne = this.columnName(entity, f) + " " + this.sqlType(Type.fieldType(entity, f))
+            if (Type.fieldAnnotation(entity, f, "Id") != null) {
+                ligne = ligne + " PRIMARY KEY"
+            }
+            defs = defs + ligne
+        }
+        return "CREATE TABLE IF NOT EXISTS " + this.tableName(entity) + " (" + defs + ")"
+    }
+
+    // Crée la table dans la base à partir d'un exemple d'entité (modèle décoré)
+    fun migrate(db: string, entity: any): string {
+        var sql = this.createTableSQL(entity)
+        DataImport.execSQL(db, sql, [])
+        return sql
+    }
+}
+
+// ---------------------------------------------------------------------
+//  Repo — dépôt de données générique pour un modèle
+// ---------------------------------------------------------------------
+class Repo {
+    var db: string
+    var table: string
+    var model: string
+    var schema: Schema
+
+    // `sample` : une instance du modèle, utilisée pour lire les métadonnées
+    fun __construct(db: string, sample: any) {
+        this.db = db
+        this.schema = new Schema()
+        this.table = this.schema.tableName(sample)
+        this.model = Type.className(sample)
+    }
+
+    fun save(entity: any): int {
+        var colonnes = ""
+        var marques = ""
+        var valeurs = []
+        for (f in Type.fields(entity)) {
+            if (colonnes != "") {
+                colonnes = colonnes + ", "
+                marques = marques + ", "
+            }
+            colonnes = colonnes + this.schema.columnName(entity, f)
+            marques = marques + "?"
+            valeurs = valeurs + [Type.get(entity, f)]
+        }
+        var sql = "INSERT INTO " + this.table + " (" + colonnes + ") VALUES (" + marques + ")"
+        return DataImport.execSQL(this.db, sql, valeurs)
+    }
+
+    // Transforme les lignes SQL (colonnes) en instances du modèle (champs)
+    fun hydrate(lignes: any): any {
+        var objets = []
+        for (ligne in lignes) {
+            var obj = Type.create(this.model)
+            for (f in Type.fields(obj)) {
+                var col = this.schema.columnName(obj, f)
+                Type.set(obj, f, ligne[col])
+            }
+            objets = objets + [obj]
+        }
+        return objets
+    }
+
+    fun all(): any {
+        return this.hydrate(DataImport.execSQL(this.db, "SELECT * FROM " + this.table, []))
+    }
+
+    fun findBy(colonne: string, valeur: any): any {
+        var sql = "SELECT * FROM " + this.table + " WHERE " + colonne + " = ?"
+        return this.hydrate(DataImport.execSQL(this.db, sql, [valeur]))
+    }
+
+    fun remove(colonne: string, valeur: any): int {
+        var sql = "DELETE FROM " + this.table + " WHERE " + colonne + " = ?"
+        return DataImport.execSQL(this.db, sql, [valeur])
+    }
+}
+
+// ---------------------------------------------------------------------
+//  Query — constructeur de requêtes fluide
+// ---------------------------------------------------------------------
+class Query {
+    var db: string
+    var table: string
+    var champs: string
+    var conds: string
+    var params: any
+    var ordre: string
+
+    fun __construct(db: string, table: string) {
+        this.db = db
+        this.table = table
+        this.champs = "*"
+        this.conds = ""
+        this.params = []
+        this.ordre = ""
+    }
+
+    fun select(champs: string): Query {
+        this.champs = champs
+        return this
+    }
+
+    fun where(colonne: string, op: string, valeur: any): Query {
+        if (this.conds != "") { this.conds = this.conds + " AND " }
+        this.conds = this.conds + colonne + " " + op + " ?"
+        this.params = this.params + [valeur]
+        return this
+    }
+
+    fun orderBy(colonne: string, sens: string): Query {
+        this.ordre = " ORDER BY " + colonne + " " + sens
+        return this
+    }
+
+    fun sql(): string {
+        var s = "SELECT " + this.champs + " FROM " + this.table
+        if (this.conds != "") { s = s + " WHERE " + this.conds }
+        s = s + this.ordre
+        return s
+    }
+
+    fun get(): any {
+        return DataImport.execSQL(this.db, this.sql(), this.params)
+    }
+}

oktopios_orm-0.1.0.dist-info/METADATA

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: oktopios-orm
+Version: 0.1.0
+Summary: ORM pour le langage Oktopios — modeles decores, migrations, query-builder (facon Doctrine / Django ORM)
+Author: Mouanwiya Ali Soule
+License: MIT License
+        
+        Copyright (c) 2025 Mouanwiya Ali Soule
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/ALISOULEMOUANWIYA/oktopios-orm
+Project-URL: Language, https://pypi.org/project/oktopios/
+Keywords: oktopios,orm,database,sqlite,migrations,okp
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: oktopios>=0.7.0
+Dynamic: license-file
+
+# oktopios-orm 🐙🗄️
+
+ORM pour le langage **[Oktopios](https://pypi.org/project/oktopios/)** — dans
+l'esprit de **Doctrine** (Symfony) et de l'**ORM de Django** : modèles déclarés
+par décorateurs, migrations automatiques, dépôt générique et query-builder.
+
+Deuxième couche de l'écosystème :
+**langage `oktopios` → `oktopios-orm` → `oktopios-framework`**.
+
+## Installation
+
+```bash
+pip install oktopios-orm
+```
+
+Cela installe aussi le langage `oktopios` (dépendance). Comme Django a besoin de
+Python et Doctrine de PHP, `oktopios-orm` a besoin de l'interpréteur `oktopios`.
+
+## Utilisation
+
+Dans un fichier `.okp` :
+
+```okp
+use "oktopios_orm/orm.okp"     // résolu depuis le paquet installé
+inject Type
+
+@Entity("articles")
+class Article {
+    @Id
+    var id: int
+    @Column("titre")
+    var title: string
+    var vues: int
+    fun __construct(title: string, vues: int) {
+        this.title = title
+        this.vues = vues
+    }
+}
+
+var schema = new Schema()
+var sample = new Article("", 0)
+schema.migrate("blog.db", sample)   // CREATE TABLE articles (id INTEGER PRIMARY KEY, titre TEXT, vues INTEGER)
+
+var repo = new Repo("blog.db", sample)
+var a = new Article("Bonjour", 100)
+Type.set(a, "id", 1)
+repo.save(a)
+
+for (x in repo.all()) { print(x.title) }
+
+var q = new Query("blog.db", "articles")
+print(q.select("id, titre, vues").where("vues", ">", 50).orderBy("vues", "DESC").get())
+```
+
+Exécuter : `okp examples/blog.okp`
+
+## Contenu (`oktopios_orm/orm.okp`)
+
+- **`Schema`** — migrations : génère le schéma SQL depuis les modèles décorés
+  (`@Entity`, `@Id`, `@Column`) ; mapping des types (`int→INTEGER`, `string→TEXT`,
+  `float→REAL`, `bool→INTEGER`).
+- **`Repo`** — dépôt générique : `save`, `all`, `findBy`, `remove`, hydratation
+  ligne → objet typé (par réflexion).
+- **`Query`** — constructeur de requêtes fluide : `select().where().orderBy().get()`,
+  paramétré (anti-injection).
+
+## Décorateurs reconnus
+
+| Décorateur | Cible | Effet |
+|---|---|---|
+| `@Entity("table")` | classe | nom de la table |
+| `@Column("colonne")` | champ | nom de la colonne |
+| `@Id` | champ | clé primaire |
+
+## Licence
+
+MIT © Mouanwiya Ali Soule

oktopios_orm-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+oktopios_orm/__init__.py,sha256=tS_5qQIanGz4veKTrPuKYAe_itQAuZnSRVao3bm_6Jk,75
+oktopios_orm/orm.okp,sha256=wVjbCZ1K3UugAQdEGumVyuMCYZ011oIRuHHyakpg6mA,6016
+oktopios_orm-0.1.0.dist-info/licenses/LICENSE,sha256=JnDpJVqc6gG-fDrMoIu7AHH9jVEOZhJs8V92NcdQFJU,1076
+oktopios_orm-0.1.0.dist-info/METADATA,sha256=hj6uswsp8qrMEi5TKH7niCSHnRuLZ8KCncLTvCqk8fI,4090
+oktopios_orm-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+oktopios_orm-0.1.0.dist-info/top_level.txt,sha256=JIx5GSVOtl8RH2u3p6w8PMd9aFx1dYucgBgU1AHCW7E,13
+oktopios_orm-0.1.0.dist-info/RECORD,,

oktopios_orm-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

oktopios_orm-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mouanwiya Ali Soule
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

oktopios_orm-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+oktopios_orm