yapople - GitLite

KO | EN

gitlite — search

#http #react-native #java #openai #hacktoberfest #html #react #golang #monitoring #github

yapople

(★ 26)

Yet another POP3 email library

파일 탐색기

ZIP 다운로드

- - coveralls.yml
  - npm.yml
- net.js
- tls.js
- yapople.test.js
- yapople.d.ts
- yapople.js
.eslintrc.js
.gitattributes
.gitignore
.npmignore
jest.config.js
LICENSE
package-lock.json
package.json
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`username`

설명 보기 ▼

사용자를 관리.
설정 모드에서 사용.
더 많은 정보: <https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/security/s1/sec-s1-xe-3se-3850-cr-book/sec-s1-xe-3se-3850-cr-book_chapter_0110.html>.

username {{admin}} privilege 15 secret {{password}}

관리자 계정 생성:

🔍

`npm install`

설명 보기 ▼

Install Node packages.

npm {{[i|install]}}

Install dependencies listed in `package.json`:

npm {{[i|install]}} {{package_name}}@{{version}}

Download a specific version of a package and add it to the list of dependencies in `package.json`:

npm {{[i|install]}} {{package_name}} {{[-D|--save-dev]}}

Download the latest version of a package and add it to the list of dev dependencies in `package.json`:

🔍

`npm test`

설명 보기 ▼

This command is an alias of `npm run test`.

tldr npm run

View documentation for the original command:

🔍

`stat`

설명 보기 ▼

파일 및 파일 시스템 정보를 표시.
관련 항목: `file`.
더 많은 정보: <https://www.gnu.org/software/coreutils/manual/html_node/stat-invocation.html>.

stat {{path/to/file}}

특정 파일에 대한 속성(크기, 권한, 생성 및 액세스 날짜 등) 표시:

stat {{path/to/file}}

파일의 크기, 권한, 생성 및 접근 날짜 등의 속성 표시:

stat {{[-t|--terse]}} {{path/to/file}}

레이블 없이 특정 파일에 대한 속성(크기, 권한, 생성 및 액세스 날짜 등) 표시:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Yet another POP3 library

