jsonplaceholder-clone 1.0.0__py3-none-any.whl

jsonplaceholder_clone/__init__.py

@@ -0,0 +1,3 @@
+from .main import app
+from .schemas import Post, UpdatePost
+from . import crud

jsonplaceholder_clone/__main__.py

@@ -0,0 +1,15 @@
+import uvicorn
+
+
+# Démarrage du serveur (commande jsonplaceholder-clone ou bouton Play ▷ de VS Code)
+def main():
+    uvicorn.run(
+        "jsonplaceholder_clone.main:app",
+        host="127.0.0.1",
+        port=8000,
+        reload=True,
+    )
+
+
+if __name__ == "__main__":
+    main()

jsonplaceholder_clone/crud.py

@@ -0,0 +1,54 @@
+from typing import Optional
+
+from .database import db_posts
+from .schemas import Post, UpdatePost
+
+
+# Récupérer tous les posts (avec filtre optionnel par userId)
+def list_posts(user_id: Optional[int] = None) -> list[dict]:
+    if user_id is not None:
+        return [p for p in db_posts if p["userId"] == user_id]
+    return db_posts
+
+
+# Récupérer UN SEUL post par son ID (None s'il n'existe pas)
+def get_post(post_id: int) -> Optional[dict]:
+    return next((p for p in db_posts if p["id"] == post_id), None)
+
+
+# Créer un nouveau post (None si l'ID existe déjà)
+def create_post(post: Post) -> Optional[dict]:
+    # On vérifie si l'ID existe déjà pour éviter les doublons
+    if get_post(post.id) is not None:
+        return None
+    new_post = post.model_dump()
+    db_posts.append(new_post)
+    return new_post
+
+
+# Remplacer complètement un post existant (None s'il n'existe pas)
+def replace_post(post_id: int, post: Post) -> Optional[dict]:
+    for index, existing in enumerate(db_posts):
+        if existing["id"] == post_id:
+            db_posts[index] = post.model_dump()
+            return db_posts[index]
+    return None
+
+
+# Modifier partiellement un post existant (None s'il n'existe pas)
+def update_post(post_id: int, data: UpdatePost) -> Optional[dict]:
+    post = get_post(post_id)
+    if post is None:
+        return None
+    # On ne met à jour que les champs envoyés
+    post.update(data.model_dump(exclude_unset=True))
+    return post
+
+
+# Supprimer un post (False s'il n'existe pas)
+def delete_post(post_id: int) -> bool:
+    post = get_post(post_id)
+    if post is None:
+        return False
+    db_posts.remove(post)
+    return True

jsonplaceholder_clone/database.py

@@ -0,0 +1,6 @@
+# Base de données fictive en mémoire
+db_posts: list[dict] = [
+    {"userId": 1, "id": 1, "title": "Premier Post", "body": "Ceci est le contenu du premier post."},
+    {"userId": 1, "id": 2, "title": "Deuxième Post", "body": "Ceci est le contenu du deuxième post."},
+    {"userId": 2, "id": 3, "title": "Troisième Post", "body": "Un post écrit par l'utilisateur 2."},
+]

jsonplaceholder_clone/main.py

@@ -0,0 +1,11 @@
+from fastapi import FastAPI
+
+from .routers import posts_router
+
+app = FastAPI(
+    title="JSONPlaceholder Clone",
+    description="Reconstruction de l'API JSONPlaceholder avec FastAPI",
+    version="1.0.0",
+)
+
+app.include_router(posts_router)

jsonplaceholder_clone/routers/__init__.py

@@ -0,0 +1 @@
+from .posts import router as posts_router

jsonplaceholder_clone/routers/posts.py

