Qpro: 基於命令行的C/CPP項目

 

環境

• Qpro基於gcc/g++/clang/...與python3,
• 請確保電腦在擁有Python環境的同時, 至少安裝了一套C/CPP編譯指令.

功能

• 提供腳本在命令行裏高效***運行C/CPP項目***。
• 提供***模板管理器***，輕鬆將代碼保存和導出。
• 提供***對拍器***，輕鬆進行程序輸出結果的對拍或進行文本文件的對比。

特殊說明

• Qpro對CLion的特殊支持: 在CLion項目中，Qpro能夠自動將其初始化爲Qpro項目

• 任意一個包含C/CPP文件的文件夾均可以成爲Qpro項目, Qpro不會對原IDE項目產生影響

• 一個文件夾能夠同時是Qpro項目和其餘IDE項目

安裝:

• pip3 install Qpro [--upgrade]

使用:

Command	Result
Qpro -init	將當前文件夾初始化爲Qpro項目
Qpro -h	查看幫助
Qpro -update	更新Qpro
Qpro -adjust	修改配置表
Qpro -scp path	將項目內文件夾或文件上傳到默認服務器
Qpro -scp-init	將整個項目上傳到默認服務器
Qpro -c project	建立一個Qpro項目
tmpm *	調用模板腳本，刷新項目中的默認源文件
run *	使用運行腳本運行你的項目
detector [-[p/f][p/f]]	運行對拍器（對拍器只能在Qpro -init後的文件夾下運行）

初始化後的項目，能夠手動編輯配置表project_configure.csv來調整配置。

配置表

• 修改project_configure.csv來調整腳本默認配置

  鍵值	含義	默認
  compile_tool	(編譯工具, 編譯後綴)	(gcc, '') / (g++, '') / ...
  compile_filename	待編譯的文件	main.cpp / main.c
  executable_filename	編譯出的可執行文件名	項目名
  input_file	默認的輸入文件	./cmake-build-debug/input.txt
  template_root	默認的模板庫根目錄	template/
  server_target	默認的服務器映射位置	空/user@ip:dir_path/

• 運行Qpro -adjust修改配置表: 

運行腳本:

• 編譯或運行

  參數	含義
  -b	編譯
  -r	運行
  -br	編譯且運行

  若是上述三個命令都不存在，則默認運行當前編譯好的程序

  參數	含義
  -f *.c / *.cpp	設置目標源文件爲*.c / *.cpp

• 輸入輸出:

  • 能夠編輯 默認的輸入文件 來設置默認輸入
  • 運行 run [...] > output.txt 使程序輸出到 ./output.txt

  參數	效果
  -i	使用默認的輸入文件做爲輸入
  -if *.*	更改輸入文件
  -if -paste	使用粘貼板內容做爲輸入

• 程序的額外命令行參數:

  • 全部未被run命令匹配的參數都將按順序傳遞給源程序。

• 查看幫助

  • run -h : 能夠查看使用幫助(Windows系統不支持顏色顯示) 

• 推薦的命令示例:

  命令	效果
  run -i	使用默認輸入文件並運行
  run	運行
  run -br -i	編譯且使用輸入文件運行

模板腳本:

• 使用

  命令	效果
  tmpm -h	查看幫助
  tmpm -r	選擇備份並恢復
  tmpm -r backup	恢復爲template/backup
  tmpm -c backup	建立或覆蓋template/backup
  tmpm -c template algorithm	拷貝指定位置, 建立模板集並寫入算法
  tmpm -a template algorithm	拷貝指定位置, 向模板集追加算法
  tmpm name	在/// __TEMPLATE__處插入name模板集內的模板

• 關於指定位置: tmpm 將會把compile_filename中處於/// __START__和/// __END__之間的內容識別, 並拷貝

對拍器

• 使用: detector 來進行兩個源程序運行結果的對拍，結果存儲在當前目錄下的./res.html。

命令	效果
detector (-pp)	打開默認對拍器(文件1與文件2都是程序)
detector -pf	運行文件1程序並將結果與文件2對比
detector -fp	運行文件2程序並將結果與文件1對比
detector -ff	對比文件1與文件2的內容(你能夠在任何位置調用)

• 若是腳本未能自動打開./res.html, 你能夠用瀏覽器打開它。