
## TL;DR

Next.js と TypeScript を使った RSS の設定方法について解説しますね。非常に簡単に設定できます。

RSS（Really Simple Syndication）は、ウェブサイトの更新情報を一覧で知ることができるデータ形式の一つです。これを利用すると、ユーザーは RSS リーダーにウェブサイトの RSS フィードを登録することで、新規記事や更新記事の情報を一元的に取得できます。ユーザーエンゲージメントを高め、定期的な訪問者を増やすためのツールとして大変有用です。

Next.js で RSS を作成するには、サーバーサイドで動作する API エンドポイントを作成してそこから RSS を提供するのが一般的な方法です。次のような URL で RSS フィードを取得できます。

```bash
http://localhost:3000/api/feed
```

それでは、必要なライブラリをインストールします。

### rss インストール

RSS フィードを生成するためには`rss`という名前のパッケージを使うことができます。以下のコマンドでインストールできます。

```bash
npm install rss
```

### 通常の設定

`pages/api`ディレクトリ内に新しいファイルを作成します。例えば、`rss.ts`という名前にすることができます。

このファイル内で`rss`ライブラリを使用して RSS フィードを生成します。一般的には、次のようなコードになります。

Next/プロジェクト名/src/pages/api/feed.ts

```tsx
import { NextApiRequest, NextApiResponse } from 'next'
import RSS from 'rss'

const fetchYourData = async () => {
  return [
    {
      title: 'Example title 1',
      description: 'Example description 1',
      slug: 'example-slug-1',
      author: 'Example author 1',
      date: new Date(),
    },
    // More items...
  ]
}

const handler = async (_: NextApiRequest, res: NextApiResponse) => {
  const feed = new RSS({
    title: 'Your Website Title',
    description: 'Your Website Description',
    feed_url: 'https://yourwebsite.com/api/rss',
    site_url: 'https://yourwebsite.com',
    image_url: 'https://yourwebsite.com/icon.png',
    managingEditor: 'Your Name',
    webMaster: 'Your Name',
    copyright: 'Your Copyright Notice',
    language: 'ja',
    pubDate: new Date().toString(),
    ttl: 60,
  })

  const data = await fetchYourData()

  data.forEach((item: { title: string; description: string; slug: string; author: string; date: Date }) => {
    feed.item({
      title: item.title,
      description: item.description,
      url: `https://yourwebsite.com/${item.slug}`,
      author: item.author,
      date: item.date,
    })
  })

  res.setHeader('Content-Type', 'application/rss+xml')
  res.write(feed.xml())
  res.end()
}

export default handler
```

このスクリプトは API エンドポイントとして動作し、データソースから記事をフェッチしてそれを RSS フィードに追加しています。`fetchYourData`関数はダミーデータの例であり、ここを自分のデータソースからデータを取得するように書き換えてください。

最後に、RSS XML をレスポンスとして返します。このエンドポイントは`https://yourwebsite.com/api/rss`でアクセスできます。RSS リーダーはこの URL から RSS フィードを取得することができます。

注意点としては、サイトのタイトル、説明、URL、記事データなどを正しく設定することが重要です。また、フィード生成に時間がかかる場合は、キャッシュを使用することを検討してください。

### ローカルで開発する場合

ローカルで開発中でも RSS フィードを確認することは可能です。Next.js の API ルーティングはローカル開発サーバでも動作します。

1. まず、`npm run dev`などを使用して Next.js のローカル開発サーバを起動します。
2. 次に、ブラウザを開き、作成した API エンドポイントの URL を指定します。例えば、API エンドポイントを`pages/api/rss.ts`に作成した場合、その URL は`http://localhost:3000/api/rss`となります（3000 は Next.js のデフォルトのポートです。別のポートを設定した場合はそのポートを使用してください）。
3. この URL にアクセスすると、作成した RSS フィードが表示されます。RSS フィードは XML 形式で表示されます。

RSS フィードをパースして人間が読みやすい形式で表示するためには、専用の RSS リーダーを使用することを推奨します。多くのブラウザは XML を構造化して表示しますが、RSS リーダーはフィードの各エントリーに対応する情報を適切に表示します。

### Markdown からの設定

マークダウンファイルからのデータをフィードに反映させるには、まずそれらのマークダウンファイルを解析してデータを取得する必要があります。gray-matter というライブラリを使うことで、マークダウンファイルからメタデータ（フロントマター）と本文を抽出することができます。

それに加え、Next.js では getStaticProps という関数を使って、ビルド時に静的データを取得することができます。この関数の中でマークダウンファイルからデータを取得し、それをフィードに反映させることができます。

マークダウンが格納されている場所を、data/blog だとすると、次のような設定になります。ローカルでの例です。

