ডেটা প্যাক

আপনার বাছাইয়ের নিয়ম, নামের ছাঁচ বা রিলিজ-নামের যাচাই এক ইনস্টল থেকে আরেক ইনস্টলে কপি করুন।

ডেটা প্যাক হলো শুধু ডেটার একটি JSON ফাইল। এটি কোড চালাতে পারে না, কোনো ঠিকানা থেকে কিছু আনতে পারে না, টাইটেল যোগ করতে পারে না, ইউজার বদলাতে পারে না, মিডিয়া ফাইলে হাত দিতে পারে না এবং গোপন তথ্য বয়ে নিতে পারে না।

শুরু করার আগে

• আপনি মালিক।
• আপনার কাছে admin স্কোপের একটি API কী আছে। health_read, read বা write কী প্রত্যাখ্যান করা হয়।
• আপনার কাছে প্যাকের JSON আছে। যে প্যাকটি আপনাকে দেওয়া হয়েছে সেটি ব্যবহার করুন, অথবা বিশেষজ্ঞদের জন্য অংশের গঠন দেখে একটি লিখুন।

একটি প্যাক সরান

সব রুট http://your-server:6262-এ আছে।

1. প্যাকটি POST /api/v1/data-packs/validate-এ পাঠান। এটি সেভ না করে যাচাই করে। আপনি "valid": true দেখতে পাবেন।
2. একই JSON POST /api/v1/data-packs-এ পাঠান। এটি প্যাকটি নিষ্ক্রিয় অবস্থায় সেভ করে। এখনো কিছুই বদলায় না।
3. সেভ হওয়া প্যাকের তালিকা দেখতে GET /api/v1/data-packs খুলুন। GET /api/v1/data-packs/{id} একটি প্যাক এক্সপোর্ট করে।
4. প্রতিটি নিয়মের জন্য একটি করে pick_rule_id এবং বড়জোর একটি naming_id দিয়ে GET /api/v1/data-packs/{id}/preview খুলুন। আপনি একটি approval_hash পাবেন।
5. একই বাছাই আর হ্যাশটি POST /api/v1/data-packs/{id}/apply-এ পাঠান। আপনি প্যাকের id এবং আপনার বেছে নেওয়া নিয়মের id দেখতে পাবেন।

Preview:

GET /api/v1/data-packs/home-cinema/preview?pick_rule_id=balanced-web&naming_id=readable

Apply body:

{
  "pick_rule_ids": ["balanced-web"],
  "naming_id": "readable",
  "approval_hash": "the hash returned by preview"
}

Caution

একটি নামের সেট আপনার বর্তমান নামের ছাঁচগুলো বদলে দেয়। আগে থেকে থাকা ফাইলের নাম বদলায় না।

প্রয়োগ করলে কী বদলায়

• বেছে নেওয়া প্রতিটি বাছাইয়ের নিয়ম নতুন করে তৈরি হয়। এটি কোনো টাইটেলে দেওয়া হয় না।
• বেছে নেওয়া নামের সেট শুধু এই সেটিংসগুলো বদলায়:
  • মুভির ফাইল ও ফোল্ডারের ছাঁচ।
  • সিরিজের ফোল্ডার, সিজন ফোল্ডার, স্পেশালের ফোল্ডার, পর্ব, daily ও anime-র ছাঁচ।
  • শিল্পীর ফোল্ডার, অ্যালবামের ফোল্ডার, ডিস্কের ফোল্ডার, ট্র্যাক ও একাধিক ডিস্কের ট্র্যাকের ছাঁচ।
  • কোলন ও অবৈধ অক্ষরের বিন্যাস।
  • একাধিক পর্বের ধরন, প্রচারের তারিখের ধরন ও absolute নম্বরের অঙ্ক।
• ইমপোর্টের সময় নাম বদল, ফোল্ডারের আচরণ, ট্যাগ পড়া ও স্ক্যানের সীমা কখনো প্যাকে থাকে না।

কাজ না করলে

লক্ষণ: Apply বলছে preview পুরোনো হয়ে গেছে। কারণ: preview-র পর প্যাক, নাম মিলে যেতে পারে এমন একটি বাছাইয়ের নিয়মের নাম, অথবা যে নামের সেটিং বদলে যেত তার কোনোটি বদলেছে। কিছুই প্রয়োগ হয়নি। সমাধান: আবার preview করুন এবং নতুন হ্যাশটি পাঠান।

লক্ষণ: ইমপোর্ট বলছে প্যাকটি আগে থেকেই আছে। কারণ: প্যাক কখনো বদলে ফেলা হয় না। সমাধান: নতুন প্যাকটিকে অন্য একটি id দিন।

লক্ষণ: পারমিশনের ত্রুটি। কারণ: কীটি মালিকের বানানো admin কী নয়। সমাধান: মালিক হিসেবে একটি admin কী বানান এবং সেটি ব্যবহার করুন।

বিশেষজ্ঞদের জন্য

সীমা ও প্রত্যাখ্যান

সীমা	মান
format	holyarrs-data-pack
version	1
একটি প্যাক বা এক্সপোর্টের সাইজ	256 KiB
বাছাইয়ের নিয়ম	32
নামের সেট	8
রিলিজ-নামের যাচাই	256
Id	1 থেকে 64 অক্ষর: ছোট হাতের অক্ষর, অঙ্ক, ডট, ড্যাশ, আন্ডারস্কোর। অক্ষর বা অঙ্ক দিয়ে শুরু ও শেষ
Apply request body	16 KiB

ডুপ্লিকেট বা অজানা ফিল্ড, শেষের পরে বাড়তি JSON, অজানা কোয়ালিটি বা বৈশিষ্ট্যের নাম, ভুল নামের শব্দ, 1 ছাড়া অন্য ভার্সন, অথবা এই সীমা ছাড়ানো মান থাকলে প্যাক প্রত্যাখ্যাত হয়। প্রতিটি রিলিজ-নামের যাচাই HolyArrs-এর parser দিয়ে চলে এবং সে যা যা আশা করে তার প্রতিটির সঙ্গে মিলতে হয়।

প্যাকের গঠন

ফিল্ড	কী থাকে
format, version, id, name	আবশ্যক হেডার
pick_rules	প্রতিটিতে থাকে id, name, kinds ও rules (ধাপ, বৈশিষ্ট্য, সাইজের সীমা, protocol, ভাষা, ক্রম)
naming	প্রতিটিতে থাকে id, name ও patterns (ওপরে তালিকাভুক্ত নামের সেটিংস)
release_tests	প্রতিটিতে থাকে id, name, release_name, hints ও expected (kind, quality, resolution, source, codec, flags)

রুট ও উত্তর

রুট	সফল হলে	প্রত্যাখ্যান
POST /api/v1/data-packs/validate	200, valid ও একটি সারসংক্ষেপসহ	400 অবৈধ, 413 খুব বড়
POST /api/v1/data-packs	201, একটি সারসংক্ষেপসহ, status inactive	409 id আছে, 400, 413
GET /api/v1/data-packs	200, data_packs-সহ
GET /api/v1/data-packs/{id}	200, প্যাকের JSON-সহ	404
GET /api/v1/data-packs/{id}/preview	200, approval_hash-সহ	pick_rule_id ও naming_id ছাড়া অন্য কোনো query হলে 400, 404
POST /api/v1/data-packs/{id}/apply	200, pack_id, pick_rule_ids, naming_id-সহ	409 পুরোনো, 400, 404

সংশ্লিষ্ট

• মেটাডেটা
• লাইব্রেরি