【個人開発】文字数を計測できる「clipcount」

WordPressでブログを書き始めてから文字数が気になることが多くなりました。SEOタイトルは多くても33文字以内に収めないと、はみ出るからです。

自分はMarkdownで下書きを作ってから、それをGutenbergの「カスタムHTML」に貼り付け「ブロックに変換」し記事を作成しています。その際に、その場で文字数を知りたいと考えるようになりました。

そこで、クリップボードを読み込み、ターミナルに文字数を出力するCUIツール「clipcount」をPythonで作りました。

目次

「clipcount」とは?

clipcountとは、Pythonで作成したオープンソースのCUIツールです。

GitHub
GitHub - yusu79/clipcount: クリップボードにコピーした文字数をカウントするツール クリップボードにコピーした文字数をカウントするツール. Contribute to yusu79/clipcount development by creating an account on GitHub.

clipcountとターミナル上で入力すると、その時に保存しているクリップボードの最新の文章を読み込んで、その文字数を出力してくれます。

簡単な使い方は、Qiitaでまとめています。

Qiita
【Python pip】コピーした文字数をカウントするツール - Qiita はじめに Wordpressでブログを始めてから、文字数に気を使うことが増えました。記事のタイトルは30文字程度に収めなければ、はみ出してしまうからです。 そこで、「clipcou...

インストール方法

pipでインストールします。

Bash
pip install clipcount

Windowsで上記を実行した際に「"WARNING: The script clipcount.exe is installed in 'ファイルパス' which is not on PATH."」という警告が表示されたなら、以下の記事をご参照ください。

あわせて読みたい
【Python Windows】pip install でPATHが通らない時の解決方法 Windowsで「pip install」しているにも関わらず、「PATHが通っていない」と言われコマンドが使えない時の解決方法です。

また、「WARNING: Failed to write executable - trying to use .deleteme logic」という警告が表示されpip install出来ない場合は以下の記事をご参照ください。

あわせて読みたい
【Windows】警告が出て「pip install」できない時の解決方法 この記事では、Windowsで「pip install」 を実行した際に、「WARNING: Failed to write executable - trying to use .deleteme logic」という警告が発生しインストール...

使い方

clipcountは「ターミナルで直接実行」することもできます。

Bash
clipcount [オプション]

また、Pythonファイル上でインポートすることも出来ます。

Python
from clipcount import clipcount
x = clipcount({オプション})
オプション説明
clipcount -hヘルプ画面を表示します。
clipcount –help_jpヘルプ画面を日本語で表示します。
clipcount -b改行コード(\n\r\n)を削除した文字数を出力します。
clipcount -s半角空白を削除した文字数を出力します。
clipcount -S全角空白を削除した文字数を出力します。
clipcount -tタブコード(\t)を削除した文字数を出力します。
clipcount –split空白文字(改行、半角空白、全角空白、タブ)を削除した文字数を出力します。
clipcount -m半角英数を0.5文字として換算して、文字数を出力します。

「clipcount」の開発動機

WordPressでブログを書き始めてから1ヶ月経ちました。 始めは色々と慣れないことばかりで大変でしたが、ようやく作り方の環境も整ってきました。

記事は、Markdownで作ってからWordpressに貼り付けるというスタイルを今のところ取っています。

そこで、本文はもちろん、タイトルやメタディスクリプションも考えるのですが、文字数がとにかく気になります。多すぎると、はみ出してしまうからです。

いくら伝えたい事があっても、表示されないなら意味がありません。そこで、タイトルを考えたらすぐに文字数を知りたいと思うようになりました。

文字数を計測できるWEBサービスは数多くあるのですが、それらの殆どが「計測したい文字をコピーする」「それを貼り付ける」という手順を踏みます。

  1. 計測したい文字列をコピーする
  2. それらを貼り付けて文字数を計測する

自分は、これを文字をコピーしただけで計測したいと思うようになりました。そこで、以前の開発でクリップボードを読み込むモジュールがPythonにはある[1]ことを知っっていたので、それを組み込んでOSSを作ってみようと思ったのが開発動機です。

また、WordPressは半角英数を0.5文字として計算するのですが、この需要に対応しているサービスが中々見つからず、それなら自分で作ろうと思ったことも、動機の一つです。