@@ -0,0 +1,61 @@
+from typing import List, Optional
+
+from fastapi import APIRouter, HTTPException, status
+
+from .. import crud
+from ..schemas import Post, UpdatePost
+
+router = APIRouter(prefix="/posts", tags=["posts"])
+
+NOT_FOUND = "Post non trouvé"
+
+
+# [GET] Récupérer TOUS les posts (avec filtre optionnel par userId)
+@router.get("", response_model=List[Post])
+def get_posts(userId: Optional[int] = None):
+    return crud.list_posts(userId)
+
+
+# [GET] Récupérer UN SEUL post par son ID
+@router.get("/{post_id}", response_model=Post)
+def get_post_by_id(post_id: int):
+    post = crud.get_post(post_id)
+    if post is None:
+        raise HTTPException(status_code=404, detail=NOT_FOUND)
+    return post
+
+
+# [POST] Créer un nouveau post
+@router.post("", status_code=status.HTTP_201_CREATED, response_model=Post)
+def create_post(post: Post):
+    created = crud.create_post(post)
+    # crud renvoie None si l'ID existe déjà
+    if created is None:
+        raise HTTPException(status_code=400, detail="Un post avec cet ID existe déjà")
+    return created
+
+
+# [PUT] Remplacer complètement un post existant
+@router.put("/{post_id}", response_model=Post)
+def update_post_complete(post_id: int, updated_post: Post):
+    result = crud.replace_post(post_id, updated_post)
+    if result is None:
+        raise HTTPException(status_code=404, detail=NOT_FOUND)
+    return result
+
+
+# [PATCH] Modifier partiellement un post existant
+@router.patch("/{post_id}", response_model=Post)
+def update_post_partial(post_id: int, partial_data: UpdatePost):
+    result = crud.update_post(post_id, partial_data)
+    if result is None:
+        raise HTTPException(status_code=404, detail=NOT_FOUND)
+    return result
+
+
+# [DELETE] Supprimer un post
+@router.delete("/{post_id}")
+def delete_post(post_id: int):
+    if not crud.delete_post(post_id):
+        raise HTTPException(status_code=404, detail=NOT_FOUND)
+    return {"message": f"Le post {post_id} a été supprimé avec succès"}

jsonplaceholder_clone/schemas.py

@@ -0,0 +1,15 @@
+from typing import Optional
+from pydantic import BaseModel
+
+
+class Post(BaseModel):
+    id: int
+    userId: int
+    title: str
+    body: str
+
+
+class UpdatePost(BaseModel):
+    userId: Optional[int] = None
+    title: Optional[str] = None
+    body: Optional[str] = None

jsonplaceholder_clone-1.0.0.dist-info/METADATA

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: jsonplaceholder-clone
+Version: 1.0.0
+Summary: Reconstruction de l'API JSONPlaceholder avec FastAPI
+Author-email: Tom Doizon <tom.doizon1@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: Licence
+Requires-Dist: fastapi
+Requires-Dist: uvicorn[standard]
+Requires-Dist: pydantic>=2
+Dynamic: license-file
+
+# JSONPlaceholder Clone
+
+Reconstruction de l'API [JSONPlaceholder](https://jsonplaceholder.typicode.com) avec FastAPI.
+L'API gère des posts (CRUD complet) avec une base de données fictive en mémoire.
+
+## Installation
+
+Depuis la racine du projet (là où se trouve `pyproject.toml`) :
+
+```bash
+py -m venv .venv
+.\.venv\Scripts\Activate.ps1      # Windows (PowerShell)
+# source .venv/bin/activate       # macOS / Linux
+pip install -e .
+```
+
+Le mode `-e` (éditable) prend en compte vos modifications sans réinstaller.
+
+## Lancer l'API
+
+```bash
+jsonplaceholder-clone
+```
+
+ou :
+
+```bash
+python -m jsonplaceholder_clone
+```
+
+L'API est disponible sur http://127.0.0.1:8000 et la documentation interactive sur http://127.0.0.1:8000/docs.
+
+## Routes
+
+| Méthode | Route          | Description                                         |
+|---------|----------------|-----------------------------------------------------|
+| GET     | `/posts`       | Liste tous les posts (filtre optionnel `?userId=1`) |
+| GET     | `/posts/{id}`  | Récupère un post par son ID                         |
+| POST    | `/posts`       | Crée un nouveau post                                |
+| PUT     | `/posts/{id}`  | Remplace complètement un post                       |
+| PATCH   | `/posts/{id}`  | Modifie partiellement un post                       |
+| DELETE  | `/posts/{id}`  | Supprime un post                                    |
+
+Exemple de post :
+
+```json
+{
+  "userId": 1,
+  "id": 1,
+  "title": "Premier Post",
+  "body": "Ceci est le contenu du premier post."
+}
+```
+
+## Utiliser le package dans un autre script
+
+```python
+from fastapi import FastAPI
+from jsonplaceholder_clone import crud
+from jsonplaceholder_clone.routers import posts_router
+
+app = FastAPI()
+app.include_router(posts_router)
+
+print(crud.list_posts())
+```
+
+## Structure du projet
+
+```
+jsonplaceholder_clone/
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── MANIFEST.in
+└── src/
+    └── jsonplaceholder_clone/
+        ├── __init__.py      # expose app, Post, UpdatePost, crud
+        ├── __main__.py      # démarrage du serveur
+        ├── main.py          # création de l'application FastAPI
+        ├── schemas.py       # modèles Pydantic
+        ├── database.py      # base de données fictive en mémoire
+        ├── crud.py          # logique métier
+        └── routers/
+            ├── __init__.py  # expose posts_router
+            └── posts.py     # routes /posts
+```
+
+## Remarque
+
+Les données sont stockées en mémoire : elles sont réinitialisées à chaque redémarrage du serveur.
+
+## Licence
+
+Ce projet est distribué sous licence MIT. Voir le fichier [LICENSE](LICENSE).

