Zakaz: Auto-Generate index.ts Files for Cleaner Imports in Your Project

Ali Esmaeili — Tue, 20 May 2025 08:23:15 +0000

Managing imports and exports in JavaScript/TypeScript projects can quickly become messy — especially as your codebase scales. That’s where Zakaz comes in.

Zakaz is a lightweight CLI tool that automatically creates index.ts or index.js files for each folder in your project, streamlining the way you import and export modules. It helps you avoid repetitive and error-prone manual exports, making your code cleaner and more maintainable.

🔧 What Does Zakaz Do?

Zakaz recursively walks through your project directories, identifies all eligible files (typically .ts, .tsx, .js, or .jsx), and generates corresponding index.ts or index.js files that re-export them. This allows you to simply import a folder instead of specifying each file individually.

✅ Before Zakaz

import Button from './components/ui/Button';
import Input from './components/ui/Input';

✅ After Zakaz

import { Button, Input } from './components';

🚀 Installation

To install Zakaz globally or as a dev dependency:

npm install @navidmnzh/zakaz-cli

To run it instantly using npx:

npx zakaz

🛠️ CLI Options

Zakaz supports several useful flags:


+-------------------------------------------------------------------------+------+
| Description | Flag |
+-------------------------------------------------------------------------+------+
| Base path to start scanning from (default is .) | -b |
| Comma-separated list of directories to ignore (e.g., node_modules,dist) | -d |
| Show detailed logs during the generation process | -l |
+-------------------------------------------------------------------------+------+

Example:

npx zakaz -b . -d node_modules,build -l

📁 Project Structure

Zakaz’s repository is cleanly organized:

src/: Contains the core logic (directory walker, export generator)
bin/: Command-line entry point
tsconfig.json: TypeScript configuration
package.json: Metadata and dependencies

💡 Why Use Zakaz?

Reduces boilerplate : No more repetitive export statements in every folder.
Prevents human error : Automatically manages module exports, reducing mistakes.
Improves scalability : Keeps your import paths consistent and clean as the project grows.
Cross-compatible : Works with both JavaScript and TypeScript.

🚧 A Few Considerations

The tool is actively maintained and may receive additional features in future.
Documentation is minimal but the codebase is readable and well-structured.

🧠 Final Thoughts

Zakaz might be small, but its impact is significant — especially for growing codebases. If you’re tired of managing index.ts files manually or want to enforce cleaner architecture in your project, give Zakaz a shot.

You can check out the GitHub repository here:

📦 Zakaz on GitHub
📁 Zakaz CLI on NPM

🙏 Credits

Special thanks to Navid Madannezhad for creating and sharing this useful tool with the developer community. Zakaz is a great example of how small utilities can make a big difference in day-to-day development.

perfometrics: A Lightweight Python Package for URL Performance Metrics

Ali Esmaeili — Sun, 18 May 2025 07:57:50 +0000

In the world of software performance and DevOps, having fast, actionable insights into your web service response times is critical. While there are heavy-duty monitoring tools available, sometimes you just want something dead-simple to test how a specific URL is performing — that’s where perfometrics comes in.

🔍 What is perfometrics?

perfometrics is a minimalistic Python package that lets you measure performance metrics for any HTTP/HTTPS URL , using nothing more than a couple of lines of code.

It’s built on top of pycurl, providing a clean API to track:

HTTP status code
DNS resolution time
TCP connection time
SSL/TLS handshake time
Time to First Byte (TTFB)
Data transfer time
Total request time

⚙️ Installation

You can install it directly from PyPI:‍

pip install perfometrics

🚀 How to Use It

import perfometrics.curl as pcurl

url = 'https://example.com'
curl_uptime = pcurl.CurlUptime(url)
metrics = curl_uptime.get_metrics()

print('Metrics for', url)
print('HTTP status code:', metrics['status_code'])
print('Time taken for DNS resolution:', metrics['dns_lookup'], 'seconds')
print('Time taken for establishing TCP connection:', metrics['tcp'], 'seconds')
print('Time taken for SSL/TLS handshake:', metrics['ssl_tls'], 'seconds')
print('Time to First Byte (TTFB):', metrics['ttfb'], 'seconds')
print('Time taken for data transfer:', metrics['data_transfer'], 'seconds')
print('Total time taken for request:', metrics['total'], 'seconds')

curl_uptime.close_session()

✅ The result gives you a breakdown of where your time is being spent in the connection process — ideal for debugging latency issues or verifying optimizations.

💡 Use Cases

DevOps Monitoring : Benchmark your production endpoints periodically
CI/CD Testing : Run it in your pipelines to ensure APIs respond within acceptable limits
Data Collection : Log metrics over time and analyze performance trends
Lightweight Health Checks : Build quick health monitors using this package

📦 What’s Inside

A single class: CurlUptime
One method: .get_metrics() returns a dictionary of timing values
Optional: .close_session() to clean up the curl handler

No need for extra config or YAMLs. Just import and measure.

📁 Source Code & Documentation

🔗 GitHub: https://github.com/aliesm-com/perfometrics
📦 PyPI: https://pypi.org/project/perfometrics/

🧠 Final Thoughts

If you’re looking for a dead-simple way to collect performance metrics for your URLs in Python, without setting up a full observability stack, give perfometrics a try.

If you like it, I’d appreciate a ⭐ on GitHub, and feel free to submit issues or PRs with ideas!

Forem: Ali Esmaeili

Zakaz: Auto-Generate index.ts Files for Cleaner Imports in Your Project

🔧 What Does Zakaz Do?

✅ Before Zakaz

✅ After Zakaz

🚀 Installation

🛠️ CLI Options

📁 Project Structure

💡 Why Use Zakaz?

🚧 A Few Considerations

🧠 Final Thoughts

🙏 Credits

perfometrics: A Lightweight Python Package for URL Performance Metrics

🔍 What is perfometrics?

⚙️ Installation

🚀 How to Use It

💡 Use Cases

📦 What’s Inside

📁 Source Code & Documentation

🧠 Final Thoughts