フッターコンテンツにスキップ
.NETヘルプ

CLIの簡素化と.NETの橋渡し:Curl DotNetとIronPDFを使う

迅速なコマンドラインツールスクリプトと堅牢な.NETコードの間のギャップをナビゲートする開発者にとって、摩擦はしばしば、C#内で適切なHTTPリクエストに動作するcURLコマンドを翻訳することにあります。 Jacob Mellorは、CurlDotNetでこのギャップを埋めました。これは、.NETエコシステムにcURLの親しみやすさをもたらすために作成されたライブラリです。

IronPDFIronXLのようなIron Software製品とこのツールを組み合わせることで、複雑なAPIコールを介してデータを取得し、すぐにプロフェッショナルなレポートを生成する強力なパイプラインを構築することができます。 この記事では、プロジェクトを次のレベルに引き上げるために、これらのツールが連携できるいくつかの例を見ていきます。

CurlDotNetとは

CurlDotNetは、業界標準のcurlツールの純粋なC# .NET実装です。 ネイティブの依存関係やlibcurlに依存するラッパーとは異なり、このライブラリは、Windows、Linux、macOSなどを完全にサポートする100%マネージドソリューションを提供します。 標準クライアントと同じ動作を保証し、APIドキュメントからコマンドのbashコピーをコードに直接貼り付けることができます。

クイック スタートとインストール

開始するには、プロジェクトディレクトリで次のコマンドを実行するだけです:

dotnet add パッケージ curldotnet

CurlDotNetパッケージがインストールされ、HttpClient設定のオーバーヘッドなしにWebリクエストを処理するためのレシピにアクセスできるようになります。

Curl-Dot-NetのCurlコマンドを使用する

このライブラリは、文字列値コマンドの解析に優れています。 GitHub API ページや内部ドキュメントから、動作する curl https 文字列があれば、それを直接実行することができます。

using CurlDotNet;

// Simply copy-paste your shell command
var command = "curl -X GET https://api.github.com/users/jacob-mellor -H 'User-Agent: curl-dot-net'";
var result = await Curl.ExecuteAsync(command);
Console.WriteLine(result.Body);
using CurlDotNet;

// Simply copy-paste your shell command
var command = "curl -X GET https://api.github.com/users/jacob-mellor -H 'User-Agent: curl-dot-net'";
var result = await Curl.ExecuteAsync(command);
Console.WriteLine(result.Body);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

.NET コード Curl DotNet 出力

最初の Curl DotNet コマンドの出力

構造化されたアプローチを好む人のために、fluentビルダーは、ヘッダー、curlオプション、およびアクセストークンを設定するためのクリーンなAPIを提供します。

var response = await Curl.GetAsync("https://api.github.com/users/ironsoftware")
    .WithHeader("Authorization", "Bearer YOUR_TOKEN")
    .WithHeader("X-API-Key", "12345")
    .ExecuteAsync();
var response = await Curl.GetAsync("https://api.github.com/users/ironsoftware")
    .WithHeader("Authorization", "Bearer YOUR_TOKEN")
    .WithHeader("X-API-Key", "12345")
    .ExecuteAsync();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

この柔軟性は、TLSハンドシェイクの仕組み、レート制限、エラー処理を内部的に処理し、curl実行ファイルのデフォルトの動作を模倣します。

.NETフレームワークにおけるIronSoftwareとの統合

CurlDotNetの出力をIron Softwareツールにパイプすることで、真の力が発揮されます。 CurlDotNetはトランスポートレイヤー(JSON、ファイル、またはHTMLのフェッチ)を処理するため、IronSoftware製品はコンテンツの処理に集中することができます。

シナリオAPIデータからPDFレポートを生成する

安全なURLからユーザーデータをダウンロードし、PDFレポートを作成する必要があるとします。 APIには特定のbashシグネチャが必要で、HttpClientで再現するのは困難ですが、curlコマンドなら簡単です。

ステップ1:Curl-Dot-Netでデータを取得する

// Define the curl command string with all necessary headers (here we use an example test website)
string curlCmd = "curl https://www.w3.org/TR/html4/ -H 'X-API-Key: secure_key'";

// Execute the request
var result = await Curl.ExecuteAsync(curlCmd);

// Extract the content (assumed to be HTML for this scenario)
string htmlContent = result.Body;
// Define the curl command string with all necessary headers (here we use an example test website)
string curlCmd = "curl https://www.w3.org/TR/html4/ -H 'X-API-Key: secure_key'";

// Execute the request
var result = await Curl.ExecuteAsync(curlCmd);

// Extract the content (assumed to be HTML for this scenario)
string htmlContent = result.Body;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ステップ2: IronPDFでPDFを生成する

