Aneio - A Simple HTTP Client Library

Aneio is a lightweight HTTP client built on Node.js core http and https modules. It provides a simple interface for making HTTP requests, similar to popular libraries like Axios, but without any external dependencies.

Features

• Supports GET, POST, PUT, and DELETE requests
• Automatically handles http and https protocols
• Simple and lightweight (core Node.js modules only)

Installation

You can use this library by cloning the repository or copying the aneio folder to your project.

https://github.com/eranees/aneio.git

Alternatively, install the package directly using npm:

npm install aneio

Usage

Initialization

Important: Add "type": "module" in package.json

To use the library with ES Modules, ensure your package.json includes:

To start using Aneio, you need to create an instance of the client with an optional base URL.

{
  "type": "module"
}

Initialization

To start using Aneio, you need to create an instance of the client with an optional base URL.

import { Aneio } from "aneio";

const client = new Aneio("https://jsonplaceholder.typicode.com");

Example: Making a GET Request

GET Request

client
	.get("/posts/1")
	.then((response) => {
		console.log("GET Response:", response);
	})
	.catch((error) => {
		console.error("Error:", error);
	});

POST Request

client
	.post("/posts", { title: "foo", body: "bar", userId: 1 })
	.then((response) => {
		console.log("POST Response:", response);
	})
	.catch((error) => {
		console.error("Error:", error);
	});

PUT Request

client
	.put("/posts/1", { id: 1, title: "foo", body: "bar", userId: 1 })
	.then((response) => {
		console.log("PUT Response:", response);
	})
	.catch((error) => {
		console.error("Error:", error);
	});

DELETE Request

client
	.delete("/posts/1")
	.then((response) => {
		console.log("DELETE Response:", response);
	})
	.catch((error) => {
		console.error("Error:", error);
	});

Options

You can pass additional options like headers and query parameters.

client
	.get("/posts/1", {
		headers: {
			Authorization: "Bearer token123",
		},
	})
	.then((response) => {
		console.log("GET with headers:", response);
	})
	.catch((error) => {
		console.error("Error:", error);
	});

API

new Aneio(baseURL)

baseURL (optional): The base URL for all requests (e.g., https://api.example.com).

client.get(path, options)

  path: The API endpoint (e.g., /users).
  options (optional): An object containing request options like headers.

client.post(path, body, options)

path: The API endpoint (e.g., /users).
body: The request body (must be JSON serializable).
options (optional): An object containing request options like headers.

client.put(path, body, options)

path: The API endpoint (e.g., /users/1).
body: The request body (must be JSON serializable).
options (optional): An object containing request options like headers.

client.delete(path, options)

path: The API endpoint (e.g., /users/1).
options (optional): An object containing request options like headers.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

Author

Anees Akbar From Kashmir