まとめると、clipcountを使うことで

  • 貼り付ける作業を省略できる
  • 半角英数を0.5文字として換算して文字数を出力する

といった事が可能となります。他にも、改行コードを削除したり、空白を削除したり、あるいは残すこともできます。

「clipcount」の特徴

デフォルトでは、空白文字(改行コード、半角空白、全角空白、タブコード)全てを含めた状態で文字数を出力します。さらに、半角文字と全角文字のどちらも「同じ1文字」として換算されています。

そのため、Wordpressのタイトルやメタディスクリプションの計測で用いるならば、-mオプションを使用してください。半角英数が0.5文字換算となります。

また、改行コード(\n\r\n)も必要ないと思われるので-bオプションをご使用ください。

文中にある空白は文字数に換算されるので、基本的に削除しなくていいのですが、純粋な文字数を知りたい方は、半角空白を削除するなら-sオプションを、全角空白を削除したいならば-Sオプションをご使用ください。また、タブコード(\t)は-tオプションで削除できます。

オプションは組み合わせる事ができます。例えば、「タブコードと改行コードだけ削除したい」方は-tbとしてください。

空白文字(改行コード、半角空白、全角空白、タブコード)全てを一括で削除したい方は-bsStとするか、もしくは--splitとしてください。

このような自由度の高さがclipcountの魅力でもあります。

「clipcount」開発過程

1.pyperclipを知る

clipcountの骨子となっているモジュールが「pyperclip」です。 import pyperclipとして、「x = pyperclip.paste()」と記述するだけで、変数にクリップボードが格納されます。非常に便利なモジュールです。

あわせて読みたい

以前の開発で存在を知り、今回の開発に繋がりました。

あわせて読みたい
【個人開発】Markdownを木構造で出力できる「marktree」 「文章全体を構造化して一目で把握したい」 と思ったことはないでしょうか? 特に自分はWordpressに投稿する際に、まずMarkdownで下書きした後、それをGutenbergの「カ...

2.「clipcount」を作る

やるべきことは単純だったので、あっという間に出来ました。 ポイントはsplit()メソッドです。文字列.split("削除したい文字")とするだけで任意の文字を削除できます。

改行コードだけは、Windowsとそれ以外で異なっているため難儀しましたが、.splitlines()メソッドを使うと、それがどの改行コードであれ削除してくれるので、助かりました。

3.半角英数を区別する機能の実装

残りの問題は半角英数を0.5文字に換算する方法です。 この問題の解決には、こちらの記事が参考になりました。

結論から述べると、unicodedataという標準搭載されているモジュールを使用すると、簡単に半角英数とそれ以外を分ける事ができます。

記事では、半角英数を1文字、全角英数を2文字として計算していましたが、自分はそれぞれ0.5文字、1文字に変えました。

4.PyPIにアップロードする

PyPIへのアップロード方法は、以下をご参照ください。

あわせて読みたい
【初心者向け】Pythonの自作パッケージをPyPIに登録する方法 Pythonで作成したパッケージをPyPIに登録する手順を、初心者の方にも分かりやすく紹介しています。最新版では、「pyproject.toml」と「poetry」を活用しています。

これで、「pip install clipcount」とするだけで、どのOSでも「clipcount」が使えるようになりました。

まとめ

この記事では、「clipcount」という、クリップボードを読み取り文字数を計測できるツールの解説と開発過程をまとめました。

WordPressでは、タイトルやメタディスクリプションなどで文字数に気を配る必要があります。さらに、半角英数は0.5文字換算されるため、自分で計算するのは少々手間がかかります。

こうした場面で、clipcount -mが便利であると考えられます。ぜひご利用いただき、お役に立てれば幸いです。

参考サイト


  1. asweigart/pyperclip: Python module for cross-platform clipboard functions. ↩︎

よろしければハートマークを押してくださると幸いです!
大変励みになります😄
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

ゆすのアバター ゆす フリーランス

問題解決方法や役立つ知識をシェアするために、ブログを立ち上げました。また、実際に体験したサービスのレポートも記事としてまとめています。

お仕事のご依頼やご質問がございましたら、お気軽にお問い合わせください。

目次