NYTPROFCSV(1p)

📦
version 6.15 · 6 versions
, in ubuntu stonking

💖 NYTPROFCSV 💖

okay so bestie, you found your way to nytprofcsv — that's the manual page name, it lives in the User Contributed Perl Documentation section (section 1p, for the perl girlies 👑). Buckle up, because this one comes with a vibe warning up top and I need you to hear me out before you get attached.

🌸 NAME 🌸

nytprofcsv — the (DEPRECATED) CSV format implementation of Devel::NYTProf::Reader. yes. deprecated. I said what I said. we'll get to that. 😭

✨ SYNOPSIS ✨

$ nytprofcsv [-h] [-d] [-o <output directory>] [-f <input file>]

perl -d:NYTProf some_perl_app.pl
nytprofcsv
Generating CSV Output...

like, that's the whole serve. run your perl app under the profiler, then run the script, and it says Generating CSV Output... at you like the little icon it is. 💅

💀 NOTE 💀

bestie. listen. nytprofcsv is deprecated and will be removed in a future release. this is not a drill. it's giving "on life support." use it if you must, but don't build your whole personality around it. 🫶

🦋 DESCRIPTION 🦋

so nytprofcsv is a script that implements Devel::NYTProf::Reader — and what it does is create comma-separated value formatted reports from Devel::NYTProf databases. CSV. commas. you know the drill.

if you want the fuller picture, go look at the Devel::NYTProf Perl code profiler, that's where all the lore lives. ✨

🎀 COMMAND-LINE OPTIONS 🎀

these are the command line options that nytprofcsv understands. there are four. four little icons. learn them.

  • -f, --file <filename> — tells it where the input file is at. ⚠️ and heads up: the input file must be the output of fprofpp. default is nytprof.out.
  • -o, --out <dir> — where the generated report gets placed. default is ./nytprof/.
  • -d, --delete — purges any existing database sitting at whatever -o (above 👆) is set to. it's giving "clean slate, no baggage, fresh start." 🧹
  • -h, --help — prints the help message. the classic. the beloved. the "help me help you." 🫶

🌈 SAMPLE OUTPUT 🌈

here's what it spits out, and honestly? look at it. it's giving data.

# Profile data generated by Devel::NYTProf::Reader v.0.01
# Format: time,calls,time/call,code
0,0,0,#--------------------------------------------------------------------
0,0,0,# My New Source File!
0,0,0,#--------------------------------------------------------------------
0,0,0,
0,0,0,package NYT::Feeds::Util;
0.00047,3,0.000156666666666667,use Date::Calc qw(Add_Delta_DHMS);
0.00360,3,0.0012,use HTML::Entities;
0.00212,3,0.000706666666666667,use Encode;
0.00248,3,0.000826666666666667,use utf8;
0.00468,3,0.00156,use strict;
0,0,0,
0.00000,1,0,require Exporter;
... that's enough, get the picture? ...

Note: that format line up top tells you what fields those numbers correspond to. read it. respect it. it's the decoder ring. 🔑

Note2: ⚠️ if the source file gets modified between profiling and report generation, the source might be misaligned. so like, don't be out here editing files mid-profile and then acting surprised. the numbers will lie to you and it won't be their fault. 😭

💜 SEE ALSO 💜

👑 AUTHOR 👑

Adam Kaplan, akaplan at nytimes dotcom. thank you for your service. 🫡

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

okay that's the whole page, you're officially educated, go forth and generate CSV ✨ nytprofcsv lives in perl v5.42.3, dated 2026-08-20, and it will always be NYTPROFCSV(1p) to me 💖🦋🎀 periodt.

📦 where this page comes from