Forem: Tykok

PokeAPI Library 🚀

Tykok — Thu, 05 Oct 2023 20:10:19 +0000

I deploy my first library on Maven Central: https://central.sonatype.com/artifact/fr.tykok/pokeapi. ✨🎉
You can use this library to wrap easily all the data from pokeapi.co API.

Here I'm gonna explain why I create PokeAPI-Kotlin for the pokeapi.co, and how I deploy it on Maven Central.

You can find all about this project on GitHub: PokeApi-Kotlin.

You are free to contribute to this project 🙌🏽

What is a library?

Many library are available on Maven Central, but what is a library? 🤔
A library is just a piece of reusable code created by a developer or a team. A library can contains specific functions, classes or modules that can be used by other developers to simplify their work when creating software.

In short, a library is a set of pre-written codes that developers can use to solve common problems and accelerate the development of their software.
It's like a toolbox for developers, where they can find ready-made solutions for their needs.

Why I create a library 🆕

I create this library to improve my skills and to understand how a library is deployed to Maven Central. My goal was also to create my own tool that I would use later, and that others can use.

🧑🏼‍💻 For this project, I used Kotlin with Gradle Kotlin DSL.

This desire also came from a desire to create an application on the Play Store.

I wanted to create an Android application, to improve myself but also to understand how to deploy an application on the Play Store.
The aim was also to have one more app to add to my portfolio, and above all to have fun!

Problem: the Kotlin library offered on pokeapi.co has been out of date for a while (2021) and I've been getting errors when installing dependencies.
I didn't look far to correct this problem, as I saw an opportunity to create my own library that I'd later use for my application project.

That's how I managed to deploy my very first library on Maven Central!

How I deploy it on Maven Central

To deploy a package to Maven Central, you need to have an account on Jira.

💬 Go to Jira to create your account.

When it’s done, you need to create an Issue on Jira with your logged account. When you create an issue, you need to provide many information about your project :

Group Id : For me it was fr.tykok.pokeapi
Project URL: Link it to your GitHub repository
SCM URL: The URL to your source control system (just add .git to your GitHub URL)

⚠️ If you use a custom domain for your `groupId` you need to prove the domain it’s your by adding a `DNS TXT record`. If you want, you can use `io.github` for your domain if you don’t want to pay for domain name.

Configure your Graddle Kotlin DSL

First, you need to define two variable will be used soon at the top of your build.gradle.kts file. Here is mine :

description = "PokeApi is a simple library you can use to make request to get data about Pokémon."
group = "fr.tykok"
version = "0.0.3"

val artifact = "pokeapi"
val projectName = "PokeApi"
val sonarSnapshotUri = "https://s01.oss.sonatype.org/content/repositories/snapshots/"
val sonarReleaseUri = "https://s01.oss.sonatype.org/content/repositories/releases/"

To define which URL, you need to use, I create a small function in my build.gradle.kts file :

fun getUriSonar(): String = if (version.toString().endsWith("SNAPSHOT")) {
    sonarSnapshotUri
} else {
    sonarReleaseUri
}

Next, you need to add this plugins in your build.gradle.kts file :

plugins {
    `maven-publish`
}

And finally, you need to configure the Maven publication:

