Giter Club home page Giter Club logo

chgasparoto / countries-capitals Goto Github PK

View Code? Open in Web Editor NEW
0.0 2.0 5.0 1.05 MB

:package: A simple package to get the capital of the countries. It's a Udemy course. If you'd like to support me, you can buy the course using the link below and get to know how I developed this package.

Home Page: https://www.udemy.com/course/como-publicar-um-package-no-npm/?referralCode=415D558FB4CB96995633

License: MIT License

JavaScript 5.92% TypeScript 94.08%
npm-package typescript udemy-course

countries-capitals's Introduction

Countries Capitals

📦 🇧🇷 A simple package to get the capital of the countries https://www.npmjs.com/package/countries-capitals

Travis (.org) Codecov npm npm NPM Language grade: JavaScript Known Vulnerabilities semantic-release Commitizen friendly udemy

Getting Started

Prerequisites

node -v
node: v10

Installing

Using npm

npm install --save countries-capital

Using Yarn

yarn add countries-capital

How to use

const Countries = require('countries-capital')
const countries = new Countries()

// filter by name
const brazil = countries.byName('brazil')

/**
 * Get all country data:
  [{
    "country": "Brazil",
    "city": "Brasília",
    "independence": "1822",
    "location": "South America"
  }]
*/
brazil.toJson()

// get capital
brazil.capital // Brasília

// resetting the filter
countries.reset()

// filter by location and independence year
countries.byLocation('europe').byIndependence(1900, '>=')

/**
 * Get all countries data:
  [{
    "country": "Bulgaria",
    "city": "Sofia",
    "independence": "1908",
    "location": "Eastern Europe"
  },
  {...},
  {...}
  ]
*/
countries.toJson()

// When country has more than one country after applying the filter it returns a random capital every time it calls .capital
countries.capital // Sofia
countries.capital // ...
countries.capital // ...
countries.capital // ...

Full API Reference

const Countries = require('countries-capital')
const countries = new Countries()

// lists all the countries data disregading any filter
countries.list()

// reset any applied filters
countries.reset()

// filter by country name
// passing country full name: single result
countries.byName('brazil')
countries.toJson() // all country data as an array of objects
countries.capital // only country capital as string

// passing country partial name: multiple results
countries.reset().byName('ind')

// filter by capital
countries.byCapital('amsterdam') // single result
countries.byCapital('ber') // multiple result
countries.byCapital(null) // multiple result. All countries without a Capital City

// filter by location
countries.byLocation('europe')
countries.byLocation('South America')
countries.byLocation(null)

// filter by independence date
countries.byIndependence(1822) // implicit = (equal sign) operator
countries.byIndependence(500, '<') // lesser than
countries.byIndependence(2000, '>=') // greater or equal than
countries.byIndependence(null) // countries without independence year

// get the longest capital name of the list
countries.longest().capital

// return all filtered data as array of objects
countries.toJson()

// return capital as string
// if countries.length === 0, throw an error
// if countries.length === 1, return specific capital
// if countries.length > 1, return random capital
countries.capital

Running the tests

To run the tests go to the terminal and enter npm run test

Contributing

If you want to collaborate, please feel free. I appreciate any help :)

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

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

countries-capitals's People

Contributors

chgasparoto avatar dependabot[bot] avatar itmecho avatar

Watchers

 avatar  avatar

countries-capitals's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.