```tsx
import fs from 'fs'
import path from 'path'
import matter from 'gray-matter'
import { NextApiRequest, NextApiResponse } from 'next'
import RSS from 'rss'

const POSTS_DIRECTORY = path.join(process.cwd(), 'data/blog')

const getAllPosts = () => {
  // Get file names under /posts
  const fileNames = fs.readdirSync(POSTS_DIRECTORY)
  const allPostsData = fileNames.map((fileName) => {
    // Remove ".md" from file name to get id
    const id = fileName.replace(/\.md$/, '')

    // Read markdown file as string
    const fullPath = path.join(POSTS_DIRECTORY, fileName)
    const fileContents = fs.readFileSync(fullPath, 'utf8')

    // Use gray-matter to parse the post metadata section
    const matterResult = matter(fileContents)

    // Combine the data with the id
    return {
      id,
      ...(matterResult.data as { date: string; title: string }),
    }
  })
  return allPostsData.sort((a, b) => {
    if (a.date < b.date) {
      return 1
    } else {
      return -1
    }
  })
}

const handler = async (_: NextApiRequest, res: NextApiResponse) => {
  const feed = new RSS({
    title: 'Your Website Title',
    description: 'Your Website Description',
    feed_url: 'http://localhost:3000/feed',
    site_url: 'http://localhost:3000',
    image_url: 'http://localhost:3000/icon.png',
    managingEditor: 'Your Name',
    webMaster: 'Your Name',
    copyright: 'Your Copyright Notice',
    language: 'ja',
    pubDate: new Date().toString(),
    ttl: 60,
  })

  const data = getAllPosts()

  data.forEach((item: { date: string; title: string; id: string }) => {
    feed.item({
      title: item.title,
      description: '', // descriptionがないので、空文字列を渡します。
      url: `http://localhost:3000/blog/${item.id}`, // slugはidと同じと仮定しています。
      author: '', // authorがないので、空文字列を渡します。
      date: new Date(item.date), // dateをDateオブジェクトに変換します。
    })
  })

  res.setHeader('Content-Type', 'application/rss+xml; charset=utf-8')
  res.write(feed.xml())
  res.end()
}

export default handler
```


Next.js と TypeScript を使って、自分だけの RSS を設定する方法を解説します。

Next.js と TypeScript で、RSS を出力する


## TL;DR

最近のフロントエンドでは、CSS や SCSS を使わずに、CSS-in-JS や Tailwind CSS などの CSS フレームワークを使った開発が主流になってきています。Tailwind CSS は、CSS を効率的に管理できるユーティリティファーストのフレームワークです。特に、マージンやパディングなどのスペーシングの設定が素早く行えます。

Tailwind CSS は効率的に CSS を管理できるユーティリティファーストのフレームワークです。特に、マージンやパディングなどのスペーシングの設定が素早く行えます。

しかし、Tailwind のデフォルトのスペーシングスケールでは対応しきれない場面も出てきます。そんな時はどうすればいいのでしょうか。そこで、今回は Tailwind CSS でカスタムマージンを設定する方法を解説します。

Tailwind CSS では、`tailwind.config.js`という設定ファイルを利用してカスタムマージンを設定できます。それでは早速、設定方法について詳しく見てみましょう。

### @tailwindcss/typography のインストール

ターミナルで以下のコマンドを実行して、`@tailwindcss/typography` をインストールしてください。

```bash
npm install @tailwindcss/typography
```

### .eslintrc.js の設定

.eslintrc.js の設定を行います。

```js
{
  "extends": ["next", "next/core-web-vitals", "prettier", "plugin:prettier/recommended"]
}
```

### tailwind.config.ts の設定

次に、Tailwind の設定ファイル`tailwind.config.js`を開きます。次に、`theme`プロパティの中に`extend`プロパティを追加します。その中に`spacing`プロパティを追加し、そこでカスタムマージンを定義します。

例えば、`margin-top: 80px;` を定義したい場合は、`mt-80`というクラス名を指定できるようにします。

```tsx
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    "./src/pages/**/*.{js,ts,jsx,tsx}",
    "./components/**/*.{js,ts,jsx,tsx}",
    "./src/styles/*.sass",
  ],
  theme: {
    screens: {
      sm: { max: "767px" }, // 768px 以下の画面幅に適用
      // ... 他のブレークポイントも定義できます。
    },
    extend: {
      // margin 関係すべてを px で指定する
      spacing: {
        10: "10px",
        20: "20px",
        30: "30px",
        40: "40px",
        50: "50px",
        60: "60px",
        70: "70px",
        80: "80px",
        90: "90px",
        100: "100px",
        110: "110px",
        120: "120px",
        130: "130px",
        140: "140px",
        150: "150px",
        160: "160px",
        170: "170px",
        180: "180px",
        190: "190px",
        200: "200px",
        210: "210px",
        220: "220px",
        230: "230px",
        240: "240px",
        250: "250px",
        260: "260px",
        270: "270px",
        280: "280px",
        290: "290px",
        300: "300px",
        310: "310px",
        320: "320px",
        330: "330px",
        340: "340px",
        350: "350px",
        360: "360px",
        370: "370px",
        380: "380px",
        390: "390px",
        400: "400px",
      },
    },
  },
  variants: {
    extend: {
      margin: ["responsive"],
    },
  },
  plugins: [require("@tailwindcss/typography")],
};
```

### カスタムマージンの利用

設定が完了したら、CSS クラスとして利用することができます。例えば、`mt-80`と指定することで、上マージンを 80px に設定することができます。他にも、`mb-80`と指定することで、下マージンを 80px に設定することができます。

TypeScript と Next.js を使ったコンポーネントでは、以下のように利用できます。

```tsx
type Props = {
  title: string;
};