[![Coverage Status](https://coveralls.io/repos/agsh/yapople/badge.svg?branch=master)](https://coveralls.io/r/agsh/yapople?branch=master)
[![NPM version](https://img.shields.io/npm/v/yapople.svg)](https://www.npmjs.com/package/yapople)

The design propose of the library is simplicity. A lot of common tasks with you POP3 mailbox doesn't require knowledge of
the eleven POP3 commands. You just want to retrieve some messages from your mailbox and that's all! So here is quick
example how to do this with 'yapople':

```javascript
const { Client } = require('yapople');
const client = new Client({
  host: 'pop.mail.ru',
  port:  995,
  tls: true,
  mailparser: true,
  username: 'username',
  password: 'password',
  options: {
    secureContext: {
      passphrase: "passphrase"
    }
  }
});
(async () => {
    await client.connect();
    const messages = await client.retrieveAll();
    messages.forEach((message) => {
      console.log(message.subject);
    });
    await client.quit();
})().catch(console.error);
```

Or with the old callback style:

```javascript
var Client = require('yapople').Client;
var client = new Client({
  host: 'pop.mail.ru',
  port:  995,
  tls: true,
  mailparser: true,
  username: 'username',
  password: 'password',
  options: {
    secureContext: {
      passphrase: "passphrase"
    }
  }
});
client.connect(function() {
  client.retrieveAll(function(err, messages) {
    messages.forEach(function(message) {
      console.log(message.subject);
    });
    client.quit();
  })
})
```

Also this is a callback-driven and command-queued library instead of [poplib](https://github.com/ditesh/node-poplib)
So you can run methods in chain, don't think about already running command and get what you want in callback instead of
putting somewhere event-listener functions to retrieve data. You can add connection options (optional) after callback.

> Uses the last TLS Api (since crypto.createCredentials is deprecated),
> so it works only with node.js v.0.12 or later.

## Installation
`npm install yapople`

## Tests
`npm test`

## Constructor properties
When you create new Client object you should pass an object which describes connection properties.

* **host** or **hostname** - _string_ - mailserver hostname
* **port** - _number_ - port, usually 110 or 995 for TLS connection
* **username** - _string_ - mailbox username
* **password** - _string_ - mailbox password
* **mailparser** - _boolean_ - use [mailparser](https://github.com/andris9/mailparser) library to automatically decode messages
* **tls** - _boolean_ - use TLS encryption
* **options** - _object_ - Optional configuration JSON object for socket creation. 
(see. [TLS](https://nodejs.org/dist/latest-v12.x/docs/api/tls.html#tls_tls_connect_options_callback) 
and [NET](https://nodejs.org/dist/latest-v12.x/docs/api/net.html#net_socket_connect_options_connectlistener))

## Properties

* **connected** - _boolean_ - connect and login state

## Methods

All the methods can be used both callback-style or promise-style if callback has been omitted.
In the examples below only async-await style will be used.

### connect([options], [callback])
- **options** - __object__
- **callback** - __function(err)__

Connect to the mailserver using `hostname` and `port`. Starts TLS connection if `tls` property is true.
Then login into your mailbox using credentials properties `username` and `password`.

If `options` is defined, valuse from `options` will be used to connect for `tls.connect` or `net.createConnection` functions. 
Precedence goes to them instead of constructor `options`.

### count([callback])
- **callback** - __function(err, count)__

Returns a count of the messages in the mailbox

### retrieve(what, [callback])
- **what** - __number or array of numbers__ - message number, or an array of message numbers
- **callback** - __function(err, messages)__

Retrieve a message/messages by its number/numbers. If the `mailparser` argument is true returned messages will be parsed
and looks like an objects. Otherwise it will be strings. Notice that results are sparse array with indexes representing
message numbers. You can access message with its number like that `messages[number]` and use all HOF like this
`messages.map(function(mail, num){ return [num, mail.subject]; })`.
Or you can represent it like normal array with construction like this: `messages.filter(a => a)`

### retrieveAll([callback])
- **callback** - __function(err, messages)__

Retrieve all messages in mailbox. Result is a sparse array starting from 1.

### delete(what, [callback])
- **what** - __number or array of numbers__ - message number, or an array of message numbers
- **callback** - __function(err, messages)__

Delete a message/messages by its number/numbers.
If you delete several messages and get an error for some message, all you delete transaction will be reset.

Note that if your connection to the server is broken at all then the messages will not actually be deleted.
You need to cleanly disconnect from the mail server for this to happen.

### deleteAll([callback])
- **callback** - __function(err, statuses)__

Delete all messages in mailbox.

### retrieveAndDeleteAll([callback])
- **callback** - __function(err, messages)__

Retrieve and delete all messages in mailbox. Result is a sparse array starting from 1.
In a callback function you'll get an error message or an array of retrieved emails. 
If you get an error for some reason, all you delete transaction will be reset.

### list(number, [callback])
- **number** - __number (optional)__ - message number
- **callback** - __function(err, info)__

Returns length of a message in octets. If no number passed, list returns an object contains message numbers as a keys
and message lengths as a values

### quit([callback])
### disconnect([callback])
- **callback** - __function(err)__

Finish current session and disconnect. All messages marked as deleted after this command will be erased.

## Protocol methods

### retr(what, [callback])
- **what** - __number or string__ - message number
- **callback** - __function(err, message)__

Retrieve full message by its number.

### stat([callback])
- **what** - __number or string__ - message number
- **callback** - __function(err, stat)__

Returns an `stat` object representing the number of messages currently in the mailbox (`count` property)
and the size in bytes (`length` property).

### top(number, linesCount, [callback])
- **number** - __number or string__ - message number
- **linesCount** - __number or string__ - the number of lines of the message body you would like returned
- **callback** - __function(err)__

Retrieve part of the message including headers, or only headers.

### dele(number, [callback])
- **number** - __number or string__ - message number
- **callback** - __function(err, response)__

Delete a message by its number.

## Changelog

**0.4.0**
- all methods returns promises
- tests were rewritten in js and jest
- additional parameter `options` in the `constructor` and `connect` method