aitextcleaner-formatting-residue 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d07760da322980151cabef103606639aa6c583d985566362aae4c8fb6bcadaa8
+  data.tar.gz: c4f92dd7d640549390abd7ec76f34536263461b08c3cedee519c5554a52ad62d
+SHA512:
+  metadata.gz: 54ec4d1021a861080206f0f2d79742e3f6bc06b08646db0500468b547412c926d13217526ecde1de64f092727b8b2a557a364ac49f18c16bba58ba2b07f5ad24
+  data.tar.gz: daf591f06bbfd019ff7cac538d150ed0455c02be3efd94e9b63ba92542079239495a07978d921a9c364c179fedd312de0962970d4528fb48ce787bbbb540eb18

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Text Cleaner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,57 @@
+# aitextcleaner-formatting-residue
+
+`aitextcleaner-formatting-residue` is a lightweight, deterministic Python library designed to clean common artifacts left behind when copying text from web pages, document editors, or generated text exports. It operates entirely locally with no external dependencies or network requests.
+
+## What It Does
+
+- Strips basic copied HTML block tags and markup wrappers.
+- Normalizes typographic punctuation residue (such as stray formatting quotes and dashes).
+- Collapses repeated blank lines and removes trailing whitespace.
+
+## What It Does Not Do
+
+- It does not detect AI-generated writing or analyze text semantics.
+- It does not guarantee originality, bypass detection tools, or rewrite content.
+- It only applies deterministic formatting cleanup to the string provided.
+
+## Python API Usage
+
+The library exposes a single function: `clean_formatting_residue(text: str)`.
+
+```python
+from aitextcleaner_formatting_residue import clean_formatting_residue
+
+raw_text = "<div><p>Sample text with trailing spaces.   \n\n\n\nNext line.</p></div>"
+cleaned = clean_formatting_residue(raw_text)
+print(cleaned)
+```
+
+## Command-Line Interface
+
+The CLI reads from standard input or an optional positional UTF-8 file argument and outputs the cleaned result directly to standard output:
+
+```bash
+# Read from a file argument
+aitextcleaner-formatting-residue input.txt
+
+# Read from standard input
+cat input.txt | aitextcleaner-formatting-residue
+```
+
+All processing occurs offline in memory; no network calls are made.
+
+## Testing
+
+You can run the test suite locally using `pytest`:
+
+```bash
+pytest
+```
+
+## Related Resources & Metadata
+
+For additional context on text cleanup patterns and web tools, visit the [AI Text Cleaner web utility](https://aitextcleaner.pro/). Package metadata and repository links may also point to this project homepage.
+
+## License
+
+This project is distributed under the MIT License.

data/lib/aitextcleaner/formatting_residue.rb

@@ -0,0 +1,20 @@
+require "cgi"
+
+module Aitextcleaner
+  module FormattingResidue
+    BLOCK_TAG = /<\/?(?:address|article|blockquote|br|div|li|p|pre|section)\b[^>]*>/i
+    HTML_TAG = /<[^>]*>/
+
+    module_function
+
+    def clean(text)
+      raise TypeError, "text must be a string" unless text.is_a?(String)
+
+      cleaned = text.gsub(BLOCK_TAG, "\n").gsub(HTML_TAG, "")
+      cleaned = CGI.unescapeHTML(cleaned)
+      cleaned = cleaned.gsub("“", '"').gsub("”", '"').gsub("‘", "'").gsub("’", "'")
+        .gsub("–", "-").gsub("—", "-").gsub("…", "...")
+      cleaned.gsub(/[ \t]+\n/, "\n").gsub(/\n{3,}/, "\n\n").strip
+    end
+  end
+end

metadata

@@ -0,0 +1,41 @@
+--- !ruby/object:Gem::Specification
+name: aitextcleaner-formatting-residue
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- AI Text Cleaner
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/aitextcleaner/formatting_residue.rb
+homepage: https://aitextcleaner.pro/
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://aitextcleaner.pro/
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.11
+specification_version: 4
+summary: Local formatting-residue cleanup helper for copied text.
+test_files: []