const CustomMarginComponent = ({ title }: Props) => {
  return <div className="mt-80">{title}</div>;
};
```

#### メリット

これまで解説した方法には、いくつかのメリットがあります。

- プロジェクト全体で一貫したスペーシングが可能になります。
- 新しい開発者がプロジェクトに参加した場合でも、スペーシングの設定方法を短時間で理解することが可能です。
- スペーシングの変更が必要な場合、一箇所の変更で全体のスペーシングを変更することが可能です。

### 参考資料

ここまで読んで、「もっと詳しく学びたい！」という方は、以下のリンクを参考にしてみてください。

- [Tailwind CSS 公式ドキュメンテーション](https://tailwindcss.com/docs/spacing)
- [Tailwind CSS カスタムスペーシングの設定方法](https://nerdcave.com/tailwind-css-custom-spacing)
- [The Power of Utility-First CSS (by Sarah Dayan, Frontend Developer at Algolia)](https://www.youtube.com/watch?v=I7CfaDYzTVM)

以上が Tailwind CSS でのカスタムマージンの設定方法になります。もしもの時のために心に留めておいてくださいね。


Tailwind CSSを使った開発では、カスタムマージンの設定が頻繁に必要です。この記事では、Next.jsとTypeScriptを使ったプロジェクトでTailwindのカスタムマージンを設定する方法を解説します。

Next.js で、Tailwind カスタムマージンを設定する


## TL;DR

Web サイトの中には数多くのページが存在しますけど、これら全てのページに容易にアクセスできるように、そのリンクを一覧化したものがサイトマップなんですね。SEO 対策にも欠かせないこのサイトマップ、Next.js と TypeScript でどのように作成するのか解説します。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.3     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

`next-sitemap`は、Next.js プロジェクトのためのサイトマップを自動的に生成する npm パッケージです。それを使ってサイトマップを作成する方法は以下の通りです。

### インストール

まずはプロジェクトのルートディレクトリで次のコマンドを実行して、`next-sitemap`パッケージをインストールします:

```bash
npm install next-sitemap
```

もしくは、yarn を使っている場合は:

```bash
yarn add next-sitemap
```

次に、プロジェクトのルートディレクトリに`next-sitemap.config.js`という名前の新しいファイルを作成します。次に示すのは、基本的な設定の例です:

```js
module.exports = {
  siteUrl: 'https://example.com',
  generateRobotsTxt: true, // (optional)
  // ...other options
}
```

上記の`siteUrl`はあなたのウェブサイトの URL に置き換えてください。`generateRobotsTxt`オプションは`robots.txt`ファイルも生成するかどうかを制御します。

最後に、あなたの`package.json`ファイルに`postbuild`スクリプトを追加します。これにより、ビルド後にサイトマップが自動的に生成されます:

```json
"scripts": {
  "build": "next build",
  "postbuild": "next-sitemap"
}
```

以上の設定で、Next.js プロジェクトにサイトマップが追加されます。ビルドを行うと、自動的にサイトマップが生成され、`/public/sitemap.xml`に保存されます。

なお、`next-sitemap`の詳細な設定やオプションについては、公式ドキュメンテーションを参照してください。

## まとめ

Next.js と TypeScript を用いて、サイトマップの生成と設定が行えましたね。これらのステップに従うことで、サイトマップの設定が容易になり、SEO 対策とユーザビリティの向上につながります。

以上がサイトマップの設定方法についての解説です。最後になりますが、以下のリンクは、このトピックに関連する参考資料です。ぜひご覧になってみてください。

- [Google Search Console Help - Learn about sitemaps](https://support.google.com/webmasters/answer/156184?hl=en)
- [MDN Web Docs - Sitemaps](https://developer.mozilla.org/en-US/docs/Glossary/Sitemap)


サイトマップの設定方法について、Next.jsとTypeScriptを用いた実装手順を解説します。SEO対策とユーザビリティの向上に役立つサイトマップの重要性を理解しましょう。

Next.js と TypeScript で、サイトマップを作る


### duck typing（ダックタイピング） とは

duck typing（ダックタイピング） とは、クラスが別でも、同じ名前のメソッドを使用することができるスタイル。共通のメソッドを持ちさえすれば、継承を使わなくても、どのようなオブジェクトでも、これらのメソッドを実行できる。「型」より「ふるまい」に注目したスタイルである。

Luciano Ramalho 著の、[Fluent Python](https://amzn.to/33H2nmj) には次のように書かれている。

> ダックタイピングは、クラスやインターフェースの明示的な宣言にかかわりなく、適切なメソッドを実装するすべてのオブジェクトで関数が動作するポリモーフィズムの一形態。
>
> ダックタイピングとは無理に訳せば「アヒル流型付け」。オブジェクトは定義された型によって規定されるのではなくて、そのメソッドが何をするかで決まるという考え方を指します。100% アヒルであってもなくても（その型でなくても）、「ガーガー」鳴けばよいということです。そういった機能さえあればよい。

例えば、異なる 3 種類の says() メソッドが 3 つのクラスの異なる動作を行うのがポリモーフィズム（多態性）だが、ダックタイピングは、次のコードのように同じメソッドを持てば、どんなオブジェクトでもメソッドの同じ処理を実行できるようになる。

```python
# 1. 血縁関係のある家族クラスを作る
class Parent:
    def __init__(self, words):
        self.words = words
    def says(self):
        return self.words

