view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN

- Submitted by: [gabriellhrn](https://github.com/gabriellhrn)
- link: https://github.com/gabriellhrn/dotfiles/blob/master/fish/.config/fish/completions/duckpan-completion.fish

#### Z Shell

- Submitted by: [elebow](https://github.com/elebow)
- link: https://github.com/elebow/duckpan-completion


### Dealing With Installation Issues

If during the course of your DuckPAN install you run into errors, don't panic, there are a few things you can try.

First, try running the install command again (`curl http://duckpan.org/install.pl | perl`), this often solves issues related to any dependencies.

If that doesn't work, you should investigate the build.log and see what's wrong. It might be a dependency issue which you can resolve by manually installing whichever dependency is missing via `cpanm`.

If it still won't install with `cpanm` try adding `--notest` to the cpanm command:

```
cpanm Test::More --notest
```

If that still doesn't work, you can also try using `--force`:

```
cpanm Test::More --force
```

If this ***still*** doesn't work, please create a GitHub Issue in the DuckPAN Repo [here](https://github.com/duckduckgo/p5-app-duckpan/issues). Be sure to paste the contents of your `build.log` and also let us know the details of your OS (`$ uname -a...

------


## Using DuckPAN


### Help

```
duckpan [--verbose|-v]
```

```
duckpan help
```

```
man duckpan
```

Shows you the DuckPAN help page which briefly describes DuckPAN and its features.


### For Instant Answer Developers

```
duckpan new [instant_answer_name]
```

Generates all necessary files for a new Spice or Goodie Instant Answer (depending on the current repo). DuckPAN will prompt you for a package name and generate the required files. If the name is already in use, DuckPAN will let you know and no files ...

Example:

```
duckpan new
```

```
duckpan new MyFirst::Spice
```

---

```
duckpan query [name ... | id ...]
```

Test Goodie and Spice triggers interactively on the command line.

Arguments:

- `[name ...]` to load one or more Spice, or Goodie Instant Answers.
- `[id ...]` to load one or more Spice, or Goodie Instant Answers; Or load a single Fathead Instant Answer

Example:

```
duckpan query Npm
```

```
duckpan query Twitter IsItUp
```

```
duckpan query mdn_css
```

---

```
duckpan server [--port <number>] [name ... | id ...]
```

Test multiple Goodie or Spice, or individual Fathead Instant Answers on a local web server, which simulates the DuckDuckGo production environment. This should be used to ensure Goodie, Spice, and Fathead Instant Answers are displayed properly.

For Spice Instant Answers, you should use the DuckPAN Server to also test your JavaScript code and Handlebars templates. 

For Fathead Instant Answers, the specified Instant Answer ID must have a matching folder in the `/lib/fathead/` dir containing an **output.txt** file. 

Options:

- `--port`, `-p` to specify which port DuckPAN's server should run on (defaults to 5000).

Arguments:

- `[name ...]` to load one or more Spice, or Goodie Instant Answers.
- `[id ...]` to load one or more Spice, or Goodie Instant Answers; Or load a single Fathead Instant Answer

Example: