capsarsiv 0.1.0__tar.gz

capsarsiv-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,57 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest tests/ -v
+
+  publish:
+    name: Build & Publish
+    needs: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}

capsarsiv-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/

capsarsiv-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sinan Erdinç
+
+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.

capsarsiv-0.1.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: capsarsiv
+Version: 0.1.0
+Summary: Türkçe Caps Arşivi Python SDK ve CLI aracı
+Author-email: Sinan Erdinç <sinanerdinc@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://capsarsiv.com
+Project-URL: Repository, https://github.com/sinanerdinc/capsarsiv
+Project-URL: Documentation, https://capsarsiv.com/developer
+Project-URL: Issues, https://github.com/sinanerdinc/capsarsiv/issues
+Keywords: caps,capsarsiv,türkçe,meme,cli,api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-httpx>=0.30; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Dynamic: license-file
+
+# capsarsiv
+
+Türkçe Caps Arşivi Python SDK ve CLI aracı.
+
+[![PyPI](https://img.shields.io/pypi/v/capsarsiv)](https://pypi.org/project/capsarsiv/)
+[![Python](https://img.shields.io/pypi/pyversions/capsarsiv)](https://pypi.org/project/capsarsiv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Türkçe Caps Arşivi](https://capsarsiv.com) API'sine erişmek için Python SDK ve komut satırı aracı.
+
+## Kurulum
+
+```bash
+pip install capsarsiv
+```
+
+## API Key
+
+API key almak için:
+
+1. [capsarsiv.com/uyelik](https://capsarsiv.com/uyelik) sayfasından giriş yapın.
+2. Hesap altındaki **developer API** bölümünde **API key oluştur**'a tıklayın.
+3. Key yalnızca oluşturulduğu anda bir kez gösterilir; güvenli bir yerde saklayın.
+
+Key'inizi ortam değişkeni olarak ayarlayın:
+
+```bash
+export CAPSARSIV_API_KEY="senin_api_keyin"
+```
+
+## Python SDK
+
+```python
+from capsarsiv import CapsArsiv
+
+# Context manager ile kullanım (önerilir)
+with CapsArsiv() as client:
+    # Capsleri listele
+    caps_list = client.caps(sort="popular", limit=10)
+    for c in caps_list:
+        print(f"{c.title} — puan: {c.score}")
+
+    # Arama yap
+    results = client.caps(q="futbol", sort="popular")
+
+    # Tag ile filtrele
+    spor_caps = client.caps(tag="spor", limit=5)
+
+    # Rastgele caps getir
+    rastgele = client.random()
+    print(f"Rastgele: {rastgele.title}")
+
+    # Slug ile detay getir
+    caps = client.get("ornek-caps")
+    print(caps.image_url)
+
+    # Tagleri listele
+    tags = client.tags(limit=20)
+    for t in tags:
+        print(f"#{t.name} ({t.count} caps)")
+
+    # Caps görselini indir
+    filepath = client.download("ornek-caps", directory="./caps")
+    print(f"İndirildi: {filepath}")
+```
+
+### API Key'i parametre olarak verme
+
+```python
+client = CapsArsiv(api_key="senin_api_keyin")
+```
+
+## CLI Kullanımı
+
+```bash
+# Capsleri listele
+capsarsiv caps
+capsarsiv caps --sort popular --limit 10
+capsarsiv caps --query futbol
+capsarsiv caps --tag spor
+
+# Rastgele caps
+capsarsiv random
+
+# Caps detayı
+capsarsiv get ornek-caps
+
+# Tagleri listele
+capsarsiv tags
+capsarsiv tags --limit 20
+
+# Caps görselini indir
+capsarsiv download ornek-caps
+capsarsiv download ornek-caps -o ./caps/
+
+# JSON çıktı
+capsarsiv --json caps --limit 5
+capsarsiv --json random
+
+# Yardım
+capsarsiv --help
+capsarsiv caps --help
+```
+
+### CLI ile API Key
+
+```bash
+# Ortam değişkeni (önerilir)
+export CAPSARSIV_API_KEY="senin_api_keyin"
+capsarsiv caps
+
+# Parametre olarak
+capsarsiv --api-key "senin_api_keyin" caps
+```
+
+## Hata Yönetimi
+
+```python
+from capsarsiv import CapsArsiv, NotFoundError, RateLimitError, AuthenticationError
+
+with CapsArsiv() as client:
+    try:
+        caps = client.get("olmayan-caps")
+    except NotFoundError:
+        print("Caps bulunamadı!")
+    except RateLimitError:
+        print("İstek limiti aşıldı, lütfen bekleyin.")
+    except AuthenticationError:
+        print("API key geçersiz!")
+```
+
+## API Limitleri
+
+- Dakikada en fazla **60** istek
+- Aylık **1000** istek (key başına)
+
+## Lisans
+
+MIT — detaylar için [LICENSE](LICENSE) dosyasına bakın.

capsarsiv-0.1.0/README.md

@@ -0,0 +1,139 @@
+# capsarsiv
+
+Türkçe Caps Arşivi Python SDK ve CLI aracı.
+
+[![PyPI](https://img.shields.io/pypi/v/capsarsiv)](https://pypi.org/project/capsarsiv/)
+[![Python](https://img.shields.io/pypi/pyversions/capsarsiv)](https://pypi.org/project/capsarsiv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Türkçe Caps Arşivi](https://capsarsiv.com) API'sine erişmek için Python SDK ve komut satırı aracı.
+
+## Kurulum
+
+```bash
+pip install capsarsiv
+```
+
+## API Key
+
+API key almak için:
+
+1. [capsarsiv.com/uyelik](https://capsarsiv.com/uyelik) sayfasından giriş yapın.
+2. Hesap altındaki **developer API** bölümünde **API key oluştur**'a tıklayın.
+3. Key yalnızca oluşturulduğu anda bir kez gösterilir; güvenli bir yerde saklayın.
+
+Key'inizi ortam değişkeni olarak ayarlayın:
+
+```bash
+export CAPSARSIV_API_KEY="senin_api_keyin"
+```
+
+## Python SDK
+
+```python
+from capsarsiv import CapsArsiv
+
+# Context manager ile kullanım (önerilir)
+with CapsArsiv() as client:
+    # Capsleri listele
+    caps_list = client.caps(sort="popular", limit=10)
+    for c in caps_list:
+        print(f"{c.title} — puan: {c.score}")
+
+    # Arama yap
+    results = client.caps(q="futbol", sort="popular")
+
+    # Tag ile filtrele
+    spor_caps = client.caps(tag="spor", limit=5)
+
+    # Rastgele caps getir
+    rastgele = client.random()
+    print(f"Rastgele: {rastgele.title}")
+
+    # Slug ile detay getir
+    caps = client.get("ornek-caps")
+    print(caps.image_url)
+
+    # Tagleri listele
+    tags = client.tags(limit=20)
+    for t in tags:
+        print(f"#{t.name} ({t.count} caps)")
+
+    # Caps görselini indir
+    filepath = client.download("ornek-caps", directory="./caps")
+    print(f"İndirildi: {filepath}")
+```
+
+### API Key'i parametre olarak verme
+
+```python
+client = CapsArsiv(api_key="senin_api_keyin")
+```
+
+## CLI Kullanımı
+
+```bash
+# Capsleri listele
+capsarsiv caps
+capsarsiv caps --sort popular --limit 10
+capsarsiv caps --query futbol
+capsarsiv caps --tag spor
+
+# Rastgele caps
+capsarsiv random
+
+# Caps detayı
+capsarsiv get ornek-caps
+
+# Tagleri listele
+capsarsiv tags
+capsarsiv tags --limit 20
+
+# Caps görselini indir
+capsarsiv download ornek-caps
+capsarsiv download ornek-caps -o ./caps/
+
+# JSON çıktı
+capsarsiv --json caps --limit 5
+capsarsiv --json random
+
+# Yardım
+capsarsiv --help
+capsarsiv caps --help
+```
+
+### CLI ile API Key
+
+```bash
+# Ortam değişkeni (önerilir)
+export CAPSARSIV_API_KEY="senin_api_keyin"
+capsarsiv caps
+
+# Parametre olarak
+capsarsiv --api-key "senin_api_keyin" caps
+```
+
+## Hata Yönetimi
+
+```python
+from capsarsiv import CapsArsiv, NotFoundError, RateLimitError, AuthenticationError
+
+with CapsArsiv() as client:
+    try:
+        caps = client.get("olmayan-caps")
+    except NotFoundError:
+        print("Caps bulunamadı!")
+    except RateLimitError:
+        print("İstek limiti aşıldı, lütfen bekleyin.")
+    except AuthenticationError:
+        print("API key geçersiz!")
+```
+
+## API Limitleri
+
+- Dakikada en fazla **60** istek
+- Aylık **1000** istek (key başına)
+
+## Lisans
+
+MIT — detaylar için [LICENSE](LICENSE) dosyasına bakın.

capsarsiv-0.1.0/capsarsiv/__init__.py

@@ -0,0 +1,25 @@
+"""Capsarsiv — Türkçe Caps Arşivi Python SDK ve CLI aracı."""
+
+from capsarsiv.client import CapsArsiv
+from capsarsiv.exceptions import (
+    APIError,
+    AuthenticationError,
+    CapsArsivError,
+    NotFoundError,
+    RateLimitError,
+)
+from capsarsiv.models import Caps, Tag
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "CapsArsiv",
+    "Caps",
+    "Tag",
+    "CapsArsivError",
+    "AuthenticationError",
+    "NotFoundError",
+    "RateLimitError",
+    "APIError",
+    "__version__",
+]