IronPDFは、HTML、CSS、JavaScript画像を忠実度の高いPDFドキュメントにレンダリングするために設計された強力なライブラリです。 最新のWeb標準を完全にサポートし、ヘッダー、フッターの追加、特定のレンダリングオプションの設定などの機能を含みます。

using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert the fetched HTML data to PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the file to the output path
pdf.SaveAs("output.pdf");
using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert the fetched HTML data to PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the file to the output path
pdf.SaveAs("output.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

CurlDotNetとIronPDFを使用してPDFに変換したテストウェブサイト

シナリオJSONをExcelにエクスポートする。

アプリがJSONフィードを消費する場合、CurlDotNetのテスト機能を使用してフェッチし、IronXLを使用してエクスポートすることができます。

ステップ 1: Curl-Dot-Net で JSON データをフェッチする。

JSONフィードのフェッチには、クリーンな.NETコードのためのfluentビルダーを使用しています:

string testUrl = "https://jsonplaceholder.typicode.com/users";

Console.WriteLine($"Executing HTTP request to fetch JSON from: {testUrl}");
// Replace the CurlDotNet fluent builder usage with the correct async method
var response = await Curl.GetAsync(testUrl); // Use Curl.GetAsync() for async HTTP GET

string jsonBody = response.Body;
string testUrl = "https://jsonplaceholder.typicode.com/users";

Console.WriteLine($"Executing HTTP request to fetch JSON from: {testUrl}");
// Replace the CurlDotNet fluent builder usage with the correct async method
var response = await Curl.GetAsync(testUrl); // Use Curl.GetAsync() for async HTTP GET

string jsonBody = response.Body;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ステップ2: IronXLを使用してExcelにロードしてエクスポートする

IronXLは、読み込み書き込み、およびExcelファイル形式(.xlsx、.xls、.csv)の操作のすべての側面を処理するように設計された包括的な.NETライブラリです。 重要なのは、サーバーやクライアントマシンにMicrosoft Officeをインストールする必要がないため、クロスプラットフォームのLinuxやCI CD環境に最適であることです。 主な機能には、グラフの作成、数式の適用、セルのスタイル設定などの完全なサポートが含まれます。

生のJSONデータが文字列になったので、IronXLを使用してそれを解析し、スプレッドシートを作成することができます。

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
 var sheet = workbook.CreateWorkSheet("User Data");

 // 1. Deserialize the JSON string to a list of UserRecord objects
 Console.WriteLine("Deserializing JSON data...");
 var salesRecords = JsonConvert.DeserializeObject<List<UserRecord>>(jsonBody);

 // 2. Insert the data into the sheet using IronXL's SetCellValue method
 Console.WriteLine("Inserting data into Excel using IronXL...");

 // Write headers
 sheet.SetCellValue(0, 0, "id");
 sheet.SetCellValue(0, 1, "name");
 sheet.SetCellValue(0, 2, "username");
 sheet.SetCellValue(0, 3, "email");

 // Write data rows
 for (int i = 0; i < salesRecords.Count; i++)
 {
     var record = salesRecords[i];
     sheet.SetCellValue(i + 1, 0, record.id);
     sheet.SetCellValue(i + 1, 1, record.name);
     sheet.SetCellValue(i + 1, 2, record.username);
     sheet.SetCellValue(i + 1, 3, record.email);
 }

 // Save the Excel file
 string filePath = "UserReport.xlsx";
 workbook.SaveAs(filePath);

 Console.WriteLine($"\n Success! Excel report saved to: {Path.GetFullPath(filePath)}");
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
 var sheet = workbook.CreateWorkSheet("User Data");

 // 1. Deserialize the JSON string to a list of UserRecord objects
 Console.WriteLine("Deserializing JSON data...");
 var salesRecords = JsonConvert.DeserializeObject<List<UserRecord>>(jsonBody);

 // 2. Insert the data into the sheet using IronXL's SetCellValue method
 Console.WriteLine("Inserting data into Excel using IronXL...");

 // Write headers
 sheet.SetCellValue(0, 0, "id");
 sheet.SetCellValue(0, 1, "name");
 sheet.SetCellValue(0, 2, "username");
 sheet.SetCellValue(0, 3, "email");

 // Write data rows
 for (int i = 0; i < salesRecords.Count; i++)
 {
     var record = salesRecords[i];
     sheet.SetCellValue(i + 1, 0, record.id);
     sheet.SetCellValue(i + 1, 1, record.name);
     sheet.SetCellValue(i + 1, 2, record.username);
     sheet.SetCellValue(i + 1, 3, record.email);
 }

 // Save the Excel file
 string filePath = "UserReport.xlsx";
 workbook.SaveAs(filePath);

 Console.WriteLine($"\n Success! Excel report saved to: {Path.GetFullPath(filePath)}");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力Excelファイル

CurlDotNetとIronExcelで作成したExcelファイル

なぜこの組み合わせなのか?

1.クロスプラットフォームの一貫性: CurlDotNetIronSoftware の両製品は、Windows、Linux、macOS をサポートしています。 これは、Microsoft AzureやAWS Lambdaのようなランタイム環境で実行されるCI CDパイプラインにとって非常に重要です。

2.コード生成:開発者はしばしばbashやシェル形式のコード生成スニペットを手にします。 curl-dot-netはこれらのスニペットを直接使用できるようにし、IronSoftwareは文書操作の重労働を処理します。

3.ネイティブ依存なし: CurlDotNetは純粋なC#実装であるため、外部C++ライブラリやlibcurlバイナリを異なるOSバージョンでリンクする際に発生する一般的な問題を避けることができます。

結論

Jacob Mellorは、DotNetコミュニティに不可欠なツールを提供しました。 開発者が.NET FrameworkおよびCoreアプリケーション内で使い慣れたcurlオプションを使用できるようにすることで、CurlDotNetはhttpリクエストプロセスを簡素化します。 Iron Softwareと組み合わせることで、シームレスなワークフローを作ることができます: curlの正確さでデータを取得し、IronPDFやIronXLのパワーで処理します。

問題が発生した場合は、GitHub ページにバグを報告して、すべてのユーザーのサポート向上に役立ててください。

よくある質問

CurlDotNetとは?

CurlDotNetは、cURLの機能を.NETエコシステムにもたらすためにJacob Mellorによって作成されたライブラリで、開発者はcURLコマンドを.NETコードに簡単に翻訳することができます。

CurlDotNetは開発者にどのように役立ちますか?

CurlDotNetは、C#内でcURLコマンドライン操作をHTTPリクエストに変換するプロセスを簡素化することで開発者を支援し、コマンドラインツールのスクリプトを堅牢な.NETアプリケーションに簡単に統合できるようにします。

CurlDotNetはどのような問題を解決しますか?

CurlDotNetは、C#で動作するcURLコマンドを適切なHTTPリクエストに変換する際に開発者が直面する摩擦の問題を解決します。CurlDotNetは、cURLのシンプルさに慣れ親しんだ開発者に、使い慣れたアプローチを提供します。

CurlDotNetはIronPdfと一緒に使用できますか?

はい、CurlDotNetは.NETアプリケーションのPDF生成ワークフローの一部としてHTTPリクエストのしやすさを向上させるためにIronPDFと一緒に使用することができます。

CurlDotNetは初心者に適していますか?

CurlDotNetは、.NETやHTTPリクエストに慣れていない方でも学習しやすい、使い慣れたコマンドラインスタイルのインターフェイスを提供しているため、初心者の方にも適しています。

CurlDotNetをIronPDFで使用する利点は何ですか?

CurlDotNetとIronPdfを使用することで、開発者はPDFを生成しながらHTTPリクエストを合理化し、効率を向上させ、両方のツールの長所を活用することができます。

CurlDotNetについてもっと知りたいのですが?

CurlDotNetの詳細については、Mediumに掲載されたJacob Mellorの記事をご覧ください。この記事では、ライブラリがcURLコマンドと.NETコード間のギャップをどのように埋めるかについての詳細な洞察を提供しています。

Jacob Mellor、Ironチームの最高技術責任者(CTO)
最高技術責任者(CTO)

Jacob Mellorは、Iron Softwareの最高技術責任者であり、C# PDF技術の開拓者としてその先進的な役割を担っています。Iron Softwareのコアコードベースのオリジナルデベロッパーである彼は、創業時から製品のアーキテクチャを形作り、CEOのCameron Rimingtonと協力してNASA、Tesla、全世界の政府機関を含む50人以上の会社に成長させました。

Jacobは、1998年から2001年にかけてマンチェスター大学で土木工学の第一級優等学士号(BEng)を取得しました。1999年にロンドンで最初のソフトウェアビジネスを立ち上げ、2005年には最初の.NETコンポーネントを作成し、Microsoftエコシステムにおける複雑な問題の解決を専門にしました。

彼の旗艦製品であるIronPDFとIronSuite .NETライブラリは、全世界で3000万以上のNuGetインストールを達成しており、彼の基本コードが世界中で使用されている開発者ツールを支えています。商業的な経験を25年間積み、コードを書くことを41年間続けるJacobは、企業向けのC#、Java、およびPython PDF技術の革新を推進し続け、次世代の技術リーダーを指導しています。