jsonplaceholder_clone-1.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+jsonplaceholder_clone/__init__.py,sha256=y2edlRqDkjJcqk0N-Or__UBqoJ0eP9KKR4NBud6qw2I,78
+jsonplaceholder_clone/__main__.py,sha256=oxQq-dULN0pQp_xpqSQX3_ck39-Q_c-3dsHgal1dzZo,286
+jsonplaceholder_clone/crud.py,sha256=GiLVCFpQXz3Fu7RKEUg80tNonXiu8Vq8wDJ2pxy5xrc,1663
+jsonplaceholder_clone/database.py,sha256=BUvax0CNCRVdWK17bGUXnDHKVX8c0I4WE4APHiNtABU,375
+jsonplaceholder_clone/main.py,sha256=1isf_B-_7DTashq14biX299jJPcV1lubW17a2LEk2O0,242
+jsonplaceholder_clone/schemas.py,sha256=epUdBs55QV_KkibG2WHiLDKxAw277c_gFJiN6hC7rP8,268
+jsonplaceholder_clone/routers/__init__.py,sha256=1BIv7wzIL5wml7j2FF8EcClxYqFELctD5rinO_GLoGI,41
+jsonplaceholder_clone/routers/posts.py,sha256=HHpHNVjoNItLF04wvz7vRthm4W4UeZteUCLOUdWhoVk,1948
+jsonplaceholder_clone-1.0.0.dist-info/licenses/Licence,sha256=N4EwQxjuar6nuK9T0hS8AIoomg52p_MbeCW2xufou8w,1086
+jsonplaceholder_clone-1.0.0.dist-info/METADATA,sha256=ZHWLLO5M9QWOTSOYhKqXmKeE0uSpWgFAQKyKuMW73F0,3346
+jsonplaceholder_clone-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+jsonplaceholder_clone-1.0.0.dist-info/entry_points.txt,sha256=8fiMaLzqrdk20K5BBA7cCnrU3LLIqLBBmHtZ6cmZTpI,78
+jsonplaceholder_clone-1.0.0.dist-info/top_level.txt,sha256=BCznWgu92u0v3sLmNvyVQMZIxn6f77kSePUBToDSCVQ,22
+jsonplaceholder_clone-1.0.0.dist-info/RECORD,,

jsonplaceholder_clone-1.0.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
+

jsonplaceholder_clone-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+jsonplaceholder-clone = jsonplaceholder_clone.__main__:main

jsonplaceholder_clone-1.0.0.dist-info/licenses/Licence

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tom Doizon
+
+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.

jsonplaceholder_clone-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+jsonplaceholder_clone