Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Modify all names to suit the current naming rule #225

Closed
200km opened this issue Nov 18, 2022 · 14 comments
Closed

Modify all names to suit the current naming rule #225

200km opened this issue Nov 18, 2022 · 14 comments
Labels
major update incompatible API changes priority::high priorityg high

Comments

@200km
Copy link
Member

200km commented Nov 18, 2022

Overview

Modify all names to suit the current naming rule

Details

Modify all names to suit the current naming rule

Conditions for close

  • all variable names are modified
  • all function names are modified
  • all parameter names in ini files are modified
  • all log names in log file are modified

Supplement

NA

Note

NA

@200km 200km added the priority::high priorityg high label Nov 18, 2022
@200km 200km added this to the Major update for v6.0.0 milestone Nov 18, 2022
@200km
Copy link
Member Author

200km commented Nov 27, 2022

少し、clang-tidyを使ってみた。
とりあえずこれを使えば自動チェックと修正ができるのでなんとかなりそうだが、次の部分をどうしようか悩んでいる。

  • 変数名や関数名に単位を入れている部分が今のNaming Ruleと合わない。
    • ルールに明示していないが、わかりやすさのため新しいコードの多くで単位を明示している。大文字・小文字も通常使われる単位系に合わせているので、NamingRuleと合わない
    • 単位に関するissueを先に解決しなければ行けない気もする
    • 同様の問題は座標系でも言える。座標系に関するissueを先に解決しなければいけない気もする
    • もしくはまずは単位や座標系以外の部分を修正し、後回しにするか。。。
  • SGP4やIGRFなど自作じゃないコードにまで適用するかどうか
    • 基本は適用せずにそれらのファイルは無視するようにして良さそう

@sksat コメントいただけると嬉しいです。

@200km 200km added the major update incompatible API changes label Nov 28, 2022
@200km
Copy link
Member Author

200km commented Jan 31, 2023

@sksat こちら、ひとまずファイル名やディレクトリ名は人力で進めようと思っています。ただ、現在のファイル命名規則が CamelCaseとしているのに対し、将来導入したいのはGoogleスタイルなので、snake_caseにすべきだなと思っています。このタイミングで全てsnake_caseにしてしまって良いでしょうか?

@sksat
Copy link
Collaborator

sksat commented Feb 2, 2023

コメント遅れてすみません......!!!

これって一旦大文字小文字だけ naming rule と合わせるとかでもとてもわかりにくくなってしまう(それぐらいだったらちゃんと修正したい),みたいなかんじですかね > 単位

はい.外部ライブラリは加味しなくていいと思います. > SGP4 や IGRF

このタイミングでいいと思います.十分に breaking change かつやるだけなのでやりましょう. > ファイル名を snake_case

@200km
Copy link
Member Author

200km commented Feb 2, 2023

ありがとうございます!

変数名や関数名に単位を入れている部分

これは、v6.0.0では単位と座標系以外は修正して、単位と座標系はv7.0.0以降に回そうと思っています。

ファイル名を snake_case

これはv6.0.0でやろうと思います。documentの方の表記も変えておきます。

@200km
Copy link
Member Author

200km commented Feb 8, 2023

このissue対応していて気になったこと

  • Interfaceディレクトリ配下のディレクトリ構成や命名を整理したい
  • 各ディレクトリ配下のCMakeListについて整理したい(特にInterfaceや Libraryで細かく分かれすぎている件など)
  • 名前として次のものは議論を呼びそう
    • Component/Abstract -> component/base_classed
    • SCIPort -> uart_port
    • Component/IdealComponent -> ?
  • Component/Missionの下でさらにTelescopeディレクトリ必要?他と合わせるなら無くて良さそう

@200km
Copy link
Member Author

200km commented Feb 8, 2023

  • ObcCommunicationBase などの命名方法なんとかしたい

@200km
Copy link
Member Author

200km commented Feb 8, 2023

  • _tfsなどどうするか
  • GSCalculator的な解析系をまとめるAnalysisディレクトリを作るか?

@200km
Copy link
Member Author

200km commented Feb 8, 2023

  • Vector.hppがvector.hppになるのは、c++のvectorとの関係で嫌だったりするのか?

@200km
Copy link
Member Author

200km commented Feb 8, 2023

↑の件はそれぞれ別にissue作った
#312
#313
#314
#315

@200km
Copy link
Member Author

200km commented Feb 8, 2023

#316

@200km
Copy link
Member Author

200km commented Feb 9, 2023

残存issueは別issueを作ったので、こちらはCLOSEする

@200km 200km closed this as completed Feb 9, 2023
@sksat
Copy link
Collaborator

sksat commented Feb 13, 2023

  • Vector.hppがvector.hppになるのは、c++のvectorとの関係で嫌だったりするのか?

閉じちゃった後でアレですが,これはそんなに嫌ではない(というか,その変更では"嫌さ"は変わらない)かなと思います.
"嫌"とすれば

  • 人間側での conflict : 「ベクタ(クラス)」と言った時に指すものが2つある
  • ソースコード上での conflict: (ファイル名ではなく)クラス名が vector だった場合,using すると区別がつかない & 最悪ビルド時に conflict してしまう

という理由になると思います

This was referenced Feb 23, 2023
@200km
Copy link
Member Author

200km commented Feb 24, 2023

ファイル名は対応したが、クラス名や変数名はまだなので再オープンする。

@200km 200km reopened this Feb 24, 2023
This was referenced Feb 25, 2023
@200km
Copy link
Member Author

200km commented Mar 13, 2023

Done

@200km 200km closed this as completed Mar 13, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
major update incompatible API changes priority::high priorityg high
Projects
None yet
Development

No branches or pull requests

2 participants