class Child(Parent):
    def says(self):
        return self.words

class Grandchild(Parent):
    def says(self):
        return self.words

parent = Parent('親')
child = Child('子供')
grandchild = Grandchild('孫')

# 2. 上の家族とは血縁関係のない友人クラスを作る
class Frend:
    def says(self):
        return '友人'

frend = Frend()

# 3. says() を実行する関数を作る
def who_says(obj):
    print('私は、', obj.says(), 'です。')

# 4. 血縁に関係なく同じふるまいをする
who_says(parent)
#私は、 親 です。
who_says(child)
#私は、 子供 です。
who_says(grandchild)
#私は、 孫 です。
who_says(frend)
#私は、 友人 です。
```

### コードの詳説

1.  最初に、 Parent クラスを継承したサブクラスを 2 つ作り、インスタンス化している。
2.  次に、Parent クラスとは無関係の Frend クラスを作る。
3.  そして、共通のメソッドである says() を実行する関数を作り呼び出すと、Parent を継承したオブジェクトと、無関係のクラス Frend のオブジェクトのどちらも同じ動きが実行される。

このように共通のメソッド says() を持ちさえすれば、継承を利用しなくても様々なオブジェクトで同じ操作を切り替えることができる。つまり、ダックタイピングは「型」より「ふるまい」に注目したスタイルなのである。

これらのことを理解すると、公式ドキュメントに書かれていることも理解できる。

> あるオブジェクトが正しいインターフェースを持っているかを決定するのにオブジェクトの型を見ないプログラミングスタイルです。代わりに、単純にオブジェクトのメソッドや属性が呼ばれたり使われたりします。
>
> （「アヒルのように見えて、アヒルのように鳴けば、それはアヒルである。」）
>
> インターフェースを型より重視することで、上手くデザインされたコードは、ポリモーフィックな代替を許して柔軟性を向上させます。ダックタイピングは type() や isinstance() による判定を避けます。 (ただし、ダックタイピングを 抽象基底クラス で補完することもできます。) その代わり、典型的に hasattr() 判定や EAFP プログラミングを利用します。
>
> [duck-typing](https://docs.python.org/ja/3/glossary.html#term-duck-typing)


Python : duck typing（ダックタイピング） とは


### 関数の再帰呼び出し

関数の再帰呼び出しとは、「関数 A の中から、この関数 A 自身を呼び出すこと」である。

「ある手続きを実行している最中に、同じ手続きを、違う対象について行う」といった入れ子構造になった処理。大きな問題が小さな問題に収束するように使う。

### 再帰のルール

1. 再帰終了条件を持つ
2. 状態を変更しながら再帰終了条件に進む
3. 再帰的に関数自身を呼び出す

### 再帰関数の定義

再帰関数の定義は 2 つある。

1. 終了条件。終了条件は、最小の問題を処理する箇所。再帰呼び出しをせずに直接的に値を返す。
2. 再帰条件。再帰条件は「より小さな問題」を処理するための再帰呼び出しを行う。

問題を小さく分解していけば最終的に最小の問題を経由し終了条件が満たされるので、再帰が終了する。

### 関数の再帰呼び出しの例

次は再帰処理のシンプルな例である。引数 n を減算した値を、関数 total で加算しながらループさせ、n が 0 までたどり着いたときに再帰を停止する。

```python
def total(n):
    if n < 1: # 0 の時、再帰を停止
        return 0
    return n + total(n - 1) # 引数を減らしていく

print(total(3))
# 6
# 3 + 2 + 1


## 階乗の計算の例

次は階乗の計算（何通りの組み合わせがあるか？）を計算する例。引数に渡された数値を -1 しながら乗算している。

python
def fac(n):
    if n == 1:
        return 1
    else:
        return n * fac(n - 1)

print(fac(3))
# 6
# 3 * 2 * 1 = 6
```

### リストのリストなど入れ子になったデータを平坦化するコード

```python
def flat(x):
    for i in x:
        if isinstance(i, list):
            for i_in in flat(i):
                yield i_in
        else:
            yield i

x = [1, 2, [3, 4, 5], [6, [7, 8, 9]]]
list(flat(x))

# [1, 2, 3, 4, 5, 6, 7, 8, 9]
```


Python : 再帰は大きな問題が小さな問題に収束するように使う


## TL;DR

f-string は式を埋め込める文字リテラルである。先頭に f を付け、`f{式}`と書く。`{}` の中に、全ての Python 式を書くことができる。

#### セパレーター

`:,` とすると、カンマのセパレーターを入れる。

```python
a = 10000000000
print(f'{a:,}')
# 10,000,000,000

print(f'{a:_}')
# 10_000_000_000
```

#### 文字の位置を指定する

`:` の後ろに整数をつけると、フィールドの最小の文字幅を指定できる。揃えたいときに便利。
`:` の後ろにキャレット、小なり、大なり を置くと文字方向を指定できる。

- `:^` は、文字を中寄せ
- `:<` は、文字を左寄せ
- `:>` は、文字を右寄せ

そして、数値分の残りを指定の文字で繰り返して埋める。

```python
passwd = 'password'

