project-to-text 1.0.2 → 1.0.4

package/README.md

@@ -3,10 +3,8 @@
 [![npm version](https://img.shields.io/npm/v/project-to-text.svg)](https://www.npmjs.com/package/project-to-text)
 [![license](https://img.shields.io/npm/l/project-to-text.svg)](https://github.com/IrbadAbdeldjelil/project-to-text/blob/main/LICENSE)
 [![downloads](https://img.shields.io/npm/dt/project-to-text.svg)](https://www.npmjs.com/package/project-to-text)
-
 A powerful tool that converts your entire project into a single text file, making it easy to share with AI assistants for code review, analysis, and feedback.
 
-
 ## Installation
 
 ```bash
@@ -20,22 +18,19 @@ cd your-project
 project-to-text
 ```
 
-Creates `thisProject.txt` with your project content.
+This creates `thisProject.txt` with your entire project content.
 
-## Usage
+## Usage Examples
 
 ### Command Line
 ```bash
-#install it globally
-npm install -g project-to-text
-
 # Basic usage
 project-to-text
 
 # Ignore specific files
-project-to-text --ignore "dist/**,*.log"
+project-to-text --ignore "dist/**,*.log,coverage/**"
 
-# Using npx
+# Using npx (no installation required)
 npx project-to-text
 ```
 
@@ -47,30 +42,23 @@ const exporter = require('project-to-text');
 await exporter();
 
 // With custom ignore patterns
-await exporter('current-file.js', ['dist/**', '*.log']);
+await exporter('current-file.js', ['dist/**', '*.log', 'temp/**']);
 ```
-## API
 
-### `exporter(thisFile?, customIgnore?)`
+## Key Features
 
-- `thisFile` - Current file name to exclude (optional)
-- `customIgnore` - Array of ignore patterns (optional)
+- ✅ **Smart File Ignoring** - Automatically excludes node_modules, build files, media files
+- ✅ **Git Integration** - Reads your .gitignore patterns automatically  
+- ✅ **Clean Output** - Well-formatted text file perfect for AI analysis
+- ✅ **Fast & Lightweight** - Processes projects in seconds
+- ✅ **Flexible** - Custom ignore patterns and programmatic API
 
-## Features
+## Perfect For
 
-- Scans entire project structure
-- Smart ignoring of node_modules, build files, etc.
-- Custom ignore patterns
-- Clean formatted output
-- Fast and lightweight
-
-## Default Ignored Files
-
-- `node_modules/**`
-- `.git/**` 
-- `dist/`, `build/`, `coverage/`
-- `*.log`
-- `package-lock.json`
+- 🤖 **AI Analysis** - Share projects with ChatGPT, Claude, and other AI assistants
+- 🔍 **Code Reviews** - Get detailed project analysis and feedback
+- 📚 **Documentation** - Create comprehensive project snapshots
+- 🚀 **Sharing** - Easily share complete projects with team members
 
 ## Output Format
 
@@ -84,28 +72,15 @@ CONTENT : {
 }
 ```
 
-## Use Cases
-
-- Share code with AI assistants (ChatGPT, Claude, etc.)
-- Code reviews and analysis
-- Project documentation
-- Backup and sharing
-
-
-
+## Links
+- **npm:** https://www.npmjs.com/package/project-to-text
+- **GitHub:** https://github.com/IrbadAbdeldjelil/project-to-text
+---
 ## 👨‍💻 Author
 
 **Irbad Abdeldjelil**
 - Email: irbadabdeldjelil@gmail.com
 - GitHub: [IrbadAbdeldjelil](https://github.com/IrbadAbdeldjelil)
-
-## 🙏 Acknowledgments
-
-- Built with [fast-glob](https://github.com/mrmlnc/fast-glob) for fast file scanning
-- Inspired by the need for better AI code analysis workflows
-
----
-
 <div align="center">
 
 **If you find this tool helpful, please consider giving it a ⭐ on GitHub!**

package/bin/exporter.js

@@ -7,19 +7,37 @@ const path = require('path');
 // الدالة الرئيسية للتصدير
 async function exporter(thisFile = path.basename(__filename), customIgnore = []) {
    try {
-     console.log('🔧 Running with ignore patterns:', customIgnore);
+     if (customIgnore.length > 0) {
+         console.log('🎯 Ignore patterns:', customIgnore);
+     }
      
+     console.log('🔍 Scanning project...');
      const projectStruc = await scanner(customIgnore);
      
      if(projectStruc.includes('thisProject.txt')) {
          await fs.rm('thisProject.txt');
-         console.log('🗑️ Deleted old file');
+         console.log('🗑️ Deleted previous thisProject.txt');
      }
      
+     console.log('📄 Processing files...');
      const results = await reader(thisFile, customIgnore);
+     
      await fs.writeFile('thisProject.txt', results, 'utf8');
      console.log('✅ Project exported successfully to thisProject.txt');
-     console.log('📊 Total files processed:', projectStruc.length);
+     console.log(`📊 Total files processed: ${projectStruc.length}`);
+     
+     // إظهار معلومات إضافية
+     const fileExtensions = {};
+     projectStruc.forEach(file => {
+         const ext = path.extname(file) || 'no-extension';
+         fileExtensions[ext] = (fileExtensions[ext] || 0) + 1;
+     });
+     
+     console.log('📈 File types summary:');
+     Object.entries(fileExtensions).forEach(([ext, count]) => {
+         console.log(`   ${ext}: ${count} files`);
+     });
+     
    } catch(error) {
      console.log('❌ Failed to export:', error.message);
    }
@@ -30,12 +48,14 @@ function parseArgs() {
     const args = process.argv.slice(2);
     let customIgnore = [];
     
-    console.log('📨 Raw arguments:', args);
-    
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--ignore' && args[i + 1]) {
             customIgnore = args[i + 1].split(',');
-            console.log('🎯 Parsed ignore patterns:', customIgnore);
+            break;
+        }
+        // دعم --ignore=value أيضاً
+        if (args[i].startsWith('--ignore=')) {
+            customIgnore = args[i].split('=')[1].split(',');
             break;
         }
     }

package/package.json

@@ -1,15 +1,36 @@
 {
   "name": "project-to-text",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Convert your project to a single text file for AI analysis and code sharing",
   "keywords": [
-    "project",
-    "text",
-    "export", 
     "ai",
-    "analysis",
-    "documentation",
-    "code-sharing"
+    "chatgpt",
+    "claude",
+    "code-analysis",
+    "project-export",
+    "developer-tools",
+    "code-review",
+    "ai-assistant",
+    "project-to-text",
+    "repomix-alternative",
+    "lightweight",
+    "fast",
+    "simple",
+    "media-ignore",
+    "gitignore-support",
+    "file-converter",
+    "project-analyzer",
+    "ai-tools",
+    "code-sharing",
+    "project-documentation",
+    "automation",
+    "productivity",
+    "nodejs",
+    "javascript",
+    "open-source",
+    "text",
+    "to-text",
+    "one-file"
   ],
   "license": "MIT",
   "author": "Irbad Abdeldjelil <irbadabdeldjelil@gmail.com>",
@@ -37,4 +58,4 @@
   "bugs": {
     "url": "https://github.com/IrbadAbdeldjelil/project-to-text/issues"
   }
-}
+}

package/src/scanner.js

@@ -1,26 +1,71 @@
 const fg = require('fast-glob');
+const fs = require('fs/promises');
+const path = require('path');
 
 module.exports = async (customIgnore = []) => {
     const defaultIgnore = [
-        'node_modules',
+        // الملفات الأساسية
         'node_modules/**',
         'README.md',
         'package-lock.json', 
         'package.json',
-        '.git',
+        
+        // نظام التحكم بالإصدارات
         '.git/**',
+        
+        // ملفات النظام
         '.DS_Store',
+        'Thumbs.db',
+        'desktop.ini',
+        
+        // الملفات المنطقية
         '*.log',
+        '*.tmp',
+        '*.temp',
+        
+        // مجلدات البناء والتوزيع
         'coverage/**',
         'dist/**',
-        'build/**'
+        'build/**',
+        'out/**',
+        '.next/**',
+        '.nuxt/**',
+        
+        // البيئة والإعدادات
+        '.env*',
+        '.config/**',
+        
+        // الوسائط - الملفات الثقيلة
+        '**/*.jpg', '**/*.jpeg', '**/*.png', '**/*.gif', '**/*.bmp', '**/*.svg',
+        '**/*.mp4', '**/*.avi', '**/*.mov', '**/*.wmv', '**/*.flv',
+        '**/*.mp3', '**/*.wav', '**/*.ogg', '**/*.flac',
+        '**/*.pdf', '**/*.doc', '**/*.docx', '**/*.ppt', '**/*.pptx',
+        '**/*.zip', '**/*.rar', '**/*.tar', '**/*.gz',
+        
+        // بيانات وقواعد بيانات
+        '**/*.db', '**/*.sqlite', '**/*.mdb'
     ];
     
-    const ignoreList = [...defaultIgnore, ...customIgnore];
+    // قراءة .gitignore إذا موجود
+    let gitignorePatterns = [];
+    try {
+        const gitignoreContent = await fs.readFile('.gitignore', 'utf8');
+        gitignorePatterns = gitignoreContent
+            .split('\n')
+            .filter(line => line.trim() && !line.startsWith('#'))
+            .map(pattern => pattern.trim());
+    } catch (error) {
+        // إذا لم يوجد .gitignore، هذا طبيعي
+    }
+    
+    const ignoreList = [...defaultIgnore, ...gitignorePatterns, ...customIgnore];
     
     const results = await fg('**/**', {
         ignore: ignoreList,
-        dot: true
+        dot: true,
+        onlyFiles: true, // نتأكد أننا نحصل على ملفات فقط وليس مجلدات
+        caseSensitiveMatch: false
     });
+    
     return results;
 }