px2dt-localdata-access

px2dt-localdata-access は、 Pickles 2 のデスクトップアプリケーションに共通する機能を提供します。

インストール - Install

$ npm install px2dt-localdata-access --save

使い方 - Usage

var Px2DtLDA = require('px2dt-localdata-access'),
    px2dtLDA = new Px2DtLDA('/path/to/data_directory/');
 
// データディレクトリを初期化
px2dtLDA.initDataDir(
    function(result){
        console.log(result);
    }
);
 
// ファイルからデータを読み込む
px2dtLDA.load(function(db){
    console.log(db);
});
 
// プロジェクト情報を追加
var projectIndexNumber = px2dtLDA.addProject({
    "name":"Your Project Name",
    "path":"/path/to/your/project/",
    "entry_script":".px_execute.php"
});
 
// プロジェクト情報を取得
var pjInfo = px2dtLDA.getProject(
    0 // <- projectIndexNumber or ProjectID
);
 
// 全プロジェクトインスタンスを取得
var pjList = px2dtLDA.getProjectAll();
 
// プロジェクトインスタンスを取得
var pjInstance = px2dtLDA.project(
    0 // <- projectIndexNumber or ProjectID
);
 
// px2package情報インスタンスを取得
var px2pkg = px2dtLDA.project(0).px2package();
console.log(px2pkg.get()); // px2package情報一式を取得
console.log(px2pkg.getPrimaryProject()); // プライマリのプロジェクト情報を取得
 
// プロジェクト情報を削除
var result = px2dtLDA.removeProject(
    0 // <- projectIndexNumber or ProjectID
);
 
// db.json 内の全てのデータをそのまま取得する
var db = px2dtLDA.getData();
 
// db.json 内の全てのデータをそのまま受け取って置き換える
var result = px2dtLDA.setData(
    { /* 更新データ全体 */ }
);
 
// 外部アプリケーションのパスをセットする
var result = px2dtLDA.setAppPath(appName, appPath);
 
// 外部アプリケーションのパスを取得する
var appPath = px2dtLDA.getAppPath( appName );
 
// 外部アプリケーションを起動する
var childProc = px2dtLDA.startApp(appName, params);
 
// データディレクトリのパスを取得する
var pathDataDir = px2dtLDA.getPathDataDir();
 
// アプリケーションデータの格納ディレクトリパスを取得する
var pathAppDataDir = px2dtLDA.getAppDataDir(appName);
 
// プロジェクトの変更を保存する
px2dtLDA.save(
    function(result){
        console.log(result);
    }
);
 
// ログ情報を追記する
px2dtLDA.log('test log message.');
 

初期化オプション - Initialize Options

var Px2DtLDA = require('px2dt-localdata-access'),
    px2dtLDA = new Px2DtLDA(
        '/path/to/data_directory/', // データディレクトリのパス (required)
        {
            "path_php": "/path/to/php", // PHPコマンドのパス
            "path_php_ini": "/path/to/php.ini", // php.iniのパス
            "path_extension_dir": "/path/to/ext", // extension_dirのパス
            "updated": function(updatedEvents){
                // データディレクトリ内に変更があった場合に検知し、
                // コールバックされます。
                console.log(updatedEvents);
            }
        }
    );

扱うデータ仕様

データ格納ディレクトリ

コンストラクタ第1引数に渡されたパスにデータを格納します。

ファイルとディレクトリ構造

├ db.json
├ common_log.log
├ commands
│　└ composer
│　　　└ composer.phar
├ appdata
│　├ {appname1}
│　│　└ anyfiles...
│　├ {appname2}
│　│　└ anyfiles...
│　├ ・・・・
│　└ {appnameN}
│　　　└ anyfiles...
└ logs
　　├ access-{YYYYMMDD}.log
　　├ access-{YYYYMMDD}.log
　　├ ・・・・
　　└ access-{YYYYMMDD}.log

• db.json が主に設定情報を格納する本体です。
• commands/ には、ツールが内部で呼び出すためのコマンド類を格納します。
• 汎用的なログ出力先として common_log.log があります。
• logs/ には、プレビューサーバーのアクセスログなどその他特別なログが出力されます。

db.json の構造定義

{
 "commands": {
  "php": "/realpath/to/php",
  "git": "/realpath/to/git",
  "composer": "/realpath/to/composer.phar"
 },
 "apps": {
  "texteditor": "/realpath/to/textEditor.app",
  "texteditorForDir": "/realpath/to/textEditor.app",
  "gitClient": "/realpath/to/gitClient.app"
 },
 "projects": [
  {
   "name": "Project Name 1",
   "path": "/realpath/to/project1/htdocs",
   "home_dir": "px-files/",
   "entry_script": ".px_execute.php",
   "extended":{
       "key1":"value",
       "key2":{
           "key3":"value"
       }
   }
  },
  {
   "name": "Project Name 2",
   "path": "/realpath/to/project2/htdocs",
   "home_dir": "px-files/",
   "entry_script": ".px_execute.php"
  },
  {
      /* ・・・・・・ */
  },
  {
   "name": "Project Name N",
   "path": "/realpath/to/projectN/htdocs",
   "home_dir": "px-files/",
   "entry_script": ".px_execute.php"
  }
 ],
 "network": {
  "preview": {
   "port": "58080",
   "accessRestriction": "loopback"
  },
  "appserver": {
   "port": "58081"
  }
 },
 "language": "ja"
}

更新履歴 - Change Log

px2dt-localdata-access v2.0.0 (2019-11-02)

• Initial Relase.

ライセンス - License

MIT License

作者 - Author

• Tomoya Koyanagi [e-mail]
• website: https://www.pxt.jp/
• Twitter: @tomk79 https://twitter.com/tomk79/