print(f'{passwd:*^20}')
# ******password******

print(f'{passwd:*<20}')
# password************

print(f'{passwd:ば>20}')
# ばばばばばばばばばばばばpassword
```

`:<10` だと、空白 10 個分が埋められる。

```python
key = 'hello'
value = 1.234

f = f'{key} = {value}'
print(f)
# hello = 1.234

f = f'{key:<10} = {value:.4f}'
# :<10     最小フィールド幅
# :.4f     有効桁数（4桁）
print(f)
# 'hello'    = 1.2340
```

#### 改行

冗長なコードは改行して表示することができる。

```python
n = [
    ('a', 1),
    ('b', 2),
    ('c', 3),
]
for i, (item, count) in enumerate(n):
    print(f'{i}: '
          f'{item:<10} = '
          f'{count}')

# 0: a          = 1
# 1: b          = 2
# 2: c          = 3
```

#### フォーマット指定

フォーマットを指定する。

```python
fl = 1111
print(f'値は{fl:.3f}である！')
# 値は1111.000である！
```

#### 入れ

子
入れ子 `{{}}` でフォーマットを指定する。

```python
point = 3
fv = 222.1111999

print(f'{fv:.{point}f}')
# 222.111
```

#### バイナリデータ変換

バイナリデータに変換する。

```python
fl = 45
print(f'bit は {fl:b}')
# bit は 101101

print(f'hex は {fl:x}')
# hex は 2d

print(f'int は {fl:d}')
# int は 45
```

#### 日付の整形

日付を整形する。

```python
import datetime
d = datetime.datetime(2022, 1, 4, 3, 15, 59)
print(f'{d:%Y-%m-%d %H:%M:%S}')
# 2022-01-04 03:15:59
```

#### 置換 (conversion)

値に対して str() を呼ぶ `!s` 、 repr() を呼ぶ `!r` 、 ascii() を呼ぶ `!a` がサポートされている。

```python
name = '12345'
print(f'hello {name!r}')
# hello '12345'

print(f'hello {name}')
# hello 12345
```

> 置換 (conversion) フィールドにより書式変換前に型の強制変換が実施されます。通常、値の書式変換は `__format__()` によって実施されます。しかしながら、場合によっては、文字列として変換することを強制したり、書式指定の定義をオーバーライドしたくなることもあります。 `__format__()` の呼び出し前に値を文字列に変換すると、通常の書式変換の処理は飛ばされます。現在 3 つの変換フラグがサポートされています: 値に対して str() を呼ぶ `!s` 、 repr() を呼ぶ `!r` 、 ascii() を呼ぶ `!a`。 [string --- 一般的な文字列操作 — Python 3.10.0b2 ドキュメント](https://docs.python.org/ja/3/library/string.html)

#### 計算

計算を行う。

```python
s = 10
print(f'{s + 1}')
# 11

w = 'world '
f'hello {w * 3}'
# 'hello world world world'

import math
print(f'{math.pi:.2f}')
# 3.14
```

#### テキスト

テキストを代入する。

````python
w = 'world'
f'hello {w}'
# 'hello world'

file_name = 'flower.jpg'
alt_name = '花の写真です'
f'<img src="{file_name}" alt="{alt_name}">'
# <img src="flower.jpg" alt="花の写真です">
``

`

#### 式をそのまま表示する
`=` は名前を表示する。`=`` の直後に `:` を入れると、配置や幅を指定できる。
```python
a = 'apple'
b = 'banana'

print(f'{a}, {b}')
# apple, banana

# = を付ける
print(f'{a=}, {b=}')
# a ='apple', b ='banana'

# 配置.幅
print(f'{a=:10.2}, {b=:.3}')
# a = ap        , b =ban
````

#### 関数

関数の結果を返す。

```python
def func():
    return 'hoge'

print(f'{func()}')
# hoge
```

#### リスト

リストの要素を返すこともできる。

```python
img = ['flower.jpg', '花の写真です']
f'<img src="{img[0]}" alt="{img[1]}">'
# <img src="flower.jpg" alt="花の写真です">

w = ['apple', 'banana', 'cherry']
f'{w[1].title()}'
# 'Banana'
```

式を複数入れられる。

```python
w = ['apple', 'banana', 'cherry']
f'{w[0].capitalize()} is not the same as...{w[1].rjust(20)}.'
# 'Apple is not the same as...              banana.'
```


Python: f-string（f 文字列）と「:」の便利な使い方


## TL;DR

Python 3 では、文字列データを表すのに bytes と str がある。bytes のインスタンスは符号なし 8 ビット値で構成され、ASCII（文字コードの標準規格） エンコーディングで表示される。str は Unicode コードポイントの文字列を含む。

### bytes 型 と str 型 のポイント

- str と bytes は同時に扱えない
- ファイルにバイナリデータを書き込む場合、バイナリモードでオープンしなければならない
- bytes は 8 ビットの値の列を含む
- str は Unicode コードポイントの文字列を含む