publishing {
    publications {
        create<MavenPublication>("library") {
            from(components["java"])
        }
    repositories {
        maven {
            url = uri(getUriSonar())
            name = projectName
            group = group
            version = version.toString()
            description = description
            credentials {
                username = project.findProperty("ossrh.username") as String?
                    ?: System.getenv("OSSRH_USERNAME")
                password = project.findProperty("ossrh.password") as String?
                    ?: System.getenv("OSSRH_PASSWORD")
            }
        }
    }
}

📝 If you want, you can check the documentation for MavenPublication.

You need to add the credentials too in the gradle.properties :

ossrh.username="username"
ossrh.password="password"

👀 Here, I use Sytem.getenv() function to get the credentials from Github Actions too.

If you want, you can check the main documentation I follow to publish my library.

What's the next step ?

Next step for me… Create a Pokedex on the Play Store with this library!

If you want, you can contribute to this project on GitHub !

Follow me

Twitter: https://twitter.com/TreportElie1
GitHub: https://github.com/Tykok
Medium: https://medium.com/@tykok

Follow me on medium ❤️

Tykok — Thu, 05 Oct 2023 20:02:06 +0000

Hello 👋🏼

I started writing articles on dev.to, and I'm currently trying to do some on Medium as well whenever I'm passionate about a topic or want to share something with you.

When I write an article, I'll publish it here and on Medium! So if you have a Medium account and want to follow me, you can do so here: https://medium.com/@tykok.

See you soon 👋🏼

Chinese npm package 汉译英

Tykok — Fri, 24 Feb 2023 12:35:17 +0000

Why create a npm package ?

Just to:

Understand what i use when i use npm i ... or yarn add ...
Especially understand how they made it !

So, i create my first package !

What is the library ?

The library named Cedict dictionary and it's actually available on npm.js and yarnpkg.com !

This library simply give you some functions and a large JSON file with for each object the :

Traditional character in Chinese
Simplified character in Chinese
Pinyin pronunciation
English translation

Here is an example of what you can have in an object :

{ 
  traditional: "上天入地", 
  simplified: "上天入地", 
  pinyin: "shang4", 
  english: "lit. to go up to heaven or down to Hades (idiom)/fig. to go to great lengths/to search heaven and earth/" 
}

ℹ️ I do not currently speak Chinese while writing this article!
It’s a really complex language, though the C language and all its pointers 🤣.

What is the Cedict ?

The Cedict, called CC-CEDICT is a continuation of the CEDICT project.

This project provide a complete downloadable Chinese to English dictionary, and all of this in a specific format of CC-CEDICT.
It's an open source project who is actually frequently updated !

ℹ️ If you want, you can go to her wiki.

How the @tykok/cedict-dictionary package work

The project have two parts :

The part who get data and format the Cedict into a JSON.
The part who simply exploit the JSON.

To get the final JSON, we need to

Download the .zip on CC-CEDICT project.
Unzip it.
Get the file who contain the dictionary.
Parse it into a JSON file.

All this actions are in a script called by a cronjob who simply execute this script and update the JSON Cedict of the library.

The second part is more simply than the previous one !

Here, we have a JSON file. And we can simply exploit it with some functions to get for example a chinese object with a traditional character.

A simple start with @tykok/cedict-dictionary

To start, use yarn or npm to install the dependency :

# With yarn
yarn add @tykok/cedict-dictionary

# With npm
npm i @tykok/cedict-dictionary

Next, just import the global class to use the Cedict :

import Cedict from '@tykok/cedict-dictionary'

And, with the Cedict class, you can use some function to get a specific chinese character, the pronunciation or all the cedict !

To know how to use this package, you can go to the documentation.

Conclusion

This project is not just for fun. I create it to learn some things i actually don't know or improve it !

Of course, this project is open source and you can come to contribute to this project. There are still many things to improve !

Tell me if you have any suggestions, or remarks for the project. And of course if this article was interesting.

Please, comment your code...

Tykok — Sun, 02 Oct 2022 00:52:30 +0000

Why should I comment my code ?

If you're actually code in Java, JavaScript, Python, PHP. You're probably hear about technical documentation and some things like :

And if you had not heard anything about "how to comment your code". So you were, you are or you will be confronted to THE question :

"What this code do ???"

And you know how it's painful when something doesn't work and you can't understand WHY !

When you use an external program, your reflex is to read documentation about this program to understand how to use this.

When you comment your code, the objectives is the same. You'll write some details for you in the future or for the people who use or improve this code.

Objectives

The objectives is multiple, just think about you in 2 years in this code. You'll be happy to see somes comments who explain what is this weird classes you added before 😆.

Now, if you don't code alone. Think about you're associate will read and use your code.

And PLEASE, think about all people who use your code in the future if you're make an open source program.

I think you understand now, when you comment your code you actually :

You saves time for you, and for other peoples
Describe, and have a readable code
Your code will be accessible

When should I comment ?

It's recommended to comment your class, you're function and use inline documentation when is necessary. I think it's the minimal requirement for a readable code.

A code has commented, is a readable code. BUT, use comment whith thriftiness.

Of course, if you're function is named sum for example, and take two arguments. It will be really simple to know what the function do.
Personaly I think you should comment for function when the function is over 10 lines, and it's required for classes.

And please remember, a developer does not only code.

A developer maintain, debug, keep an eye on evolution, document, and think how to resolve problems.
So please, comment your code and make happy the "you" of tomorrow and all people who read your code. And you'll make a step to become a programming god 😃.

Tell me if you have any suggestions, or remarks and of course if this article was interesting.
There is so much to say about this, feel free to express your point of view, so don't hesitate. 😜

Why the object approach with JavaScript methods is the best for me

Tykok — Sat, 23 Jul 2022 21:12:00 +0000

What is an object in JavaScript ?

Like the mdn web docs says :

"The Object type represents one of JavaScript's data types. It is used to store various keyed collections and more complex entities. Objects can be created using the Object() constructor or the object initializer / literal syntax."

So an object, is simply a structure with many properties have data assigned to them. Here is an exemple of an object :

const simplePerson = {
  id: 1,
  name: 'Jean',
  age: 24,
};

You can store everything you want ! You can store too a function for example :

const person = {
  id: 1,
  name: 'Jean',
  age: 24,
  print: function() {
    return `Id : ${this.id} -
            Name : ${this.name} -
            Age ${this.age}`;
  },
};

And you can store an object into a property too !

How use this ?

When you have an object, you can access all property inside of them.

For example, with the object person build before we gonna access the value of the property name.

Like you can see in this pictures, is simple to access properties of an object an use it.

Why I would use object for my function parameters ?

Because it's very useful. Imagine, you have a function with 10 parameters. When you call your function you need to give the value in order of each argument.

function foo(id, name, age) {
  // Some code here...
}

// When you call you're function
foo(1, 'Jean', 24);

If the order of each parameters changes in you're function declaration or you decided to add or remove some parameters, you need to change ALL function call to not have bugs !

It's not maintenable...

So i personally recommended to use object parameter instead of a list of parameters. And you have many ways to do that.

First way

You can for example use only one parameters for your function declaration. This object gonna have specific properties needed when you're gonne call the function.

function foo(person) {
  // Some code here...
  // person.id ...
}

// Build the object directly with call
foo({
  id: 1, 
  name: 'Jean', 
  age: 24
});

// Or build it before calling
let person = {
  id: 1, 
  name: 'Jean', 
  age: 24
}
foo(person)

Here if we want, we can easily change the order of the property in the object. They don't change create a bug in you're function.

Second way

The second way is to use the call method. When you use call in your function you can use the this statement.

Here is an exemple.

function calcRectArea() {
  return this.width * this.height;
}

console.log(calcRectArea.call({width: 5, height: 6}));
// Will show 30

Third way

The third and the last way to make this is to simply define an object parameters an declare your properties into this object parameters.

To understand what i say, i show you an example here :

function calcRectArea({height, width}) {
  return width * height;
}

console.log(calcRectArea({width: 5, height: 6}));
// Will show 30 too

Here for me the declaration is simpler than the 2 previous ones, because you can know what properties names the object needs and it's not necessary to read the function.

Conclusion

For me, the object approach for the declaration of a function is really useful, because you don't need to have a list of each parameters you need for one function and you can define named arguments when you call you're function like Python, for example !

Of course, this approach is not useful for a function with one parameter for example. But with this approach you can easily maintain your code and make updates on it.

But wait... for all parameters declaration, we don't know the type of the function parameters and how we can know this ?

I'll try to explain this in an other section talk about JSDoc 😜

Tell me if you have any suggestions, or remarks and of course if this article was interesting. 😜

How i spent 1 hour of my time for a line break in a Bash.

Tykok — Thu, 12 May 2022 21:11:02 +0000

I hope this article will help you if you want to use Bash to create a small script.

So yes, I confirm, I spent 1 HOUR OF MY TIME for a little break.

Why this happening ?

Because line break in Windows are not the same for Linux and when you run your Bash script you can have an error like this :

And you can search for a long time in your codes, why this error appeared.

And this error appear just because the encoding of your file using the unicode of your line break is "CR+LF" (000D + 000A) instead of "LF" (000A).

CR is for "cariage return" and LF is for "line feed".

When you press enter, one of this Unicode is used. And Linux doesn't like the CR+LF because he represents all line endings by a LF and in my case, he gave me some problems.

How to solve it ?

To solve it, you have many solutions. The most easily it's to use your favorite IDE and change the line ending.

For exemple in VSCode it's at the bottom.

If you use Git, you can use a file named .gitatttributes. You can in this file, specify to get what is the end of the line of a specific file.

*.sh        text eol=lf
*.md        text=auto
*.txt       text

In the first line we declare the end of the lines for all files with .sh extension by LF.

And the last solution is to use the command dos2unix you can use to convert all lines endings of a file.

And you, have you ever have an absurd problem like that ?

Main sources :

The website solves my problems (and save me).

Microsoft explains line endings.

Use variables in your package.json

Tykok — Wed, 11 May 2022 17:36:14 +0000

Yes, you can use variable in your package.json file

So I'm gonna show you how you can use variables in this file.

What is the "`package.json`" ?

The package.json is like the official NodeJS website defines it to us :

A kind of a manifest for your project. It can do a lot of things, completely unrelated. It's a central repository of configuration for tools, for example. It's also where npm and yarn store the names and versions for all the installed packages.

For more precision in the package.json you can declare :

The name of your application
The version
The Licence
The description of your project
The dependencies of your project (for production, and development)
Script for your project (Run project, run tests, run Lint, run the build, ...)
The engine of tools (Node, npm, ...)
The author name of the project
All contributors

And a lot of other things...

Why use variables into my `package.json`

Imagine, you define a command in your scripts section into the package. Jason of your own project to use many Bash files you created and has really useful for your project.

And all the Bash files are in the .bin repository, inside your project.

Your script section gonna be like that :



{
    ...
    "scripts": {
        "bash1": "bash .bin/yourFirstBash.sh",
        "bash2": "bash .bin/yourSecondBash.sh",
        "bash3": "bash .bin/yourThirdBash.sh",
    }
    ...
}

All it's ok, but now if for any reasons you need to move this bin into another directory you need to change your package.json for each line.

And here you can use variables to change quickly the destination of your Bash script 😄.

How to use variables in your `package.json`?

To use variable, you need to declare a section named config (or something else, but not a name was already taken by the package.json). And in this section, you can declare ALL YOUR VARIABLES :



{
    ...
    "config": {
        "path": ".bin",
        "entrypoint": "server.js",
        "testFolder": "src/test",
    }
    ...
}

And to use a variable, you just need to write $npm_package_ + config (name of the section) + _path (name of the variable).

Here is an example with the previous section of scripts:



{
    ...
    "scripts": {
        "bash1": "bash $npm_package_config_path/yourFirstBash.sh",
        "bash2": "bash $npm_package_config_path/yourSecondBash.sh",
        "bash3": "bash $npm_package_config_path/yourThirdBash.sh",
    }
    ...
}

And you what do you think about using variables into your `package.json` ?

Main source : https://brianchildress.co/variables-in-package-json/

Meta announce the use of NFT

Tykok — Tue, 19 Apr 2022 12:52:42 +0000

Today we hear a lot of things about NFT's. And with this growing trend the Meta's CEO wants to develop the usage of this by integrating this usage into Instagram.

Mark Zuckerberg make this announce on occasion of the event of South by SouthWest, and he say the teams of Instagram work on this integration in the social network.

Wait, what is an NFT ?

An NFT, is an abreviation to say Non-Fungible Token. Is a token who represent an object with a numerical identity was store on a blockchain.

An NFT is considered as a property deed, for example it is possible to buy a car through an NFT. And with this NFT you can say this car is your !

But an NFT can be all you want, for example a collection named Bored Ape Yacht Club have a lot of pictures, and the most expansive cost only 100 000 000 000 000 ETH (Ethereum) and 289 721 000 000 000 000,00 in dollar (currently).

Don't panic, you can get a lot of NFT for a small price, and you can also create your own NFT and sell it.

The world of NFT is very large, but what does Meta's CEO want to do with it?

What the Meta's CEO gonna do with that ?

The future of Instagram

The global objective, it's to use NFT's with Instagram and more precisely in the Metaverse of Meta.

The NFT's gonna be based and your profile and your life (Meta have a lot of information about that) and can be used in Instagram, Facebook, ....

For example, with your account you have an avatar and this avatar have some clothes. You can personalize this avatar with many things and exchanges virtual objects you have with other people in the Metaverse. All your clothes, accessories, etc. gonna be yours and gonna be linked with your account.

This new world is an opportunity for many marks, who can for example, create a special shoe with a large rarity.

But all I say here, it's assumption because the Metaverse is not for tomorrow, and the Meta group need a lot of time to develop this new virtual world.

But imagine what could be possible in the future...

And you, what do you want to be able to do in the Metaverse ?

A French IA win against eight world champion of bridge

Tykok — Thu, 07 Apr 2022 23:11:14 +0000

What is the Bridge ?

The bridge, it's a card game (52 cards) played with four people, in a team of two against two.

It's a game based on the communication (because we play at two) and it's a game need a strategic reflexion and it's a random game.

Why this is a real advance

It's a real advance in IA, because of the particular difficulty to play in this game.

Indeed, this game, it's a random game played with partial information for each players. With this game, the IA makes many choices without knowing the cards of other players.

So we can say the bridge as a really hard game, modelled on the real life.

In real life we make sometimes choices without knowing the result or the consequences of these choices.

It's a really different IA of AlphaGo (Go) and Deep blue (Chess). Because unlike of the bridge, in Chess and Go, all information is observable and available for the IA.

AlphaGo IA reportage.

Who created this IA ?

That AI is called Nuke, and it was founded by a French start-up named Nukkai. This start-up was created to make many searches on IA.

An for Veronique Ventos (the founder of Nukkai) the bridge was a really good game to explore the potential of IA.

So this IA, was created to explore the many possibilities of IA and try to make a new challenge.

How Nuke globally work ?

Nuke was trained with the simulation of "Monte Carlo".

This simulation is named "Monte Carlo" (Monaco place) because of many randomnes games.

That's not all, Nuke it's not a "black box" for human. Indeed, he makes decisions and explain all of human in many different levels of comprehension.
This makes a real difference, because here we gonna understand exactly how the IA works unlike of AlphaGo for example who win but we don't know how exactly how he win.

The redifusion of Nukkai challenge

What do you think about the evolution of AI ?

A particular thanks to "Siècle digital" and "Monde numérique" who giving me information about this news.

An auctions due to the close of "United Front Games" studio make a gamer really happy

Tykok — Tue, 22 Mar 2022 19:42:25 +0000

The PS4 have now 9 years, and all this secrets are not yet revelated.

Indeed, the Canadian studio at the origin of the game named Sleeping Dogs, made an auction following the closure of the studio of many materials of the studio.

We could find there :

Server equipment
Furniture (desk, lamps, TV, ...)

But above all a PS4 devkit.

Indeed, the player named "kaneda2004" who is in possession of this priceless object actually owns a console used by developers during the development of video games.

The console is not virgin, but containing nearly 800GB of content developers could reveal secrets that have not yet seen the light.

"kaneda2004" has also decided to go all the way, contacting members of Assembler Games in an attempt to extract encrypted data and reveal what they contain.

The 9 year old PS4 has not yet delivered all its secrets and this despite the arrival of the PS5 2 years ago!

My main source for this article : https://gaming.gentside.com/console/ps4-un-joueur-fait-une-decouverte-en-fouillant-sa-console-achetee-aux-encheres_art16192.html

"DALL-E" Artificial intelligence that will draw your text

Tykok — Mon, 31 Jan 2022 21:35:16 +0000

Presentation of DALL-E

The January 5, 2021, the openai.com website put forward an AI able to translate a word or a sentence into a picture.

Say like this, it seems easy to do... But it is a really challenge !

For exemple, if you give this sentence :

"An armchair in the shape of an avocado."

You can have this beautiful pictures :

Source : Website of openai.com

This extraordinary AI is called DALL-E, a contraction of the name of the surrealist artist Salvador Dali and the robot WALL-E.

Github official repo is here

DALL-E is based on the GPT-3 model, which had a bad buzz this year because it suggested to a patient to commit suicide when used as a medical chatbot by Nabla.

The GPT-3 for Generative Pre-trained Transformer 3 is an autoregressive language model that uses deep learning to produce human-like text.
It is the successor of GPT-2, and he the third-generation language prediction model who was created OpenAI.

But openai.com had warned Nabla on the use of the GPT-3 model in medical, and had say to Nabla :

"Health is in the high-stakes category because people rely on accurate medical information to make life-and-death decisions, and mistakes in this area could result in serious harm."

But with DALL-E, the risks would not be of this magnitude because the use here of GPT-3 is different.

The GPT-3 Model

We already know that with this model, OpenAI is for example able to generate code from a sentence in English.

OpenAI has shown it for example with the presentation of Codex accessible in private beta since August 2021.

He has been trained and is actually able to program in many langage like CSS, JSX, Python and others.

Incredibly powerful, this model has also managed to write a dissertation in less than twenty minutes against three days for a student.

Here is an example of many use of GPT-3 if you want to see more

But as we have already seen, this model is not without its flaws...

Indeed it can be dangerous, and can for example develop conspiracy theories on Reddit.
But this is normal because the AI has been trained on hundreds of billions and he necessarily used resources present on the web, which tends to amplify the racist and sexist bias of the model. But of course researchers are already working on this problem.

With this model, many technological advances can be made in the field of AI. And maybe one day machines will really be able to understand everything we say...

What do you think this AI will be able to do in the future ?

Microsoft announces $68.7 billion buyout of Activision Blizzard

Tykok — Tue, 18 Jan 2022 22:17:19 +0000

This is the biggest transaction in Microsoft's history.

Indeed, Microsoft bought Activision Blizzard which is an industry of video games very well know through many different games like :

Call Of Duty
Crash Bandicoot
Doom
World Of Warcraft
Overwatch

And many others...

On 18 January, Microsoft reached an agreement to buy Activision Blizzard for a total of $68.7 billion.

Through this buy, Microsoft could be the third biggest industry of video games in the world after Tencent and Sony by adding at Microsoft 400 million monthly players in nearly 190 countries.
Knowing that Microsoft was early implemented a strategy to compete with PlayStation by the marketing of Xbox Game Pass Ultimate since August 2019.

The Xbox Game Pass Ultimate gives a catalog of 100 free games (and much more with the buy of Activision Blizzard) for only $15 by month at gamers of Xbox and PC.

To conclude, with this buy Microsoft could be a reference in the world of video games and could also turn more to metaverse platform development who would be the future of video games according to Satya Nadella.

Forem: Tykok

PokeAPI Library 🚀

What is a library?

Why I create a library 🆕

How I deploy it on Maven Central

Configure your Graddle Kotlin DSL

What's the next step ?

Follow me

Follow me on medium ❤️

Chinese npm package 汉译英

Why create a npm package ?

What is the library ?

What is the Cedict ?

How the @tykok/cedict-dictionary package work

A simple start with @tykok/cedict-dictionary

Conclusion

Please, comment your code...

Why should I comment my code ?

Objectives

When should I comment ?

Why the object approach with JavaScript methods is the best for me

What is an object in JavaScript ?

How use this ?

Why I would use object for my function parameters ?

First way

Second way

Third way

Conclusion

How i spent 1 hour of my time for a line break in a Bash.

Why this happening ?

How to solve it ?

And you, have you ever have an absurd problem like that ?

Use variables in your package.json

What is the "package.json" ?

Why use variables into my package.json

How to use variables in your package.json?

And you what do you think about using variables into your package.json ?

Meta announce the use of NFT

Wait, what is an NFT ?

What the Meta's CEO gonna do with that ?

Meta

What is the Metaverse ?

The future of Instagram

And you, what do you want to be able to do in the Metaverse ?

A French IA win against eight world champion of bridge

What is the Bridge ?

Why this is a real advance

Who created this IA ?

How Nuke globally work ?

What do you think about the evolution of AI ?

An auctions due to the close of "United Front Games" studio make a gamer really happy

"DALL-E" Artificial intelligence that will draw your text

Presentation of DALL-E

The GPT-3 Model

What do you think this AI will be able to do in the future ?

Microsoft announces $68.7 billion buyout of Activision Blizzard

What is the "`package.json`" ?

Why use variables into my `package.json`

How to use variables in your `package.json`?

And you what do you think about using variables into your `package.json` ?