#### バイナリデータについて

データ形式を大別すると、テキストとバイナリに分類される。バイナリデータとは、文字・画像・音楽・動画などテキストデータ以外のデータ。人が見ても意味が不明瞭なデータである。

バイナリデータを操作するためのものは 2 つある。

- bytes:イミュータブル（変更不可）。バイトのタプルのようなもの
- bytearray:ミュータブル（変更可）。バイトのリストのようなもの

[組み込み型 — Python 3.10.0b2 ドキュメント](https://docs.python.org/ja/3/library/stdtypes.html#binary-sequence-types-bytes-bytearray-memoryview)

#### bytes 型

bytes 型はコンピューターにとって扱いやすいバイト配列を扱う。バイトの不変なシーケンス（複数の要素を順番に並べたデータ型）である。str 型は人が読み書きしやすいが、bytes 型はコンピューターにとって扱いやすい。ハードディスクに直接保存可能である。

b の後で、クォートで囲むとバイト型になる。次のコードでは、encode() を使い文字列をエンコードしている。

```python
# str を bytes に変換する
s = 'café'
print(type(s))
b = s.encode('utf8')
print(b)
print(type(b))

# bytes を str に変換する
bb = b'd\xc3\xa9j\xc3\xa0 vu'
s = bb.decode('utf8')
print(s)
print(type(s))
```

#### str 型

str 型は文字列を扱う。str は Unicode コードポイントの不変なシーケンスである。人間が読み書きしやすい形式にするため、エンコード (str -> bytes) とデコード (bytes -> str) を行う。

### bytes と str の変換

Python では、文字列をバイト列に変換するには str オブジェクトの encode メソッドを使用し、逆にバイト列を文字列に変換するには bytes オブジェクトの decode メソッドを使用する。

#### encode メソッド

encode メソッドを使うと、str を bytes に変換できる。エンコードには様々な方式があるが、一般的によく使われるのは UTF-8 である。

```python
# str を bytes に変換する
s = 'café'
b = s.encode('utf8')
print(b)
```

#### decode メソッド

decode メソッドを使うと、bytes を str に変換できる。エンコードした方式と同じ方式を指定する。

```python
# bytes を str に変換する
bb = b'd\xc3\xa9j\xc3\xa0 vu'
s = bb.decode('utf8')
print(s)
```

Python の文字列とバイト列の取り扱いは独特な部分もあるので、使い分けや変換方法を理解しておくと便利である。


Python 3 では、文字列データを表すのに bytes と str がある。bytes のインスタンスは符号なし 8 ビット値で構成され、ASCII（文字コードの標準規格） エンコーディングで表示される。str は Unicode コードポイントの文字列を含む。

Python: bytes 型 と str 型の違い。変換方法


## TL;DR

MySQL へ接続するモジュール mysqlclient を使うには、インポートの際に MySQLdb と記述する必要がある。

### mysqlclient のインストール

MySQL と mysqlclient をインストールする。

```python
brew install mysql
pip install mysqlclient
```

[mysqlclient · PyPI](https://pypi.org/project/mysqlclient/)

### mysqlclient のインポート

```python
import MySQLdb
```

インポートしたときに ModuleNotFoundError エラーが出る場合は、[インポートしたときに「ModuleNotFoundError」になる場合の対処法](https://commte.net/7655)を参考にするとよい。

### Python DB API のバージョンを確認する

インポートが正しく動いたら、データベースのモジュールが PEP 249 に準拠しているか調べておこう。Python の扱うデータベース API は、[PEP 249](https://www.python.org/dev/peps/pep-0249/)によって、API 仕様の統一がされている。

#### apilevel

データベースのモジュールが、PEP 249 に準拠しているか調べたい場合、apilevel を使う。apilevel は、サポートされているデータベース API レベルを示す文字列定数である。現在、文字列「1.0」と「2.0」のみが許可されている。

```python
import MySQLdb
print(MySQLdb.apilevel)
# 2.0
```

2.0 と表示された。DB API 2.0 に準拠している。

### データベース作成

次に、データベースを作る。sample というデータベースを作成してみよう。mysql をたたいた後で、create database を入れる。

```python
mysql
create database sample;
```

### データベースに接続しテーブルを作る

基本的なメソッドは次のとおり

#### connect

データベースに接続するために `connect()` メソッドを使用します。このメソッドは、データベースへの接続を表すコネクションオブジェクトを返します。

```python
db = MySQLdb.connect(host="localhost", user="username", passwd="password", db="sample")
```

ここで、`"username"` と `"password"` は実際の MySQL のユーザ名とパスワードに置き換えてください。

#### cursor

データベースに対して操作を行うためには、カーソルオブジェクトが必要です。これはコネクションオブジェクトの `cursor()` メソッドを使用して取得できます。

```python
cursor = db.cursor()
```

#### execute

SQL コマンドを実行するためには、カーソルオブジェクトの `execute()` メソッドを使用します。

以下の例では、新しいテーブルを作成します。

```python
cursor.execute("CREATE TABLE example (id INT, name VARCHAR(20));")
```

### with 文の使い方

with 文を使うと、データベースの接続やカーソルの取得、そして処理が完了した後のクリーンアップを一連のブロック内で自動的に行うことができます。

```python
with MySQLdb.connect(host="localhost", user="username", passwd="password", db="sample") as db:
    with db.cursor() as cursor:
        cursor.execute("CREATE TABLE example (id INT, name VARCHAR(20));")
```

with 文を使うことで、データベース接続が適切に閉じられ、リソースのリークを防ぐことができます。また、エラーが発生した場合でも、接続が適切に閉じられることが保証されます。

---

以上が mysqlclient（MySQLdb）の基本的な使用方法です。これらの手順を踏むことで、Python から MySQL に対する様々な操作を行うことが可能になります。さらに詳しく知りたい方は、公式ドキュメンテーションを参照してください。


この記事ではPythonでMySQLに接続するためのモジュールmysqlclient（MySQLdb）の使用方法について説明します。具体的なインストール手順、インポート方法、APIバージョンの確認方法、データベース作成、データベース接続とテーブル作成、およびwith文の使用について詳しく説明します。

Python: MySQL へ接続するモジュール mysqlclient（MySQLdb）の使い方


## TL;DR

モジュールをインストールした後、ファイルに「import モジュール名」を記載すると ModuleNotFoundError というエラーが出る場合の対処法。

ModuleNotFoundError が出たときは、次の 3 点を確認する。

1. モジュールが格納されているパスを確認する
2. .bashrc に PYTHONPATH を記述する
3. .bashrc を再読み込みする

### ModuleNotFoundError

ModuleNotFoundError は、モジュールが読み込めていないことを表している。

インポートを試みたがモジュールが読み込めない、そういった場合に表示される。

例えば、MySQL へ接続するモジュール mysqlclient を インストールし、test.py というファイルの冒頭にインポート文を記述したとしよう。

```python
import MySQLdb
```

しかし、いざ Python を走らせようとすると、次のようにモジュールの読み込みエラーがでる。

```bash
Traceback (most recent call last):
  File "/Users/ユーザー名/projects/Python/test.py",
  line 1, in <module>
    import MySQLdb
ModuleNotFoundError: No module named 'MySQLdb'
```

こういうケースでは、モジュール名の見直しを行うか、.bashrc に モジュール検索パスである PYTHONPATH を指定してあげると解決することがある。

### 手順

#### モジュールが格納されているパスを確認する

次の方法でモジュールがインストールされているパスを調べる。pprint を使って、パスを整形表示したほうが見やすい。

```python
>>> import sys
>>> import pprint
>>> pprint.pprint(sys.path)
['',
 '/Users/ユーザー名/.pyenv/versions/3.9.6/lib/python39.zip',
 '/Users/ユーザー名/.pyenv/versions/3.9.6/lib/python3.9',
 '/Users/ユーザー名/.pyenv/versions/3.9.6/lib/python3.9/lib-dynload',
 '/Users/ユーザー名/.pyenv/versions/3.9.6

/lib/python3.9/site-packages']
```

上記の場合、パスは通っている。モジュールは「site-packages」以下に格納されている。

パスが通ってない場合は、モジュールが格納されている場所を探し、ディレクトリを直接確認してみよう。

```bash
ユーザー
└── .pyenv
    └── versions
        └── 3.9.6
            └── lib
                └── python3.9
                    └── site-packages
                        ├── MySQLdb
                        ├── numpy
                        ├── path
                        └── pip
```

そして、パスを追加する。

```python
>>> sys.path.append('パス')
```

#### .bashrc に PYTHONPATH を記述する

.bashrc に、先程調べたモジュールのパスを追加する。.bashrc の場所は、Mac の場合 `/Users/ユーザー名/` の中にある。

PYTHONPATH の記述方法はこちらである。PYTHONPATH は、モジュールファイルのデフォルトの検索パスを追加する。

```bash
$ export PYTHONPATH="モジュールへのパス:${PYTHONPATH}"
```

ディレクトリパスの最後にはスラッシュは付けない。

```bash
$ export PYTHONPATH="/Users/ユーザー名/.pyenv/versions/3.9.6/lib/python3.9/site-packages:${PYTHONPATH}"
```

> この環境変数のフォーマットは、(Unix ならコロン、 Windows ならセミコロン) で区切られた 1 つ以上のディレクトリパスです。存在しないディレクトリは警告なしに無視されます。 [コマンドラインと環境 — Python 3.10.0b2 ドキュメント](https://docs.python.org/ja/3/using/cmdline.html#envvar-PYTHONPATH)

#### .bashrc を再読み込み

保存したら、忘れずに.bashrc を再読み込みする。

```bash
$ source ~/.bashrc
```

私の場合はこれで無事に稼働した。

### 上述した方法でも動かない場合

何かの理由で .bashrc を編集できない場合、次のように、py ファイルの上部に sys.path.addend()メソッドを直接記述することで動く可能性がある。

```python
import sys
sys.path.append("/Users/ユーザー名/.pyenv/versions/3.9.6/lib/python3.9/site-packages")

import numpy as np
```


モジュールをインストールした後、ファイルに「import モジュール名」を記載すると ModuleNotFoundError というエラーが出る場合の対処法について説明します。

Python: インポートしたときに「ModuleNotFoundError」になる場合の対処法


## TL;DR

Python 標準ライブラリである collections の Counter()関数は要素数の計算を行う。出現の回数を集計する場合などに便利である。

### Counter()クラス のポイント

- ハッシュ（辞書）可能なオブジェクトを数え要素数を返す
- イテラブル、マッピング、キーワード引数のオブジェクトを数える
- 和集合・減算・積集合などが可能
- subtract()で減算を行う
- most_common()で要素を降順で返す

```python
c = Counter()
# 空のカウンターを作成する

c = Counter('gallahad')
# イテラブルなカウンター作成

c = Counter({'red': 4, 'blue': 2})
# マッピング

c = Counter(cats=4, dogs=8)
# キーワード引数セット
```

> ハッシュ可能なオブジェクトを数え上げる辞書（dict）のサブクラス。要素を辞書のキーとして保存し、そのカウントを辞書の値として保存するコレクション。 [collections --- コンテナデータ型 — Python 3.10.0b2 ドキュメント](https://docs.python.org/ja/3/library/collections.html?highlight=collections%20counter#collections.Counter)

### Counter()

要素数を数える。存在しない要素には 0 を返す。

```python
from collections import Counter
c = Counter(['a', 'a', 'b', 'c'])
c['a']
# 2
```

イテラブルな要素を数える。イテラブルなオブジェクトとは、リスト、タプル、辞書、文字列など複数の要素を持ったオブジェクトを指す。

次のコードでは、タプルや文字もイテラブルなのでカウントされている。

```python
c = Counter('abbbd')
c
# Counter({'a': 1, 'b': 3, 'd': 1})

c = Counter(('a', 'a', 'a', 'b', 'c', 'c'))
c
# Counter({'a': 3, 'b': 1, 'c': 2})
```

#### 結合

リストの結合。

````python
one = Counter(['a', 'a', 'a', 'b', 'c', '
```markdown
c', 'c'])
two = Counter(['a', 'b', 'b', 'b', 'c'])
three = one + two
print(three)
# Counter({'a': 4, 'b': 4, 'c': 3})
````

#### 差分

```python
one = Counter(['a', 'a', 'a', 'b', 'c', 'c', 'c'])
two = Counter(['a', 'b', 'b', 'b', 'c'])
three = one - two
print(three)
# Counter({'a': 2, 'c': 2})
```

#### 交差点

```python
one = Counter(['a', 'a', 'a', 'b', 'c', 'c', 'c'])
two = Counter(['a', 'b', 'b', 'b', 'c'])
three = one & two
print(three)
# Counter({'a': 1, 'b': 1, 'c': 1})
```

#### 積集合

```python
one = Counter(['a', 'a', 'a', 'b', 'c', 'c', 'c'])
two = Counter(['a', 'b', 'b', 'b', 'c'])
three = one | two
print(three)
# Counter({'a': 3, 'b': 3, 'c': 3})
```

### most_common()

最も一般的な要素を降順で返す。

```python
c = Counter('abbbccccd')
print(c.most_common())
# [('c', 4), ('b', 3), ('a', 1), ('d', 1)]
```

引数を指定すると、その数だけ要素を返す。

```python
print(c.most_common(2))
# [('c', 4), ('b', 3)]
```

このように、Counter()は非常に便利な関数で、Python のコーディングにおいて頻繁に使用される。データ分析や情報処理の際には特に役立つツールである。


Python 標準ライブラリである collections の Counter()関数は要素数の計算を行う。出現の回数を集計する場合などに便利である。

2023-05-23

Next.js と TypeScript で、RSS を出力する

2023-05-23

Next.js で、Tailwind カスタムマージンを設定する

2023-05-22

Next.js と TypeScript で、サイトマップを作る

2022-1-22

Python : duck typing（ダックタイピング）とは

2022-1-14

Python : 再帰は大きな問題が小さな問題に収束するように使う

2021-12-7

Python: f-string（f 文字列）と「:」の便利な使い方

2021-12-06

Python: bytes 型と str 型の違い。変換方法

2021-12-02

Python: MySQL へ接続するモジュール mysqlclient（MySQLdb）の使い方

2021-12-01

Python: インポートしたときに「ModuleNotFoundError」になる場合の対処法

2021-11-29

Python: カウンタ。Counter()関数で要素数を計算する

2023-05-23

Next.js と TypeScript で、RSS を出力する

2023-05-23

Next.js で、Tailwind カスタムマージンを設定する

2023-05-22

Next.js と TypeScript で、サイトマップを作る

2022-1-22

Python : duck typing（ダックタイピング） とは

2022-1-14

Python : 再帰は大きな問題が小さな問題に収束するように使う

2021-12-7

Python: f-string（f 文字列）と「:」の便利な使い方

2021-12-06

Python: bytes 型 と str 型の違い。変換方法

2021-12-02

Python: MySQL へ接続するモジュール mysqlclient（MySQLdb）の使い方

2021-12-01

Python: インポートしたときに「ModuleNotFoundError」になる場合の対処法

2021-11-29

Python: カウンタ。Counter()関数で要素数を計算する

Python : duck typing（ダックタイピング）とは

Python: bytes 型と str 型の違い。変換方法